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, che consentono 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 sezione 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 nelle 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: stringa

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

  • INDIRIZZO_METRICO APERTO:

    • Indirizzo IP di ascolto per un endpoint con metriche aperte. Il valore predefinito è 127.0.0.1 se non fornito

    • Tipo: stringa

  • OPEN_METRICS_PORT:

    • Porta di ascolto per endpoint a metrica aperta. Il valore predefinito è 80 se non viene 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 all'host locale o implementa controlli di sicurezza di rete appropriati per limitare l'accesso solo ai sistemi di monitoraggio autorizzati.

Risoluzione dei problemi

Se riscontrate problemi con la configurazione del OpenMetrics server, utilizzate 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.

Passaggi per la risoluzione dei problemi

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

    • Verifica che OPEN_METRICS sia impostato su «on» nei valori di configurazione. Vedi describe-addon.

    • Verifica che la versione del componente aggiuntivo sia v1.1.0 o successiva nelle impostazioni Configura componenti aggiuntivi selezionati.

  2. Testa direttamente l'endpoint delle metriche:

    • Accedi alle metriche su http://pod-ip:port/metrics (sostituisci pod-ip con l'indirizzo IP effettivo del pod e la porta 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 per l'utente degli strumenti di monitoraggio per informazioni dettagliate su come effettuare le seguenti operazioni:

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

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

    • Verifica che lo strumento di monitoraggio abbia accesso di rete all'indirizzo IP del pod.

Parametri mancanti in alcuni pod specifici

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

Passaggi per la risoluzione dei problemi

Il componente aggiuntivo 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, prendi in considerazione l'utilizzo di approcci di monitoraggio alternativi per quei pod specifici.

Errori di connessione rifiutata

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

Passaggi 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 del cluster.

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

  2. Controlla la configurazione OPEN_METRICS_PORT:

    • Verifica 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 il corretto funzionamento della OpenMetrics configurazione:

  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 del pod.