Passer au contenu principal
Afficher en Markdown

Préparer les identifiants pour OpenTelemetry

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.

Étape 1 : Créer une clé KMS

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.

  1. Ouvrez la console AWS KMS dans la Région de votre profil Kiro.

  2. Choisissez Customer managed keys, puis choisissez Create key.

  3. Pour Key type, choisissez Symmetric. Pour Key usage, choisissez Encrypt and decrypt. Choisissez Next.

  4. Entrez un Alias, comme kiro-otel-export. Choisissez Next, choisissez les administrateurs de votre clé, puis choisissez Next de nouveau.

  5. Sur Define key usage permissions, choisissez Next, puis choisissez Finish.

  6. 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" } } }
  7. Choisissez Save changes.

Étape 2 : Rédiger la valeur du secret

Le secret est un objet JSON à deux clés :

json
{ "OTEL_EXPORTER_OTLP_ENDPOINT": "https://<collector-host>", "OTEL_EXPORTER_OTLP_HEADERS": "<Header-Name>=<value>" }
  • OTEL_EXPORTER_OTLP_ENDPOINT est le point de terminaison de votre collecteur. Il doit utiliser https://, 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 comme localhost. Il ne peut pas contenir d'identifiants.
  • OTEL_EXPORTER_OTLP_HEADERS est l'en-tête d'authentification, au format Name=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
SignalMétriques OTLPJournaux OTLP, un enregistrement par événement
ProtocolegRPC (par défaut) ou HTTP/protobuf, choisi dans la consoleHTTP/protobuf uniquement, avec compression gzip
Chemin du point de terminaisonPour HTTP/protobuf, Kiro ajoute /v1/metrics sauf si l'URL se termine déjà par ce chemin. Pour gRPC, Kiro utilise l'URL telle quelleKiro ajoute /v1/logs sauf si l'URL se termine déjà par ce chemin
En-têtesUn en-têteUn 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.

Valeurs par plateforme

Utilisez un identifiant d'ingestion, pas un identifiant d'administration.

PlateformeProtocole et point de terminaison des métriquesPoint de terminaison des événementsEn-têteIdentifiant
HoneycombgRPC, https://api.honeycomb.io:443https://api.honeycomb.iox-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 CloudHTTP/protobuf, https://otlp-gateway-<zone>.grafana.net/otlphttps://otlp-gateway-<zone>.grafana.net/otlpAuthorization=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
DatadogHTTP/protobuf, https://otlp.datadoghq.com/v1/metricshttps://otlp.datadoghq.comdd-api-key=<api-key>Une clé API, pas une clé d'application. Utilisez le point de terminaison de votre site Datadog, comme datadoghq.eu
DynatraceHTTP/protobuf, https://<environment-id>.live.dynatrace.com/api/v2/otlphttps://<environment-id>.live.dynatrace.com/api/v2/otlpAuthorization=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
ElasticgRPC, https://<deployment>.ingest.<region>.gcp.elastic-cloud.com:443Non couvert sur cette pageAuthorization=ApiKey <base64>L'encodage base64 de <id>:<api_key>
Amazon CloudWatchHTTP/protobuf, https://monitoring.<region>.amazonaws.com/v1/metricshttps://logs.<region>.amazonaws.comMé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 PreppergRPC, https://<receiver-host>:21891L'URL de votre otel_logs_sourceAuthorization=Basic <base64>L'utilisateur de votre source Data Prepper. Pour les événements, définissez compression: "gzip" sur la source
Votre propre collecteur OTLPgRPC sur 4317, ou HTTP/protobuf sur 4318https://<collector-host>:4318Selon les exigences de votre collecteurSon récepteur OTLP/HTTP doit accepter gzip

Pour les clés API CloudWatch, consultez OTLP endpoints dans le Amazon CloudWatch User Guide.

Étape 3 : Stocker le secret

  1. Ouvrez la console AWS Secrets Manager dans la Région de votre profil Kiro, puis choisissez Store a new secret.

  2. Pour Secret type, choisissez Other type of secret.

  3. Choisissez l'onglet Plaintext, supprimez le texte d'exemple et collez la valeur de l'étape 2.

  4. Pour Encryption key, choisissez la clé de l'étape 1. Ne choisissez pas aws/secretsmanager. Choisissez Next.

  5. Entrez un Secret name, comme kiro/otel-metrics ou kiro/otel-events.

  6. 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": "*" } ] }
  7. Choisissez Next. Laissez la rotation désactivée, puis choisissez Next de nouveau.

  8. Choisissez Store.

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

Utiliser l'AWS CLI

Sautez la première commande si vous avez déjà la clé.

bash
# 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":"*"}]}'

Changer le point de terminaison ou faire la rotation de l'identifiant

Mettez à jour la valeur du secret. Conservez le même ARN de secret.

bash
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).

Étape suivante

Activez l'exportation dans la console Kiro. Si votre collecteur n'est pas sur l'Internet public, configurez d'abord la connectivité privée.

Page mise à jour : 16 novembre 2026