IoT Agent

概要

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 を手動でインストールするには、以下のコマンドを実行します。

    1. apt を更新し、apt-transport-https をインストールして 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 サイトを に設定します。デフォルトは 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 は、標準 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

    その他の参考資料

    お役に立つドキュメント、リンクや記事:

    Agent の概要DOCUMENTATION more more