View a markdown version of this page

Configura il componente aggiuntivo per strumenti di monitoraggio di terze parti - Amazon CloudWatch

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura il componente aggiuntivo per strumenti di monitoraggio di terze parti

È possibile configurare il componente aggiuntivo Network Flow Monitor per esporre un OpenMetrics server durante l'installazione. Ciò consente l'integrazione con strumenti di monitoraggio di terze parti come Prometheus, consentendo di raccogliere e analizzare le metriche del flusso di rete insieme all'infrastruttura di monitoraggio esistente. Scopri di più su. OpenMetrics Questa funzionalità è disponibile a partire dalla versione aggiuntiva v1.1.0.

Per abilitare il OpenMetrics server, aggiungi OPEN_METRICS, OPEN_METRICS_ADDRESS e OPEN_METRICS_PORT ai valori di configurazione del componente aggiuntivo EKS Network Flow Monitor. Questa guida spiegherà come eseguire questa operazione utilizzando sia la CLI che la Console. Consulta la configurazione avanzata dei componenti aggiuntivi di Amazon EKS per ulteriori dettagli sull'aggiunta di valori di configurazione.

Configurazione CLI

Quando si utilizza AWS Command Line Interface, è possibile fornire i valori di configurazione come parametro:

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}}'

Configurazione della console

Quando si utilizza la console Amazon EKS, questi valori possono essere aggiunti in Impostazioni di configurazione opzionali, come parte dei valori di configurazione.

JSON di esempio:

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

YAML di esempio:

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

Parametri aggiuntivi EKS Network Flow Monitor OpenMetric

  • OPEN_METRICS:

    • Abilita o disabilita le metriche aperte. Disabilitato se non fornito

    • Tipo: String

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

  • INDIRIZZO_OPEN_METRICS:

    • Indirizzo IP di ascolto per l'endpoint open metrics. Il valore predefinito è 127.0.0.1 se non fornito

    • Tipo: String

  • OPEN_METRICS_PORT:

    • Porta di ascolto per open metrics endpoint. Il valore predefinito è 80 se non fornito

    • Tipo: numero intero

    • Intervallo: [0.. 65535]

Importante: quando si imposta OPEN_METRICS_ADDRESS su 0.0.0.0, l'endpoint delle metriche sarà accessibile da qualsiasi interfaccia di rete. Prendi in considerazione l'utilizzo di 127.0.0.1 per l'accesso solo su localhost o implementa controlli di sicurezza di rete appropriati per limitare l'accesso solo ai sistemi di monitoraggio autorizzati.

Risoluzione dei problemi

Se riscontri problemi con la configurazione del OpenMetrics server, utilizza le seguenti informazioni per diagnosticare e risolvere i problemi più comuni.

Le metriche non vengono visualizzate

Problema: il OpenMetrics server è configurato, ma le metriche non vengono visualizzate nello strumento di monitoraggio.

Procedure per la risoluzione dei problemi:

  1. Verifica che il OpenMetrics server sia abilitato nella configurazione del componente aggiuntivo:

  2. Testa direttamente l'endpoint delle metriche:

    • Accedi alle metriche su http://pod-ip:port/metrics (sostituisci pod-ip con l'indirizzo IP e la porta effettivi del pod con la porta configurata).

    • Se non riesci ad accedere all'endpoint, verifica la configurazione di rete e le impostazioni del gruppo di sicurezza.

  3. Convalida la configurazione dello strumento di monitoraggio. Consulta la guida utente degli strumenti di monitoraggio per i dettagli su come eseguire le seguenti operazioni:

    • Assicurati che il tuo strumento di monitoraggio (come Prometheus) sia configurato per eseguire lo scraping dell'endpoint corretto.

    • Verifica che le impostazioni dell'intervallo di scraping e del timeout siano appropriate.

    • Verifica che il tuo strumento di monitoraggio disponga dell'accesso di rete all'indirizzo IP del pod.

Metriche mancanti nei pod specifici

Problema: le metriche sono disponibili in alcuni pod ma non in altri del cluster.

Procedure per la risoluzione dei problemi:

L'add-on Network Flow Monitor non supporta i pod che utilizzano HostNetwork: true. Se le specifiche del tuo pod includono questa impostazione, le metriche non saranno disponibili per quei pod.

Soluzione alternativa: rimuovi l'impostazione HostNetwork: true dalle specifiche del pod, se possibile. Se hai bisogno di una rete host per la tua applicazione, valuta la possibilità di utilizzare approcci di monitoraggio alternativi per quei pod specifici.

Errori di connessione rifiutata

Problema: ricevi errori di «connessione rifiutata» quando provi ad accedere all'endpoint delle metriche.

Procedure per la risoluzione dei problemi:

  1. Verifica la configurazione OPEN_METRICS_ADDRESS:

    • Se impostato su 127.0.0.1, l'endpoint è accessibile solo dall'interno del pod.

    • Se impostato su 0.0.0.0, l'endpoint dovrebbe essere accessibile da altri pod nel cluster.

    • Assicurati che il tuo strumento di monitoraggio possa raggiungere l'indirizzo configurato.

  2. Controlla la configurazione OPEN_METRICS_PORT:

    • Verificate che il numero di porta non sia già utilizzato da un altro servizio.

    • Assicurati che la porta rientri nell'intervallo valido (1-65535).

    • Verifica che eventuali gruppi di sicurezza o policy di rete consentano il traffico su questa porta.

Fasi di verifica

Per confermare che la OpenMetrics configurazione funzioni correttamente:

  1. Controlla lo stato del componente aggiuntivo:

    aws eks describe-addon --cluster-name your-cluster-name --addon-name aws-network-flow-monitoring-agent
  2. Verifica lo stato del pod:

    kubectl get pods app.kubernetes.io/name=aws-network-flow-monitoring-agent
  3. Testa l'endpoint delle metriche dall'interno del cluster:

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

    Sostituisci 9109 con il numero di porta configurato e il nome del pod con un AddOn nome pod.