Affichage de l'activité par utilisateur

Vous pouvez configurer Kiro pour qu'il recueille la télémétrie d'activité par utilisateur pour les abonnés Kiro de votre organisation et qu'il la fournisse sous forme de rapport CSV quotidien. Utilisez ce rapport pour vérifier l'utilisation, optimiser l'attribution des licences, suivre la consommation de crédits et de dépassements, et comprendre comment les utilisateurs individuels interagissent avec Kiro à travers les clients.

Chaque jour à 2 h 00 (02:00) Temps universel coordonné (UTC), Kiro génère un rapport CSV par type de client Kiro (IDE, CLI et Plugin) 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 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 alors 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 semblable à 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 Amazon Simple Storage Service User Guide.

1. Connectez-vous à la console AWS.

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

3. Choisissez Settings.

4. Sous Kiro user activity reports, choisissez Edit.

5. Activez Collect granular metrics per user.

6. Sous S3 location, 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é au prochain passage à 2 h 00 UTC après l'activation des rapports, puis de nouveaux fichiers sont écrits chaque jour par la suite. Une fois les rapports dans votre compartiment, vous pouvez les interroger avec Amazon Athena, visualiser les tendances dans Amazon QuickSight, ou les intégrer dans votre pipeline analytique existant.

Pour une vue d'ensemble de l'utilisation de Kiro sans détail 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.

Le tableau suivant décrit les métriques incluses dans les rapports d'activité des utilisateurs générés par Kiro.

1. Le rapport contient des colonnes statiques (tous les champs sauf les messages des modèles) et des colonnes dynamiques (messages des modèles).
2. Le nombre de colonnes de messages de modèles dépendra du nombre de modèles utilisés au cours de la date du rapport.
3. Les noms des colonnes de messages de modèles sont les noms des modèles en minuscules, en ordre alphabétique, en commençant par Auto.
4. Les valeurs des colonnes de messages de modèles correspondent au nombre de messages traités par ce modèle au cours de la journée du rapport pour un utilisateur. Si un utilisateur n'a pas utilisé un modèle, la colonne affichera une valeur de 0.

Le rapport d'activité des utilisateurs hérité continue de s'exécuter parallèlement au nouveau rapport par client. Ce rapport contient des données pour l'utilisation du CLI et du plugin uniquement. 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

Chaque colonne montre une métrique, comme décrit dans Anciennes métriques du rapport d'activité des utilisateurs.

Le fichier CSV est structuré comme suit :

• Un CSV par clientType, contenant tous les utilisateurs ayant interagi avec ce client au cours de la journée.
• Chaque ligne montre un utilisateur ayant interagi avec Kiro ce jour-là.
• Chaque colonne montre une métrique, comme décrit dans Métriques du rapport d'activité des utilisateurs. Les métriques sont calculées en fonction de la télémétrie des utilisateurs recueillie au cours de la journée.
• Si plus de 1 000 utilisateurs interagissent avec Kiro au cours de la journée, Kiro divise les données en plusieurs fichiers CSV contenant 1 000 utilisateurs chacun. Les fichiers portent le suffixe part_1, part_2, et ainsi de suite.

Les rapports sont enregistrés au chemin suivant. Le segment 00 est une partition d'heure fixe qui reflète l'heure d'écriture de 2 h 00 UTC.

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.