Amazon Linux 用 Agent の基本的な使用方法

概要

このページでは、Amazon Linux 用 Datadog Agent の基本的な機能について説明します。Agent をまだインストールしていない場合は、Datadog Agent インテグレーションに関するドキュメントで手順を参照してください。

64-bit x86 および Arm v8 アーキテクチャ用のパッケージをご用意しています。その他のアーキテクチャについては、ソースインストールをご利用ください。

コマンド

Agent v6 & v7 では、オペレーティングシステムから提供されるサービスマネージャーが Agent のライフサイクルを担う一方で、他のコマンドは Agent バイナリから直接実行する必要があります。Agent v5 では、ほぼすべてがサービスマネージャーによって実行されます。

Amazon Linux 2、Amazon Linux 2022/2023

Amazon Linux 2022/2023 を Agent バージョン <= 6.39/7.39 でインストールする場合、libxcrypt-compat パッケージが必要です。このパッケージをインストールするには、
dnf install -y libxcrypt-compat
を実行してください。
説明コマンド
Agent をサービスとして起動sudo systemctl start datadog-agent
サービスとして実行中の Agent の停止sudo systemctl stop datadog-agent
サービスとして実行中の Agent の再起動sudo systemctl restart datadog-agent
Agent サービスのステータスsudo systemctl status datadog-agent
実行中の Agent のステータスページsudo datadog-agent status
フレアの送信sudo datadog-agent flare
コマンドの使用方法の表示sudo datadog-agent --help
チェックの実行sudo -u dd-agent -- datadog-agent check <CHECK_NAME>

Amazon Linux

説明コマンド
Agent をサービスとして起動sudo start datadog-agent
サービスとして実行中の Agent の停止sudo stop datadog-agent
サービスとして実行中の Agent の再起動sudo restart datadog-agent
Agent サービスのステータスsudo status datadog-agent
実行中の Agent のステータスページsudo datadog-agent status
フレアの送信sudo datadog-agent flare
コマンドの使用方法の表示sudo datadog-agent --help
チェックの実行sudo -u dd-agent -- datadog-agent check <CHECK_NAME>
説明コマンド
Agent をサービスとして起動sudo service datadog-agent start
サービスとして実行中の Agent の停止sudo service datadog-agent stop
サービスとして実行中の Agent の再起動sudo service datadog-agent restart
Agent サービスのステータスsudo service datadog-agent status
実行中の Agent のステータスページsudo service datadog-agent info
フレアの送信sudo service datadog-agent flare
コマンドの使用方法の表示sudo service datadog-agent
チェックの実行sudo -u dd-agent -- dd-agent check <CHECK_NAME>

: ご使用のシステムで service ラッパーを使用できない場合は、以下を使用してください。

  • upstart ベースのシステムの場合: sudo start/stop/restart/status datadog-agent
  • systemd ベースのシステムの場合: sudo systemctl start/stop/restart/status datadog-agent

[サービスライフサイクルコマンドについては、こちらを参照してください][2]。

コンフィギュレーション

Agent の構成ファイルおよびフォルダーの場所:

  • /etc/datadog-agent/datadog.yaml

インテグレーション用構成ファイルの場所

  • /etc/datadog-agent/conf.d/

Agent の構成ファイルおよびフォルダーの場所

  • /etc/dd-agent/datadog.conf

インテグレーション用構成ファイルの場所

  • /etc/dd-agent/conf.d/

Agent のアンインストール

sudo yum remove datadog-agent

このコマンドでは、Agent は削除されますが以下は削除されません。

  • datadog.yaml コンフィギュレーションファイル
  • /etc/datadog-agent コンフィギュレーションフォルダ内のユーザー作成ファイル
  • /opt/datadog-agent フォルダ内のユーザー作成ファイル
  • dd-agent ユーザー
  • Datadog ログファイル

以上の要素も削除したい場合は、Agent 削除後に次のコマンドを実行します。

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/
sudo yum remove datadog-agent

このコマンドでは、Agent は削除されますが以下は削除されません。

  • datadog.yaml コンフィギュレーションファイル
  • /etc/dd-agent コンフィギュレーションフォルダ内のユーザー作成ファイル
  • /opt/datadog-agent フォルダ内のユーザー作成ファイル
  • dd-agent ユーザー
  • Datadog ログファイル

以上の要素も削除したい場合は、Agent 削除後に次のコマンドを実行します。

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/dd-agent/ \
&& sudo rm -rf /var/log/datadog/

ヘルプ

Agent のトラブルシューティングに関するドキュメントを参照してください。

埋め込み Agent の使用

Agent には、埋め込み Python 環境が /opt/datadog-agent/embedded/ に含まれています。pythonpip などの共通バイナリは /opt/datadog-agent/embedded/bin/ に含まれています。

詳細については、埋め込み Agent へのパッケージの追加方法の手順を参照してください。

その他の参考資料