Registri strutturati senza segreti
Registri strutturati senza segreti — Gestire workflow AI affidabili. Uno schema stabile degli eventi; Un elenco di campi consentiti; Correlazione senza dati personali. Esercitazione pratica: Registri strutturati senza segreti.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Uno schema stabile degli eventi
- Un elenco di campi consentiti
- Correlazione senza dati personali
Uno schema stabile degli eventi
I registri JSON sono utili con nomi e tipi coerenti. Se un worker scrive duration, un altro elapsedSeconds e un terzo «lento», l’aggregazione diventa inaffidabile. Definisci schemaVersion, timestamp UTC, level, event, jobId, attempt, durationMs ed errorCode. Un passo riuscito usa event=artifact.persisted invece di una frase arbitraria. Il frammento è uno schema didattico nostro, non OTLP; durationMs=240 è immaginario. Valida prima del salvataggio: durata non negativa, orario valido e jobId presente negli eventi del lavoro. Non cambiare significato ai campi senza migrare i consumatori. Un campo duration con unità diverse può generare un falso rallentamento di mille volte. Il suffisso Ms rende visibili gli errori d’unità. Non aggiungere tutto il contenuto del modello.
{"schemaVersion":1,"timestamp":"2026-11-18T10:00:00Z","level":"info","event":"artifact.persisted","jobId":"job-7","attempt":1,"durationMs":240,"errorCode":null}
Un elenco di campi consentiti
Evita perdite senza copiare l’intero oggetto d’errore. Scegli i campi necessari e scarta quelli sconosciuti. L’errore didattico contiene code=TIMEOUT, request.headers.Authorization=TRAINING_SECRET e body con testo della riunione. Conserva code e operationName, non intestazione o body. Le espressioni regolari sono un livello aggiuntivo utile, ma possono perdere nuovi formati o array annidati. Un elenco consentito limita i dati prima della scrittura. Prova canary in campi annidati, parametri URL e messaggi d’eccezione, mai segreti reali. Definisci permessi di lettura, conservazione e comportamento a disco pieno: debug illimitato può fermare il workflow. La rimozione segue una politica esplicita, non pulizie improvvisate durante incidenti. Il codice sicuro dell’errore deve restare utilizzabile.
Correlazione senza dati personali
Un ID stabile basta per trovare tutti gli eventi di job-7; nome della persona e testo non servono. Trasmetti jobId a ogni fase e traceId quando il tracciamento è configurato. Conservali nei metadati della coda senza creare nuovi jobId per le ripetizioni. Un ID non autorizza la lettura dell’artefatto: l’accesso a summary.json privato richiede controlli separati. Non usare jobId come label delle metriche: ogni lavoro aggiunge un valore, moltiplicando le serie temporali. Bastano stage, status e service; cerca il singolo jobId nei registri o nelle tracce. La separazione supporta contatori aggregati e indagini precise. Prova con due lavori didattici concorrenti per verificare che gli eventi restino distinti senza dati personali.
Esercitazione pratica
Registri strutturati senza segreti
Vai alla lezione