커뮤니티 통합 사용하기

개요

커뮤니티에서 Datadog Agent용으로 개발한 통합은 Datadog integrations-extra 깃허브 저장소에 저장됩니다. Agent 패키지로 제공되지는 않으나, 애드온으로 설치할 수는 있습니다.

구성

신규 사용자의 경우, Datadog Agent의 최신 버전을 다운로드해 설치하시기 바랍니다.

설치

사용하는 Agent 버전을 선택하세요.

    Agent v7.21 / v6.21 이상인 경우:

    1. 다음 명령어를 실행해 Agent 통합을 설치하세요.

      datadog-agent integration install -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>

    2. 통합을 코어 통합과 유사하게 설정하세요.

    3. Agent를 다시 시작합니다.

    참조: 필요한 경우 설치 명령어에 sudo -u dd-agent 접두어를 덧붙이세요.

    커뮤니티 통합과 도커(Docker) Agent를 사용할 때는 설치된 통합으로 Agent를 빌드하시길 권장합니다. 다음의 Dockerfile을 사용해, integrations-extras에서 <INTEGRATION_NAME>을 포함하도록 업데이트된 버전의 Agent를 빌드하세요

    FROM gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>

    agent integration install 명령어는 도커 내부에서 실행되며 Error loading config: Config File "datadog" Not Found in "[/etc/datadog-agent]": warn라는 경고 메시지를 표시합니다. 이 경고는 무해하므로 무시할 수 있습니다.

    새 Agent 이미지와 자동탐지를 함께 사용해 <INTEGRATION_NAME>를 활성화합니다.

    Agent v7.21 / v6.21 이하의 경우:

    1. integrations-extra 저장소에서 <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/ 폴더 내의 파일을 다운로드합니다.
    2. <INTEGRATION_NAME>.py 및 기타 파이썬(Python) 파일을 Agent checks.d 디렉터리에 위치시킵니다.
    3. Agent 설정 디렉터리에 새 <INTEGRATION_NAME>.d/ 폴더를 만듭니다.
    4. <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/data/ 폴더에서 conf.yaml.example 파일을 만든 디렉터리에 위치시킵니다.
    5. 파일의 이름을 conf.yaml로 바꿉니다.
    6. 통합을 코어 통합과 유사하게 설정하세요.
    7. Agent를 다시 시작합니다.

    참고 자료

    Additional helpful documentation, links, and articles:

    Agent 트러블슈팅설명서 more more 새로운 통합(Integration)을 생성하기설명서 more more