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.
Dans l'activité d'un utilisateur, les événements s'imbriquent sur quatre niveaux :
- Une conversation est une session de clavardage.
- Un tour est une requête de l'utilisateur et tout le travail qu'elle démarre.
- Une requête LLM est un appel au modèle. Kiro envoie un événement
kiro.chat.messagepour chaque requête. - Un appel d'outil est un outil que l'agent exécute. Kiro envoie un événement
kiro.tool.callpour chaque appel d'outil.
| Niveau | Description | Événement | Clé | Comment compter |
|---|---|---|---|---|
| Profil | Votre profil Kiro | Attribut de ressource de chaque événement | kiro.profile.arn | Un pour chaque destination d'exportation |
| Utilisateur | Une personne | Les deux événements | kiro.user.id | kiro.user.id distincts |
| Conversation | Une session de clavardage | Les deux événements | kiro.conversation.id; kiro.root_conversation_id pour la session, y compris les sous-agents | kiro.conversation.id distincts. Pour les sessions, kiro.root_conversation_id distincts |
| Tour | Une requête de l'utilisateur et les requêtes LLM et appels d'outils qu'elle démarre | Aucun | Aucune | Non disponible. Pour en savoir plus, consultez Limites. |
| Requête LLM | Un appel au modèle | kiro.chat.message | kiro.message.id | Nombre d'événements kiro.chat.message |
| Appel d'outil | Un outil que l'agent a exécuté | kiro.tool.call | kiro.tool.use.id | Nombre d'événements kiro.tool.call |
| Utilisateur-jour | Un utilisateur un jour donné | Ligne du rapport CSV et métriques kiro.daily.* | Utilisateur et date | Une 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.
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...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, additionnezkiro.credits.usedparkiro.root_conversation_id. - La durée de l'appel d'outil
invoke_sub_agent, 18 712 ms, comprend tout le travail du sous-agent.
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.
{ "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 :
{ "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 :
{ "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.
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'utilisateur | Requête LLM | kiro.tool_calls | Crédits | Événements kiro.tool.call |
|---|---|---|---|---|
| 1 (MCP) | deb2deec | {"tool_load":1} | 0,054 | tool_load, BUILTIN, 2 ms |
| 1 (MCP) | 4939e050 | {"tool_call":1} | 0,062 | mcp_my_mcp_server_find_city, MCP, serveur my-mcp-server, 14 ms |
| 1 (MCP) | e6f917b8 | Aucun | 0,050 | Aucun (réponse finale) |
| 2 (Skill) | 3144bcf6 | {"disclose_context":1} | 0,055 | disclose_context, SKILL, Skill word-count, 12 ms |
| 2 (Skill) | d5325d0f | {"read_file":1} | 0,059 | read_file, BUILTIN, 8 ms |
| 2 (Skill) | f028dd4f | Aucun | 0,052 | Aucun (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.
{ "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.
{ "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" }
Pour joindre les événements, procédez comme suit :
- Supprimez les doublons. Une nouvelle tentative peut livrer un événement deux fois. Supprimez les événements
kiro.chat.messageen double parkiro.message.id, et les événementskiro.tool.callen double parkiro.tool.use.id. - Pour joindre un appel d'outil à sa requête LLM, utilisez
kiro.message.id. L'événementkiro.tool.callne contient paskiro.root_conversation_idnikiro.user.email. Obtenez-les à partir de la requête. - Pour joindre des événements à une conversation, utilisez
kiro.conversation.id. Pour joindre des événements à une session, y compris ses sous-agents, utilisezkiro.root_conversation_id. - 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_callsun outil qui n'a pas été exécuté.
| Niveau | Question | Événement | Comment répondre |
|---|---|---|---|
| Utilisateur | Combien de personnes utilisent Kiro, et sur quel client? | kiro.chat.message | Comptez les kiro.user.id distincts par kiro.client.type. |
| Utilisateur | Quels utilisateurs approchent de leur limite de crédits? | kiro.chat.message | Additionnez 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. |
| Conversation | Combien coûte une session? | kiro.chat.message | Additionnez 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. |
| Conversation | Combien de conversations chaque utilisateur démarre-t-il? | kiro.chat.message | Comptez les kiro.conversation.id distincts par kiro.user.id, où kiro.request.subagent est false. |
| Requête LLM | Quels modèles les utilisateurs utilisent-ils, et combien coûtent-ils? | kiro.chat.message | Comptez les événements et additionnez kiro.credits.used par kiro.model.name. |
| Requête LLM | Quel est le temps de réponse p95? | kiro.chat.message | Calculez le p95 de kiro.response.duration_ms par kiro.client.type. |
| Requête LLM | Combien de réponses s'arrêtent à la limite de sortie? | kiro.chat.message | Comptez les événements où kiro.answer.cut_off est true. |
| Requête LLM | Combien de crédits les requêtes qui utilisent un outil dépensent-elles? | kiro.chat.message | Additionnez kiro.credits.used où kiro.tool_calls contient le nom de l'outil, par exemple read_file. |
| Requête LLM | Combien coûtent les sous-agents et les requêtes internes? | kiro.chat.message | Additionnez 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 LLM | Combien de crédits chaque mode d'agent utilise-t-il? | kiro.chat.message | Additionnez kiro.credits.used par kiro.agent_mode. |
| Appel d'outil | Quels outils sont utilisés, et par combien de personnes? | kiro.tool.call | Comptez les événements et les kiro.user.id distincts par kiro.tool.name. |
| Appel d'outil | Quels outils échouent, et pourquoi? | kiro.tool.call | Comptez 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'outil | Quels outils sont les plus lents? | kiro.tool.call | Calculez le p95 de kiro.tool.duration_ms par kiro.tool.name. |
| Appel d'outil | Quels serveurs MCP sont utilisés, lents ou en échec? | kiro.tool.call | Calculez 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.call | Comptez les événements où kiro.tool.outcome est ABORT, et divisez par tous les événements. |
| Appel d'outil | Quels modes d'agent exécutent des outils? | kiro.tool.call | Comptez les événements par kiro.tool.agent_mode. |
| Appel d'outil | À quelle fréquence chaque Skill se charge-t-il? | kiro.tool.call | Comptez 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.
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énement | Colonne du rapport CSV | Métrique ou attribut OpenTelemetry |
|---|---|---|
kiro.user.id | UserId | Attribut kiro.user.id |
kiro.user.email | User_Email | Attribut kiro.user.email |
kiro.client.type | Client_Type | Attribut kiro.client.type |
kiro.client.version | Client_Version | kiro.daily.client_version_seen |
kiro.model.name | *model_name*_messages et *model_name*_credits | kiro.daily.model_messages et kiro.daily.model_credits |
kiro.credits.used | Credits_Used | kiro.daily.credits |
kiro.credits.overage | Overage_Credits_Used | kiro.daily.overage_credits |
kiro.tool_calls | *tool_name*_tool_calls | kiro.daily.tool_calls |
kiro.tool_call_count supérieur à 0 | Requests_With_Tools | kiro.daily.requests_with_tools |
kiro.answer.cut_off | Answers_Cut_Off | kiro.daily.answers_cut_off |
kiro.response.duration_ms | Avg_Response_Ms | kiro.daily.avg_response_ms |
kiro.subscription.tier | Subscription_Tier | Attribut kiro.subscription.tier |
kiro.usage.limit | Usage_Limit | Attribut kiro.usage.limit |
kiro.overage.enabled | Overage_Enabled | Attribut kiro.overage.enabled |
kiro.overage.cap | Overage_Cap | Attribut kiro.overage.cap |
kiro.tool.name sur kiro.tool.call | *tool_name*_tool_calls_client et *tool_name*_tool_errors_client | kiro.daily.tool_calls_client et kiro.daily.tool_errors_client |
kiro.tool.kind | *kind*_tool_calls_by_kind_client | kiro.daily.tool_calls_by_kind_client |
kiro.tool.outcome | *outcome*_tool_calls_by_outcome_client | kiro.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_client | kiro.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_client | kiro.daily.tool_errors_by_type_client |
kiro.mcp.server | *server*_mcp_server_calls_client et *server*_mcp_server_errors_client | kiro.daily.mcp_server_calls_client et kiro.daily.mcp_server_errors_client |
kiro.skill.name | *skill*_skill_calls_client | kiro.daily.skill_calls_client |
kiro.tool.agent_mode | *mode*_tool_calls_by_agent_mode_client | kiro.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.
- 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, utilisezkiro.root_conversation_id. Les requêtes sanskiro.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_callsetkiro.tool.callcomptent des choses différentes.kiro.tool_callscompte les outils que le modèle a demandés.kiro.tool.callcompte les outils que le client a exécutés. Le rapport CSV a une colonne pour chacun :*tool_name*_tool_callset*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_callscontient cet outil.
Pour les versions du client qui envoient chaque attribut, consultez Versions des clients.
Comprendre les événements en temps réel