개요
Datadog IoT Agent는 IoT 기기와 임베디드 애플리케이션의 모니터링에 최적화된 Agent 버전입니다. IoT Agent를 사용하면 디지털 디스플레이에서 보안 기기에 이르기까지, 이미지 탐지 알고리즘을 실행하는 다양한 기기를 모니터링할 수 있습니다.
기능
IoT Agent에는 다음과 같은 시스템 점검이 포함됩니다. IoT 기기의 설정은 다른 유형의 호스트와 동일합니다.
또한 IoT Agent는 다음을 지원합니다.
IoT Agent는 파이썬(Python) 명령해석기(Interpreter)와 표준 Agent와 사전 패키지화된 기타 통합을 포함하지 않습니다. 또한 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_MAJOR_VERSION=7 DD_AGENT_FLAVOR=datadog-iot-agent bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
수동
데비안(Debian) 기반의 운영 체제에서 IoT Agent를 수동 설치하려면 다음 명령어를 실행하세요.
apt
를 업데이트하고 apt-transport-https
를 설치해 HTTPS로 다운로드하고, curl
과 gnupg
를 설치해 서명 키를 얻습니다.
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
시스템에 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_382E94DE.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
우분투(Ubuntu) 14 이하 또는 데비안(Debian) 8 이하 버전을 실행 중이라면 키링을 /etc/apt/trusted.gpg.d
로 복사하세요.
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
apt
를 업데이트하고 IoT Agent를 설치합니다.
sudo apt-get update
sudo apt-get install datadog-iot-agent datadog-signing-keys
설정 샘플을 복사하고, 적절한 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"
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
IoT Agent 시작하기:
sudo systemctl restart datadog-agent.service
RPM 기반의 운영 체제에서 IoT Agent를 수동 설치하려면 다음 명령어를 실행하세요.
다음의 콘텐츠로 /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_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/
로컬 Yum 저장소를 업데이트하고 Agent를 설치하세요.
sudo yum makecache
sudo yum install datadog-iot-agent
설정 샘플을 복사하고, 적절한 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"
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
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
참고 자료
Additional helpful documentation, links, and articles: