Comment puis-je résoudre les problèmes de journalisation dans Amazon EKS ?
Je souhaite résoudre les problèmes qui surviennent lorsque j'active la journalisation dans les clusters Amazon Elastic Kubernetes Service (Amazon EKS).
Résolution
Avant de résoudre le problème, assurez-vous que votre application écrit des journaux.
Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l'AWS CLI.
Vérifier que le réseau est correctement configuré
Vérifiez que la mise en réseau est correctement configurée pour vos sous-réseaux et groupes de sécurité Amazon Virtual Private Cloud (Amazon VPC). Vérifiez les points suivants :
- Si vous utilisez une passerelle Internet, vérifiez qu'elle est correctement associée à la table de routage. Vérifiez également que le trafic réseau entrant ou sortant est correctement acheminé.
- Si vous utilisez une passerelle NAT, vérifiez qu'elle est correctement configurée au sein d'un sous-réseau public. Puis, vérifiez que la table de routage associée est correctement acheminée.
- Si vous disposez d'un cluster privé avec accès Internet limité, assurez-vous que votre cluster utilise le point de terminaison d’interface VPC com.amazonaws.region.logs associé à la politique adéquate.
- Si vous disposez d’un compte de service, vous avez peut-être configuré les pods avec les rôles Gestion des identités et des accès AWS (AWS IAM). S'il n'existe aucun accès Internet sortant, vous devez utiliser le point de terminaison de VPC AWS Security Token Service (AWS STS) com.amazonaws.region.logs dans votre VPC.
- Vous souhaiterez peut-être extraire des images d'un référentiel privé Amazon Elastic Container Registry (Amazon ECR). Si vous ne disposez pas d'une passerelle NAT ou d'un accès Internet sortant, vous avez besoin des points de terminaison de VPC et du point de terminaison de passerelle Amazon Simple Storage Service (Amazon S3) suivants :
com.amazonaws.region-code.s3
com.amazonaws.region-code.ecr.api
com.amazon.region-code.ecr.dkr - Le groupe de sécurité pour votre point de terminaison de VPC doit disposer d’une règle entrante qui autorise le trafic à partir du port 443. Vérifiez également que le groupe de sécurité du nœud autorise le trafic sortant vers les points de terminaison de VPC.
Vérifier que les pods disposent d’autorisations suffisantes
Si vous utilisez des pods dotés de rôles IAM pour les comptes de service, vérifiez que vous avez annoté le compte de service avec le rôle IAM approprié. Puis, vérifiez que vous avez créé le fournisseur IAM OpenID Connect (OIDC) pour le cluster.
Pour vérifier le rôle et les autorisations IAM du compte de service, procédez comme suit :
-
Décrivez le rôle IAM du compte de service, puis vérifiez que l'annotation suivante est présente. Exécutez la commande suivante :
eks.amazonaws.com/role-arn: arn:aws:iam::111122223333:role/YOUR-ROLE-NAMERemarque : Remplacez YOUR-ROLE-NAME par le nom du rôle IAM de votre compte.
-
Vérifiez que le rôle IAM est associé à la politique CloudWatchAgentServerPolicy. Ou bien confirmez qu'il utilise une politique ayant les mêmes autorisations. Si tel n'est pas le cas, assurez-vous que CloudWatchAgentServerPolicy est associé au rôle de nœud.
Résoudre les problèmes de configuration de Fluent Bit
Si vous avez installé le routeur de journaux Fluent Bit, vérifiez que les pods fonctionnent et que le système envoie des journaux à Amazon CloudWatch. Si tel n'est pas le cas, des problèmes peuvent se produire avec vos autorisations IAM ou votre réseau.
Pour résoudre les problèmes liés au déploiement et à la configuration de Fluent Bit, vérifiez les points suivants :
Pour vérifier les pods dans l'espace de noms dans lequel vous avez installé Fluent Bit, exécutez la commande suivante :
kubectl get pods -n NAMESPACE
Remarque : Remplacez NAMESPACE par le nom de votre espace de noms.
Si vos nœuds présentent des teintes, assurez-vous que les pods sont configurés avec les tolérances.
Si les pods se trouvent dans un état autre que EN COURS D’EXÉCUTION, exécutez la commande suivante pour vérifier les événements de pod :
kubectl describe pod POD_NAME -n NAMESPACE
Remarque : Remplacez POD_NAME par le nom de votre pod et NAMESPACE par le nom de votre espace de noms.
Pour vérifier l’absence d’erreurs dans les journaux du pod, exécutez la commande suivante :
kubectl logs POD_NAME -n NAMESPACE
Remarque : Remplacez POD_NAME par le nom de votre pod et NAMESPACE par le nom de votre espace de noms.
Par défaut, le niveau de journalisation de Fluent Bit est défini sur infos. Si vous souhaitez obtenir plus d'informations, configurez-le sur déboguer. Pour plus d'informations, consultez la page Fichier de configuration sur le site Web de Fluent Bit.
Pour afficher vos configurations Fluent Bit ConfigMap, exécutez la commande suivante :
kubectl get cm CONFIGMAP_NAME -n NAMESPACE -o yaml
Remarque : Remplacez CONFIGMAP_NAME par le nom de votre ConfigMap et NAMESPACE par le nom de votre espace de noms.
Vérifiez que le rôle de nœud ou le rôle associé au compte de service dispose des autorisations IAM appropriées en fonction de la destination configurée.
Résoudre les problèmes liés à l'agent CloudWatch
Vérifiez que le rôle IAM dispose des autorisations nécessaires. Si vous utilisez un rôle IAM doté d'un rôle de compte de service, assurez-vous d'avoir créé un fournisseur OIDC ainsi qu'un rôle et une politique IAM. Vérifiez que le compte de service est correctement annoté avec le rôle IAM approprié.
Vérifiez que les pods DaemonSet cloudwatch-agent s’exécutent correctement. Si vos nœuds présentent des teintes, vérifiez que les pods sont configurés avec des tolérances. Pour obtenir la liste de pods, exécutez la commande suivante :
kubectl logs POD_NAME -n amazon-cloudwatch
Remarque : Remplacez POD_NAME par le nom de votre pod.
Si les pods se trouvent dans un état autre que EN COURS D’EXÉCUTION, exécutez le contrôle des événements de pod. Exécutez la commande suivante :
kubectl describe pod POD_NAME -n amazon-cloudwatch
Remarque : Remplacez POD_NAME par le nom de votre pod.
Vérifiez que vous avez correctement défini le nom du cluster dans le ConfigMap. Pour vérifier les journaux des pods, exécutez la commande suivante :
kubectl logs POD_NAME -n amazon-cloudwatch
Remarque : Remplacez POD_NAME par le nom de votre pod.
Si vous utilisez une image publique dans le DaemonSet, assurez-vous que vos nœuds ont accès à Internet. Si vous utilisez une image provenant de votre référentiel privé, vérifiez que le trafic requis est autorisé.
Résoudre les problèmes de journalisation sur un cluster Fargate
Remarque : La journalisation AWS Fargate ne prend pas en charge la configuration dynamique de ConfigMaps. Les modifications ne s'appliquent pas aux pods existants. Aussi, toute modification apportée à ConfigMaps ne s'applique qu'aux nouveaux pods.
Pour vérifier que vous avez créé un espace de noms nommé aws-observability avec l’étiquette aws-observability: enabled, exécutez la commande suivante :
kubectl get ns aws-observability -o yaml
Vérifiez que vous avez spécifié la politique IAM appropriée dans le rôle d'exécution du pod pour votre profil Fargate. Par exemple, si vous souhaitez envoyer des journaux à CloudWatch, assurez-vous que le rôle d'exécution du pod dispose des autorisations suivantes :
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:CreateLogGroup", "logs:DescribeLogStreams", "logs:PutLogEvents", "logs:PutRetentionPolicy" ], "Resource": "*" }] }
Vérifiez que vous avez correctement créé le ConfigMap dans l'espace de noms aws-observability. Vérifiez que le ConfigMap est conforme aux règles utilisées par Fargate pour valider les champs.
Si les journaux de processus Fluent Bit sont manquants, vérifiez que vous avez défini flb_log_cw: "true" dans le ConfigMap.
Résoudre les problèmes liés au module complémentaire CloudWatch Observability dans Amazon EKS
Si le module complémentaire CloudWatch Observability d'Amazon EKS utilise un rôle IAM pour le compte de service, vérifiez que vous avez créé un fournisseur OIDC pour votre cluster. Puis, vérifiez que vous avez configuré le compte de service avec le rôle approprié. La politique CloudWatchAgentServerPolicy doit être associée au rôle.
Si vous avez utilisé la console de gestion AWS pour installer le module complémentaire géré, vérifiez que les pods et le statut du module complémentaire sont actifs dans la console. Si le module complémentaire se trouve dans un état d'échec, vérifiez le motif de l'échec. De même, si vous avez utilisé Helm pour installer le module complémentaire, vérifiez que l'installation de Helm s'est bien déroulée.
Si vous constatez un échec provenant de ressources existantes, il est possible que vous ayez déjà installé les composants requis pour le module complémentaire. Si vous avez déjà installé l'agent CloudWatch, supprimez-le du cluster avant d'installer le module complémentaire. Vous devez également créer une sauvegarde de toutes les personnalisations ou modifications que vous avez apportées à l'agent CloudWatch d'origine avant d'installer le module complémentaire. Vous pouvez réappliquer les personnalisations après avoir installé ou mis à jour le module complémentaire ou le graphique Helm.
Informations connexes
Comment activer les métriques Container Insights sur un cluster Amazon EKS ?
- Sujets
- Containers
- Langue
- Français

Contenus pertinents
demandé il y a 2 ans
demandé il y a 4 ans
demandé il y a 2 ans
demandé il y a 2 ans
AWS OFFICIELA mis à jour il y a 10 mois
AWS OFFICIELA mis à jour il y a un an
AWS OFFICIELA mis à jour il y a 5 ans