본문 바로가기
WIKI 기술 지식 베이스

IoT Agent

원문 보기 위키 갱신

리소스가 제한된 환경을 위해 최적화된 Datadog IoT Agent로 IoT 디바이스와 임베디드 애플리케이션을 모니터링하는 방법을 설명해 드릴게요. 일반 Agent와 달리 가벼운 풋프린트를 갖추고 있어 디지털 디스플레이부터 이미지 감지 알고리즘을 실행하는 보안 디바이스까지 다양한 기기를 감시할 수 있어요.

출처: 문서

본문

개요

Datadog IoT Agent는 IoT 디바이스와 임베디드 애플리케이션을 모니터링하도록 최적화된 Agent 버전이에요. 고객들은 디지털 디스플레이부터 이미지 감지 알고리즘을 실행하는 보안 디바이스까지 다양한 디바이스를 모니터링하기 위해 IoT Agent를 사용해요.

기능

IoT Agent에는 다음 시스템 체크가 포함되어 있어요. IoT 디바이스의 구성은 다른 유형의 호스트와 동일해요.

또한 IoT Agent는 다음도 지원해요:

반면 IoT Agent에는 표준 Agent에 번들로 제공되는 Python 인터프리터와 다른 통합들이 포함되어 있지 않아요. APM용 트레이싱, 라이브 프로세스 모니터링, Cloud Network Monitoring도 지원하지 않아요.

설정

요구 사항

IoT Agent는 x64, arm64(ARMv8), ARMv7 아키텍처에서 실행되는 Linux 디바이스용 DEB, RPM 패키지로 제공돼요.

리소스

IoT 디바이스는 일반적으로 클라우드 인프라 호스트보다 리소스 제약이 커요. IoT Agent는 최소 풋프린트를 갖추고 최소한의 네트워크 대역폭만 사용하도록 설계되었어요.

정확한 리소스 요구 사항은 사용량에 따라 달라져요. Datadog이 IoT Agent(v7.20)를 내부적으로 테스트했을 때 발견한 결과는 다음과 같아요:

  • CPU: 0.5% (2 Intel Xeon VCPU가 있는 VM 기준)
  • 메모리: 36 MB
  • 네트워크 대역폭: 업로드 237 bps / 다운로드 79 bps
  • 디스크: 63 MB

설치

자동 설치

운영 체제와 칩셋 아키텍처에 맞는 IoT Agent를 자동으로 다운로드해 설치하려면 다음 명령을 사용하세요:

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

DEB

Debian 기반 운영 체제에 IoT Agent를 수동으로 설치하려면 다음 명령을 실행하세요:

  1. apt를 업데이트하고 HTTPS 다운로드를 위한 apt-transport-https, 서명 키를 얻기 위한 curl, gnupg를 설치하세요:

    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 사이트를 <YOUR_DATADOG_SITE>로 설정하세요. 기본값은 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

RPM 기반 운영 체제에 IoT Agent를 수동으로 설치하려면 다음 명령을 실행하세요:

  1. 시스템에 Datadog의 Yum 리포지토리를 설정하기 위해 /etc/yum.repos.d/datadog.repo를 다음 내용으로 생성하세요:

    [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/

  1. 로컬 yum 리포지토리를 업데이트하고 Agent를 설치하세요:

    sudo yum makecache
sudo yum install datadog-iot-agent

  2. 예제 구성 파일을 복사하고 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"

  3. Datadog 사이트를 <YOUR_DATADOG_SITE>로 설정하세요. 기본값은 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"

  4. IoT Agent를 시작하세요:

    sudo systemctl restart datadog-agent.service

CLI

IoT Agent는 표준 Agent와 동일한 CLI 명령어를 지원해요.

제거

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

더 알아보기 (Learn more)