Kiro lit le point de terminaison et les identifiants de votre collecteur dans un secret AWS Secrets Manager de votre compte. Kiro stocke uniquement l'Amazon Resource Name (ARN) du secret. Il lit le secret chaque fois qu'il envoie des données, vous pouvez donc faire la rotation d'un identifiant ou déplacer votre collecteur en mettant à jour le secret. Vous n'avez rien à changer dans la console Kiro.
Vous avez besoin de :
- Une clé AWS Key Management Service (AWS KMS) gérée par le client. Les deux exportations peuvent utiliser la même clé.
- Un secret pour chaque exportation OpenTelemetry que vous activez. Les métriques OpenTelemetry et les événements en temps réel nécessitent des secrets différents, car ils envoient vers des chemins différents.
Créez la clé et les secrets dans le même compte AWS et la même Région que votre profil Kiro. Dans les exemples, remplacez <region> par cette Région et <account-id> par votre ID de compte AWS.
Kiro lit le secret à partir d'un compte AWS appartenant à Kiro. La clé par défaut aws/secretsmanager ne peut pas être utilisée entre comptes, vous avez donc besoin d'une clé gérée par le client.
-
Ouvrez la console AWS KMS dans la Région de votre profil Kiro.
-
Choisissez Customer managed keys, puis choisissez Create key.
-
Pour Key type, choisissez Symmetric. Pour Key usage, choisissez Encrypt and decrypt. Choisissez Next.
-
Entrez un Alias, comme
kiro-otel-export. Choisissez Next, choisissez les administrateurs de votre clé, puis choisissez Next de nouveau. -
Sur Define key usage permissions, choisissez Next, puis choisissez Finish.
-
Ouvrez la clé. Dans l'onglet Key policy, choisissez Edit et ajoutez cette instruction. Elle permet à Kiro de déchiffrer le secret uniquement par l'intermédiaire de Secrets Manager dans votre Région.
json{ "Sid": "AllowKiroDecryptViaSecretsManager", "Effect": "Allow", "Principal": { "Service": "q.amazonaws.com" }, "Action": ["kms:Decrypt", "kms:DescribeKey"], "Resource": "*", "Condition": { "StringEquals": { "kms:ViaService": "secretsmanager.<region>.amazonaws.com" } } } -
Choisissez Save changes.
Le secret est un objet JSON à deux clés :
{ "OTEL_EXPORTER_OTLP_ENDPOINT": "https://<collector-host>", "OTEL_EXPORTER_OTLP_HEADERS": "<Header-Name>=<value>" }
OTEL_EXPORTER_OTLP_ENDPOINTest le point de terminaison de votre collecteur. Il doit utiliserhttps://, et son hôte doit être un nom de domaine ou une adresse IP publique, pas une adresse IP interne ni un nom d'un seul mot commelocalhost. Il ne peut pas contenir d'identifiants.OTEL_EXPORTER_OTLP_HEADERSest l'en-tête d'authentification, au formatName=value. Kiro sépare chaque paire au premier=, de sorte que le remplissage base64 comme==est conservé.
Les deux exportations utilisent le secret différemment :
| Métriques OpenTelemetry | Événements OpenTelemetry en temps réel | |
|---|---|---|
| Signal | Métriques OTLP | Journaux OTLP, un enregistrement par événement |
| Protocole | gRPC (par défaut) ou HTTP/protobuf, choisi dans la console | HTTP/protobuf uniquement, avec compression gzip |
| Chemin du point de terminaison | Pour HTTP/protobuf, Kiro ajoute /v1/metrics sauf si l'URL se termine déjà par ce chemin. Pour gRPC, Kiro utilise l'URL telle quelle | Kiro ajoute /v1/logs sauf si l'URL se termine déjà par ce chemin |
| En-têtes | Un en-tête | Un ou plusieurs en-têtes, séparés par des virgules. Une valeur ne peut pas contenir de virgule |
Par l'Internet public, votre collecteur doit être joignable depuis Internet. Quelle que soit la connectivité, il doit présenter un certificat TLS approuvé publiquement, et Kiro rejette les certificats autosignés et les adresses IP internes. Si votre collecteur n'est pas sur l'Internet public, consultez Connectivité privée.
Utilisez un identifiant d'ingestion, pas un identifiant d'administration.
| Plateforme | Protocole et point de terminaison des métriques | Point de terminaison des événements | En-tête | Identifiant |
|---|---|---|---|---|
| Honeycomb | gRPC, https://api.honeycomb.io:443 | https://api.honeycomb.io | x-honeycomb-team=<ingest-key> | Une clé d'ingestion : l'ID de clé et le secret de clé ensemble, pas l'ID de clé seul |
| Grafana Cloud | HTTP/protobuf, https://otlp-gateway-<zone>.grafana.net/otlp | https://otlp-gateway-<zone>.grafana.net/otlp | Authorization=Basic <base64> | L'encodage base64 de <instance-id>:<token>. Le jeton commence par glc_. Grafana Cloud nécessite la temporalité Cumulative pour les métriques. Avant le 26 novembre 2026, Grafana Cloud rejette les métriques quotidiennes parce qu'elles sont trop anciennes. Consultez Vérifier la fenêtre temporelle de votre plateforme |
| Datadog | HTTP/protobuf, https://otlp.datadoghq.com/v1/metrics | https://otlp.datadoghq.com | dd-api-key=<api-key> | Une clé API, pas une clé d'application. Utilisez le point de terminaison de votre site Datadog, comme datadoghq.eu |
| Dynatrace | HTTP/protobuf, https://<environment-id>.live.dynatrace.com/api/v2/otlp | https://<environment-id>.live.dynatrace.com/api/v2/otlp | Authorization=Api-Token <token> ou Authorization=Bearer <token> | Utilisez Api-Token pour un jeton d'accès (dt0c01.). Le secret des métriques nécessite metrics.ingest; le secret des événements nécessite logs.ingest. Utilisez Bearer pour un jeton de plateforme (dt0s16.). Le secret des métriques nécessite openpipeline:metrics:ingest; le secret des événements nécessite openpipeline:logs:ingest. Avant le 26 novembre 2026, Dynatrace rejette les métriques quotidiennes parce qu'elles sont trop anciennes. Consultez Vérifier la fenêtre temporelle de votre plateforme |
| Elastic | gRPC, https://<deployment>.ingest.<region>.gcp.elastic-cloud.com:443 | Non couvert sur cette page | Authorization=ApiKey <base64> | L'encodage base64 de <id>:<api_key> |
| Amazon CloudWatch | HTTP/protobuf, https://monitoring.<region>.amazonaws.com/v1/metrics | https://logs.<region>.amazonaws.com | Métriques : Authorization=Bearer <api-key>. Événements : Authorization=Bearer <api-key>,x-aws-log-group=<group>,x-aws-log-stream=<stream> | Une clé API CloudWatch. Kiro ne peut pas signer les requêtes avec AWS Signature Version 4 (SigV4). Pour les événements, créez d'abord le groupe de journaux et le flux de journaux, puis activez l'authentification par jeton porteur pour le groupe de journaux |
| OpenSearch par Data Prepper | gRPC, https://<receiver-host>:21891 | L'URL de votre otel_logs_source | Authorization=Basic <base64> | L'utilisateur de votre source Data Prepper. Pour les événements, définissez compression: "gzip" sur la source |
| Votre propre collecteur OTLP | gRPC sur 4317, ou HTTP/protobuf sur 4318 | https://<collector-host>:4318 | Selon les exigences de votre collecteur | Son récepteur OTLP/HTTP doit accepter gzip |
Pour les clés API CloudWatch, consultez OTLP endpoints dans le Amazon CloudWatch User Guide.
-
Ouvrez la console AWS Secrets Manager dans la Région de votre profil Kiro, puis choisissez Store a new secret.
-
Pour Secret type, choisissez Other type of secret.
-
Choisissez l'onglet Plaintext, supprimez le texte d'exemple et collez la valeur de l'étape 2.
-
Pour Encryption key, choisissez la clé de l'étape 1. Ne choisissez pas
aws/secretsmanager. Choisissez Next. -
Entrez un Secret name, comme
kiro/otel-metricsoukiro/otel-events. -
Sous Resource permissions, choisissez Edit permissions et collez cette politique. Choisissez Save.
json{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowKiroGetSecretValue", "Effect": "Allow", "Principal": { "Service": "q.amazonaws.com" }, "Action": "secretsmanager:GetSecretValue", "Resource": "*" } ] } -
Choisissez Next. Laissez la rotation désactivée, puis choisissez Next de nouveau.
-
Choisissez Store.
-
Ouvrez le secret et copiez le Secret ARN. Vous l'entrez dans la console Kiro.
Répétez l'étape 2 et l'étape 3 pour la deuxième exportation, si vous utilisez les deux.
Sautez la première commande si vous avez déjà la clé.
# 1. Create the KMS key with the Kiro decrypt statement aws kms create-key --region <region> \ --description "Kiro OpenTelemetry export" \ --policy '{"Version":"2012-10-17","Statement":[ {"Sid":"EnableRoot","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::<account-id>:root"},"Action":"kms:*","Resource":"*"}, {"Sid":"AllowKiroDecryptViaSecretsManager","Effect":"Allow","Principal":{"Service":"q.amazonaws.com"},"Action":["kms:Decrypt","kms:DescribeKey"],"Resource":"*","Condition":{"StringEquals":{"kms:ViaService":"secretsmanager.<region>.amazonaws.com"}}}]}' \ --query KeyMetadata.KeyId --output text # 2. Create the secret, encrypted with the key. Save the value from Step 2 as secret.json. aws secretsmanager create-secret --region <region> \ --name kiro/otel-events --kms-key-id <key-id> \ --secret-string file://secret.json # 3. Let Kiro read the secret aws secretsmanager put-resource-policy --region <region> \ --secret-id kiro/otel-events \ --resource-policy '{"Version":"2012-10-17","Statement":[{"Sid":"AllowKiroGetSecretValue","Effect":"Allow","Principal":{"Service":"q.amazonaws.com"},"Action":"secretsmanager:GetSecretValue","Resource":"*"}]}'
Mettez à jour la valeur du secret. Conservez le même ARN de secret.
aws secretsmanager put-secret-value --region <region> \ --secret-id kiro/otel-events --secret-string file://secret.json
Kiro utilise la nouvelle valeur la prochaine fois qu'il envoie des données. Les événements en temps réel l'utilisent à la prochaine livraison, car Kiro ne met pas le secret en cache. Les métriques l'utilisent à la prochaine exportation quotidienne, à 00:30 UTC (02:00 UTC avant le 26 novembre 2026).
Activez l'exportation dans la console Kiro. Si votre collecteur n'est pas sur l'Internet public, configurez d'abord la connectivité privée.
Préparer les identifiants pour OpenTelemetry