Configurer la AWS télémétrie CDK CLI

Version de la CLI du CDK

Version de la CLI (x.y.z)

La collecte de ces informations nous aidera à diviser nos données en deux par version, ce qui peut nous aider à identifier les versions problématiques.

"2.1100.0"

ID d'installation

UUID aléatoire stocké sur des machines locales exécutant des commandes CLI

Cela nous permet d'estimer le nombre distinct d'utilisateurs concernés par une erreur. Chaque machine unique aura son propre identifiant d'installation généré aléatoirement via l'UUID V4.

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

ID de session

UUID aléatoire généré à chaque appel de commande CLI

Cela nous permet d'identifier tous les événements provenant d'une même commande.

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

ID de l’événement

L'identifiant de session plus un compteur

Cela crée un identifiant unique pour chaque événement d'une session.

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

Région

Région AWS

Cela nous aidera à diviser nos données en deux pour les problèmes spécifiques à chaque région.

"us-east-1"

Horodatage

L'heure (générée par le client) à laquelle les données sont envoyées à notre terminal de télémétrie

Cela nous aidera à générer des graphiques de séries chronologiques.

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

État de l'événement

Le « résultat » de l'événement. Les valeurs possibles sont « SUCCESS », « FAILURE », « ABORTED »

Cela nous aidera à suivre les taux d'erreur sur chaque commande de la CLI et à nous avertir des régressions potentielles avant qu'elles ne soient signalées par les clients.

"SUCCESS"

Type d’événement

Un identifiant pour le type d'événement qui produit les données

Il s'agit d'une énumération qui identifie le type d'événement qui s'est produit car il peut y avoir plusieurs événements lors de l'exécution d'une commande.

"SYNTH"

Chemin de commande

La commande et les propriétés saisies dans la CLI, avec tout texte libre expurgé

Outre les paramètres de commande, ces informations aident à déterminer le comportement de l'événement qui s'est produit, ce qui nous aide à identifier le rayon d'explosion et la cause des problèmes survenus.

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

Paramètres de commande

Les paramètres optionnels saisis dans la CLI, avec tout texte libre expurgé

Outre le chemin de commande, ces informations aident à déterminer le comportement de l'événement qui s'est produit, ce qui nous aide à identifier le rayon d'explosion et la cause des problèmes qui surviennent.

{
  all: true,
  concurrency: 4
}

Configuration

Paramètres supplémentaires susceptibles d'affecter la commande CLI (par exemple cdk.context.json ou les valeurs de contexte danscdk.json/~/.cdk.json), avec tout texte libre expurgé

Cela nous aidera à faciliter le débogage en fournissant une vue complète de tous les paramètres possibles susceptibles d'affecter le comportement de la CLI.

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

Système d’exploitation

Le système d'exploitation utilisé

Cela nous aidera à résoudre les problèmes qui n'affectent que des systèmes d'exploitation spécifiques.

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

CI/CD

Si la commande CLI est invoquée ou non depuis un CI/CD environnement

Cela nous aidera à identifier les problèmes spécifiques aux CI/CD environnements.

false

Version du nœud

Version du nœud utilisée dans l'environnement

Cela nous aidera à résoudre tout problème spécifique au nœud qui pourrait survenir.

"v22.0.0"

Duration

Durée de l'événement en millisecondes

Cela nous aide à observer des tendances quant à la durée de certains événements.

{ total: 300 }

Compteurs

Diverses mesures de comptage dérivées de l'exécution de votre application CDK et de votre CLI

Nous surveillerons comment les statistiques de comptage telles que (mais sans s'y limiter) le nombre de ressources CFN affectent la durée du déploiement.

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

Dépendances

Dépendances AWS pertinentes et leurs versions

Nous prévoyons de suivre les dépendances AWS susceptibles d'affecter le résultat de la CLI aws-cdk-lib, comme jsii, projen, etc. Nous collecterons uniquement les dépendances relatives à des bibliothèques spécifiques appartenant à AWS.

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

Noms des erreurs

Le nom de l'erreur, si une erreur se produit.

Nous enregistrons uniquement les noms des erreurs que nous contrôlons, ce qui permet d'identifier les types d'erreurs récurrents.

"ToolkitError"

Les statistiques suivantes nécessitent une inscription explicite et ne sont PAS collectées actuellement :

Messages d'erreur

Le message d'erreur renvoyé en cas d'erreur. Texte en forme libre expurgé

[Nécessite une inscription] La capture du message d'erreur nous aidera à agréger plus rapidement les données sur les erreurs rencontrées, ainsi qu'à résoudre les problèmes rencontrés dans des cas d'utilisation individuels.

Non collecté actuellement

Erreur Stack Trace

La trace du message d'erreur, en cas d'erreur. Texte en forme libre expurgé

[Nécessite une inscription] Le stack trace sera utile à des fins de débogage individuel et est nécessaire pour que nous puissions reproduire les problèmes susceptibles de survenir.

Non collecté actuellement

Journaux d'erreurs

Les journaux d'une commande CLI ayant échoué, en cas d'erreur. Texte en forme libre expurgé

[Nécessite une inscription] Les journaux d'erreurs nous aideront également à déboguer et à reproduire les problèmes rencontrés dans la CLI.

Non collecté actuellement