Passer au contenu principal
Afficher en Markdown

Activer les exportations dans la console Kiro

Vous activez chaque exportation dans la console Kiro. Pour utiliser la console, vous avez besoin des autorisations décrites dans Politique : autoriser les administrateurs à configurer Kiro et à abonner des utilisateurs.

Kiro offre deux endroits pour configurer les exportations :

  • Controls. Vous définissez les exportations dans une politique. Vos modifications vont dans le brouillon de la politique. Kiro les utilise seulement après que vous avez publié la politique, et seulement pour les profils auxquels la politique est attribuée.
  • Settings (obsolète). Vous définissez les exportations dans la boîte de dialogue Enable usage metrics logs. Utilisez-la seulement si votre organisation n'utilise pas encore Controls.

Ouvrir la page du rapport d'activité des utilisateurs

La page User activity report dans Controls regroupe tous les paramètres d'exportation. Ouvrez-la avant de suivre les étapes des sections suivantes.

  1. Connectez-vous à la console AWS, et passez à la console Kiro.
  2. Dans le volet de navigation, choisissez Controls, puis choisissez votre politique.
  3. Choisissez Edit. Vos modifications sont enregistrées automatiquement dans le brouillon.
  4. Dans l'onglet Rules and settings, allez à Privacy and telemetry.
  5. Choisissez la ligne Kiro user activity reports ou la ligne Kiro real-time user activity events. Les deux ouvrent la page User activity report. Show in YAML dans la ligne ouvre plutôt la vue YAML.

La page affiche un Destinations overview et un onglet pour chaque exportation : CSV report, OpenTelemetry metrics et OpenTelemetry real-time events.

Chaque état dans Destinations overview indique ce que la politique demande, et non si des données sont arrivées. Par exemple, On, over the public internet signifie que la politique active l'exportation.

Activer le rapport CSV

Avant de commencer, préparez le compartiment S3.

  1. Ouvrez la page du rapport d'activité des utilisateurs, et choisissez l'onglet CSV report.
  2. Dans CSV report settings, choisissez Turn on.
  3. Pour CSV destination, saisissez l'URI S3 avec son préfixe, par exemple s3://amzn-s3-demo-bucket/user-activity-reports/.
  4. Choisissez Save to draft. Cela active aussi Collect metrics per user, dont chaque exportation quotidienne a besoin.
  5. Choisissez Publish, puis confirmez dans la boîte de dialogue Publish changes?.

Kiro écrit le premier rapport à la prochaine occurrence de 2 h UTC. Pour le confirmer, consultez Activer le rapport CSV.

Activer les métriques OpenTelemetry

Avant de commencer, créez la clé AWS Key Management Service (AWS KMS) et le secret des métriques.

  1. Ouvrez la page du rapport d'activité des utilisateurs, et choisissez l'onglet OpenTelemetry metrics.
  2. Dans Connection, choisissez Turn on.
  3. Pour OpenTelemetry credentials, collez l'Amazon Resource Name (ARN) de votre secret des métriques.
  4. Pour OpenTelemetry protocol, choisissez gRPC ou HTTP/protobuf. Utilisez le protocole que votre collecteur accepte. Un mauvais protocole ne cause aucune erreur, mais aucune métrique n'arrive.
  5. Pour OpenTelemetry temporality, conservez Delta, ou choisissez Cumulative pour un collecteur basé sur Prometheus comme Grafana Cloud.
  6. Choisissez Save to draft. Cela active aussi Collect metrics per user.
  7. Si votre collecteur n'est pas sur l'Internet public, suivez dès maintenant les étapes 2 à 4 de Choisir la connectivité privée, pour que Kiro n'envoie jamais cette exportation par l'Internet public.
  8. Testez la connexion dans Test connection. Par l'Internet public, cela envoie un enregistrement de test. Avec la connectivité privée, cela vérifie seulement votre configuration.
  9. Choisissez Publish, puis confirmez dans la boîte de dialogue Publish changes?.
  10. Avec la connectivité privée, prévoyez jusqu'à environ 10 minutes pour AWS PrivateLink, ou jusqu'à environ 15 minutes pour Amazon VPC Lattice, puis testez de nouveau. Ce test envoie un enregistrement par la connexion privée.

La première exportation s'exécute à la prochaine occurrence de 0 h 30 UTC (2 h UTC avant le 26 novembre 2026). Elle envoie les métriques de la veille. Kiro n'envoie aucune donnée quand vous publiez. Pour confirmer la première exportation, consultez Confirmer l'exportation.

Activer les événements en temps réel

Avant de commencer, créez le secret des événements. Il doit être différent du secret des métriques. Les événements en temps réel n'ont pas besoin de Collect metrics per user.

  1. Ouvrez la page du rapport d'activité des utilisateurs, et choisissez l'onglet OpenTelemetry real-time events.
  2. Dans Connection, choisissez Turn on. Dans la boîte de dialogue, Export real-time events to OpenTelemetry est déjà activé.
  3. Pour Event export credentials, collez l'ARN de votre secret des événements.
  4. Choisissez Save to draft. Le protocole est toujours OTLP logs over HTTP (http/protobuf).
  5. Si votre collecteur n'est pas sur l'Internet public, suivez dès maintenant les étapes 2 à 4 de Choisir la connectivité privée, pour que Kiro n'envoie jamais cette exportation par l'Internet public.
  6. Testez la connexion dans Test connection. Par l'Internet public, cela envoie un enregistrement de test. Avec la connectivité privée, cela vérifie seulement votre configuration.
  7. Choisissez Publish, puis confirmez dans la boîte de dialogue Publish changes?.
  8. Avec la connectivité privée, prévoyez jusqu'à environ 10 minutes pour AWS PrivateLink, ou jusqu'à environ 15 minutes pour Amazon VPC Lattice, puis testez de nouveau. Ce test envoie un enregistrement par la connexion privée.

Les événements commencent avec la prochaine activité des utilisateurs après la publication. Kiro n'envoie pas l'activité antérieure. Pour confirmer que les événements arrivent, consultez Confirmer l'exportation.

Choisir la connectivité privée

Avant de commencer, configurez AWS PrivateLink ou Amazon VPC Lattice, et placez l'hôte privé dans le secret.

  1. Ouvrez la page du rapport d'activité des utilisateurs, et choisissez l'onglet OpenTelemetry metrics ou l'onglet OpenTelemetry real-time events.
  2. Dans Private connectivity, choisissez Edit.
  3. Pour Private connectivity, choisissez AWS PrivateLink ou Amazon VPC Lattice, et saisissez les champs du mode :
    • Pour AWS PrivateLink, saisissez le Endpoint service name et la Endpoint service Region. La région doit correspondre à la région dans le nom du service.
    • Pour Amazon VPC Lattice, saisissez l'ARN de la configuration de ressources dans Lattice resource configuration, et le Collector hostname.
  4. Choisissez Save to draft.
  5. Choisissez Publish, puis confirmez dans la boîte de dialogue Publish changes?. Kiro établit la connexion privée seulement après la publication.
  6. Prévoyez jusqu'à environ 10 minutes pour AWS PrivateLink, ou jusqu'à environ 15 minutes pour Amazon VPC Lattice. Ensuite, testez la connexion.

Pour revenir à l'Internet public, réglez Private connectivity à Public internet, enregistrez et publiez.

Désactiver une exportation

Dans Controls, ouvrez l'onglet de l'exportation, choisissez Turn off, et publiez. Dans Settings (obsolète), désélectionnez l'exportation, et choisissez Enable.

Kiro conserve les valeurs enregistrées, comme l'ARN du secret et les champs de connectivité privée, alors vous pouvez réactiver l'exportation. Avec la connectivité privée, Kiro libère son point de terminaison de VPC ou son association Lattice dans un délai d'environ 5 minutes.

Page mise à jour : 16 novembre 2026