Linux

概要

このページでは、Linux 環境用の Datadog Agent の基本的な機能を説明します。サポートされている Linux ディストリビューションとバージョンの完全なリストについては、サポートされているプラットフォーム のドキュメントを参照してください。

Agent のインストール

Linux に Agent をインストールするには、Fleet Automation のアプリ内手順 に従い、生成されたスクリプトをホストで実行してください。

Linux ホストに Datadog Agent をインストールするためのアプリ内の手順。

Agent の構成

Datadog Agent 構成ファイルは /etc/datadog-agent/datadog.yaml にあります。この YAML ファイルには、Datadog にデータを送信するために使用されるホスト全体の次のような接続情報が含まれています。

  • api_key: 自分の組織の Datadog API キー
  • site: ターゲットの Datadog リージョン (例: datadoghq.com、datadoghq.eu、ddog-gov.com、us2.ddog-gov.com)
  • proxy: アウトバウンドトラフィック用の HTTP/HTTPS プロキシエンドポイント (Datadog Agent プロキシ構成 を参照)
  • デフォルトのタグ、ログレベル、および Datadog 構成

/etc/datadog-agent/datadog.yaml.example にある完全にコメント化されたリファレンスファイルには、比較やコピーアンドペーストに使用できるすべてのオプションがリストされています。または、GitHubにあるLinux用Agent設定ファイルの例をご覧ください。

インテグレーションファイル

インテグレーション用の構成ファイルは /etc/datadog-agent/conf.d/ にあります。各インテグレーションにサブディレクトリ <INTEGRATION>.d/ があり、次のものが含まれています。

  • conf.yaml: インテグレーションがメトリクスとログを収集する方法を制御するアクティブな構成
  • conf.yaml.example: サポートされているキーとデフォルトを示すサンプル

コマンド

説明コマンド
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>

注: CentOS/RHEL 6 や SUSE 11 などの upstart ベースのシステムでは、systemctl <action> を <action> に置き換えてください。たとえば、SUSE 11 システムで Agent をサービスとして起動する場合は、sudo start datadog-agent を使用します。

Agent のアンインストール

Agent をアンストールするには、該当する Linux 環境のコマンドを実行してください。

CentOS、Rocky、AlmaLinux、Amazon Linux、Oracle Linux、および Red Hat の場合

sudo yum remove datadog-agent

Debian、Ubuntu の場合

sudo apt-get remove datadog-agent -y

SUSE の場合

sudo zypper 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/

Debian および Ubuntu の残りの Agent アーティファクトをアンインストールするには、次のコマンドを実行します。

sudo apt-get remove --purge datadog-agent -y

Single Step APM Instrumentation のアンインストール

Single Step APM Instrumentation と一緒に Agent をインストールしていて、それをアンインストールする場合は、APM Instrumentation を削除するために 追加のコマンドを実行 する必要があります。自分の環境 に該当する手順を実行してください。

トラブルシューティング

詳細な手順については、Agent のトラブルシューティング を参照してください。

埋め込み Agent の使用

Agent には /opt/datadog-agent/embedded/ に埋め込まれた Python 環境が含まれています。python や pip などの一般的なバイナリは、/opt/datadog-agent/embedded/bin/ に含まれています。

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

参考資料

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

ログの収集ドキュメント more more プロセスの収集ドキュメント more more トレースの収集ドキュメント more more Agent のアーキテクチャを詳しく見るドキュメント more more インバウンドポートの構成ドキュメント more more