Vous pouvez exporter quotidiennement la télémétrie d'activité par utilisateur pour les abonnés à Kiro de votre organisation. Utilisez ces exportations pour auditer l'utilisation, optimiser l'attribution des licences, suivre la consommation de crédits et de crédits de dépassement, et comprendre comment chaque utilisateur interagit avec Kiro dans les différents clients.
Kiro propose deux formats d'exportation indépendants. Vous pouvez activer l'un ou l'autre, ou les deux :
| Format | Choisissez-le lorsque |
|---|---|
| CSV dans Amazon S3 | Vous souhaitez obtenir des fichiers quotidiens pour les requêtes, les tableaux de bord ou un pipeline d'analyse existant. |
| OpenTelemetry | Vous souhaitez que Kiro transmette quotidiennement des métriques agrégées à votre collecteur compatible avec OpenTelemetry. |
Les deux formats contiennent les mêmes métriques agrégées d'utilisation quotidienne. L'exportation OpenTelemetry transforme ces métriques au format OTLP.
Chaque jour à 2 h UTC, Kiro génère un rapport CSV par type de client Kiro (IDE, CLI et module d'extension) et l'écrit dans votre compartiment S3.
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 contenir le fichier CSV du rapport d'activité des utilisateurs. Le compartiment doit :
Se trouver dans la Région AWS où le profil Kiro a été installé. Ce profil a été installé lorsque vous avez abonné pour la première fois des utilisateurs de la main-d'œuvre d'IAM Identity Center à Kiro Pro. Pour en savoir plus sur ce profil et les Régions où il est pris en charge, consultez Profil Kiro et Régions prises en charge.
Se trouver dans le compte AWS où les utilisateurs sont abonnés. Si des utilisateurs sont abonnés dans plusieurs comptes AWS, vous devez créer des compartiments dans chacun de ces comptes. Les compartiments entre comptes ne sont pas pris en charge.
(Facultatif, mais recommandé) Être différent du compartiment que vous utilisez peut-être pour la journalisation des requêtes des utilisateurs.
Inclure un préfixe, aussi appelé sous-dossier, où Kiro enregistrera le fichier CSV. Le fichier CSV ne peut pas être enregistré à la racine du compartiment.
Avoir une politique de compartiment comme celle qui suit. Remplacez bucketName, prefix, region et accountId par vos propres renseignements. Les valeurs region et accountId dans le bloc Condition de la politique doivent correspondre à la Région où votre profil Kiro a été installé et au compte AWS où les utilisateurs sont abonnés.
{ "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 en savoir plus sur la protection des données dans votre compartiment Amazon S3, consultez Protection des données par chiffrement dans le Guide de l'utilisateur d'Amazon Simple Storage Service.
Connectez-vous à la console AWS.
Passez à la console Kiro. Pour utiliser la console Kiro, vous devez disposer des autorisations définies dans Politique : Autoriser les administrateurs à configurer Kiro et à abonner des utilisateurs.
Choisissez Paramètres.
Sous Rapports d'activité des utilisateurs de Kiro, choisissez Modifier.
Activez Recueillir des métriques granulaires par utilisateur.
Sous Emplacement S3, entrez l'URI Amazon S3 que vous utiliserez pour contenir les rapports CSV. Exemple : s3://amzn-s3-demo-bucket/user-activity-reports/
Le premier rapport CSV est généré lors du prochain cycle de 2 h UTC suivant l'activation des rapports, puis de nouveaux fichiers sont écrits chaque jour. Une fois les rapports dans votre compartiment, vous pouvez les interroger avec Amazon Athena, visualiser les tendances dans Amazon QuickSight ou les intégrer à votre pipeline d'analyse existant.
Pour obtenir une vue d'ensemble de l'utilisation de Kiro sans détails par utilisateur, consultez Affichage de l'utilisation de Kiro sur le tableau de bord. Pour capturer également le contenu des requêtes des utilisateurs, consultez Journalisation des requêtes.
Chaque fichier CSV contient des colonnes statiques et des colonnes dynamiques de messages par modèle.
| Nom de la métrique | Description |
|---|---|
| Date | Date de l’activité indiquée dans le rapport |
| UserId | ID de l'utilisateur dont l'activité est rapportée |
| Client_Type | KIRO_IDE, KIRO_CLI ou PLUGIN |
| Chat_Conversations | Nombre de conversations de l'utilisateur au cours de la journée |
| Credits_Used | Crédits du forfait d’abonnement de l’utilisateur consommés au cours de la journée |
| Overage_Cap | Limite de dépassement définie par l'administrateur lorsque Overage_Enabled est true. Si le dépassement n'est pas activé, ce champ affiche comme valeur prédéfinie le nombre maximal de crédits inclus dans le forfait d'abonnement |
| Overage_Credits_Used | Nombre total de crédits de dépassement utilisés par l'utilisateur, si le dépassement est activé |
| Overage_Enabled | Indique si le dépassement est activé pour cet utilisateur |
| ProfileId | Profil associé à l'activité de l'utilisateur |
| Subscription_Tier | Forfait d'abonnement Kiro : Pro, ProPlus, ProMax ou Power |
| Total_Messages | Nombre de messages envoyés à Kiro et reçus de Kiro, y compris les requêtes des utilisateurs, les appels d'outils et les réponses de Kiro |
| New_User | Indique si l'utilisateur a activé son abonnement Kiro à la date du rapport |
| User_Email | Adresse courriel de l'utilisateur |
| model_name_messages | Nombre de messages traités par un modèle pour un utilisateur, y compris Auto |
Le nombre de colonnes *model_name*_messages dépend des modèles utilisés à la date du rapport. Ces colonnes utilisent les noms de modèles en minuscules, en ordre alphabétique, en commençant par Auto. Une colonne contient 0 lorsqu'un utilisateur n'a pas utilisé ce modèle pendant la journée du rapport.
Le rapport d'activité des utilisateurs hérité continue de s'exécuter parallèlement au rapport par client et contient l'utilisation de l'interface CLI et du module d'extension. Ses fichiers CSV quotidiens sont publiés dans le même compartiment S3, au chemin suivant :
s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/by_user_analytic/Region/year/month/day/00/accountId_by_user_analytic_timestamp.csv
Le segment 00 est une partition horaire fixe pour le cycle d’écriture de 2 h UTC. Dans chaque fichier :
part_1, part_2, et ainsi de suite.Le tableau suivant décrit les métriques héritées incluses dans les rapports d'activité des utilisateurs générés par Kiro.
| Nom de la métrique | Description |
|---|---|
| Chat_AICodeLines | Lignes de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique inclut le code généré dans le clavardage Kiro (et non dans le clavardage intégré) et inséré dans l'IDE. |
| Chat_MessagesInteracted | Nombre de messages de clavardage ayant donné lieu à une interaction positive de l’utilisateur avec Kiro. Exemples d'interactions positives : cliquer sur un lien, insérer une suggestion et voter en faveur d'une réponse de Kiro. Cette métrique inclut les messages générés par le clavardage Kiro (et non par le clavardage intégré). |
| Chat_MessagesSent | Nombre de messages envoyés à Kiro et reçus de Kiro. Cette métrique inclut les requêtes des utilisateurs et les réponses de Kiro dans le clavardage Kiro (et non dans le clavardage intégré). |
| CodeFix_AcceptanceEventCount | Nombre de corrections de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux corrections de code générées par la fonctionnalité de révision de code. |
| CodeFix_AcceptedLines | Lignes de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux lignes de code générées par la fonctionnalité de révision de code. |
| CodeFix_GeneratedLines | Lignes de code suggérées par Kiro. Cette métrique s'applique aux lignes de code générées par la fonctionnalité de révision de code. |
| CodeFix_GenerationEventCount | Nombre de corrections de code suggérées par Kiro. Cette métrique s'applique aux corrections de code générées par la fonctionnalité de révision de code. |
| CodeReview_FailedEventCount | Nombre de problèmes de code qui ont été détectés, mais pour lesquels Kiro n'a pas pu suggérer de correction. Cette métrique s'applique aux problèmes de code générés à l'aide de la fonctionnalité de révision de code. |
| CodeReview_FindingsCount | Nombre de problèmes de code détectés par Kiro. Cette métrique s'applique aux problèmes de code détectés à l'aide de la fonctionnalité de révision de code. |
| CodeReview_SucceededEventCount | Nombre de problèmes de code qui ont été détectés et pour lesquels Kiro a pu générer une suggestion de correction. Cette métrique s'applique aux problèmes de code détectés à l'aide de la fonctionnalité de révision de code. |
| Dev_AcceptanceEventCount | Nombre de fonctionnalités de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux fonctionnalités de code générées par la commande /dev. |
| Dev_AcceptedLines | Lignes de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux lignes de code générées par la commande /dev. |
| Dev_GeneratedLines | Lignes de code suggérées par Kiro. Cette métrique s'applique aux lignes de code générées par la commande /dev. |
| Dev_GenerationEventCount | Nombre de fonctionnalités de code suggérées par Kiro. Cette métrique s'applique aux fonctionnalités de code générées par la commande /dev. |
| DocGeneration_AcceptedFileUpdates | Nombre de mises à jour de fichiers suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux mises à jour de fichiers générées par la commande /doc. |
| DocGeneration_AcceptedFilesCreations | Nombre de créations de fichiers suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux créations de fichiers générées par la commande /doc. |
| DocGeneration_AcceptedLineAdditions | Lignes d'ajouts à la documentation suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique à la documentation générée par la commande /doc. |
| DocGeneration_AcceptedLineUpdates | Lignes de mises à jour de la documentation suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique à la documentation générée à l'aide de la commande /doc. |
| DocGeneration_EventCount | Nombre de fois où l'utilisateur a interagi avec Kiro à l'aide de la commande /doc. |
| DocGeneration_RejectedFileCreations | Nombre de créations de fichiers suggérées par Kiro et rejetées par l'utilisateur. Cette métrique s'applique aux créations de fichiers générées par la commande /doc. |
| DocGeneration_RejectedFileUpdates | Nombre de mises à jour de fichiers suggérées par Kiro et rejetées par l'utilisateur. Cette métrique s'applique aux mises à jour de fichiers générées par la commande /doc. |
| DocGeneration_RejectedLineAdditions | Lignes d'ajouts à la documentation suggérées par Kiro et rejetées par l'utilisateur. Cette métrique s'applique à la documentation générée par la commande /doc. |
| DocGeneration_RejectedLineUpdates | Lignes de mises à jour de la documentation suggérées par Kiro et rejetées par l'utilisateur. Cette métrique s'applique à la documentation générée à l'aide de la commande /doc. |
| InlineChat_AcceptedLineAdditions | Lignes d'ajouts de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique inclut les ajouts de code générés dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_AcceptedLineDeletions | Lignes de suppressions de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique inclut les suppressions de code suggérées dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_AcceptanceEventCount | Nombre de suggestions du clavardage intégré (et non du clavardage Kiro) qui ont été acceptées par l'utilisateur. |
| InlineChat_DismissalEventCount | Nombre de suggestions du clavardage intégré (et non du clavardage Kiro) qui ont été abandonnées par l'utilisateur. Par « abandonnée », on entend que la suggestion de code a été affichée, mais que l'utilisateur a continué à saisir du texte ou à effectuer d'autres opérations dans son IDE, sans accepter ni rejeter explicitement la suggestion de code. |
| InlineChat_DismissedLineAdditions | Lignes d'ajouts de code suggérées par Kiro et abandonnées par l'utilisateur. Par « abandonnée », on entend que la suggestion de code a été affichée, mais que l'utilisateur a continué à saisir du texte ou à effectuer d'autres opérations dans son IDE, sans accepter ni rejeter explicitement la suggestion de code. Cette métrique inclut les ajouts de code générés dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_DismissedLineDeletions | Lignes de suppressions de code suggérées par Kiro et abandonnées par l'utilisateur. Par « abandonnée », on entend que la suggestion de code a été affichée, mais que l'utilisateur a continué à saisir du texte ou à effectuer d'autres opérations dans son IDE, sans accepter ni rejeter explicitement la suggestion de code. Cette métrique inclut les suppressions de code suggérées dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_EventCount | Nombre de sessions de clavardage intégré (et non de clavardage Kiro) auxquelles l'utilisateur a participé. |
| InlineChat_RejectedLineAdditions | Lignes d'ajouts de code suggérées par Kiro et rejetées par l'utilisateur. Cette métrique inclut les ajouts de code générés dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_RejectedLineDeletions | Lignes de suppressions de code suggérées par Kiro et rejetées par l'utilisateur. Cette métrique inclut les suppressions de code générées dans le clavardage intégré (et non dans le clavardage Kiro). |
| InlineChat_RejectionEventCount | Nombre de suggestions du clavardage intégré (et non du clavardage Kiro) qui ont été rejetées par l'utilisateur. |
| Inline_AICodeLines | Lignes de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique inclut le code accepté sous forme de suggestions intégrées. |
| Inline_AcceptanceCount | Nombre de suggestions intégrées acceptées par l'utilisateur. |
| Inline_SuggestionsCount | Nombre de suggestions intégrées affichées à l'utilisateur. |
| TestGeneration_AcceptedLines | Lignes de code suggérées par Kiro et acceptées par l'utilisateur. Cette métrique s'applique aux lignes de code générées par la commande /test. |
| TestGeneration_AcceptedTests | Nombre de tests unitaires suggérés par Kiro et acceptés par l'utilisateur. Cette métrique s'applique aux tests unitaires générés par la commande /test. |
| TestGeneration_EventCount | Nombre de fois où l'utilisateur a interagi avec Kiro par la commande /test. |
| TestGeneration_GeneratedLines | Lignes de code suggérées par Kiro. Cette métrique s'applique aux lignes de code générées par la commande /test. |
| TestGeneration_GeneratedTests | Nombre de tests unitaires suggérés par Kiro. Cette métrique s'applique aux tests unitaires générés par la commande /test. |
| Transformation_EventCount | Nombre de fois où l'utilisateur a interagi avec Kiro par la commande /transform, à l'exclusion des fois où l'utilisateur a transformé du code en ligne de commande. |
| Transformation_LinesGenerated | Lignes de code suggérées par Kiro. Cette métrique s'applique au code généré par la commande /transform, à l'exclusion du code transformé en ligne de commande. |
| Transformation_LinesIngested | Lignes de code fournies à Kiro aux fins de transformation. Cette métrique s'applique au code fourni par la commande /transform, à l'exclusion du code fourni aux fins de transformation en ligne de commande ou de conversion SQL. |
Affichage de l'activité par utilisateur