IoT Agent

개요

Datadog IoT Agent는 IoT 기기와 임베디드 애플리케이션의 모니터링에 최적화된 Agent 버전입니다. IoT Agent를 사용하면 디지털 디스플레이에서 보안 기기에 이르기까지, 이미지 탐지 알고리즘을 실행하는 다양한 기기를 모니터링할 수 있습니다.

기능

IoT Agent에는 다음과 같은 시스템 점검이 포함됩니다. IoT 기기의 설정은 다른 유형의 호스트와 동일합니다.

또한 IoT Agent는 다음을 지원합니다.

IoT Agent에는 표준 Agent와 함께 사전 패키징된 Python 인터프리터 및 기타 통합 기능이 포함되어 있지 않습니다. 또한 APM, 실시간 프로세스 모니터링 또는 네트워크 성능 모니터링에 대한 추적도 지원하지 않습니다.

구성

요건

IoT Agent는 x64, arm64(ARMv8), ARMv7 아키텍처에서 실행 중인 Linux 기기에 DEB 및 RPM 패키지로 사용할 수 있습니다.

리소스

일반적으로 IoT 기기는 클라우드 인프라스트럭처 호스트보다 리소스의 제한이 많습니다. IoT Agent는 최소한의 풋프린트(Footprint)로, 네트워크 대역폭을 가능한 한 적게 소모하도록 설계되었습니다.

구체적인 리소스 요건은 사용 상황에 따라 달라집니다. Datadog에서 진행한 IoT Agent(v7.20) 내부 테스트에서는 다음과 같은 사항을 알 수 있었습니다.

  • CPU: 0.5% (2 Intel Xeon VCPU를 사용하는 가상 머신(VM))
  • 메모리: 36MB
  • 네트워크 대역폭: 237bps 업 / 79bps 다운
  • 디스크: 63MB

설치

자동

사용 중인 운영 체제와 칩셋 아키텍처에 적합한 IoT Agent를 자동으로 다운로드하여 설치하려면 다음 명령어를 사용하세요.

DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="" DD_AGENT_FLAVOR=datadog-iot-agent bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

수동

데비안(Debian) 기반의 운영 체제에서 IoT Agent를 수동 설치하려면 다음 명령어를 실행하세요.

  1. apt를 업데이트하고 apt-transport-https를 설치해 HTTPS로 다운로드하고, curlgnupg를 설치해 서명 키를 얻습니다.

    sudo apt-get update
    sudo apt-get install apt-transport-https curl gnupg
    
  2. 시스템에 Datadog deb 저장소(리포지터리)를 구성하고 Datadog의 APT 키를 내보내기합니다.

    sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable 7' > /etc/apt/sources.list.d/datadog.list"
    sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
    
    curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    curl https://keys.datadoghq.com/DATADOG_APT_KEY_06462314.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    
  3. 우분투(Ubuntu) 14 이하 또는 데비안(Debian) 8 이하 버전을 실행 중이라면 키링을 /etc/apt/trusted.gpg.d로 복사하세요.

    sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
    
  4. apt를 업데이트하고 IoT Agent를 설치합니다.

    sudo apt-get update
    sudo apt-get install datadog-iot-agent datadog-signing-keys
    
  5. 설정 샘플을 복사하고, 적절한 API 키를 지정합니다.

    DD_API_KEY=<YOUR_DD_API_KEY> ; sudo sh -c "sed 's/api_key:.*/api_key:$DD_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  6. Datadog 사이트를 로 설정합니다. 기본 설정은 datadoghq.com입니다.

    sudo sh -c "sed 's/# site:.*/site: <YOUR_DD_SITE>/' /etc/datadog-agent/datadog.yaml > /etc/datadog-agent/datadog.yaml.new && mv /etc/datadog-agent/datadog.yaml.new /etc/datadog-agent/datadog.yaml
    
  7. IoT Agent 시작하기:

    sudo systemctl restart datadog-agent.service
    

RPM 기반의 운영 체제에서 IoT Agent를 수동 설치하려면 다음 명령어를 실행하세요.

  1. 다음의 콘텐츠로 /etc/yum.repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 저장소를 구성합니다.

    [datadog]
    name = Datadog, Inc.
    baseurl = https://yum.datadoghq.com/stable/7/<HOST_ARCHITECTURE>
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_4F09D16B.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    

    참조: dnf에 버그가 발생하고 있으므로, RHEL/CentOS 8.1에서는 repo_gpgcheck=1 대신 repo_gpgcheck=0을 사용해주세요.

    baseurl는 호스트 OS에 따라 결정됩니다.

    • x86_64 - https://yum.datadoghq.com/stable/7/x86_64/
    • arm64 - https://yum.datadoghq.com/stable/7/aarch64/
    • ARMv7 - https://yum.datadoghq.com/stable/7/armv7hl/
  2. 로컬 Yum 저장소를 업데이트하고 Agent를 설치하세요.

    sudo yum makecache
    sudo yum install datadog-iot-agent
    
  3. 설정 샘플을 복사하고, 적절한 API 키를 지정합니다.

    DD_API_KEY=<YOUR_DD_API_KEY> ; sudo sh -c "sed 's/api_key:.*/api_key:$DD_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  4. Datadog 사이트를 로 설정합니다. 기본은 datadoghq.com입니다.

    sudo sh -c "sed 's/# site:.*/site: <YOUR_DD_SITE>/' /etc/datadog-agent/datadog.yaml > /etc/datadog-agent/datadog.yaml.new && mv /etc/datadog-agent/datadog.yaml.new /etc/datadog-agent/datadog.yaml
    
  5. IoT Agent 시작하기:

    sudo systemctl restart datadog-agent.service
    

CLI

IoT Agent는 동일한 CLI 명령어를 표준 Agent로 지원합니다.

삭제

sudo apt-get remove datadog-iot-agent -y

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

  • datadog.yaml 설정 파일
  • /etc/datadog-agent 설정 폴더에서 사용자가 생성한 파일
  • /opt/datadog-agent 폴더에서 사용자가 생성한 파일
  • dd-agent 사용자

이러한 요소까지 삭제하고자 하시는 분은 다음의 명령어를 사용하세요.

sudo apt-get remove --purge datadog-iot-agent -y

참고 자료

추가 유용한 문서, 링크 및 기사:

PREVIEWING: may/unit-testing