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énement | Un enregistrement pour chaque | Mesuré par |
|---|---|---|
kiro.chat.message | Requête LLM que le service Kiro termine | Le service Kiro |
kiro.tool.call | Appel 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.
- 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.messageporte 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).
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 ressource | Valeur |
|---|---|
service.name | kiro-enterprise |
kiro.profile.arn | arn:aws:codewhisperer:<region>:<account-id>:profile/<profile-id> |
kiro.profile.id | L'ID du profil Kiro |
kiro.account.id | Le compte AWS qui contient le profil Kiro |
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.
| Attribut | Type | Présence | Description |
|---|---|---|---|
kiro.message.id | string | Toujours | L'ID de la requête. Unique pour chaque requête. Utilisez-le pour supprimer les doublons |
kiro.user.id | string | Toujours | L'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.email | string | Quand Kiro la trouve | L'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.type | string | Toujours | KIRO_IDE, KIRO_CLI, KIRO_WEB, KIRO_CREW ou PLUGIN. D'autres valeurs peuvent apparaître à mesure que Kiro ajoute des clients |
kiro.client.version | string | Quand définie | La 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.name | string | Toujours | Le modèle, comme auto. Les requêtes sur des modèles internes ne sont pas envoyées |
kiro.conversation.id | string | Quand défini | La 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_id | string | Quand défini | La 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_mode | string | Quand défini | Le 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.used | double | Quand définis | Crédits que la requête a utilisés |
kiro.credits.overage | double | Quand définis | Crédits de dépassement que la requête a utilisés |
kiro.tool_call_count | integer | Quand défini | Nombre d'outils que le modèle a demandés |
kiro.tool_calls | string | Quand le modèle a demandé un outil | Un 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.subagent | boolean | Quand défini | true pour une requête que Kiro démarre, comme un sous-agent, un résumé ou un titre de session |
kiro.answer.cut_off | boolean | Quand défini | Indique si la réponse s'est arrêtée à la limite de sortie du modèle |
kiro.response.duration_ms | integer | Quand définie | Temps en millisecondes entre la requête et la réponse complète |
kiro.subscription.tier | string | Quand défini | PRO, PRO_PLUS, PRO_MAX, POWER ou POOLING |
kiro.usage.limit | integer | Quand définie | La limite de crédits de l'utilisateur. 999999 pour un utilisateur d'un bassin partagé sans limite individuelle |
kiro.overage.enabled | boolean | Quand défini | Indique si le dépassement est activé pour l'utilisateur |
kiro.overage.cap | double | Quand définie | La limite de dépassement de l'utilisateur |
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.
| Attribut | Type | Présence | Description |
|---|---|---|---|
kiro.tool.use.id | string | Toujours | Unique pour chaque appel d'outil. Utilisez-le pour supprimer les doublons |
kiro.message.id | string | Toujours | La requête qui a demandé l'outil. Tous les appels d'outils d'une requête le partagent |
kiro.user.id | string | Toujours | Même valeur que sur kiro.chat.message |
kiro.conversation.id | string | Quand défini | Même valeur que sur kiro.chat.message |
kiro.client.type | string | Toujours | KIRO_IDE, KIRO_CLI, KIRO_WEB ou UNKNOWN |
kiro.tool.name | string | Quand défini | L'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.kind | string | Toujours | BUILTIN, MCP, SKILL ou UNKNOWN |
kiro.tool.outcome | string | Quand défini | COMPLETED, 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_ms | integer | Quand définie | Durée de l'appel, en millisecondes |
kiro.tool.agent_mode | string | Quand défini | VIBE, SPEC, QUICK_SPEC, BUG_FIX, PLAN, AUTONOMOUS, CUSTOM ou UNKNOWN. Le client affiche VIBE comme Default |
kiro.error.type | string | Quand l'appel ne s'est pas terminé | Le type d'erreur |
kiro.mcp.server | string | Appels MCP | Le nom configuré du serveur MCP. remote est la recherche Web de Kiro, pas un serveur que vous avez configuré |
kiro.skill.name | string | Chargements de Skill | Le name dans le fichier SKILL.md du Skill |
kiro.source | string | Toujours | CLIENT. Le client mesure chaque appel d'outil |
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ées | Kiro CLI |
|---|---|
Événements kiro.tool.call | 3.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_mode | 3.0.0 ou ultérieure |
kiro.agent_mode et kiro.skill.name | 3.1.0 ou ultérieure |
Recherche Web comme remote_web_search | 3.1.0 ou ultérieure |
Noms d'outils MCP dans kiro.tool.name, comme mcp_my_mcp_server_find_city | 3.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.
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érification | Attendu |
|---|---|
| Enregistrements | Un pour chaque requête LLM, et un pour chaque appel d'outil terminé |
| Attribut de ressource | service.name = kiro-enterprise |
| Attributs | Au moins kiro.event.name, kiro.user.id et kiro.message.id, plus kiro.tool.use.id sur les appels d'outils |
| Plateforme | Où vérifier |
|---|---|
| Honeycomb | Le jeu de données kiro-enterprise. Interrogez COUNT groupé par eventName |
| Grafana Cloud | Explore, votre source de données Loki, {service_name="kiro-enterprise"} |
| Dynatrace | L'application Logs, filtrée sur service.name = kiro-enterprise |
| Datadog | Log Explorer, filtré sur service:kiro-enterprise |
| Amazon CloudWatch Logs | Logs 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.namedevientkiro_model_name. N'ajoutez pas| jsonà une requête. Le corps est du texte brut. - CloudWatch Logs imbrique les attributs. Utilisez
attributes.kiro.model.nameetresource.attributes.service.name. - Dynatrace n'affiche pas
eventName. Filtrez surkiro.event.name.
Une nouvelle tentative peut livrer un événement deux fois. Supprimez les doublons sur ces clés :
kiro.message.idpourkiro.chat.messagekiro.tool.use.idpourkiro.tool.call. N'utilisez paskiro.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.
- 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.
- Honeycomb. Interrogez les événements, par exemple
SUM(kiro.credits.used)groupé parkiro.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.idcomme 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.
- 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.
Événements OpenTelemetry en temps réel