Passer au contenu principal
Afficher en Markdown

Tester la connexion

Par l'Internet public, Test connection envoie un enregistrement de test à votre collecteur avec les valeurs du brouillon de la politique. Avec la connectivité privée, il vérifie votre configuration avant la publication et envoie un enregistrement une fois la connexion privée prête. Rien n'est enregistré, et aucune donnée d'utilisation n'est envoyée. Utilisez-le pour repérer un mauvais point de terminaison, une mauvaise identifiant ou un mauvais protocole avant la première exportation. Activez l'exportation dans le brouillon avant de la tester.

Dans Controls, chaque onglet OpenTelemetry de la page User activity report comporte une section Test connection. Dans Settings (obsolète), Test connection se trouve dans la boîte de dialogue Enable usage metrics logs. Pour ouvrir la page, consultez Ouvrir la page du rapport d'activité des utilisateurs.

Quand tester

ConnectivitéCe que le test utiliseQuand tester
Internet publicLes valeurs du brouillonÀ tout moment, aussi avant la publication
AWS PrivateLinkAvant la publication : une vérification de votre configuration. Après la publication : la connexion privée que Kiro a établieAvant la publication, pour repérer une étape manquante. Puis après la publication, quand la connexion est prête. Cela peut prendre jusqu'à environ 10 minutes
Amazon VPC LatticeAvant la publication : une vérification de votre configuration. Après la publication : la connexion privée que Kiro a établieAvant la publication, pour repérer une étape manquante. Puis après la publication, quand la connexion est prête. Cela peut prendre jusqu'à environ 15 minutes

Avant la publication, un test privé n'envoie rien. Kiro lit seulement votre configuration et nomme la première étape manquante :

  • AWS PrivateLink : le compte de Kiro voit le service de point de terminaison, et le service a un nom DNS privé vérifié.
  • Amazon VPC Lattice : la configuration de ressources est partagée avec le compte de Kiro.
  • Les deux : Kiro peut lire le secret. Pour Amazon VPC Lattice, le point de terminaison du secret utilise le nom d'hôte du collecteur.

Quand toutes les vérifications réussissent, le message détaillé commence par « Kiro checked your setup and found nothing missing ». Publiez, attendez que la connexion soit prête, jusqu'à environ 10 minutes pour AWS PrivateLink ou 15 minutes pour Amazon VPC Lattice, et testez de nouveau pour envoyer un enregistrement de test.

Ce que le test envoie

L'enregistrement de test ressemble à un enregistrement réel. Il a les mêmes attributs de ressource, comme service.name = kiro-enterprise. Il a aussi des attributs qui le marquent comme un test :

AttributTest des métriquesTest des événements
EnregistrementUn point de données de valeur 1, dans la métrique kiro.test.connectionUn enregistrement de journal avec eventName = kiro.test.connection
kiro.testtruetrue
kiro.test.signalmetricsevents
kiro.test.idNon envoyé. Un attribut de métrique qui change à chaque test ajouterait une nouvelle série à votre backendUn ID pour ce test

Le test des métriques utilise son propre nom de métrique, hors de kiro.daily.*, alors il ne change pas vos totaux quotidiens. Pour garder les événements de test hors de vos tableaux de bord et de vos alertes, filtrez sur kiro.event.name != "kiro.test.connection".

Lire le résultat

La console affiche Connection successful quand le test réussit. Un test réussi signifie que votre collecteur a accepté un enregistrement de test par le chemin que vous avez choisi. Il ne prouve pas que les données d'utilisation arriveront :

  • L'exportation doit encore être publiée.
  • Kiro envoie les événements seulement quand vos utilisateurs sont actifs, et les métriques une fois par jour à 0 h 30 UTC (2 h UTC avant le 26 novembre 2026).
  • Certains collecteurs acceptent une requête, puis abandonnent les enregistrements qu'elle contient. Vérifiez toujours les données à la destination.

Quand le test échoue, la console affiche l'un de ces résultats. Un test échoué affiche aussi un Test ID. Donnez-le à AWS Support si vous le contactez.

Ce que la console afficheCe que cela signifieQuoi faire
Could not run the test, avec un message comme « OTel exporter configuration requires a valid Secrets Manager secret ARN »Kiro a vérifié l'ARN du secret avant le test et l'a rejeté. Rien n'a été appelé. D'autres messages indiquent que le secret doit appartenir au compte AWS du profil, ou doit se trouver dans la région du profilCollez l'ARN complet d'un secret situé dans le même compte et la même région que votre profil Kiro
Connection failed : « Kiro could not read the secret. Check all three: … »Kiro ne peut pas lire le secret, ou le secret n'a pas de point de terminaison. Le message énumère trois vérifications. Le secret utilise une clé AWS Key Management Service (AWS KMS) gérée par le client, et non aws/secretsmanager. La politique de la clé accorde à Kiro kms:Decrypt et kms:DescribeKey. La politique de ressource du secret accorde à Kiro secretsmanager:GetSecretValueVérifiez la politique de la clé KMS, la politique de ressource du secret et le JSON du secret. Consultez Préparer les identifiants
Connection failed : « Kiro did not send the test. OTEL_EXPORTER_OTLP_ENDPOINT must be an https:// URL with a domain name or public IP address, and no credentials. »Kiro a rejeté le point de terminaison avant d'envoyer quoi que ce soit. L'URL n'est pas en https://, contient des identifiants, ou son hôte est une adresse IP interne ou un nom d'un seul mot comme localhost. Un nom DNS privé pour AWS PrivateLink ou Amazon VPC Lattice est acceptéUtilisez une URL https:// dont l'hôte est un nom de domaine ou une adresse IP publique
Connection failed : « Kiro did not send the test: it could not read OTEL_EXPORTER_OTLP_HEADERS in the secret. »Kiro ne peut pas analyser OTEL_EXPORTER_OTLP_HEADERS, ou celle-ci nomme un en-tête que Kiro réserve, comme Host ou Content-Type. Rien n'a été envoyéMétriques : utilisez une seule paire HeaderName=value. Événements : utilisez des paires HeaderName=value séparées par des virgules, sans en-tête réservé
Connection failed : « Kiro sent the test event, but the collector did not accept it. » Pour les métriques, le message indique « test datapoint »Kiro a envoyé l'enregistrement, et votre collecteur ne l'a pas accepté. Par exemple, l'hôte est injoignable, la requête a expiré, TLS a échoué, ou le collecteur a renvoyé 401 ou 403Vérifiez d'abord l'identifiant dans OTEL_EXPORTER_OTLP_HEADERS. Vérifiez ensuite que le point de terminaison est exact et joignable. Pour les événements, vérifiez que le collecteur accepte les journaux OTLP par HTTP. Pour les métriques, vérifiez le protocole, et la temporalité si le formulaire l'affiche. Consultez Dépannage
Endpoint not ready yet (AWS PrivateLink) ou Connection not ready yet (Amazon VPC Lattice), avec un message détailléVous avez choisi un mode privé, et la connexion privée de Kiro n'est pas prête. Rien n'a été envoyéNormal jusqu'à environ 10 minutes après la publication avec AWS PrivateLink, ou 15 minutes avec Amazon VPC Lattice. Testez de nouveau plus tard. Si le problème persiste, lisez le message détaillé et consultez Erreurs de connectivité privée
Could not run the test : « Private connectivity is not available for this AWS account yet, so Kiro did not run the test. To check the collector now, set Private connectivity to Public internet and test again. » Dans Settings (obsolète), le message est « OTel private connectivity is not enabled for this account »La connectivité privée n'est pas encore offerte pour ce compte AWS. Ce n'est pas une erreur de configuration du collecteur. Rien n'a été envoyéSi vos règles réseau permettent la livraison publique, testez par Public internet. Pour utiliser la connectivité privée, contactez AWS Support
Connection failed : « Kiro could not complete the test. Try again in a moment. If it keeps happening, contact support with the test ID below. »Une défaillance du côté de KiroRéessayez dans un instant. Si le problème persiste, contactez AWS Support avec le Test ID
Too many tests : « Connection tests are rate limited. Wait a few seconds and try again — this is not a problem with your configuration. »Vous avez lancé des tests plus vite que Kiro le permetAttendez quelques secondes et testez de nouveau

Un test réussi affiche le point de terminaison vers lequel Kiro a livré, pour que vous puissiez confirmer l'URL.

Page mise à jour : 16 novembre 2026