Docker 에이전트와 함께 일하기

IBM Cloud에서 IBM Cloud Monitoring 서비스의 인스턴스를 프로비저닝한 후 지원되는 호스트에서 Monitoring 에이전트를 두 개의 Docker 컨테이너로 배치하여 데이터 및 메트릭을 자동으로 수집할 수 있습니다. 사용자는 각 환경에서 모니터할 메트릭을 구성할 수 있습니다.

하나 이상의 태그를 각 모니터링 에이전트에 연관시킬 수 있습니다. 태그는 TAG_NAME:TAG_VALUE 형식의 쉼표로 구분된 값입니다. 환경을 모니터할 때 이러한 태그를 사용하여 에이전트에서 사용 가능한 메트릭을 식별할 수 있습니다. 예를 들어, 이 에이전트가 수집하는 모든 메트릭과 함께 서비스 이름과 위치에 대한 정보를 포함할 수 있습니다.

Docker 의 두 컨테이너로 모니터링 에이전트 배포하기

Linux 의 호스트에서 모니터링 에이전트를 표준 Docker 컨테이너로 직접 구성할 때, 모니터링 에이전트를 올바르게 실행하기 위해 외부 리눅스 헤더를 설치해야 할 수도 있습니다.

예를 들어 다음 명령을 실행하여 외부 linux 헤더를 설치해야 합니다.

apt-get -y install linux-headers-$(uname -r)
  • 명령을 사용하여 *...-linuxkituname -r를 리턴하는 컨테이너와 MacOS를 사용할 때 호환되지 않을 가능성이 큽니다.

Docker 컨테이너 두 개에 모니터링 에이전트를 구성하여 메트릭스를 수집하고 IBM Cloud Monitoring 서비스의 인스턴스로 전달하려면 다음 단계를 완료하십시오

  1. 액세스 키를 가져오십시오. 자세한 정보는 IBM Cloud UI를 통해 액세스 키 가져오기를 참조하십시오.

  2. 공용 또는 사설 수집 URL을 가져오십시오. 자세한 정보는 콜렉터 엔드포인트를 참조하십시오.

  3. 모니터링 에이전트를 배치하십시오. 다음 명령을 실행하십시오.

    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. 모니터링 에이전트를 실행하십시오.

    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

    여기서,

    • MONITORING_ACCESS_KEY는 인스턴스에 대한 수집 키입니다.

    • COLLECTOR_ENDPOINT는 모니터링 인스턴스가 사용 가능한 지역에 대한 공용 또는 사설 수집 URL입니다. 엔드포인트를 가져오려면 콜렉터 엔드포인트를 참조하십시오.

    • TAG_DATA는 TAG_NAME:TAG_VALUE 형식의 쉼표로 구분된 태그입니다. 하나 이상의 태그를 모니터링 에이전트에 연관시킬 수 있습니다. 예를 들어, role:serviceX,location:us-south입니다.

컨테이너는 분리 모드에서 실행됩니다. 컨테이너의 출력을 보려면 -d를 제거하십시오.

CLI를 사용하여 에이전트 버전 확인

에이전트 버전을 확인하려면 다음 명령을 실행하십시오.

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

CLI를 사용하여 에이전트 상태 확인

에이전트 상태를 확인하려면 다음 명령을 실행하십시오.

docker ps | grep sysdig-agent

docker ps -a를 실행하면 실행 중인 컨테이너를 모두 볼 수 있습니다.

실행 중인 컨테이너 목록이 표시됩니다. 이름이 sysdig-agent 인 컨테이너가 나열되는지 확인하십시오.

에이전트 로그 찾기

에이전트 로그를 보려면 다음 명령을 실행하십시오

docker logs sysdig-agent

에이전트의 로그 보기

오류를 찾기 위해 다음 명령을 실행하여 로그를 볼 수 있습니다.

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

Docker 에이전트 업데이트

Linux 시스템에 컨테이너로 배포된 모니터링 에이전트를 제거하려면 다음 단계를 완료하십시오

  1. 모니터링 에이전트 컨테이너를 중지하십시오. 다음 명령을 실행하십시오.

    docker stop sysdig-agent

  2. 모니터링 에이전트 컨테이너를 제거하십시오. 다음 명령을 실행하십시오.

    docker rm sysdig-agent

  3. 최신 버전의 모니터링 에이전트를 가져오십시오. 다음 명령을 실행하십시오.

    docker pull sysdig/agent

  4. 에이전트를 설치하십시오. 자세히 알아보십시오.

모니터링 에이전트 컨테이너 제거

배치된 모니터링 에이전트를 제거하려면 다음 단계를 완료하십시오.

  1. 모니터링 에이전트 컨테이너를 중지하십시오.

    다음 명령을 실행하십시오.

    docker stop sysdig-agent

  2. 모니터링 에이전트 컨테이너에 대한 참조를 제거하십시오.

    docker rm sysdig-agent