View a markdown version of this page

Configuration d'un module complémentaire pour les outils de surveillance tiers - Amazon CloudWatch
Configuration de la CLIConfiguration de la consoleOpenMetric Paramètres du module complémentaire EKS Network Flow MonitorRésolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration d'un module complémentaire pour les outils de surveillance tiers

Vous pouvez configurer le module complémentaire Network Flow Monitor pour exposer un OpenMetrics serveur lors de l'installation. Cela permet l'intégration à des outils de surveillance tiers tels que Prometheus, ce qui vous permet de collecter et d'analyser des mesures de flux réseau parallèlement à votre infrastructure de surveillance existante. En savoir plus sur OpenMetrics. Cette fonctionnalité est disponible à partir de la version complémentaire v1.1.0.

Pour activer le OpenMetrics serveur, ajoutez OPEN_METRICS, OPEN_METRICS_ADDRESS et OPEN_METRICS_PORT aux valeurs de configuration du module complémentaire EKS Network Flow Monitor. Ce guide explique comment procéder à l'aide de la CLI et de la console. Consultez la section Configuration avancée des modules complémentaires Amazon EKS pour plus de détails sur l'ajout de valeurs de configuration.

Configuration de la CLI

Lors de l'utilisation AWS Command Line Interface, vous pouvez fournir les valeurs de configuration en tant que paramètre :

aws eks create-addon \
  --cluster-name my-cluster-name \
  --addon-name aws-network-flow-monitoring-agent \
  --addon-version v1.1.0-eksbuild.1 \
  --configuration-values '{"env":{"OPEN_METRICS":"on","OPEN_METRICS_ADDRESS":"0.0.0.0","OPEN_METRICS_PORT":9109}}'

Configuration de la console

Lorsque vous utilisez la console Amazon EKS, ces valeurs peuvent être ajoutées sous Paramètres de configuration facultatifs, dans le cadre des valeurs de configuration.

Exemple de JSON : 

{
    "env": {
        "OPEN_METRICS": "on",
        "OPEN_METRICS_ADDRESS": "0.0.0.0",
        "OPEN_METRICS_PORT": 9109
    }
}

Exemple de YAML : 

env:
  OPEN_METRICS: "on"
  OPEN_METRICS_ADDRESS: "0.0.0.0"
  OPEN_METRICS_PORT: 9109

OpenMetric Paramètres du module complémentaire EKS Network Flow Monitor

  • OPEN_METRICS :

    • Activez ou désactivez les métriques ouvertes. Désactivé s'il n'est pas fourni

    • Type : Chaîne

    • Valeurs : ["on », « off"]

  • ADRESSE OPEN_METRICS_ADDRESS :

    • Adresse IP d'écoute pour le point de terminaison Open Metrics. La valeur par défaut est 127.0.0.1 si elle n'est pas fournie

    • Type : Chaîne

  • OPEN_METRICS_PORT :

    • Port d'écoute pour le point de terminaison Open Metrics. La valeur par défaut est 80 si elle n'est pas fournie

    • Type : Integer

    • Plage : [0.. 65535]

Important : lorsque vous définissez OPEN_METRICS_ADDRESS sur 0.0.0.0, le point de terminaison des métriques sera accessible depuis n'importe quelle interface réseau. Envisagez d'utiliser 127.0.0.1 pour l'accès à l'hôte local uniquement ou mettez en œuvre des contrôles de sécurité réseau appropriés pour restreindre l'accès aux seuls systèmes de surveillance autorisés.

Résolution des problèmes

Si vous rencontrez des problèmes de configuration du OpenMetrics serveur, utilisez les informations suivantes pour diagnostiquer et résoudre les problèmes courants.

Les métriques ne s'affichent pas

Problème : le OpenMetrics serveur est configuré, mais les métriques n'apparaissent pas dans votre outil de surveillance.

Étapes de résolution des problèmes :

  1. Vérifiez que le OpenMetrics serveur est activé dans la configuration de votre module complémentaire :

    • Vérifiez que OPEN_METRICS est réglé sur « activé » dans vos valeurs de configuration. Voir describe-addon.

    • Vérifiez que la version du module complémentaire est la v1.1.0 ou ultérieure dans les paramètres Configurer les modules complémentaires sélectionnés.

  2. Testez directement le point de terminaison des métriques :

    • Accédez aux métriques sur http ://pod-ip:port/metrics (remplacez pod-ip par l'adresse IP réelle du pod et le port par votre port configuré).

    • Si vous ne pouvez pas accéder au terminal, vérifiez la configuration de votre réseau et les paramètres de votre groupe de sécurité.

  3. Validez la configuration de votre outil de surveillance. Consultez le guide d'utilisation de vos outils de surveillance pour plus de détails sur les opérations suivantes :

    • Assurez-vous que votre outil de surveillance (tel que Prometheus) est configuré pour récupérer le bon terminal.

    • Vérifiez que l'intervalle de grattage et les paramètres de temporisation sont appropriés.

    • Vérifiez que votre outil de surveillance dispose d'un accès réseau à l'adresse IP du pod.

Métriques manquantes dans des pods spécifiques

Problème : les métriques sont disponibles dans certains pods mais pas dans d'autres de votre cluster.

Étapes de résolution des problèmes :

Le module complémentaire Network Flow Monitor ne prend pas en charge les pods qui utilisent HostNetwork : true. Si la spécification de votre pod inclut ce paramètre, les métriques ne seront pas disponibles pour ces pods.

Solution : supprimez le paramètre HostNetwork : true de la spécification de votre pod si possible. Si vous avez besoin d'un réseau hôte pour votre application, envisagez d'utiliser d'autres approches de surveillance pour ces pods spécifiques.

Erreurs de connexion refusée

Problème : le message d'erreur « connexion refusée » s'affiche lorsque vous tentez d'accéder au point de terminaison des métriques.

Étapes de résolution des problèmes :

  1. Vérifiez la configuration OPEN_METRICS_ADDRESS :

    • S'il est défini sur 127.0.0.1, le point de terminaison n'est accessible que depuis le pod.

    • S'il est défini sur 0.0.0.0, le point de terminaison doit être accessible depuis les autres pods du cluster.

    • Assurez-vous que votre outil de surveillance peut atteindre l'adresse configurée.

  2. Vérifiez la configuration OPEN_METRICS_PORT :

    • Vérifiez que le numéro de port n'est pas déjà utilisé par un autre service.

    • Assurez-vous que le port se trouve dans la plage valide (1-65535).

    • Vérifiez que tous les groupes de sécurité ou politiques réseau autorisent le trafic sur ce port.

Étapes de vérification

Pour vérifier que votre OpenMetrics configuration fonctionne correctement, procédez comme suit :

  1. Vérifiez l'état du module complémentaire :

    aws eks describe-addon --cluster-name your-cluster-name --addon-name aws-network-flow-monitoring-agent

  2. Vérifiez l'état du pod :

    kubectl get pods app.kubernetes.io/name=aws-network-flow-monitoring-agent

  3. Testez le point de terminaison des métriques depuis le cluster :

    kubectl exec add-on-pod-name -- curl localhost:9109/metrics

    Remplacez 9109 par le numéro de port que vous avez configuré et le nom du module par un nom de AddOn module.