Utilizzo dell'agent Docker
Dopo aver eseguito il provisioning di un servizio IBM Cloud Monitoring nel IBM Cloud, puoi distribuire l'agent Monitoring come due contenitori Docker negli host supportati per raccogliere dati e metriche automaticamente. È possibile configurare quali metriche monitorare in ciascun ambiente.
È possibile associare uno o più tag a ciascun agente di monitoraggio. I tag sono valori separati da virgole formattati come NOME_TAG:VALORE_TAG. Quando si monitora l'ambiente, è possibile utilizzare questi tag per identificare le metriche disponibili da un agente. Ad esempio, è possibile includere informazioni sul nome del servizio e sulla posizione con tutte le metriche raccolte da questo agente.
Distribuzione di un agent di monitoraggio come due contenitori Docker
Quando si configura un agent di monitoraggio direttamente su un host Linux come contenitori Docker standard, potrebbe essere necessario installare intestazioni linux esterne per avviare correttamente l'agent di monitoraggio.
Ad esempio, potrebbe essere necessario eseguire il seguente comando per installare le intestazioni linux esterne:
apt-get -y install linux-headers-$(uname -r)
Nota che quando utilizzi un MacOS con un contenitore che restituisce ... - linuxkit con il comando uname -r
, molto probabilmente non è compatibile.
Completare i seguenti passaggi per configurare un agente di monitoraggio su due container di Docker per raccogliere e inoltrare le metriche a un'istanza del servizio IBM Cloud Monitoring:
-
Ottenere la chiave di accesso. Per ulteriori informazioni, vedi Ottenimento della chiave di accesso tramite l'IU IBM Cloud.
-
Ottenere l'ingestione pubblica o privata URL. Per ulteriori informazioni, vedi Endpoint del raccoglitore.
-
Distribuire l'agente di controllo. Esegui il seguente comando:
docker run -it --privileged --rm --name sysdig-agent-kmodule \ -v /usr:/host/usr:ro \ -v /boot:/host/boot:ro \ -v /lib/modules:/host/lib/modules \ quay.io/sysdig/agent-kmodule
-
Eseguire l'agent di monitoraggio:
docker run -d --name sysdig-agent \ --restart always \ --privileged \ --net host \ --pid host \ -e ACCESS_KEY=[MONITORING_ACCESS_KEY] \ -e COLLECTOR=[COLLECTOR_ENDPOINT] \ [-e TAGS=[TAG_DATA]] -v /var/run/docker.sock:/host/var/run/docker.sock \ -v /dev:/host/dev \ -v /proc:/host/proc:ro \ -v /boot:/host/boot:ro \ --shm-size=512m \ quay.io/sysdig/agent-slim
Dove
-
MONITORING_ACCESS_KEY è la chiave di inserimento dell'istanza.
-
COLLECTOR_ENDPOINT è l' URL e di ingestione pubblico o privato per la regione in cui è disponibile l'istanza di monitoraggio. Per ottenere un endpoint, vedi Endpoint raccoglitore.
-
TAG_DATA sono tag separate da virgole formattate come TAG_NAME: TAG_VALUE. È possibile associare uno o più tag al proprio agente di monitoraggio. Ad esempio, role:serviceX,location:us-south.
-
Il contenitore funziona in modalità staccata. Per vedere l'output del contenitore, rimuovere -d.
Verifica della versione di un agent utilizzando la CLI
Per controllare la versione di un agente, eseguire il seguente comando:
docker exec sysdig-agent /opt/draios/bin/dragent --version
Controllo dello stato di un agent utilizzando la CLI
Per controllare lo stato di un agente, eseguire il seguente comando:
docker ps | grep sysdig-agent
Puoi eseguire docker ps -a
per visualizzare tutti i contenitori in esecuzione.
Viene visualizzato l'elenco dei contenitori in esecuzione. Verificare che sia elencato un container con nome sysdig-agent
.
Ricerca dei log dell'agente
Per vedere i log dell'agent, è possibile eseguire il seguente comando:
docker logs sysdig-agent
Visualizzazione dei log di un agente
Per cercare gli errori, puoi eseguire il seguente comando per visualizzare i log:
docker logs sysdig-agent 2>&1 | grep "error"
Aggiornamento di un agente di Docker
Completare la seguente procedura per eliminare l'agente di controllo distribuito come contenitore in un sistema Linux:
-
Interrompere il contenitore dell'agente di monitoraggio. Esegui il seguente comando:
docker stop sysdig-agent
-
Rimuovere il contenitore dell'agente di controllo. Esegui il seguente comando:
docker rm sysdig-agent
-
Scarica l'ultima versione dell'agente di monitoraggio. Esegui il seguente comando:
docker pull sysdig/agent
-
Installare l'agent. Ulteriori informazioni.
Rimozione dei contenitori dell'agent di monitoraggio
Completare la seguente procedura per rimuovere un agente di controllo distribuito:
-
Interrompere il contenitore dell'agente di monitoraggio.
Esegui il seguente comando:
docker stop sysdig-agent
-
Rimuovere i riferimenti al contenitore dell'agent di monitoraggio.
docker rm sysdig-agent