콘텐츠로 이동

Docker 설치¶

DataWay 데이터 게이트웨이 주소 선택¶

DataWay는 Guance의 데이터 게이트웨이로, 수집기가 Guance에 데이터를 보고하려면 반드시 DataWay 게이트웨이를 거쳐야 합니다.

컨테이너 방식으로 DataKit 설치¶

sudo docker run \
    --hostname "$(hostname)" \
    --workdir /usr/local/datakit \
    --name datakit-docker \
    -v "/host/conf/dir":"/usr/local/datakit/conf.d/host-inputs-conf" \
    -v "/":"/rootfs" \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -e ENV_DATAWAY="https://openway.guance.com?token=tkn_7f5********fda8681" \
    -e ENV_GLOBAL_HOST_TAGS="" \
    -e ENV_HTTP_LISTEN="0.0.0.0:9529" \
    -e HOST_PROC="/rootfs/proc" \
    -e HOST_SYS="/rootfs/sys" \
    -e HOST_ETC="/rootfs/etc" \
    -e HOST_VAR="/rootfs/var" \
    -e HOST_RUN="/rootfs/run" \
    -e HOST_DEV="/rootfs/dev" \
    -e HOST_ROOT="/rootfs" \
    --cpus 2 \
    --memory 1g \
    --privileged \
    --publish 9529:9529 \
    -d \
    pubrepo.guance.com/datakit/datakit:1.86.2

설치 단계에서 설치 명령에 환경 변수를 추가하여 일부 DataKit 구성을 정의할 수 있습니다.

추가 환경 변수 확인

일반 구성¶

호스트 머신 디렉터리 선택. 예: /host/conf/dir
호스트 머신 포트 선택. 예: 9529
DataKit 이름 정의. 예: datakit-docker
설치할 DataKit 버전 선택 (배포 플랜인 경우 지정 필요)
전역 호스트 태그 추가, 여러 태그는 쉼표로 구분. 예: host=datakit_hostname
활성화할 수집기 지정, 기본적으로 일부 호스트 관련 수집기가 활성화됩니다. 예: cpu, mem, disk

실제 사용자 모니터링(RUM) & HTTP¶

DataKit HTTP 서비스 주소 구성 (❗️RUM 기능을 사용하는 경우 공개 네트워크에서 접근 가능한 주소로 구성해야 함). 예: localhost
RUM 수집기 활성화 여부 선택
IP 지리 정보 데이터베이스 설치 여부 선택
DataKit 404 페이지 비활성화 여부 선택

애플리케이션 성능 모니터링(APM)¶

DDTrace 수집기 활성화 여부 선택

DCA¶

DCA 서비스 활성화 여부 선택

DataKit 사용¶

설치가 완료되면 다음 명령을 실행하여 DataKit 실행 상태를 확인할 수 있습니다:

docker exec -it <컨테이너 이름 또는 컨테이너 ID> datakit monitor

컨테이너 실행 매개변수 설명¶

매개변수	설명
`--hostname`	호스트 머신의 호스트 이름을 DataKit 실행 호스트 이름으로 사용, 현재 호스트 머신에서 여러 DataKit을 실행해야 하는 경우 적절한 접미사를 추가할 수 있음, 예: `--hostname "$(hostname)-dk1"`
`--workdir`	컨테이너 작업 디렉터리 설정
`-v`	다양한 호스트 머신 파일 마운트, 컨테이너가 호스트 머신 시스템 리소스에 액세스할 수 있도록 함
`-e`	다양한 DataKit 런타임 환경 변수 구성
`--publish`	외부 Trace 등 데이터 수신을 위해 DataKit 컨테이너의 HTTP 포트(기본 9529)를 호스트 머신에 매핑해야 함. 데이터 전송 주소 구성 시 호스트 머신의 IP와 9529 포트를 지정