Configurazione della AWS telemetria CLI CDK

Versione CDK CLI

Versione CLI (x.y.z)

La raccolta di questi dati ci aiuterà a suddividere in due i nostri dati per versione, il che può aiutarci a identificare le versioni problematiche.

"2.1100.0"

ID di installazione

UUID casuale memorizzato su macchine locali che eseguono comandi CLI

Questo ci aiuta a stimare il numero distinto di utenti interessati da un errore. Ogni macchina univoca avrà il proprio ID di installazione generato casualmente tramite UUID V4.

"881d3281-2811-4c86-b7b6-4a8a621cf6f2"

ID sessione

UUID casuale generato su ogni chiamata del comando CLI

Questo ci aiuta a identificare tutti gli eventi provenienti dallo stesso comando.

"c47e3d55-bc20-406b-a02a-e0285dd63230"

ID evento

L'ID della sessione più un contatore

Questo crea un identificatore univoco per ogni evento in una sessione.

"c47e3d55-bc20-406b-a02a-e0285dd63230:0"

Region

Regione AWS

Questo ci aiuterà a suddividere in due i nostri dati per problemi specifici della regione.

"us-east-1"

Time stamp

L'ora (generata dal cliente) in cui i dati vengono inviati al nostro endpoint di telemetria

Questo ci aiuterà a generare grafici di serie temporali.

"2025-12-12T00:00:00.000Z"

Stato dell'evento

Il «risultato» dell'evento. I valori possibili sono 'SUCCESS', 'FAILURE', 'ABORTED'

Questo ci aiuterà a tenere traccia dei tassi di errore su ogni comando CLI e ad avvisarci di potenziali regressioni prima che vengano segnalate dai clienti.

"SUCCESS"

Tipo di evento

Un identificatore per il tipo di evento che produce i dati

Si tratta di un enum che identifica il tipo di evento che si è verificato poiché possono esserci più eventi nell'esecuzione di un comando.

"SYNTH"

Percorso di comando

Il comando e le proprietà inseriti nella CLI, con qualsiasi testo libero redatto

Oltre ai parametri di comando, queste informazioni aiutano a determinare il comportamento dell'evento che si è verificato, il che ci aiuta a identificare il raggio di esplosione e la causa dei problemi che si verificano.

["cdk", "deploy", "$STACK1"]

Parametri di comando

I parametri opzionali inseriti nella CLI, con qualsiasi testo libero redatto

Oltre al percorso del comando, queste informazioni aiutano a determinare il comportamento dell'evento che si è verificato, il che ci aiuta a identificare il raggio di esplosione e la causa dei problemi che si verificano.

{
  all: true,
  concurrency: 4
}

Configurazione

Parametri aggiuntivi che possono influire sul comando CLI (ad esempio cdk.context.json o valori di contesto incdk.json/), con qualsiasi testo libero oscurato ~/.cdk.json

Questo ci aiuterà a facilitare il debug fornendo una visione completa di tutti i possibili parametri che possono influire sul comportamento della CLI.

{
  context: {
    "@aws-cdk/core:explicitStackTags": true
  }
}

Sistema operativo

Il sistema operativo utilizzato

Questo ci aiuterà a risolvere i problemi che riguardano solo sistemi operativi specifici.

{
  platform: "linux",
  release: "5.15.0-1019-aws",
}

CI/CD

Se il comando CLI viene richiamato o meno da un ambiente CI/CD

Questo ci aiuterà a identificare i problemi specifici degli ambienti. CI/CD

false

Versione del nodo

La versione del nodo utilizzata nell'ambiente

Questo ci aiuterà a risolvere eventuali problemi specifici del nodo che si presentano.

"v22.0.0"

Durata

La durata dell'evento in millisecondi

Questo ci aiuta a notare i modelli relativi alla durata di eventi specifici.

{ total: 300 }

Contatori

Diverse contrometriche derivate dall'esecuzione dell'app CDK e della CLI

Monitoreremo in che modo statistiche di conteggio come (ma non solo) il conteggio delle risorse CFN influiscono sulla durata dell'implementazione.

{
  resourceCount: 25,
  errorCount: 0,
  warningCount: 2,
}

Dipendenze

Dipendenze AWS pertinenti e relative versioni

Abbiamo intenzione di tenere traccia delle dipendenze di AWS che potrebbero influire sul risultato della CLI, aws-cdk-lib come jsii, projen, ecc. Raccoglieremo solo le dipendenze da specifiche librerie di proprietà di AWS.

[{ "aws-cdk-lib": "2.232.0"}]

Nomi degli errori

Il nome dell'errore, se si verifica un errore.

Registriamo solo i nomi degli errori che controlliamo, il che aiuta a identificare i tipi di errore ricorrenti.

"ToolkitError"

Le seguenti metriche richiedono un consenso esplicito e NON sono attualmente raccolte:

Messaggi di errore

Il messaggio di errore viene restituito, se si verifica un errore. Testo in formato libero redatto

[Richiede il consenso esplicito] L'acquisizione del messaggio di errore ci aiuterà ad aggregare i dati sugli errori riscontrati con maggiore frequenza, oltre a consentirci di eseguire il debug di ciò che è andato storto nei singoli casi d'uso.

Al momento non sono raccolti

Error Stack Trace

La traccia dello stack del messaggio di errore, se si verifica un errore. Testo in formato libero redatto

[Richiede l'attivazione] La traccia dello stack sarà utile per scopi di debug individuali ed è necessaria per poter riprodurre i problemi che potrebbero sorgere.

Attualmente non raccolto

Log di errore

I log di un comando CLI fallito, se si verifica un errore. Testo in formato libero redatto

[Richiede il consenso esplicito] I log degli errori ci aiuteranno anche a eseguire il debug e a riprodurre i problemi che vediamo nella CLI.

Al momento non sono raccolti