Ping
セキュリティモニタリングが使用可能です セキュリティモニタリングが使用可能です

Ping

Agent Check Agentチェック

Supported OS: Linux Mac OS Windows

概要

このチェックでは、システムの ping コマンドを使用して、ホストの到達可能性をテストします。 また、オプションで、チェックから宛先ホストに送信されるメッセージの往復時間を測定します。

Ping は、インターネット制御メッセージプロトコル(ICMP)エコー要求パケットをターゲットホストに送信し、ICMP エコー応答を待機することで動作します。

ICMP パケットの作成には raw ソケットが必要であり、raw ソケットの作成には Agent にないルート権限が必要であるため、このチェックでは ICMP エコー要求自体を生成するのではなく、システムの ping コマンドを使用します。ping コマンドは、setuid アクセスフラグを使用して昇格した権限で実行し、この問題を回避します。

セットアップ

Ping チェックは Datadog Agent パッケージに含まれていません

インストール

Agent v6.8 以降を使用している場合は、以下の手順に従って、ホストに Ping チェックをインストールしてください。バージョン 6.8 以前の Agent または Docker Agent でチェックをインストールする場合は、コミュニティインテグレーションのインストールに関する Agent のガイドを参照してください。

  1. 開発ツールキットをインストールします。
  2. integrations-extras リポジトリを複製します。

    git clone https://github.com/DataDog/integrations-extras.git
  3. ddev 構成を integrations-extras/ パスで更新します。

    ddev config set extras ./integrations-extras
  4. ping パッケージをビルドします。

    ddev -e release build ping
  5. Datadog Agent をダウンロードして起動します。

  6. 次のコマンドを実行して、Agent でインテグレーション Wheel をインストールします。

    sudo -u dd-agent datadog-agent integration install -w <PATH_OF_PING_ARTIFACT_>/<PING_ARTIFACT_NAME>.whl
  7. 他のパッケージ化されたインテグレーションと同様にインテグレーションを構成します。

コンフィグレーション

  1. ping のパフォーマンスデータの収集を開始するには、Agent の構成ディレクトリのルートにある conf.d/ フォルダーの ping.d/conf.yaml ファイルを編集します。使用可能なすべての構成オプションの詳細については、サンプル ping.d/conf.yaml を参照してください。

  2. Agent を再起動します

検証

Agent の status サブコマンドを実行し、Checks セクションで ping を探します。

収集データ

メトリクス

network.tcp.response_time
(gauge)
The response time of a given host and ping port, tagged with url, e.g. 'host:192.168.1.100'.
Shown as millisecond
network.ping.can_connect
(gauge)
Value of 1 if the agent can successfully communicate with the target host, 0 otherwise

Service Checks

network.ping.can_connect:

Agent がターゲットホストと通信できない場合は、CRITICAL を返します。ping が成功すると、OK を返します。

イベント

Ping チェックには、イベントは含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。