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 | 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:
-
Accedi direttamente a dragent.yaml. Il file si trova in
/opt/draios/etc/dragent.yaml. -
Modifica il file. Utilizzare una sintassi YAML valida.
-
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 restartper attivare le modifiche.
| 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 |