Personalizzare gli agent di controllo Linux

Per impostazione predefinita, l'agent di monitoraggio raccoglie i dati da una serie di piattaforme e applicazioni. È possibile modificare il file di configurazione dell'agent per modificarne il comportamento predefinito e includere o escludere i dati. È possibile personalizzare il file di configurazione dell'agente di monitoraggio per includere metriche personalizzate come JMX, StatsD, e Prometheus. È anche possibile filtrare metriche e contenitori.

L'agent di monitoraggio utilizza due file di configurazione che specificano quali dati raccogliere automaticamente:

file di configurazione dell'agente di monitoraggio
File Descrizione Posizione
dragent.default.yaml File di configurazione principale
IMPORTANTE: non modificare questo file.
/opt/draios/etc/dragent.default.yaml
dragent.yaml File di configurazione modificato per personalizzare l'agent di monitoraggio. /opt/draios/etc/dragent.yaml

È possibile modificare il file dragent.yaml per personalizzare i dati raccolti. Le modifiche diventano effettive immediatamente dopo il salvataggio del file. L'agent rileva la modifica e riavvia automaticamente. È possibile trovare la frequenza e i file che un agent di monitoraggio controlla nel file dragent.default.yaml.

Ad esempio, dragent.default.yaml include le seguenti informazioni:

check_frequency_s: 5
files:
- /opt/draios/etc/dragent.yaml
- /opt/draios/etc/kubernetes/config/dragent.yaml
- /opt/draios/etc/kubernetes/secrets/access-key

Modifica del file yaml dragent

Il file yaml viene memorizzato in /opt/draios/etc/.

Completare la seguente procedura per modificare il file e applicare le modifiche:

  1. Accedi direttamente a dragent.yaml. Il file si trova in /opt/draios/etc/dragent.yaml.

  2. Modifica il file. Utilizzare una sintassi YAML valida.

  3. Riavviare l'agent. Esegui il seguente comando:

    service dragent restart
    

Porte di blocco

Per bloccare il traffico di rete e le metriche dalle porte di rete, devi personalizzare la sezione blacklisted_ports nel file dragent.yaml. È necessario elencare le porte da cui si desidera filtrare i dati.

Nota: la porta 53 (DNS) è sempre nella blacklist.

Ad esempio, il seguente esempio mostra come impostare la sezione blacklisted_ports di un agent di monitoraggio per escludere i dati provenienti dalle porte 6666 e 6379:

blacklisted_ports:
    - 6666
    - 6379

Inclusione ed esclusione delle metriche

Per filtrare le metriche personalizzate, devi personalizzare la sezione metrics_filter nel file dragent.yaml. È possibile specificare quali metriche includere e quali filtrare configurando i parametri di filtro include e exclude.

Nota: l'ordine delle regole di filtraggio viene impostato come segue: viene applicata la prima regola che corrisponde a una metrica.

Ad esempio, se la sezione metrics_filter di un agent di monitoraggio è simile alla seguente:

metrics_filter:
  - include: metricA.*
  - exclude: metricA.*
  - include: metricB.*
  - include: haproxy.backend.*
  - exclude: haproxy.*
  - exclude: metricC.*
  • Si sta configurando l'agente di monitoraggio per raccogliere tutti i dati dalle metriche che iniziano con metricA, metricB e haproxy.backend
  • Stai filtrando le metriche che iniziano con metricC e altre metriche che iniziano con haproxy.
  • La voce exclude: metricA.* viene ignorata.

Modifica del livello di log

Per configurare il livello di log, devi modificare la sezione log nel file dragent.yaml.

L'agent di monitoraggio genera voci di log in /opt/draios/logs/draios.log.

  • Il file di log ruota quando raggiunge la dimensione di 10MB.
  • Vengono conservati i 10 file di log più recenti. La data / ora aggiunta al nome file viene utilizzata per stabilire quali file conservare.
  • I livelli di log validi sono: nessuno, errore, avvertenza, info, debug, traccia
  • Il livello di log predefinito è info, dove viene creata una voce per ogni trasmissione di metriche aggregate ai server di backend, una volta al secondo, oltre alle voci per eventuali avvertenze ed errori.
  • È possibile modificare il tipo di log e le voci raccolte configurando il file di configurazione dell'agent di monitoraggio /opt/draios/etc/dragent.yaml. Dopo aver modificato il file, è necessario riavviare l'agent nella shell con service dragent restart per attivare le modifiche.
Voci della sezione Log
Casi di utilizzo Voce della sezione di log
Risoluzione dei problemi relativi al comportamento dell'agent file_priority: debug
Riduci output console contenitore console_priority: warning
Filtro degli eventi per severità event_priority: warning
Verificare quali metriche sono incluse o escluse metrics_excess_log: true