Passer au contenu principal
Afficher en Markdown

Dépanner les exportations d'activité des utilisateurs

Kiro n'envoie pas de notification d'échec. Commencez par Tester la connexion. Le test nomme la cause de la plupart des erreurs de configuration. Utilisez ensuite les vérifications de cette page.

Vérifier les éléments de base

  1. La politique est publiée. Dans Controls, les modifications s'appliquent seulement après que vous avez choisi Publish. Sous Destinations overview, l'état de l'exportation doit commencer par On, comme On, over the public internet.
  2. La politique est attribuée. Kiro applique la politique seulement aux profils auxquels elle est attribuée.
  3. Les utilisateurs sont actifs. Kiro envoie les événements en temps réel seulement quand des utilisateurs travaillent dans Kiro. Les exportations quotidiennes couvrent seulement les utilisateurs qui ont été actifs ce jour-là.
  4. La première exportation quotidienne a eu lieu. Kiro envoie le rapport CSV à 02:00 UTC, et les métriques OpenTelemetry à 00:30 UTC (02:00 UTC avant le 26 novembre 2026). Chacun couvre la veille.

Aucun rapport CSV n'arrive

CauseCorrectif
Le compartiment n'est pas dans la Région ou le compte du profil KiroCréez le compartiment dans la Région du profil et dans le compte où les utilisateurs sont abonnés
La politique de compartiment ne permet pas à q.amazonaws.com d'écrireAjoutez la politique de compartiment. Vérifiez que aws:SourceAccount et aws:SourceArn correspondent à votre compte et à votre Région
L'URI S3 n'a pas de préfixeAjoutez un préfixe. Kiro ne peut pas écrire à la racine d'un compartiment

Aucune métrique OpenTelemetry n'arrive

Vérifiez ces causes dans l'ordre :

  1. Région ou compte. Le secret et sa clé AWS Key Management Service (AWS KMS) doivent se trouver dans le même compte et la même Région que votre profil Kiro.
  2. Autorisation manquante. q.amazonaws.com a besoin de secretsmanager:GetSecretValue sur le secret, et de kms:Decrypt et kms:DescribeKey sur la clé. N'accorder qu'une seule de ces autorisations échoue de la même façon que n'en accorder aucune.
  3. Mauvais protocole. gRPC vers un point de terminaison HTTP seulement, ou HTTP/protobuf vers un point de terminaison gRPC seulement, échoue sans erreur. Grafana Cloud, Datadog et Amazon CloudWatch ont besoin de HTTP/protobuf.
  4. Mauvaise temporalité. Grafana Cloud rejette les métriques delta. Choisissez Cumulative.
  5. En-tête mal formé. Utilisez un seul en-tête au format Name=value. Pour un identifiant en base64, la valeur décodée contient exactement un :.
  6. Amazon CloudWatch seulement. Les métriques se trouvent dans le compte qui a émis la clé API. Elles n'apparaissent pas dans la console de métriques classique. Interrogez-les avec PromQL.
  7. Points de données trop anciens. Avant le 26 novembre 2026, les métriques quotidiennes arrivent avec environ deux heures de retard. Dynatrace et Grafana Cloud les rejettent parce qu'elles sont trop anciennes. D'ici là, utilisez les événements en temps réel pour ces plateformes, ou comblez l'écart avec le rapport CSV. Consultez Vérifier la fenêtre temporelle de votre plateforme.

Aucun événement en temps réel n'arrive

Vérifiez ces causes dans l'ordre :

  1. Région ou compte. Le secret et sa clé KMS doivent se trouver dans le même compte et la même Région que votre profil Kiro.
  2. Autorisation manquante. q.amazonaws.com a besoin d'une autorisation sur le secret et sur la clé.
  3. Le secret des métriques a été utilisé. Le secret des événements doit pointer vers l'URL de base des journaux de votre collecteur, pas vers une URL de métriques comme https://otlp.datadoghq.com/v1/metrics.
  4. Mauvais chemin. Donnez l'URL de base. Kiro ajoute /v1/logs. Pour Grafana Cloud, l'URL de base se termine par /otlp.
  5. En-tête mal formé. Utilisez des paires Name=value séparées par des virgules, sans virgule dans une valeur. CloudWatch Logs a besoin des trois en-têtes.
  6. CloudWatch Logs seulement. Vérifiez que le groupe de journaux et le flux de journaux existent. L'authentification par jeton Bearer doit être activée pour le groupe de journaux. La clé API doit provenir du compte qui possède le groupe de journaux.
  7. Mauvais préfixe Dynatrace. Utilisez Api-Token avec un jeton d'accès, et Bearer avec un jeton de plateforme.

Aucune donnée d'appel d'outil n'arrive

Les événements kiro.chat.message arrivent, mais pas les événements kiro.tool.call, ou les colonnes CSV et les métriques _client sont vides.

CauseCorrectif
Le client est trop ancienMettez à jour Kiro IDE vers la dernière version. Mettez à jour Kiro CLI vers 3.0.0 ou ultérieure, ou vers 3.1.0 ou ultérieure quand Collect metrics per user est désactivé. Consultez Versions des clients
Un ancien processus est toujours en coursQuittez chaque fenêtre IDE et chaque processus kiro-cli, puis redémarrez-les
Kiro CLI utilise le moteur d'agent V2Exécutez kiro-cli settings chat.agentEngine v3
Les requêtes n'ont pas utilisé d'outilsEnvoyez une requête qui lit un fichier ou exécute une commande

Connectivité privée

Résultats du test

Quand la connexion privée n'est pas prête, le test n'envoie rien, et le résultat affiche Endpoint not ready yet ou Connection not ready yet. Le message détaillé vous indique pourquoi.

Le message détaillé commence parSignificationQuoi faire
« Kiro has not set up a private connection to endpoint service … »Kiro n'a aucune connexion pour ce service de point de terminaison. Habituellement, le compte de Kiro n'est pas un principal autorisé. Attendre n'aide pasDemandez à votre fournisseur, ou au propriétaire de votre propre service de point de terminaison, d'autoriser le compte de Kiro. Puis publiez de nouveau
« This profile is not using Kiro's private connection to endpoint service … »La politique publiée ne sélectionne pas ce service de point de terminaisonPubliez la connectivité privée avec ce service de point de terminaison, et activez l'exportation
« Kiro's private connection to this endpoint service was set up in … »La Région du test diffère de la Région publiéeCorrigez Endpoint service Region
« Kiro is still creating … », « … is still being set up », « … does not have a private DNS name yet » ou « … is in its warm-up period »La connexion est en cours de créationTestez de nouveau. La connexion peut prendre jusqu'à environ 10 minutes après la publication avec AWS PrivateLink, ou 15 minutes avec Amazon VPC Lattice. Si le message persiste, vérifiez que le propriétaire du service de point de terminaison a accepté la connexion et que le service a un nom DNS privé
« Kiro's private connection to this endpoint service is in state … »Le propriétaire du service de point de terminaison a rejeté la connexion, ou elle a échoué. Attendre n'aide pasDemandez au propriétaire du service de point de terminaison de vérifier la demande de connexion de Kiro
« Kiro has not set up a private connection to resource configuration … »Kiro n'a aucune connexion pour cette configuration de ressourcesPartagez la configuration de ressources avec Kiro, puis publiez de nouveau
« Kiro has not connected to resource configuration … »Kiro n'a pas trouvé votre partage de ressourcesVérifiez la Région, l'ID de compte et la configuration de ressources du partage
« Resource configuration … is connected under a different collector hostname … »Le nom d'hôte du test diffère du nom d'hôte publiéUtilisez le nom d'hôte publié. Pour le changer, consultez Comportement et limites
« Kiro's connection to resource configuration … failed and is being replaced »L'association a échoué. Attendre n'aide pasVérifiez la configuration de ressources et sa passerelle de ressources, puis publiez de nouveau
« Kiro's connection to resource configuration … is active, but … is not resolvable … »Le DNS de votre nom d'hôte n'est pas encore prêt dans le réseau de KiroTestez de nouveau dans une minute
« Kiro has not built the private connection yet, so nothing was sent … »Vous avez testé un mode privé avant de publierPubliez, puis testez de nouveau quand la connexion est prête, jusqu'à environ 10 minutes après la publication avec AWS PrivateLink, ou 15 minutes avec Amazon VPC Lattice
« Kiro checked your setup and found nothing missing … »Vous avez testé avant de publier. Votre configuration semble complète, et Kiro n'a pas encore établi la connexionPubliez, puis testez de nouveau quand la connexion est prête, jusqu'à environ 10 minutes après la publication avec AWS PrivateLink, ou 15 minutes avec Amazon VPC Lattice
« Kiro's AWS account cannot see endpoint service … »Le compte de Kiro n'est pas un principal autorisé du service de point de terminaison, ou le nom est erroné. Attendre n'aide pasVérifiez le nom. Demandez au propriétaire du service de point de terminaison d'autoriser le compte de Kiro, puis publiez de nouveau
« Kiro could not confirm that the endpoint service has a verified private DNS name … »Le service de point de terminaison n'a peut-être pas de nom DNS privé, ou le nom n'est pas encore vérifiéDemandez au propriétaire du service de point de terminaison de définir et de vérifier le nom DNS privé, puis publiez
« Resource configuration … is not shared with Kiro's AWS account, or the share invitation expired … »Kiro n'a pas trouvé votre partage AWS RAMPartagez la configuration de ressources avec le compte de Kiro, puis publiez dans les 12 heures
« Kiro cannot tell how long your private connection has been available »Kiro ne peut pas confirmer que la période de préchauffage du point de terminaison est terminéeTestez de nouveau. La connexion peut prendre jusqu'à environ 10 minutes après la publication pour être prête
« Kiro cannot create the private connection: … does not offer any availability zone … »Le service de point de terminaison n'a aucune zone de disponibilité que Kiro peut utiliser dans votre Région. Attendre n'aide pasDemandez au propriétaire du service de point de terminaison d'ajouter des zones de disponibilité au service, puis publiez de nouveau
« … endpoint service is not available to Kiro's AWS account »Le compte de Kiro ne peut pas utiliser le service de point de terminaison. Attendre n'aide pasDemandez au propriétaire du service de point de terminaison d'autoriser le compte de Kiro, puis publiez de nouveau
« Resource configuration … is not owned by this profile's AWS account »La configuration de ressources appartient à un autre compteCréez et partagez la configuration de ressources depuis le compte qui contient votre profil Kiro, puis publiez de nouveau
« Collector hostname … cannot be used for private connectivity »Le nom d'hôte enfreint une règle de nom d'hôte, par exemple il contient une étiquette vpceChoisissez un nom d'hôte qui respecte les règles de Choisir le nom d'hôte du collecteur, puis publiez de nouveau
Un message détaillé qui indique que la connexion Amazon VPC Lattice est dans sa période de préchauffageL'association est active, et Kiro attend avant d'envoyerTestez de nouveau. La connexion peut prendre jusqu'à environ 15 minutes après la publication pour être prête
« Testing a private connection is not available in this Region yet. »Kiro ne peut pas exécuter un test privé dans cette RégionVérifiez que les données arrivent à votre collecteur

Symptômes

SymptômeCauseCorrectif
AWS PrivateLink : erreurs TLS, ou aucune donnéeLe secret utilise le nom d'hôte public du collecteur ou un nom vpce.amazonaws.comUtilisez le nom DNS privé du service de point de terminaison
AWS PrivateLink : jamais prêtLe compte de Kiro n'est pas autorisé, le propriétaire du service de point de terminaison n'a pas accepté la connexion, ou le service n'a pas de nom DNS privéDemandez au propriétaire du service de point de terminaison de vérifier ces trois points, puis publiez de nouveau
AWS PrivateLink : le fournisseur n'a pas de nom DNS privéLe fournisseur s'attend à une zone hébergée privée dans votre VPC, que Kiro ne peut pas utiliserExécutez votre propre collecteur, partagez-le par Amazon VPC Lattice, et transférez les données à votre fournisseur
AWS PrivateLink, entre Régions : jamais prêtLe service de point de terminaison ne prend pas en charge la Région de votre profil, ou il se trouve dans une autre partition AWSDemandez au propriétaire du service de point de terminaison d'ajouter votre Région au service
Amazon VPC Lattice : jamais prêtLe partage nomme le mauvais compte, se trouve dans la mauvaise Région, a été créé après votre publication, ou provient d'un compte qui ne possède pas la configuration de ressourcesPartagez depuis le compte propriétaire vers le compte de Kiro pour votre Région, puis publiez de nouveau
Amazon VPC Lattice : jamais prêt, et vous avez publié plus de 12 heures après avoir créé le partageL'invitation de partage a expiréAjoutez de nouveau le compte de Kiro au partage, et publiez dans les 12 heures
Amazon VPC Lattice : jamais prêt, et vous avez publié un partage correct dans les 12 heuresUn autre client Kiro utilise déjà le nom d'hôte du collecteurChoisissez un nom d'hôte dans votre propre domaine. Désactivez l'exportation, publiez, attendez environ 5 minutes, puis publiez l'exportation avec le nouveau nom d'hôte. Passez plutôt à Public internet seulement si vos règles réseau le permettent. Consultez Comportement et limites
Amazon VPC Lattice : les livraisons expirentLe port n'est pas 443, 4317 ou 4318, ou un groupe de sécurité le bloqueConsultez Choisir un port de collecteur et Groupes de sécurité
Amazon VPC Lattice : erreurs TLSLe certificat est autosigné, émis par une autorité de certification privée, ou ne couvre pas le nom d'hôteConsultez Utiliser une autorité de certification privée
Amazon VPC Lattice : les données s'arrêtent après que vous avez changé le secretL'hôte dans le secret ne correspond plus au Collector hostname. Kiro les compare avant chaque livraison, et n'envoie rien quand ils diffèrentUtilisez le même nom d'hôte dans les deux. Pour changer le nom d'hôte, consultez Comportement et limites
Un équilibreur de charge devant le collecteur renvoie des erreursLe protocole ne correspond pas au groupe ciblePour gRPC, utilisez la version de protocole gRPC. Pour HTTP, utilisez HTTP1 ou HTTP2
Le test indique « Kiro did not send the test. OTEL_EXPORTER_OTLP_ENDPOINT must be an https:// URL … »Le point de terminaison du secret commence par http://, ou son hôte est une adresse IP interne ou un nom d'un seul motUtilisez une URL https:// que votre certificat couvre
Page mise à jour : 16 novembre 2026