Chaque jour à 02:00 UTC, Kiro écrit un rapport CSV de l'activité de la veille dans un compartiment Amazon S3 de votre compte. Kiro écrit un fichier pour chaque type de client Kiro, comme IDE et CLI. Chaque ligne décrit un utilisateur pour cette journée.
s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/user_report/region/year/month/day/00/clientType_accountId_user_report_timestamp.csv
Créez un compartiment Amazon S3 pour les rapports. Le compartiment doit respecter ces exigences :
- Il se trouve dans la Région AWS de votre profil Kiro. Pour en savoir plus, consultez Profil Kiro et Régions prises en charge.
- Il se trouve dans le compte AWS où vos utilisateurs sont abonnés. Si des utilisateurs sont abonnés dans plus d'un compte, créez un compartiment dans chaque compte. Kiro ne prend pas en charge les compartiments entre comptes.
- Il a un préfixe, aussi appelé dossier. Kiro ne peut pas écrire à la racine d'un compartiment.
- (Recommandé) Il s'agit d'un compartiment différent de celui de la journalisation des requêtes.
Ajoutez cette politique de compartiment. Remplacez bucketName, prefix, region et accountId par vos valeurs. Les valeurs region et accountId du bloc Condition doivent être la Région de votre profil Kiro et le compte où les utilisateurs sont abonnés. Pour trouver l'ID de compte, consultez Trouver votre ID de compte AWS.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "KiroLogsWrite", "Effect": "Allow", "Principal": { "Service": "q.amazonaws.com" }, "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::bucketName/prefix/*" ], "Condition": { "StringEquals": { "aws:SourceAccount": "accountId" }, "ArnLike": { "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*" } } } ] }
Pour protéger les données du compartiment, consultez Protecting data with encryption dans le Amazon Simple Storage Service User Guide.
Activez le rapport dans la console Kiro. Pour les étapes, consultez Activer le rapport CSV.
Kiro écrit le premier rapport au prochain 02:00 UTC suivant l'activation. Ensuite, Kiro écrit un nouveau rapport chaque jour.
Pour confirmer le premier rapport, listez s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/user_report/ après 02:00 UTC. Attendez-vous à un fichier pour chaque type de client que les utilisateurs ont utilisé la veille. Si aucun fichier n'arrive, consultez Dépannage.
Vous pouvez interroger les rapports avec Amazon Athena, construire des tableaux de bord dans Amazon QuickSight ou les charger dans votre propre pipeline d'analyse.
Chaque rapport comporte des colonnes statiques, puis des colonnes dynamiques pour chaque modèle et chaque outil, puis des colonnes d'outils mesurées par le client, et enfin quatre colonnes au niveau des requêtes. Les colonnes dynamiques dépendent des modèles et des outils que les utilisateurs ont utilisés ce jour-là, de sorte que la position d'une colonne ultérieure peut changer d'un jour à l'autre. Lisez les colonnes par le nom de leur en-tête, pas par leur position.
| Colonne | Description |
|---|---|
Date | Date de l'activité |
UserId | 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 |
Client_Type | KIRO_IDE, KIRO_CLI, KIRO_WEB, KIRO_CREW ou PLUGIN. D'autres valeurs peuvent apparaître à mesure que Kiro ajoute des clients |
Chat_Conversations | Nombre de conversations que l'utilisateur a eues ce jour-là |
Credits_Used | Crédits utilisés à partir du plan d'abonnement de l'utilisateur |
Overage_Cap | La limite de dépassement fixée par l'administrateur, lorsque Overage_Enabled est vrai. Sinon, les crédits compris dans le plan d'abonnement |
Overage_Credits_Used | Crédits de dépassement utilisés, lorsque le dépassement est activé |
Overage_Enabled | Indique si le dépassement est activé pour l'utilisateur : true ou false |
ProfileId | L'ARN du profil Kiro de l'activité |
Subscription_Tier | PRO, PRO_PLUS, PRO_MAX, POWER ou POOLING |
Total_Messages | Messages envoyés à Kiro et provenant de Kiro, y compris les requêtes de l'utilisateur, les appels d'outils et les réponses de Kiro |
New_User | Indique si l'utilisateur a activé son abonnement ce jour-là |
User_Email | 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 |
Usage_Limit | La limite de crédits de l'utilisateur. 999999 pour un utilisateur d'un bassin partagé sans limite individuelle |
*model_name*_messages | Messages traités par le modèle pour l'utilisateur, y compris Auto |
*model_name*_credits | Crédits utilisés par le modèle pour l'utilisateur. Les crédits que Kiro ne peut pas attribuer à un modèle se trouvent dans unallocated_credits |
*tool_name*_tool_calls | Nombre de fois où le modèle a demandé l'outil pour l'utilisateur |
Colonnes *_client | Appels d'outils que le client Kiro a exécutés, avec leurs résultats et leurs durées. Consultez Colonnes d'outils mesurées par le client |
Client_Version | Versions du client Kiro à partir desquelles l'utilisateur a envoyé des requêtes, séparées par ;. Vide lorsque Kiro n'a enregistré aucune version |
Requests_With_Tools | Requêtes dans lesquelles l'agent a appelé au moins un outil |
Answers_Cut_Off | Réponses interrompues parce que la réponse a atteint la limite de longueur de sortie du modèle |
Avg_Response_Ms | Temps de réponse moyen en millisecondes, depuis la réception de la requête par Kiro jusqu'à la fin de la réponse. 0 lorsque l'utilisateur n'a eu aucune requête chronométrée |
Le nombre de colonnes *model_name*_messages, *model_name*_credits et *tool_name*_tool_calls dépend des modèles et des outils qu'un utilisateur quelconque a utilisés ce jour-là.
- Kiro trie chaque famille de colonnes par nom.
- Dans les colonnes de modèles, les traits d'union deviennent des traits de soulignement. Par exemple,
claude-sonnet-4-5devientclaude_sonnet_4_5_messagesetclaude_sonnet_4_5_credits. - Kiro utilise les noms d'outils tels quels.
- Une colonne contient
0lorsque l'utilisateur n'a pas utilisé ce modèle ou cet outil ce jour-là. - Les modèles internes que Kiro utilise pour son propre traitement sont exclus des colonnes
*model_name*_messageset deTotal_Messages.
Les colonnes *tool_name*_tool_calls comptent les outils que le modèle a demandés. Les colonnes qui se terminent par _client comptent les appels d'outils que le client Kiro a exécutés et signalés. Le client n'envoie ces données qu'à partir des versions prises en charge. Consultez Versions des clients.
| Colonne | Description |
|---|---|
*tool_name*_tool_calls_client | Appels d'outils que le client a exécutés, pour chaque outil |
*tool_name*_tool_errors_client | Erreurs d'appels d'outils, pour chaque outil |
*tool_name*_tool_duration_ms_avg_client | Durée moyenne des appels d'outils en millisecondes, pour chaque outil |
*kind*_tool_calls_by_kind_client | Appels d'outils pour chaque type d'outil, comme builtin, mcp ou skill |
*kind*_tool_duration_by_kind_ms_avg_client | Durée moyenne des appels d'outils en millisecondes, pour chaque type d'outil |
*outcome*_tool_calls_by_outcome_client | Appels d'outils pour chaque résultat, comme completed ou abort |
*errorType*_tool_errors_by_type_client | Erreurs d'appels d'outils pour chaque type d'erreur |
*server*_mcp_server_calls_client | Appels d'outils pour chaque serveur MCP |
*server*_mcp_server_errors_client | Erreurs d'appels d'outils pour chaque serveur MCP |
*server*_mcp_server_duration_ms_avg_client | Durée moyenne des appels d'outils en millisecondes, pour chaque serveur MCP |
*skill*_skill_calls_client | Chargements de Skill pour chaque Skill |
*mode*_tool_calls_by_agent_mode_client | Appels d'outils pour chaque mode d'agent, comme vibe ou spec |
Chaque valeur du paramètre fictif qui survient ce jour-là obtient sa propre colonne. Ces règles s'appliquent :
- Les valeurs de type, de résultat et de mode d'agent sont en minuscules. Les noms d'outils et de serveurs MCP conservent leur casse.
- Un appel d'outil dont le résultat est
UNKNOWNn'est pas compté. - Un mode d'agent que Kiro ne reconnaît pas est compté comme
unknown. - Un appel d'outil échoué sans type d'erreur est compté comme
unknown.
Pour l'attribut d'événement en temps réel derrière chaque colonne, consultez Correspondance entre les événements et les données quotidiennes.
Kiro écrit aussi un rapport d'activité des utilisateurs hérité dans le même compartiment, dans le chemin by_user_analytic. Pour son emplacement et ses métriques, consultez Rapport d'activité des utilisateurs hérité.
Exporter des rapports CSV vers Amazon S3