Trabalhando com o agente Docker

Depois de provisionar uma instância do serviço IBM Cloud Monitoring no IBM Cloud, é possível implementar o agente Monitoring como dois contêineres do Docker em hosts suportados para coletar dados e métricas automaticamente. É possível configurar quais métricas devem ser monitoradas em cada ambiente.

É possível associar uma ou mais tags a cada agente de monitoramento. As tags são valores separados por vírgula formatados como TAG_NAME:TAG_VALUE. Ao monitorar seu ambiente, é possível usar essas tags para identificar as métricas que estão disponíveis em um agente. Por exemplo, é possível incluir informações sobre o nome do serviço e o local com todas as métricas que são coletadas por esse agente.

Implantação de um agente de monitoramento como dois contêineres Docker

Quando você configura um agente de monitoramento diretamente em um host Linux como contêineres Docker padrão, talvez seja necessário instalar cabeçalhos externos do Linux para iniciar o agente de monitoramento corretamente.

Por exemplo, talvez seja necessário executar o comando a seguir para instalar cabeçalhos linux externos:

apt-get -y install linux-headers-$(uname -r)

Observe que quando você usa um MacOS com um contêiner que retorna ...-linuxkit com o comando uname -r, é muito provável que ele não seja compatível.

Conclua as etapas a seguir para configurar um agente de monitoramento em dois contêineres Docker para coletar e encaminhar métricas a uma instância do serviço IBM Cloud Monitoring:

  1. Obtenha a chave de acesso. Para obter mais informações, consulte Obtendo a chave de acesso por meio da IU da IBM Cloud.

  2. Obtenha a URL de ingestão pública ou privada. Para obter mais informações, consulte terminais do coletor.

  3. Implemente o agente de monitoramento. Execute o comando a seguir:

    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. Execute o agente de monitoramento:

    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

    em que

    • MONITORING_ACCESS_KEY é a chave de ingestão para a instância.

    • COLLECTOR_ENDPOINT é a URL de ingestão pública ou privada para a região na qual a instância de monitoramento está disponível. Para obter um terminal, veja Terminais do coletor.

    • TAG_DATA são tags separadas por vírgula formatadas como TAG_NAME:TAG_VALUE. É possível associar uma ou mais tags ao seu agente de monitoramento. Por exemplo, role:serviceX,location:us-south.

O contêiner é executado no modo separado. Para ver a saída do contêiner, remova -d.

Verificando a versão de um agente usando a CLI

Para verificar a versão de um agente, execute o seguinte comando:

docker exec sysdig-agent /opt/draios/bin/dragent --version

Verificando o status de um agente usando a CLI

Para verificar o status de um agente, execute o seguinte comando:

docker ps | grep sysdig-agent

É possível executar docker ps -a para ver todos os contêineres que estão em execução.

É exibida a lista de contêineres em execução. Verifique se um contêiner com o nome sysdig-agent está listado.

Localizando logs do agente

Para ver os registros do agente, você pode executar o seguinte comando:

docker logs sysdig-agent

Como visualizar os logs de um agente

Para procurar por erros, você pode executar o seguinte comando para visualizar os logs:

docker logs sysdig-agent 2>&1 | grep "error"

Atualização de um agente Docker

Conclua as etapas a seguir para remover o agente de monitoramento que está implantado como um contêiner em um sistema Linux:

  1. Pare o contêiner do agente de monitoramento. Execute o comando a seguir:

    docker stop sysdig-agent

  2. Remova o contêiner do agente de monitoramento. Execute o comando a seguir:

    docker rm sysdig-agent

  3. Obtenha a versão mais recente do agente de monitoramento. Execute o comando a seguir:

    docker pull sysdig/agent

  4. Instale o agente. Saiba mais.

Removendo os contêineres do agente de monitoramento

Conclua as seguintes etapas para remover um agente de monitoramento implementado:

  1. Pare o contêiner do agente de monitoramento.

    Execute o comando a seguir:

    docker stop sysdig-agent

  2. Remova referências ao contêiner do agente de monitoramento.

    docker rm sysdig-agent