概要
Datadog IoT Agent は、IoT デバイスおよび埋め込み型アプリケーションの監視に最適化された、Agent の バージョンです。IoT Agent を使用すると、デジタルディスプレイからセキュリティデバイスまで、画像検知アルゴリズムを実行するさまざまなデバイスを監視することができます。
機能
IoT Agent には、以下のシステムチェックが含まれています。IoT デバイスのコンフィギュレーションは、ほかのタイプのホストの場合と同様です。
さらに、IoT Agent は以下にも対応します。
IoT Agent には、Python インタープリターおよび標準 Agent にパッケージ化されているその他のインテグレーションは含まれません。また、APM のトレース、ライブプロセスモニタリング、ネットワークパフォーマンスモニタリングもサポートしていません。
セットアップ
要件
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="" DD_AGENT_FLAVOR=datadog-iot-agent bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.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_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
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_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/
ローカルの 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 は、標準 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
その他の参考資料