Passer au contenu principal
Afficher en Markdown

Comprendre les événements en temps réel

Kiro envoie deux événements en temps réel qui décrivent ce que font vos utilisateurs : kiro.chat.message pour chaque requête LLM, et kiro.tool.call pour chaque appel d'outil. Joignez-les pour répondre à des questions auxquelles les exportations quotidiennes ne peuvent pas répondre, comme le coût par session, le temps de réponse p95, ou quels serveurs MCP échouent. Le rapport CSV et les métriques OpenTelemetry totalisent la même utilisation pour chaque utilisateur et chaque jour, sans ID de requête, de conversation ni d'appel d'outil.

Pour recevoir ces événements, activez les événements en temps réel. Pour chaque attribut et ses règles de présence, consultez Événements OpenTelemetry en temps réel.

Comment les événements sont organisés

Dans l'activité d'un utilisateur, les événements s'imbriquent sur quatre niveaux :

  1. Une conversation est une session de clavardage.
  2. Un tour est une requête de l'utilisateur et tout le travail qu'elle démarre.
  3. Une requête LLM est un appel au modèle. Kiro envoie un événement kiro.chat.message pour chaque requête.
  4. Un appel d'outil est un outil que l'agent exécute. Kiro envoie un événement kiro.tool.call pour chaque appel d'outil.
Chargement de l'image...Hiérarchie des événements. Un profil contient des utilisateurs. Chaque utilisateur a des conversations et des lignes quotidiennes. Une conversation contient des tours. Un tour contient des requêtes LLM. Une requête peut contenir des appels d'outil. Un sous-agent démarre une autre conversation liée à la session.
NiveauDescriptionÉvénementCléComment compter
ProfilVotre profil KiroAttribut de ressource de chaque événementkiro.profile.arnUn pour chaque destination d'exportation
UtilisateurUne personneLes deux événementskiro.user.idkiro.user.id distincts
ConversationUne session de clavardageLes deux événementskiro.conversation.id; kiro.root_conversation_id pour la session, y compris les sous-agentskiro.conversation.id distincts. Pour les sessions, kiro.root_conversation_id distincts
TourUne requête de l'utilisateur et les requêtes LLM et appels d'outils qu'elle démarreAucunAucuneNon disponible. Pour en savoir plus, consultez Limites.
Requête LLMUn appel au modèlekiro.chat.messagekiro.message.idNombre d'événements kiro.chat.message
Appel d'outilUn outil que l'agent a exécutékiro.tool.callkiro.tool.use.idNombre d'événements kiro.tool.call
Utilisateur-jourUn utilisateur un jour donnéLigne du rapport CSV et métriques kiro.daily.*Utilisateur et dateUne ligne du rapport CSV

Une requête de l'utilisateur donne habituellement lieu à deux requêtes LLM ou plus. Dans la première requête, le modèle demande un outil. Le client exécute l'outil, et le modèle lit le résultat dans la requête suivante. Une requête qui ne demande aucun outil est habituellement la réponse finale du tour.

Exemple : une conversation avec un sous-agent

Dans cette conversation Kiro CLI, l'utilisateur envoie deux requêtes. La première requête demande à l'agent de lire un fichier. La seconde requête demande à l'agent d'utiliser un sous-agent.

Chargement de l'image...Exemple de session Kiro CLI. Un tour lit un fichier. Un autre tour démarre une conversation de sous-agent avec trois requêtes. L'agent parent et le sous-agent partagent un même ID de conversation racine.

Cet exemple montre ce qui suit :

  • Deux requêtes de l'utilisateur donnent lieu à sept requêtes LLM et onze appels d'outils.
  • Le sous-agent utilise 0,281 des 0,566 crédits. Les requêtes du sous-agent ont leur propre kiro.conversation.id. Pour les inclure dans le coût de la session, additionnez kiro.credits.used par kiro.root_conversation_id.
  • La durée de l'appel d'outil invoke_sub_agent, 18 712 ms, comprend tout le travail du sous-agent.

Événements pour une requête

Kiro envoie un événement kiro.chat.message pour la requête 6b7d77cd, et un événement kiro.tool.call pour l'appel read_file que la requête a demandé. Les deux événements ont les mêmes kiro.message.id et kiro.conversation.id.

Chaque enregistrement a les attributs de ressource suivants.

json
{ "service.name": "kiro-enterprise", "kiro.profile.arn": "arn:aws:codewhisperer:us-east-1:111122223333:profile/EXAMPLEPROFILE", "kiro.profile.id": "EXAMPLEPROFILE", "kiro.account.id": "111122223333" }

L'événement kiro.chat.message pour la requête :

json
{ "kiro.event.name": "kiro.chat.message", "kiro.user.id": "user-0001", "kiro.user.email": "user@example.com", "kiro.message.id": "6b7d77cd-6d6f-49b4-871a-800f5a9860fe", "kiro.conversation.id": "15b089f2-4183-4cff-80e9-58693758f931", "kiro.root_conversation_id": "15b089f2-4183-4cff-80e9-58693758f931", "kiro.client.type": "KIRO_CLI", "kiro.model.name": "auto", "kiro.credits.used": 0.09051340049751244, "kiro.credits.overage": 0.0, "kiro.subscription.tier": "POWER", "kiro.overage.enabled": false, "kiro.overage.cap": 10000.0, "kiro.usage.limit": 10000, "kiro.client.version": "3.1.0", "kiro.tool_call_count": 1, "kiro.tool_calls": "{\"read_file\":1}", "kiro.request.subagent": false, "kiro.answer.cut_off": false, "kiro.response.duration_ms": 2120, "kiro.agent_mode": "VIBE" }

L'événement kiro.tool.call pour l'appel d'outil :

json
{ "kiro.event.name": "kiro.tool.call", "kiro.user.id": "user-0001", "kiro.message.id": "6b7d77cd-6d6f-49b4-871a-800f5a9860fe", "kiro.conversation.id": "15b089f2-4183-4cff-80e9-58693758f931", "kiro.tool.use.id": "toolu_bdrk_01AtD5hruZYFg5eZDP9jostw", "kiro.tool.name": "read_file", "kiro.tool.kind": "BUILTIN", "kiro.tool.agent_mode": "VIBE", "kiro.tool.outcome": "COMPLETED", "kiro.tool.duration_ms": 23, "kiro.client.type": "KIRO_CLI", "kiro.source": "CLIENT" }

Une requête de sous-agent a kiro.request.subagent défini à true. Dans l'exemple, la requête 4cb19c4f a demandé sept outils. Son événement a kiro.tool_call_count défini à 7 et kiro.tool_calls défini à {"read_file":7}. Sept événements kiro.tool.call ont kiro.message.id défini à 4cb19c4f-9493-4ade-ada4-8fa57f1aaf82.

Exemple : un appel d'outil MCP et un Skill

Dans cette conversation Kiro CLI, l'utilisateur envoie deux requêtes. La première requête demande à l'agent d'utiliser l'outil find_city d'un serveur MCP nommé my-mcp-server. La seconde requête demande à l'agent d'utiliser un Skill d'espace de travail nommé word-count.

Requête de l'utilisateurRequête LLMkiro.tool_callsCréditsÉvénements kiro.tool.call
1 (MCP)deb2deec{"tool_load":1}0,054tool_load, BUILTIN, 2 ms
1 (MCP)4939e050{"tool_call":1}0,062mcp_my_mcp_server_find_city, MCP, serveur my-mcp-server, 14 ms
1 (MCP)e6f917b8Aucun0,050Aucun (réponse finale)
2 (Skill)3144bcf6{"disclose_context":1}0,055disclose_context, SKILL, Skill word-count, 12 ms
2 (Skill)d5325d0f{"read_file":1}0,059read_file, BUILTIN, 8 ms
2 (Skill)f028dd4fAucun0,052Aucun (réponse finale)

L'outil MCP n'était pas chargé au début de la conversation. Le modèle appelle d'abord tool_load pour charger l'outil, puis appelle l'outil par tool_call. Le kiro.tool_calls de la requête liste l'appel comme tool_call. L'événement kiro.tool.call a le nom de l'outil MCP dans kiro.tool.name et le nom du serveur dans kiro.mcp.server.

json
{ "kiro.event.name": "kiro.tool.call", "kiro.user.id": "user-0001", "kiro.message.id": "4939e050-c0f9-4920-8bb3-3bbebd00875b", "kiro.conversation.id": "ea84e0db-dfd2-425f-8105-4bedd84f4dc4", "kiro.tool.use.id": "toolu_bdrk_01EuDAFzpJQN4najZSrMqFf8", "kiro.tool.name": "mcp_my_mcp_server_find_city", "kiro.tool.kind": "MCP", "kiro.tool.agent_mode": "VIBE", "kiro.tool.outcome": "COMPLETED", "kiro.tool.duration_ms": 14, "kiro.client.type": "KIRO_CLI", "kiro.source": "CLIENT", "kiro.mcp.server": "my-mcp-server" }

Un chargement de Skill est un appel à l'outil disclose_context. L'événement a kiro.tool.kind défini à SKILL et le nom du Skill dans kiro.skill.name. Un outil que le Skill utilise, comme read_file, est un événement distinct.

json
{ "kiro.event.name": "kiro.tool.call", "kiro.user.id": "user-0001", "kiro.message.id": "3144bcf6-ef4f-416d-8c9b-d142e2a2b194", "kiro.conversation.id": "3ec6bef9-1939-4b41-97f2-3aa436bb0d40", "kiro.tool.use.id": "toolu_bdrk_01KWfxVL4FqU69Q3dNF3Ht2M", "kiro.tool.name": "disclose_context", "kiro.tool.kind": "SKILL", "kiro.tool.agent_mode": "VIBE", "kiro.tool.outcome": "COMPLETED", "kiro.tool.duration_ms": 12, "kiro.client.type": "KIRO_CLI", "kiro.source": "CLIENT", "kiro.skill.name": "word-count" }

Joindre les événements

Chargement de l'image...Chemin de jointure d'un appel d'outil à sa session. Utilisez kiro.message.id pour la requête, kiro.conversation.id pour la conversation et kiro.root_conversation_id pour la session complète.

Pour joindre les événements, procédez comme suit :

  1. Supprimez les doublons. Une nouvelle tentative peut livrer un événement deux fois. Supprimez les événements kiro.chat.message en double par kiro.message.id, et les événements kiro.tool.call en double par kiro.tool.use.id.
  2. Pour joindre un appel d'outil à sa requête LLM, utilisez kiro.message.id. L'événement kiro.tool.call ne contient pas kiro.root_conversation_id ni kiro.user.email. Obtenez-les à partir de la requête.
  3. Pour joindre des événements à une conversation, utilisez kiro.conversation.id. Pour joindre des événements à une session, y compris ses sous-agents, utilisez kiro.root_conversation_id.
  4. Attendez-vous à des événements sans correspondance. Si un utilisateur annule une réponse après l'exécution d'un outil, l'appel d'outil n'a pas d'événement de requête. Une requête peut lister dans kiro.tool_calls un outil qui n'a pas été exécuté.

Questions auxquelles les événements répondent

NiveauQuestionÉvénementComment répondre
UtilisateurCombien de personnes utilisent Kiro, et sur quel client?kiro.chat.messageComptez les kiro.user.id distincts par kiro.client.type.
UtilisateurQuels utilisateurs approchent de leur limite de crédits?kiro.chat.messageAdditionnez kiro.credits.used par kiro.user.id pour le mois, et divisez par kiro.usage.limit. Excluez les valeurs kiro.usage.limit de 999999. Ce sont des utilisateurs d'un bassin partagé sans limite individuelle.
ConversationCombien coûte une session?kiro.chat.messageAdditionnez kiro.credits.used par kiro.root_conversation_id. La somme comprend les sous-agents. Pour obtenir le coût d'une conversation sans ses sous-agents, additionnez par kiro.conversation.id.
ConversationCombien de conversations chaque utilisateur démarre-t-il?kiro.chat.messageComptez les kiro.conversation.id distincts par kiro.user.id, où kiro.request.subagent est false.
Requête LLMQuels modèles les utilisateurs utilisent-ils, et combien coûtent-ils?kiro.chat.messageComptez les événements et additionnez kiro.credits.used par kiro.model.name.
Requête LLMQuel est le temps de réponse p95?kiro.chat.messageCalculez le p95 de kiro.response.duration_ms par kiro.client.type.
Requête LLMCombien de réponses s'arrêtent à la limite de sortie?kiro.chat.messageComptez les événements où kiro.answer.cut_off est true.
Requête LLMCombien de crédits les requêtes qui utilisent un outil dépensent-elles?kiro.chat.messageAdditionnez kiro.credits.used où kiro.tool_calls contient le nom de l'outil, par exemple read_file.
Requête LLMCombien coûtent les sous-agents et les requêtes internes?kiro.chat.messageAdditionnez kiro.credits.used par kiro.request.subagent. La valeur true comprend les sous-agents et les requêtes internes, comme les résumés.
Requête LLMCombien de crédits chaque mode d'agent utilise-t-il?kiro.chat.messageAdditionnez kiro.credits.used par kiro.agent_mode.
Appel d'outilQuels outils sont utilisés, et par combien de personnes?kiro.tool.callComptez les événements et les kiro.user.id distincts par kiro.tool.name.
Appel d'outilQuels outils échouent, et pourquoi?kiro.tool.callComptez les événements où kiro.tool.outcome est ERROR ou FAULT, ou FAILURE pour les clients qui l'envoient, par kiro.tool.name et kiro.error.type.
Appel d'outilQuels outils sont les plus lents?kiro.tool.callCalculez le p95 de kiro.tool.duration_ms par kiro.tool.name.
Appel d'outilQuels serveurs MCP sont utilisés, lents ou en échec?kiro.tool.callCalculez le nombre, le taux d'erreur et la durée p95 par kiro.mcp.server.
Appel d'outilÀ quelle fréquence les utilisateurs refusent-ils ou annulent-ils un outil?kiro.tool.callComptez les événements où kiro.tool.outcome est ABORT, et divisez par tous les événements.
Appel d'outilQuels modes d'agent exécutent des outils?kiro.tool.callComptez les événements par kiro.tool.agent_mode.
Appel d'outilÀ quelle fréquence chaque Skill se charge-t-il?kiro.tool.callComptez les événements où kiro.tool.kind est SKILL, par kiro.skill.name.

Le rapport CSV et les métriques OpenTelemetry répondent aux questions au niveau de l'utilisateur sous forme de nombres et de moyennes. Pour les centiles, les conversations, ou une jointure entre une requête et ses appels d'outils, utilisez les événements en temps réel.

Correspondance entre les événements et les données quotidiennes

Le rapport CSV et les métriques OpenTelemetry totalisent les mêmes données pour chaque utilisateur et chaque jour. Ce tableau indique quelle colonne et quelle métrique chaque attribut d'événement alimente. Pour le type et la présence de chaque attribut, consultez Événements OpenTelemetry en temps réel. Pour les règles des colonnes, consultez Colonnes du rapport.

Attribut d'événementColonne du rapport CSVMétrique ou attribut OpenTelemetry
kiro.user.idUserIdAttribut kiro.user.id
kiro.user.emailUser_EmailAttribut kiro.user.email
kiro.client.typeClient_TypeAttribut kiro.client.type
kiro.client.versionClient_Versionkiro.daily.client_version_seen
kiro.model.name*model_name*_messages et *model_name*_creditskiro.daily.model_messages et kiro.daily.model_credits
kiro.credits.usedCredits_Usedkiro.daily.credits
kiro.credits.overageOverage_Credits_Usedkiro.daily.overage_credits
kiro.tool_calls*tool_name*_tool_callskiro.daily.tool_calls
kiro.tool_call_count supérieur à 0Requests_With_Toolskiro.daily.requests_with_tools
kiro.answer.cut_offAnswers_Cut_Offkiro.daily.answers_cut_off
kiro.response.duration_msAvg_Response_Mskiro.daily.avg_response_ms
kiro.subscription.tierSubscription_TierAttribut kiro.subscription.tier
kiro.usage.limitUsage_LimitAttribut kiro.usage.limit
kiro.overage.enabledOverage_EnabledAttribut kiro.overage.enabled
kiro.overage.capOverage_CapAttribut kiro.overage.cap
kiro.tool.name sur kiro.tool.call*tool_name*_tool_calls_client et *tool_name*_tool_errors_clientkiro.daily.tool_calls_client et kiro.daily.tool_errors_client
kiro.tool.kind*kind*_tool_calls_by_kind_clientkiro.daily.tool_calls_by_kind_client
kiro.tool.outcome*outcome*_tool_calls_by_outcome_clientkiro.daily.tool_calls_by_outcome_client
kiro.tool.duration_ms*tool_name*_tool_duration_ms_avg_client, *kind*_tool_duration_by_kind_ms_avg_client et *server*_mcp_server_duration_ms_avg_clientkiro.daily.tool_duration_ms_avg_client, kiro.daily.tool_duration_by_kind_ms_avg_client et kiro.daily.mcp_server_duration_ms_avg_client
kiro.error.type*errorType*_tool_errors_by_type_clientkiro.daily.tool_errors_by_type_client
kiro.mcp.server*server*_mcp_server_calls_client et *server*_mcp_server_errors_clientkiro.daily.mcp_server_calls_client et kiro.daily.mcp_server_errors_client
kiro.skill.name*skill*_skill_calls_clientkiro.daily.skill_calls_client
kiro.tool.agent_mode*mode*_tool_calls_by_agent_mode_clientkiro.daily.tool_calls_by_agent_mode_client

kiro.message.id, kiro.conversation.id, kiro.root_conversation_id, kiro.request.subagent, kiro.agent_mode, kiro.tool.use.id et kiro.source n'ont pas de colonne quotidienne. Les noms de colonnes CSV utilisent des valeurs de type, de résultat et de mode d'agent en minuscules. Les métriques quotidiennes les conservent en majuscules, comme dans les événements.

Limites

  • Les tours n'ont pas de clé. Aucun attribut n'identifie les requêtes qui proviennent de la même requête de l'utilisateur. Pour estimer les tours, ordonnez les requêtes d'une conversation par heure. Démarrez un nouveau tour après chaque requête qui n'a pas de kiro.tool_calls.
  • Les sous-agents démarrent une nouvelle conversation. Les requêtes d'un sous-agent ont leur propre kiro.conversation.id. Pour les lier à la session parente, utilisez kiro.root_conversation_id. Les requêtes sans kiro.root_conversation_id, comme les requêtes de Kiro CLI sur le moteur d'agent V2, ne peuvent pas être liées à leur parent.
  • kiro.tool_calls et kiro.tool.call comptent des choses différentes. kiro.tool_calls compte les outils que le modèle a demandés. kiro.tool.call compte les outils que le client a exécutés. Le rapport CSV a une colonne pour chacun : *tool_name*_tool_calls et *tool_name*_tool_calls_client.
  • Les crédits sont rapportés pour chaque requête, pas pour chaque appel d'outil. Pour trouver les crédits d'un outil, utilisez les requêtes dont le kiro.tool_calls contient cet outil.

Pour les versions du client qui envoient chaque attribut, consultez Versions des clients.

Page mise à jour : 16 novembre 2026