IBM Cloud Docs
Utilizzo dell'agent Docker

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:

  1. Ottenere la chiave di accesso. Per ulteriori informazioni, vedi Ottenimento della chiave di accesso tramite l'IU IBM Cloud.

  2. Ottenere l'ingestione pubblica o privata URL. Per ulteriori informazioni, vedi Endpoint del raccoglitore.

  3. 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
    
  4. 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:

  1. Interrompere il contenitore dell'agente di monitoraggio. Esegui il seguente comando:

    docker stop sysdig-agent
    
  2. Rimuovere il contenitore dell'agente di controllo. Esegui il seguente comando:

    docker rm sysdig-agent
    
  3. Scarica l'ultima versione dell'agente di monitoraggio. Esegui il seguente comando:

    docker pull sysdig/agent
    
  4. Installare l'agent. Ulteriori informazioni.

Rimozione dei contenitori dell'agent di monitoraggio

Completare la seguente procedura per rimuovere un agente di controllo distribuito:

  1. Interrompere il contenitore dell'agente di monitoraggio.

    Esegui il seguente comando:

    docker stop sysdig-agent
    
  2. Rimuovere i riferimenti al contenitore dell'agent di monitoraggio.

    docker rm sysdig-agent