To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.
To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.
概要
このチェックは、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 のサポートチームまでお問合せください。