1. Che cosa deve contenere il file
APS Logic non richiede il patrimonio informativo completo del sistema.
Rappresenta il comportamento del sistema, non i suoi segreti.
2. Current State oppure Historical Replay
Current State
Usalo per un singolo momento operativo.
Historical Replay
Usalo per una sequenza temporale causale.
3. I campi principali
- system_id
-
Identificatore minimizzato del sistema.
- observation_id
-
Identificatore univoco dell'osservazione.
- timestamp
-
Momento reale dell'osservazione.
- entity_id
-
Entità osservata.
- entity_type
-
Classe dell'entità.
- category
-
Categoria del segnale.
- magnitude_band
-
Intensità qualitativa osservata.
- confidence_band
-
Confidenza dell'osservazione.
- recurrence_descriptor
-
Ricorrenza osservabile.
- volatility_band
-
Volatilità osservabile.
4. Come trasformare dati reali
La sorgente può essere un SIEM, telemetria, sensori, sistemi industriali o altre fonti autorizzate.
RAW DATA → MINIMIZATION → NORMALIZED OBSERVATIONS → APS INPUT READINESS → APS LOGIC
5. Regole temporali e causali
-
Eventi simultanei possono appartenere allo stesso momento APS.
-
Eventi diversi nel tempo devono restare separati.
-
Mantieni la geometria temporale originale.
-
Non comprimere la storia.
-
Non utilizzare informazioni future.
6. Historical Replay e evento di riferimento
L'evento osservato è un riferimento esterno e non deve contaminare il replay causale.
7. Cosa non caricare
- Password e credenziali.
- Dati personali non necessari.
- Payload sensibili non necessari.
- Documenti o dump indiscriminati.
- Informazioni future retroiniettate nel passato.
8. Quando un file è pronto per APS
Un JSON valido non è necessariamente APS-ready.
- Modalità corretta.
- Timestamp reali.
- Entità e categorie coerenti.
- Dimensioni dinamiche supportate dai dati.
- Nessuna future leakage.
- Dati minimizzati.
9. Errori comuni
-
Confondere severity e magnitude.
-
Inventare recurrence o volatility.
-
Comprimere il tempo.
-
Usare il futuro per costruire il passato.
-
Caricare dati inutili.
10. Current State — esempio minimo
{
"contract_version": "2",
"analysis_mode": "current_state",
"system_id": "system-demo",
"observations": [
{
"observation_id": "obs_001",
"timestamp": "2026-08-17T09:00:00Z",
"entity_id": "component_a",
"entity_type": "technical_component",
"category": "signal_a",
"magnitude_band": "MEDIUM",
"confidence_band": "MEDIUM",
"recurrence_descriptor": "REPEATED",
"volatility_band": "MEDIUM"
}
]
}
11. Historical Replay — esempio minimo
{
"contract_version": "2",
"analysis_mode": "historical_replay",
"system_id": "historical-system",
"incident": {
"timestamp": "2026-08-17T10:00:00Z",
"label": "Observed event"
},
"observations": [
{
"observation_id": "obs_001",
"timestamp": "2026-08-17T09:00:00Z",
"entity_id": "component_a",
"entity_type": "technical_component",
"category": "signal_a",
"magnitude_band": "LOW",
"confidence_band": "MEDIUM",
"recurrence_descriptor": "SINGLE",
"volatility_band": "LOW"
},
{
"observation_id": "obs_002",
"timestamp": "2026-08-17T09:20:00Z",
"entity_id": "component_b",
"entity_type": "technical_component",
"category": "signal_b",
"magnitude_band": "MEDIUM",
"confidence_band": "MEDIUM",
"recurrence_descriptor": "REPEATED",
"volatility_band": "MEDIUM"
}
]
}
12. Confine della guida
Questa guida spiega come rappresentare correttamente un sistema per APS Logic. Non descrive come APS Logic calcola o interpreta internamente le osservazioni.