Comment puis-je résoudre les erreurs d'autorisation courantes pour une instance EC2 sur laquelle CloudWatch est installé ?
Je souhaite résoudre les erreurs d'autorisation courantes pour Amazon CloudWatch sur une instance Amazon Elastic Compute Cloud (Amazon EC2).
Brève description
Les erreurs d'autorisation CloudWatch les plus courantes sur une instance Amazon EC2 sont présentées ci-dessous :
- Rôles AWS Identity and Access Management (IAM) non attachés
- Autorisations manquantes dans les rôles IAM attachés
- Aucun accès aux points de terminaison de service CloudWatch
- États d'association de profils bloqués
- Informations d'identification incorrectement configurées
- Impossible de récupérer les informations de métadonnées
- Bundles de certificats manquants
Résolution
Rôles IAM non rattachés
Si vous avez des rôles IAM non attachés, le message d'erreur suivant peut s'afficher dans le fichier journal CloudWatch amazon-cloudwatch-agent.log :
« Failed to get credential from session: NoCredentialProviders: no valid providers in chain caused by: EnvAccessKeyNotFound: failed to find credentials in the environment. »
Pour exécuter l'agent CloudWatch, assurez-vous que votre instance est correctement associée à un rôle IAM. Utilisez la politique gérée AWS CloudWatchAgentServerPolicy pour créer le rôle IAM requis pour que chaque serveur exécute l'agent CloudWatch. Si l'agent envoie des journaux à CloudWatch Logs et que vous souhaitez définir des politiques de conservation des groupes de journaux, ajoutez l'autorisation Logs:PutRetentionPolicy au rôle.
Pour plus d'informations, consultez la section Créer des rôles et des utilisateurs IAM à utiliser avec l'agent CloudWatch.
Autorisations manquantes dans les rôles IAM attachés
Assurez-vous que les rôles IAM attachés contiennent les autorisations suivantes pour l'agent CloudWatch :
"Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData", "ec2:DescribeVolumes", "ec2:DescribeTags", "logs:PutLogEvents", "logs:DescribeLogStreams", "logs:DescribeLogGroups", "logs:CreateLogStream", "logs:CreateLogGroup", "logs:PutRetentionPolicy", "xray:PutTraceSegments", "xray:PutTelemetryRecords", "xray:GetSamplingRules", "xray:GetSamplingTargets", "xray:GetSamplingStatisticSummaries" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ssm:GetParameter" ], "Resource": "arn:aws:ssm:*:*:parameter/AmazonCloudWatch-*" } ] }
Aucun accès aux points de terminaison de service CloudWatch
La connexion aux points de terminaison de service peut être établie via une connexion Internet ou via des points de terminaison Amazon Virtual Private Cloud (Amazon VPC). Pour transmettre des métriques et des journaux, l'agent CloudWatch doit maintenir la connectivité avec des points de terminaison de service CloudWatch spécifiques.
- Pour les métriques, l'agent CloudWatch doit être connecté aux points de terminaison des services https://ec2.example-region.amazonaws.com et https://monitoring.example-region.amazonaws.com.
- Pour les journaux, l'agent CloudWatch doit être connecté au point de terminaison de service https://logs.example-region.amazonaws.com.
Si vous n'avez pas accès aux points de terminaison de service CloudWatch, le message d'erreur suivant ou similaire peut s'afficher dans le fichier journal amazon-cloudwatch-agent.log: de l'agent CloudWatch :
« 2023-12-30T02:56:37Z W! {"caller":"ec2tagger/ec2tagger.go:485","msg":"ec2tagger: Unable to describe ec2 tags for initial retrieval","kind":"processor","name":"ec2tagger","pipeline":"metrics/host","error":"RequestError: send request failed\caused by: Post \"https://ec2.us-west-1.amazonaws.com/\": dial tcp 176.32.118.30:443: i/o timeout"} »
Pour envoyer des métriques depuis une instance Amazon EC2 qui n'a pas de connexion, configurez une passerelle NAT ou créez un point de terminaison Amazon VPC. Si vous créez un point de terminaison de VPC Amazon, assurez-vous de tester la connectivité. En outre, pour chaque zone de disponibilité qui accède à CloudWatch, sélectionnez un sous-réseau.
Remarque : Si vous configurez une passerelle NAT ou créez un point de terminaison Amazon VPC, des frais supplémentaires sont facturés. Pour plus d'informations, consultez la section Tarification AWS PrivateLink et Tarification Amazon VPC.
États d'association de profils bloqués
Les états d'association de profils bloqués se produisent lorsque vous mettez à jour un profil d'instance et qu'un rôle se dissocie alors qu'un autre rôle est associé. Si l'ancien rôle n'est pas complètement dissocié, les états d'association de votre profil sont bloqués.
Pour répertorier les associations pour l'instance, exécutez la commande suivante :
Remarque : Remplacez example-instance-id par l'ID d'instance requis et example-region par la région AWS requise.
$ aws ec2 describe-iam-instance-profile-associations --filters Name=instance-id,Values=example-instance-id --region example-region
Exemple de sortie :
{ "IamInstanceProfileAssociations": [ { "AssociationId": "iip-assoc-aaaaaaaaa", "InstanceId": "i-08c9a2ccvssdfgge", "IamInstanceProfile": { "Arn": "arn:aws:iam::1234567890:instance-profile/CloudWatch_Monitoring", "Id": "AIPAdddddsgggggg" }, "State": "disassociating" }, { "AssociationId": "iip-assoc-bbbbbbb", "InstanceId": "i-08c9a2ccvssdfgge", "IamInstanceProfile": { "Arn": "arn:aws:iam::1234567890:instance-profile/Grafana", "Id": "AIPA3gggdddddddgg" }, "State": "associating" } ] }
Pour résoudre les états d'association de profils bloqués, utilisez la console de gestion AWS ou l'interface de ligne de commande AWS (AWS CLI).
Utiliser la console de gestion AWS
Utiliser l'AWS CLI
Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes AWS CLI, consultez la section Résoudre les erreurs de l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.
-
Dissociez toutes les associations une par une. Exécutez la commande suivante pour chaque association que vous souhaitez dissocier.
Remarque : Remplacez example-association-id par l'ID d'association que vous souhaitez dissocier.$ aws ec2 disassociate-iam-instance-profile --association-id example-association-id -
Répertoriez les associations pour le profil d'instance afin de vous assurer que toutes les associations requises sont dissociées :
Remarque : Remplacez example-instance-id par l'ID d'instance requis et example-region par la région AWS requise.$ aws ec2 describe-iam-instance-profile-associations --filters Name=instance-id,Values=example-instance-id --region example-region -
Attacher le profil IAM :
Remarque : Remplacez example-instance-id par l'ID d'instance requis et example-profile-name par le nom de profil requis.aws ec2 associate-iam-instance-profile \ --instance-id example-instance-id \ --iam-instance-profile Name=example-profile-name
Informations d'identification incorrectement configurées
L'agent CloudWatch recherche les types d'informations d'identification suivants dans l'ordre :
- env
- assume-role
- assume-role-with-web-identity
- sso
- shared-credentials-file
- custom-process
- config-file
- ec2-credentials-file
- boto-config
- container-role
- iam-role
Remarque : Les informations d’identificationiam-role figurent en dernier dans la liste des accès recherchés par l'agent CloudWatch. Si d'autres types d’informations d’identification sont trouvés avant iam-role, les informations d’identificationiam-role ne sont pas utilisées.
Pour vérifier quelles informations d’identification sont utilisées, exécutez la commande suivante sur l'instance :
$ aws sts get-caller-identity --debug
Pour résoudre le problème de non-utilisation des informations d’identificationiam-role, associez la politique appropriée aux informations d’identification détectées ou supprimez les informations d’identification détectées. Lorsque vous supprimez les informations d'identification détectées, les informations d'identification iam-role deviennent les informations d'identification principales.
Impossible de récupérer les informations de métadonnées
Si l'agent CloudWatch ne parvient pas à récupérer les informations de métadonnées, il se peut que l’erreur EC2MetadataError s’affiche dans le fichier journal amazon-cloudwatch-agent.log. Pour résoudre cette erreur, procédez de la manière suivante :
Vérifier l'accessibilité des métadonnées
-
Pour vérifier l'accessibilité des métadonnées, exécutez les commandes suivantes :
```bash curl http://169.254.169.254/latest/meta-data/iam/security-credentials curl http://169.254.169.254/latest/meta-data/identity-credentials/ec2/security-credentials/ec2-instance curl http://169.254.169.254/latest/meta-data/identity-credentials/ec2/security-credentials curl http://169.254.169.254/latest/meta-data ``` -
Pour différentes versions de métadonnées, exécutez les commandes suivantes :
IMDSv1 :wget -q -O - http://169.254.169.254/latest/meta-data/instance-id curl http://169.254.169.254/IMDSv2 :
TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \ && curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://169.254.169.254/latest/meta-data/
Vérifier les paramètres réseau
Vérifiez les tables de routage pour déterminer qu'aucun itinéraire n'a été créé pour l'adresse IP des métadonnées 169.254.169.254 :
-
Pour Linux, exécutez les commandes suivantes :
Vérifier les tables de routage au niveau du noyau du système d'exploitation :sudo route -n netstat -rn ip route listVérifier le pare-feu :
sudo iptables -LSi un itinéraire est manquant, ajoutez-en un à la table de routage au niveau du noyau :
Remarque : Remplacez example-gateway par la passerelle requise.sudo ip route add 169.254.169.254 via <example-gateway> -
Pour Windows, exécutez les commandes suivantes :
Vérifier les tables de routage :ipconfig /all route printSi un itinéraire est manquant, ajoutez les itinéraires statiques :
Remarque : Remplacez example-gateway par l'adresse IP de passerelle requise.route -p ADD 169.254.169.251 MASK 255.255.255.255 <gateway-ip> route -p ADD 169.254.169.250 MASK 255.255.255.255 <example-gateway> route -p ADD 169.254.169.254 MASK 255.255.255.255 <example-gateway> route -p ADD 169.254.169.249 MASK 255.255.255.255 <example-gateway> route -p ADD 169.254.169.123 MASK 255.255.255.255 <example-gateway> route -p ADD 169.254.169.253 MASK 255.255.255.255 <example-gateway>
Vérifier la limite de saut de réponse PUT pour IMDS
Par défaut, le paramètre HttpPutResponseHopLimit est défini sur 1. Cela permet au paquet d'être transféré par un seul routeur ou saut et à la requête de rester sur le réseau local de l'instance. Si les scénarios suivants sont présents, ajustez la limite de saut :
- Si vos requêtes IMDS passent par plusieurs sauts réseau, ajustez votre HttpPutResponseHopLimit.
- Si vous utilisez des systèmes d'orchestration de conteneurs sur des instances Amazon EC2 et que des sauts supplémentaires sont introduits pour les requêtes vers le service de métadonnées, ajustez la limite de saut. Ajustez la limite de saut afin que les conteneurs puissent toujours accéder à IMDS.
- Si vous transférez ou acheminez des requêtes via des chemins réseau spécifiques à des fins d'inspection ou de journalisation, ajustez votre limite de saut.
- Si des problèmes de réseau entraînent des pannes lorsque vous accédez à IMDS, ajustez la limite de saut à des fins de diagnostic. Assurez-vous de revenir à la valeur limite de saut une fois le dépannage terminé.
Vérifier les paramètres de proxy
Les paramètres de proxy peuvent interférer avec la capacité de l'agent CloudWatch à récupérer les informations relatives aux métadonnées. Si un proxy est configuré, mettez à jour le fichier common-config.toml avec les valeurs de proxy appropriées.
Exemples de paramètres de proxy :
```toml [proxy] # http_proxy = "{example-http-url}" # https_proxy = "{example-https-url}" no_proxy = "169.254.169.254"
Vérifier la compatibilité de la version avec IMDSv2
Les versions antérieures à la version 1.23 de l'agent CloudWatch ne prennent pas en charge IMDSv2. Si vous exécutez une ancienne version de l'agent CloudWatch, mettez-le à jour avec la dernière version.
Pour vérifier la version de votre agent CloudWatch, exécutez les commandes suivantes :
Pour Linux :
```bash sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a status ```
Pour Windows :
```powershell & $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status ```
Vérifier si l'agent CloudWatch suppose qu'il fonctionne sur site
Si l'agent CloudWatch est installé sur les conteneurs Docker Amazon EC2 et ne parvient pas à récupérer les informations de métadonnées, l'agent suppose qu'il s'exécute sur site. Le message d'erreur suivant peut s'afficher :
« 2023/05/19 11:43:50 I! access ECS task metadata fail with response unable to get response from http://169.254.170.2/v2/metadata, error: Get "http://169.254.170.2/v2/metadata": context deadline exceeded (Client.Timeout exceeded while awaiting headers), assuming I'm not running in ECS.
I! Detected the instance is OnPremise »
Cette erreur se produit lorsque l'agent CloudWatch essaie de localiser les informations d'identification dans /root/.aws/credentials sur une machine Linux et qu'il y a un délai d'attente. Ce délai se produit lorsque l'agent tente de se connecter à l'adresse IP du point de terminaison des métadonnées pour Amazon Elastic Container Service (Amazon ECS) au lieu d'Amazon EC2. Pour résoudre ce problème, effectuez l'une des opérations suivantes :
- Utilisez la version complète de l'agent CloudWatch installé sur le système d'exploitation sous-jacent. Cela vous permet de contourner la configuration du cluster.
- Utilisez l'option OnPremise de l'agent CloudWatch dans CloudWatch Container Insights et assurez-vous que les informations d'identification AWS correctes sont fournies. Cela empêche les appels de métadonnées vers le point de terminaison Amazon ECS.
Bundles de certificats manquants
Lorsque le bundle de certificats n'inclut pas le certificat racine Amazon nécessaire, le client Amazon EC2 rencontre des problèmes de confiance. L'erreur suivante peut s'afficher dans le fichier journal de l'agent CloudWatch :
"caused by: Post "https://ec2.ca-central-1.amazonaws.com/": x509: certificate signed by unknown authority, metrics will be dropped until it got fixed 2023-08-08T17:24:10Z E! refresh EC2 Instance Tags failed: RequestError: send request failed caused by: Post "https://ec2.ca-central-1.amazonaws.com/": x509: certificate signed by unknown authority, metrics will be dropped until it got fixed 2023-08-08T17:34:10Z E! refresh EC2 Instance Tags failed: RequestError: send request failed caused by: Post "https://ec2.ca-central-1.amazonaws.com/": x509: certificate signed by unknown authority, metrics will be dropped until it got fixed"
Pour inspecter les bundles de certificats, exécutez les commandes suivantes :
-
Pour Linux, les certificats sont stockés dans /etc/ssl/certs/. Pour inspecter le principal bundle de certificats, exécutez la commande suivante :
``bash cat /etc/ssl/certs/ca-certificates.crt `` -
Pour les applications qui possèdent leurs propres certificats, exécutez la commande suivante :
Remarque : Remplacez example-region par la région AWS requise.``bash curl --cacert /path/to/ca-bundle.crt -Iv https://ec2.example-region.amazonaws.com/ `` -
Pour Windows, les certificats sont gérés via la console de gestion Microsoft (MMC). Pour accéder à la console MMC depuis un ordinateur Windows, appuyez simultanément sur la touche avec l'icône Windows et la touche R. Lorsque l'invite apparaît, saisissez mmc, puis sélectionnez Entrée.
Remarque : Si le certificat racine Amazon est manquant, ajoutez-le au bundle de certificats de votre système ou de votre application.
- Balises
- Amazon EC2Amazon CloudWatch
- Langue
- Français

Contenus pertinents
demandé il y a 2 ans
demandé il y a 3 ans
demandé il y a 4 ans
demandé il y a 4 ans
AWS OFFICIELA mis à jour il y a 8 mois