Passer au contenu principal
Afficher en Markdown

Exporter des rapports CSV vers Amazon S3

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

Préparer le compartiment S3

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.

json
{ "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.

Activer le rapport CSV

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.

Colonnes du rapport

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.

ColonneDescription
DateDate de l'activité
UserIdL'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_TypeKIRO_IDE, KIRO_CLI, KIRO_WEB, KIRO_CREW ou PLUGIN. D'autres valeurs peuvent apparaître à mesure que Kiro ajoute des clients
Chat_ConversationsNombre de conversations que l'utilisateur a eues ce jour-là
Credits_UsedCrédits utilisés à partir du plan d'abonnement de l'utilisateur
Overage_CapLa 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_UsedCrédits de dépassement utilisés, lorsque le dépassement est activé
Overage_EnabledIndique si le dépassement est activé pour l'utilisateur : true ou false
ProfileIdL'ARN du profil Kiro de l'activité
Subscription_TierPRO, PRO_PLUS, PRO_MAX, POWER ou POOLING
Total_MessagesMessages 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_UserIndique si l'utilisateur a activé son abonnement ce jour-là
User_EmailL'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_LimitLa limite de crédits de l'utilisateur. 999999 pour un utilisateur d'un bassin partagé sans limite individuelle
*model_name*_messagesMessages traités par le modèle pour l'utilisateur, y compris Auto
*model_name*_creditsCré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_callsNombre de fois où le modèle a demandé l'outil pour l'utilisateur
Colonnes *_clientAppels 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_VersionVersions 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_ToolsRequêtes dans lesquelles l'agent a appelé au moins un outil
Answers_Cut_OffRéponses interrompues parce que la réponse a atteint la limite de longueur de sortie du modèle
Avg_Response_MsTemps 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

Colonnes dynamiques

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-5 devient claude_sonnet_4_5_messages et claude_sonnet_4_5_credits.
  • Kiro utilise les noms d'outils tels quels.
  • Une colonne contient 0 lorsque 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*_messages et de Total_Messages.

Colonnes d'outils mesurées par le client

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.

ColonneDescription
*tool_name*_tool_calls_clientAppels d'outils que le client a exécutés, pour chaque outil
*tool_name*_tool_errors_clientErreurs d'appels d'outils, pour chaque outil
*tool_name*_tool_duration_ms_avg_clientDurée moyenne des appels d'outils en millisecondes, pour chaque outil
*kind*_tool_calls_by_kind_clientAppels d'outils pour chaque type d'outil, comme builtin, mcp ou skill
*kind*_tool_duration_by_kind_ms_avg_clientDurée moyenne des appels d'outils en millisecondes, pour chaque type d'outil
*outcome*_tool_calls_by_outcome_clientAppels d'outils pour chaque résultat, comme completed ou abort
*errorType*_tool_errors_by_type_clientErreurs d'appels d'outils pour chaque type d'erreur
*server*_mcp_server_calls_clientAppels d'outils pour chaque serveur MCP
*server*_mcp_server_errors_clientErreurs d'appels d'outils pour chaque serveur MCP
*server*_mcp_server_duration_ms_avg_clientDurée moyenne des appels d'outils en millisecondes, pour chaque serveur MCP
*skill*_skill_calls_clientChargements de Skill pour chaque Skill
*mode*_tool_calls_by_agent_mode_clientAppels 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 UNKNOWN n'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.

Rapport hérité

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é.

Page mise à jour : 16 novembre 2026