概要
このチェックは、Datadog Agent を通じて Speedtest を監視します。
セットアップ
Speedtest チェックは Datadog Agent パッケージに含まれていないため、お客様自身でインストールする必要があります。
インストール
Agent v7.21 / v6.21 以降の場合は、下記の手順に従い Speedtest チェックをホストにインストールします。Docker Agent または 上記バージョン以前の Agent でインストールする場合は、コミュニティインテグレーションの使用をご参照ください。
以下のコマンドを実行して、Agent インテグレーションをインストールします。
datadog-agent integration install -t datadog-speedtest==<INTEGRATION_VERSION>
コアのインテグレーションと同様にインテグレーションを構成します。
注: すべてのホストについて、Speedtest CLI をインストールし、使用前に Datadog Agent ユーザー (例: sudo -u dd-agent speedtest) として契約に同意する必要があります。
構成
Speedtest のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの speedtest.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、speedtest.d/conf.yaml のサンプルを参照してください。
Agent を再起動します。
検証
Agent の statusサブコマンドを実行し、Checks セクションで speedtest を探します。
収集データ
メトリクス
speedtest.ping.jitter
(gauge) | Jitter in milliseconds
Shown as millisecond |
speedtest.ping.latency
(gauge) | Latency in milliseconds
Shown as millisecond |
speedtest.download.bandwidth
(gauge) | Download bandwidth in mebibytes per second
Shown as mebibyte |
speedtest.download.bandwidth.bit_per_sec
(gauge) | Download bandwidth in bits per second
Shown as bit |
speedtest.download.bandwidth.byte_per_sec
(gauge) | Download bandwidth in bytes per second
Shown as byte |
speedtest.download.bytes
(gauge) | Download test payload size in bytes
Shown as byte |
speedtest.download.elapsed
(gauge) | Download test elapsed time in milliseconds
Shown as millisecond |
speedtest.upload.bandwidth
(gauge) | Upload bandwidth in mebibytes per second
Shown as mebibyte |
speedtest.upload.bandwidth.bit_per_sec
(gauge) | Upload bandwidth in bits per second
Shown as bit |
speedtest.upload.bandwidth.byte_per_sec
(gauge) | Upload bandwidth in bytes per second
Shown as byte |
speedtest.upload.bytes
(gauge) | Upload test payload size in bytes
Shown as byte |
speedtest.upload.elapsed
(gauge) | Upload test elapsed time in milliseconds
Shown as millisecond |
speedtest.packet_loss
(gauge) | Percentage of packet loss for this test
Shown as percent |
イベント
Speedtest チェックには、イベントは含まれません。
サービスチェック
speedtest.run
Returns CRITICAL if the check can’t run the test, or OK results available.
Statuses: ok, critical
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問合せください。
