Passer au contenu principal
Afficher en Markdown

Événements OpenTelemetry en temps réel

Kiro peut envoyer chaque requête LLM et chaque appel d'outil à votre collecteur OpenTelemetry Protocol (OTLP) sous forme d'événement. Chaque événement est un enregistrement de journal OTLP. Les événements de requête LLM arrivent habituellement en quelques secondes. Les événements d'appel d'outil prennent plus de temps, car le client Kiro signale d'abord chaque appel à Kiro.

ÉvénementUn enregistrement pour chaqueMesuré par
kiro.chat.messageRequête LLM que le service Kiro termineLe service Kiro
kiro.tool.callAppel d'outil terminéLe client Kiro

Pour configurer l'exportation, préparez les identifiants, puis activez les événements en temps réel. Pour savoir comment les événements sont liés entre eux, consultez Comprendre les événements en temps réel.

Comment Kiro envoie les événements

  • Protocole. Journaux OTLP par HTTP/protobuf, compressés avec gzip. gRPC n'est pas pris en charge pour les événements.
  • Livraison. Au mieux. Kiro réessaie un événement qui ne peut pas être livré pendant jusqu'à environ 10 minutes, puis l'abandonne. Kiro n'envoie pas de nouveau les événements abandonnés. Rarement, un événement arrive deux fois. Consultez Supprimer les doublons.
  • Contenu. Les événements portent des ID, des nombres et des durées. kiro.chat.message porte aussi l'adresse courriel de l'utilisateur. Les événements ne portent pas de requêtes, de réponses, de code ni de contenu de fichiers.
  • Heure de l'enregistrement. Le moment où l'événement s'est produit : quand la requête s'est terminée, ou quand l'appel d'outil s'est terminé. L'heure d'observation est le moment où Kiro a envoyé l'événement. Pour une requête LLM, c'est habituellement quelques secondes après l'heure de l'enregistrement. Pour un appel d'outil, l'écart est plus grand, et peut atteindre 45 minutes quand le client signale l'appel en retard. Consultez kiro.tool.call.
  • Disponibilité. Profils Kiro dans US East (Virginie du Nord) et Europe (Francfort).

Champs communs

Chaque enregistrement a la portée d'instrumentation kiro.enterprise.events, la gravité INFO et le corps kiro.enterprise.event. Toutes les données se trouvent dans les attributs. Chaque enregistrement a un eventName, et l'attribut kiro.event.name avec la même valeur. Certaines plateformes, comme Dynatrace, n'affichent pas eventName; filtrez donc sur kiro.event.name. Kiro omet les attributs qui n'ont pas de valeur.

Ces attributs de ressource apparaissent une fois pour chaque livraison :

Attribut de ressourceValeur
service.namekiro-enterprise
kiro.profile.arnarn:aws:codewhisperer:<region>:<account-id>:profile/<profile-id>
kiro.profile.idL'ID du profil Kiro
kiro.account.idLe compte AWS qui contient le profil Kiro

kiro.chat.message

Un enregistrement pour chaque requête LLM. Une requête de l'utilisateur peut produire plusieurs requêtes LLM, par exemple quand l'agent appelle des outils.

AttributTypePrésenceDescription
kiro.message.idstringToujoursL'ID de la requête. Unique pour chaque requête. Utilisez-le pour supprimer les doublons
kiro.user.idstringToujoursL'ID d'utilisateur IAM Identity Center de l'utilisateur. Si le profil se connecte par un fournisseur d'identité externe, l'ID d'utilisateur de ce fournisseur
kiro.user.emailstringQuand Kiro la trouveL'adresse courriel de l'utilisateur. Avec un fournisseur d'identité externe qui n'a pas d'adresse courriel pour l'utilisateur, le nom d'utilisateur
kiro.client.typestringToujoursKIRO_IDE, KIRO_CLI, KIRO_WEB, KIRO_CREW ou PLUGIN. D'autres valeurs peuvent apparaître à mesure que Kiro ajoute des clients
kiro.client.versionstringQuand définieLa version du client tirée de l'agent utilisateur de la requête, comme 3.1.0. Non envoyée quand le client n'a envoyé aucune version. Un client mis à jour signale sa nouvelle version après son redémarrage
kiro.model.namestringToujoursLe modèle, comme auto. Les requêtes sur des modèles internes ne sont pas envoyées
kiro.conversation.idstringQuand définiLa conversation de la requête. Un clavardage d'un moteur Kiro CLI antérieur reçoit un ID de la forme cli_<uuid>_<8 characters> quand vous l'ouvrez sur le moteur actuel. Il reçoit un nouvel ID chaque fois que vous l'ouvrez. Traitez chacun de ces ID comme sa propre conversation
kiro.root_conversation_idstringQuand définiLa conversation de premier niveau de la session. Une requête de premier niveau a son propre kiro.conversation.id. Une requête de sous-agent a l'ID de sa session parente. Non envoyé par Kiro CLI sur le moteur d'agent V2
kiro.agent_modestringQuand définiLe mode d'agent de la session. Mêmes valeurs que kiro.tool.agent_mode. Une requête de sous-agent a le mode de sa session parente
kiro.credits.useddoubleQuand définisCrédits que la requête a utilisés
kiro.credits.overagedoubleQuand définisCrédits de dépassement que la requête a utilisés
kiro.tool_call_countintegerQuand définiNombre d'outils que le modèle a demandés
kiro.tool_callsstringQuand le modèle a demandé un outilUn objet JSON de noms d'outils et de nombres, comme {"fs_write":1,"read_file":3}. Jusqu'à 32 outils, en conservant les plus appelés. Un appel à un outil MCP est listé comme tool_call
kiro.request.subagentbooleanQuand définitrue pour une requête que Kiro démarre, comme un sous-agent, un résumé ou un titre de session
kiro.answer.cut_offbooleanQuand définiIndique si la réponse s'est arrêtée à la limite de sortie du modèle
kiro.response.duration_msintegerQuand définieTemps en millisecondes entre la requête et la réponse complète
kiro.subscription.tierstringQuand définiPRO, PRO_PLUS, PRO_MAX, POWER ou POOLING
kiro.usage.limitintegerQuand définieLa limite de crédits de l'utilisateur. 999999 pour un utilisateur d'un bassin partagé sans limite individuelle
kiro.overage.enabledbooleanQuand définiIndique si le dépassement est activé pour l'utilisateur
kiro.overage.capdoubleQuand définieLa limite de dépassement de l'utilisateur

kiro.tool.call

Un enregistrement pour chaque appel d'outil terminé. Une requête dans laquelle le modèle ne demande aucun outil n'a pas d'enregistrement kiro.tool.call.

L'heure de l'enregistrement est le moment où l'appel d'outil s'est terminé. Si le client signale l'appel avec plus de 45 minutes de retard, l'heure de l'enregistrement est le moment où Kiro l'a reçu.

AttributTypePrésenceDescription
kiro.tool.use.idstringToujoursUnique pour chaque appel d'outil. Utilisez-le pour supprimer les doublons
kiro.message.idstringToujoursLa requête qui a demandé l'outil. Tous les appels d'outils d'une requête le partagent
kiro.user.idstringToujoursMême valeur que sur kiro.chat.message
kiro.conversation.idstringQuand définiMême valeur que sur kiro.chat.message
kiro.client.typestringToujoursKIRO_IDE, KIRO_CLI, KIRO_WEB ou UNKNOWN
kiro.tool.namestringQuand définiL'outil, comme read_file ou invoke_sub_agent. Un outil MCP est mcp_<server>_<tool>, chaque - du nom du serveur étant écrit _, comme mcp_my_mcp_server_find_city. La recherche Web de Kiro est remote_web_search. Un chargement de Skill est disclose_context
kiro.tool.kindstringToujoursBUILTIN, MCP, SKILL ou UNKNOWN
kiro.tool.outcomestringQuand définiCOMPLETED, ERROR, FAULT, ABORT ou UNKNOWN. Un appel que l'utilisateur refuse ou annule est ABORT. FAILURE apparaît seulement quand le client l'envoie
kiro.tool.duration_msintegerQuand définieDurée de l'appel, en millisecondes
kiro.tool.agent_modestringQuand définiVIBE, SPEC, QUICK_SPEC, BUG_FIX, PLAN, AUTONOMOUS, CUSTOM ou UNKNOWN. Le client affiche VIBE comme Default
kiro.error.typestringQuand l'appel ne s'est pas terminéLe type d'erreur
kiro.mcp.serverstringAppels MCPLe nom configuré du serveur MCP. remote est la recherche Web de Kiro, pas un serveur que vous avez configuré
kiro.skill.namestringChargements de SkillLe name dans le fichier SKILL.md du Skill
kiro.sourcestringToujoursCLIENT. Le client mesure chaque appel d'outil

Versions des clients

Le client Kiro signale les appels d'outils, de sorte que certains attributs nécessitent une version prise en charge du client. Les événements kiro.chat.message arrivent de toutes les versions du client.

Pour Kiro IDE, mettez à jour vers la dernière version.

Pour Kiro CLI, le tableau indique la version minimale que Kiro prend en charge pour chaque type de données. Certaines versions antérieures en envoient une partie, mais Kiro ne les prend pas en charge pour ces données. Kiro CLI envoie les données d'appels d'outils seulement sur le moteur d'agent V3.

DonnéesKiro CLI
Événements kiro.tool.call3.0.0 ou ultérieure
Événements kiro.tool.call quand Collect metrics per user est désactivé3.1.0 ou ultérieure
kiro.tool.agent_mode3.0.0 ou ultérieure
kiro.agent_mode et kiro.skill.name3.1.0 ou ultérieure
Recherche Web comme remote_web_search3.1.0 ou ultérieure
Noms d'outils MCP dans kiro.tool.name, comme mcp_my_mcp_server_find_city3.2.1 ou ultérieure

Après une mise à jour, quittez chaque fenêtre IDE ouverte et chaque processus kiro-cli, puis redémarrez-les. Un ancien processus continue d'envoyer des données avec son ancienne version.

Confirmer l'exportation

Kiro ne vous avise pas quand une livraison réussit ou échoue. Vérifiez votre collecteur après que des utilisateurs ont été actifs.

VérificationAttendu
EnregistrementsUn pour chaque requête LLM, et un pour chaque appel d'outil terminé
Attribut de ressourceservice.name = kiro-enterprise
AttributsAu moins kiro.event.name, kiro.user.id et kiro.message.id, plus kiro.tool.use.id sur les appels d'outils
PlateformeOù vérifier
HoneycombLe jeu de données kiro-enterprise. Interrogez COUNT groupé par eventName
Grafana CloudExplore, votre source de données Loki, {service_name="kiro-enterprise"}
DynatraceL'application Logs, filtrée sur service.name = kiro-enterprise
DatadogLog Explorer, filtré sur service:kiro-enterprise
Amazon CloudWatch LogsLogs Insights sur votre groupe de journaux : filter eventName = "kiro.chat.message" | stats count(*) by attributes.kiro.model.name

Les plateformes stockent les noms d'attributs de différentes façons :

  • Grafana Cloud remplace les points par des traits de soulignement, de sorte que kiro.model.name devient kiro_model_name. N'ajoutez pas | json à une requête. Le corps est du texte brut.
  • CloudWatch Logs imbrique les attributs. Utilisez attributes.kiro.model.name et resource.attributes.service.name.
  • Dynatrace n'affiche pas eventName. Filtrez sur kiro.event.name.

Supprimer les doublons

Une nouvelle tentative peut livrer un événement deux fois. Supprimez les doublons sur ces clés :

  • kiro.message.id pour kiro.chat.message
  • kiro.tool.use.id pour kiro.tool.call. N'utilisez pas kiro.message.id, car les appels d'outils le partagent.

Kiro ne garantit pas l'ordre des événements. Triez par heure de l'enregistrement, pas par ordre d'arrivée.

Comportement de livraison

  • Les échecs temporaires sont réessayés. Un HTTP 5xx, 408, 425 ou 429, un délai d'attente dépassé ou une erreur de connexion est réessayé pendant jusqu'à environ 10 minutes. Ensuite, les événements sont abandonnés.
  • Les erreurs de configuration ne sont pas réessayées. Kiro abandonne les événements immédiatement pour tout autre 4xx, comme 400, 401, 403 ou 404. Il les abandonne aussi pour un secret que Kiro ne peut pas lire, ou un en-tête mal formé.
  • Un profil en échec fait une pause. Après 5 échecs de configuration sans livraison réussie entre eux, Kiro cesse d'envoyer pour le profil pendant environ 5 minutes, et abandonne ses événements. Puis Kiro réessaie.
  • La connectivité privée n'a pas de solution de repli. Tant que la connexion privée n'est pas prête, les livraisons échouent et sont réessayées comme des échecs temporaires.
  • Les métriques quotidiennes ne changent pas. Les événements abandonnés n'affectent pas le rapport CSV quotidien ni les métriques OpenTelemetry.

Transformer les événements en métriques

  • Honeycomb. Interrogez les événements, par exemple SUM(kiro.credits.used) groupé par kiro.model.name. Enregistrez la requête dans un tableau, ou ajoutez un déclencheur.
  • Grafana Cloud. Utilisez des requêtes de métriques LogQL, par exemple sum by (kiro_model_name) (count_over_time({service_name="kiro-enterprise"} [5m])). Utilisez une règle d'enregistrement pour conserver le résultat comme métrique.
  • Amazon CloudWatch Logs. Utilisez Logs Insights. Pour les filtres de métriques, ajoutez un transformateur de journaux qui copie chaque champ dont vous avez besoin dans un champ plat, car les filtres de métriques ne peuvent pas lire les noms contenant des points. N'utilisez pas kiro.user.id comme dimension de métrique. Chaque valeur est une métrique facturée, et CloudWatch désactive un filtre de métriques à 1 000 valeurs distinctes.

Coûts

  • AWS Secrets Manager et AWS KMS. Kiro lit votre secret des événements, et le déchiffre avec votre clé, pour chaque livraison. Une livraison porte jusqu'à 5 secondes d'événements de requête LLM d'un profil ou de ses événements d'appel d'outil, jamais les deux. Un profil occupé cause habituellement deux lectures toutes les 5 secondes, une pour chaque type d'événement. Un gros lot peut en causer davantage. Votre compte paie ces requêtes.
  • Votre plateforme. Votre plateforme d'observabilité facture l'ingestion et le stockage des journaux.
Page mise à jour : 16 novembre 2026