Passer au contenu

Comment puis-je résoudre les erreurs d'autorisation courantes pour une instance EC2 sur laquelle CloudWatch est installé ?

Lecture de 11 minute(s)
0

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

  1. Détachez le rôle IAM de l'instance.
  2. Rattachez le rôle IAM à l’instance.

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.

  1. 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
  2. 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
  3. 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 list

    Vérifier le pare-feu :

    sudo iptables -L

    Si 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 print

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

AWS OFFICIELA mis à jour il y a 3 ans