DogStatsD には、アプリケーションから生成されるメトリクスを、転送プロトコルを介して Agent に送信するという機能があります。このプロトコルには UDP (User Datagram Protocol) または UDS (Unix Domain Socket) が使用されます。
DogStatsD を使用して大量のメトリクスを 1 つの Agent に送信する際、適切な措置を講じずに実行すると以下のような問題が発生する場合があります。
- Agent の CPU 使用量の増加
- データグラムやメトリクスのドロップ
- DogStatsD クライアントライブラリ (UDS) により返されるエラー
これらの問題の大半は、以下で説明するようにコンフィギュレーションを調整することで軽減できます。
一般的な方法
Datadog 公式クライアントを使用する
DataDog は、すべての主要なプログラミング言語について、公式 DogStatsD クライアントの最新バージョンを使用することをお勧めします。
クライアント側のバッファリングを有効にする
StatsD や DogStatsD のクライアントが、デフォルトで 1 つのデータグラムごとに 1 つのメトリクスを送信する場合がありますが、これによりクライアントやオペレーティングシステム、そして Agent のオーバーヘッドは非常に高くなります。複数のメトリクスを 1 つのダイアグラムにバッファリングできるようにクライアントを作成し、このオプションを有効にすることで問題を著しく改善できます。
バッファリングをサポートする、コミュニティサポートの DogStatsD クライアントを使用している場合、Agent 側のデータごとのバッファサイズ (デフォルトで 8KB、dogstatsd_buffer_size を使用して Agent で構成可能) およびネットワーク/OS の最大データグラムサイズを超えない最大データグラムサイズを構成するようにしてください。
DogStatsD が公式にサポートするクライアントの例をご紹介します。
デフォルトでは、Datadog の公式 Golang ライブラリ DataDog/datadog-go はバッファリングを使用します。各パケットのサイズとメッセージの数は、UDS と UDP に異なるデフォルト値を使用します。クライアントコンフィギュレーションの詳細については、DataDog/datadog-go を参照してください。
package main
import (
"log"
"github.com/DataDog/datadog-go/v5/statsd"
)
func main() {
// この例では、メトリクスはデフォルトで UDP の正しいデフォルトコンフィギュレーションでバッファリングされます。
statsd, err := statsd.New("127.0.0.1:8125")
if err != nil {
log.Fatal(err)
}
statsd.Gauge("example_metric.gauge", 1, []string{"env:dev"}, 1)
}
以下の例では、Datadog の公式 Python ライブラリ datadogpy を使用して、最小限のパケット数でメトリクスを送信するバッファリングされた DogStatsD クライアントを使用しています。バッファリング機能では、自動フラッシュはパケットサイズ制限および 300ms (構成可能) ごとに実行されます。
from datadog import DogStatsd
# クライアント v0.43.0 以降を使用している場合
dsd = DogStatsd(host="127.0.0.1", port=8125, disable_buffering=False)
dsd.gauge('example_metric.gauge_1', 123, tags=["environment:dev"])
dsd.gauge('example_metric.gauge_2', 1001, tags=["environment:dev"])
dsd.flush() # Optional manual flush
# v0.43.0 より前のクライアントを使用している場合、バッファリングを使用するためにコンテキストマネージャーが必要です
dsd = DogStatsd(host="127.0.0.1", port=8125)
with dsd:
dsd.gauge('example_metric.gauge_1', 123, tags=["environment:dev"])
dsd.gauge('example_metric.gauge_2', 1001, tags=["environment:dev"])
デフォルトでは、Python DogStatsD クライアントインスタンス (
statsd グローバルインスタンスを含む) はプロセス間で共有できませんが、スレッドセーフです。このため、親プロセスと各子プロセスは、クライアントの独自のインスタンスを作成するか、
disable_buffering を
True に設定してバッファリングを明示的に無効にする必要があります。詳細については、
datadog.dogstatsd のドキュメントを参照してください。
以下の例では、Datadog の公式 Ruby ライブラリ [dogstatsd-ruby][1] を使用して、フラッシュがトリガーされたときに 1 つのパケットでメトリクスを送信するバッファー付き DogStatsD クライアントインスタンスを作成します。
require 'datadog/statsd'
statsd = Datadog::Statsd.new('127.0.0.1', 8125)
statsd.increment('example_metric.increment', tags: ['environment:dev'])
statsd.gauge('example_metric.gauge', 123, tags: ['environment:dev'])
# synchronous flush
statsd.flush(sync: true)
以下の例では、Datadog 公認の Java ライブラリである java-dogstatsd-client を使用して、最大のパケットサイズが 1500 バイトのバッファリングされた DogStatsD クライアントインスタンスを作成します。このクライアントインスタンスから送信されるメトリクスはすべてバッファリングされ、最大で 1500 パケット長のパッケージに入れて送信されます。
import com.timgroup.statsd.NonBlockingStatsDClient;
import com.timgroup.statsd.StatsDClient;
import java.util.Random;
public class DogStatsdClient {
public static void main(String[] args) throws Exception {
StatsDClient Statsd = new NonBlockingStatsDClientBuilder()
.prefix("namespace").
.hostname("127.0.0.1")
.port(8125)
.maxPacketSizeBytes(1500)
.build();
Statsd.incrementCounter("example_metric.increment", ["environment:dev"]);
Statsd.recordGaugeValue("example_metric.gauge", 100, ["environment:dev"]);
}
}
以下の例では、Datadog 公認の C# ライブラリである dogstatsd-csharp-client を使用し、UDP で転送を行う DogStatsD クライアントを作成します。
using StatsdClient;
public class DogStatsdClient
{
public static void Main()
{
var dogstatsdConfig = new StatsdConfig
{
StatsdServerName = "127.0.0.1",
StatsdPort = 8125,
};
using (var dogStatsdService = new DogStatsdService())
{
if (!dogStatsdService.Configure(dogstatsdConfig))
throw new InvalidOperationException("Cannot initialize DogstatsD. Set optionalExceptionHandler argument in the `Configure` method for more information.");
// Counter と Gauge は同じデータグラムで送信されます
dogStatsdService.Counter("example_metric.count", 2, tags: new[] { "environment:dev" });
dogStatsdService.Gauge("example_metric.gauge", 100, tags: new[] { "environment:dev" });
}
}
}
以下のコードブロックは、Datadog 公認の PHP ライブラリである php-datadogstatsd を使用し、複数のメトリクスを 1 つのパケットで送信するようバッファリングされた DogStatsD クライアントインスタンスを作成します。
<?php
require __DIR__ . '/vendor/autoload.php';
use DataDog\BatchedDogStatsd;
$client = new BatchedDogStatsd(
array('host' => '127.0.0.1',
'port' => 8125,
)
);
$client->increment('example_metric.increment', array('environment'=>'dev'));
$client->increment('example_metric.increment', $sampleRate->0.5 , array('environment'=>'dev'));
メトリクスのサンプリング
クライアント側でサンプリングレートの値を設定すると、DogStatsD クライアントから Agent へのトラフィックを減らすことができます。たとえば、サンプリングレートを 0.5 にすると、送信される UDP パケットの数が半減します。この方法には、トラフィックが減る代わりに精度や粒度がやや低下するという欠点もあります。
詳しい情報やコードの例が必要な場合は、DogStatsD の「サンプリングレート」パラメータの説明を参照してください。
UDS (Unix Domain Socket) を介した DogStatsD の使用
UDS は DogStatsD ペイロードの転送に使用される、プロセス間通信プロトコルです。UDP と比べてオーバーヘッドが小さく、多くのシステムで DogStatsD のフットプリントを減らすことができます。
クライアント側の集計
クライアントライブラリは、クライアント側でメトリクスを集計し、Datadog Agent に送信しなければならないメッセージの数を減らし、IO パフォーマンスとスループットを向上させることができます。
クライアント側の集計は、v5.0.0 以降の Go クライアントでのみ利用可能です。
詳しくは、クライアント側の集計を参照してください。
クライアント側の集計は、java-dogstatsd-client version 2.11.0 以降で利用でき、version 3.0.0 以降ではデフォルトで有効になっています。
StatsDClient Statsd = new NonBlockingStatsDClientBuilder()
// 通常設定
.enableAggregation(true)
.build();
クライアント側の集計は、ゲージ、カウンター、セットに対して可能です。
詳しくは、クライアント側の集計を参照してください。
クライアント側の集計は DogStatsD C# クライアント v7.0.0 以降で利用可能で、デフォルトで有効になっています。クライアント側の集計はゲージ、カウンター、セットで利用可能です。
var dogstatsdConfig = new StatsdConfig
{
StatsdServerName = "127.0.0.1",
StatsdPort = 8125,
ClientSideAggregation = new ClientSideAggregationConfig()
};
詳しくは、DogStatsD for C# リポジトリをご覧ください。
複数のメトリクス処理パイプラインを実行し、パケットドロップを制限する
DogStatsD サーバーが UDS を使用しており、高いスループットでパケットをドロップしている場合、CPU をより多く使用するように構成することで処理速度を改善し、パケットドロップを減少させることができる場合があります。
また、クライアントテレメトリーがパケットドロップを示し、サーバーが 2 CPU または 2 コア以上使用可能であっても使用しない場合は、DogStatsD サーバーを構成することができます。
パケットドロップを減らすには
- クライアントキューのサイズを
8192 に増やします。詳細については、クライアントライブラリの構成を参照してください。ドロップの量が減少し、アプリケーションがより多くの RAM を使用するようになるかもしれません。 - さらに、Datadog Agent の構成で、
dogstatsd_pipeline_autoadjust: true 機能を有効にすることができます。Agent はカスタムメトリクスの処理に複数のコアを使用するため、CPU 使用率が高くなることがありますが、パケットドロップは少なくなります。
オペレーティングシステムのカーネルバッファ
ほとんどのオペレーティングシステムは、メトリクスを含むデータグラムを UDP や UDS を介して受信し、バッファに追加します。バッファにはサイズ制限があるため、その最大値に達すると、データグラムとその中に含まれるメトリクスがドロップを始めます。この最大値を調整すれば、受信したメトリクスを Agent が処理する時間を増やすことができます。
UDP (User Datagram Protocol) の場合
Linux
ほとんどの Linux ディストリビューションで、カーネル バッファの最大サイズはデフォルトで 212992(208 KB) に設定されています。これを確認するには、次のコマンドを使用します。
$ sysctl net.core.rmem_max
net.core.rmem_max = 212992
DogStatsD ソケットバッファの最大サイズを 25MB に設定するには、次を実行します。
sysctl -w net.core.rmem_max=26214400
これを永続的に変更するには、次のコンフィギュレーションを /etc/sysctl.conf に追加します。
net.core.rmem_max = 26214400
続いて、Agent の dogstatsd_so_rcvbuf コンフィギュレーションオプションを、datadog.yaml 内で同じ数値に設定します。
dogstatsd_so_rcvbuf: 26214400
Kubernetes で Agent または DogStatsD を開発している場合は、Kubernetes の sysctl に関するメモ セクションを参照してください。
UDS (Unix Domain Socket) 経由
Linux
UDS ソケットの場合、リーダーがライターより遅い場合、Linux はキュー内のデータグラムを内部的にバッファリングしています。このキューのサイズは、Linux がソケットごとにバッファリングするデータグラムの最大数を表します。この値は、次のコマンドで照会できます。
sysctl net.unix.max_dgram_qlen
値が 512 未満の場合は、次のコマンドを使用して 512 以上に増やすことができます。
sysctl -w net.unix.max_dgram_qlen=512
これを永続的に変更するには、次のコンフィギュレーションを /etc/sysctl.conf に追加します。
net.unix.max_dgram_qlen = 512
同様に、net.core.wmem_max を 4MiB に増やして、クライアントの書き込みパフォーマンスを向上させることができます。
net.core.wmem_max = 4194304
続いて、Agent の dogstatsd_so_rcvbuf コンフィギュレーションオプションを、datadog.yaml 内で同じ数値に設定します。
dogstatsd_so_rcvbuf: 4194304
Kubernetes の sysctl に関するメモ
Kubernetes を使用して Agent や DogStatsD をデプロイしていて、上記のように sysctl を構成する場合は、コンテナごとに値を設定します。net.* sysctl にネームスペースが設定されている場合は、ポッドごとに設定できます。Kubernetes クラスターでの sysctl の使用に関する Kubernetes のドキュメントを参照してください。
適切なパケットサイズを確保する
適切なサイズのパケットを Datadog Agent の DogStatsD サーバーに送信することにより、余分な CPU 使用を回避します。公式 DogStatsD クライアントの最新バージョンは、パフォーマンスに最適化されたサイズのパケットを送信します。
最新の Datadog DogStatsD クライアントのいずれかを使用している場合は、このセクションをスキップできます。
送信されたパケットが小さすぎる場合、Datadog Agent は複数を一緒にパックして、後でパイプラインでバッチ処理します。公式 DogStatsD クライアントは、メトリクスをグループ化して、パケットあたりのメトリクスの数の比率を最適化できます。
DogStatsD クライアントが dogstatsd_buffer_size のサイズのパケットを送信する場合、Datadog Agent が最も最適に動作します。パケットはバッファサイズより大きくしてはなりません。そうでない場合、Agent はパケットをバッファに完全にロードできず、メトリクスが不正になります。DogStatsD クライアントの対応するコンフィギュレーションフィールドを使用します。
UDP に関する注意: UDP パケットは通常 Ethernet および IP レイヤーを通過するため、パケットサイズをネットワーク上の単一の Ethernet フレームよりも小さい値に制限することにより、IP パケットの断片化を回避できます。ほとんどの場合、IPv4 ネットワークは 1500 バイトの MTU で構成されているため、この状況では送信パケットのパケットサイズを 1472 に制限する必要があります。
UDS に関する注意: 最高のパフォーマンスを得るには、UDS パケットサイズを 8192 バイトにする必要があります。
Agent の最大メモリ使用量を制限する
Agent は、DogStatsD クライアントから送信されたメトリクスのバーストを吸収しようとしますが、そのためには、メモリを使用する必要があります。これが短時間であり、このメモリが OS にすぐに解放された場合でも、スパイクが発生し、メモリ使用量の制限によりポッドまたはコンテナがエビクションされる可能性があるコンテナ化された環境で問題になる可能性があります。
アプリケーションでバーストでメトリクスを送信することは避けてください。これにより、Datadog Agent が最大メモリ使用量に達するのを防ぎます。
最大メモリ使用量を制限するために注意すべきもう 1 つのことは、バッファリングを減らすことです。Agent 内の DogStatsD サーバーのメインバッファは、dogstatsd_queue_size フィールドで構成できます (Datadog Agent 6.1.0 以降)。そのデフォルト値の 1024 は、およその最大メモリ使用量である 768MB を引き起こします。
注: バッファサイズを小さくすると、パケットドロップの数が増える可能性があります。
この例では、DogStatsD の最大メモリ使用量を約 384MB に減らします。
dogstatsd_queue_size: 512
バースト検知を使用してアプリケーションからメトリクスのバーストを検知するには、次のセクションを参照してください。
メトリクスの処理統計とバースト検知を有効にする
DogStatsD には、どのメトリクスが最も多く処理されたかを把握するのに役立つ統計モードが搭載されています。
注: メトリクス統計モードを有効にすると、DogStatsD のパフォーマンスが低下する可能性があります。
この統計モードは以下のいずれかの方法で有効化できます。
- コンフィギュレーションファイルで
dogstatsd_stats_enable を true に設定 - 環境変数
DD_DOGSTATSD_STATS_ENABLE を true に設定 datadog-agent config set dogstatsd_stats true コマンドを使用して、ランタイム時に有効化を行います。ランタイム時にこれを無効化するには、datadog-agent config set dogstatsd_stats false コマンドを使用してください。
このモードを有効化したら、コマンド datadog-agent dogstatsd-stats を実行します。処理されたメトリクスのリストが受信したメトリクスの降順で返されます。
このモードでシステムを実行すると、DogStatsD サーバーがバースト検知メカニズムを実行します。バーストが検知されたら警告ログが送信されます。例:
DogStatSd によりメトリクスのバーストが検知されました。最後の 5 秒間のメトリクスカウントは次の通りです: [250 230 93899 233 218]
クライアント側のテレメトリー
DogStatsD クライアントは、デフォルトでテレメトリーメトリクスを Agent に送信します。これを利用して、ボトルネックが存在する場合にトラブルシューティングを行うことができます。各メトリクスには、クライアントの言語とバージョンがタグ付けされます。これらのメトリクスはカスタムメトリクスとしてカウントされません。
以下のタグは、すべてのクライアントに共通してタグ付けされます。
| タグ | 説明 | 例 |
|---|
client | クライアントの言語 | client:py |
client_version | クライアントのバージョン | client_version:1.2.3 |
client_transport | クライアントが使用する転送プロトコル (udp または uds) | client_transport:uds |
注: UDP を使用すると、クライアントがネットワークエラーを検出できないため、バイトやパケットがドロップしてもメトリクスには反映されません。
バージョン 0.34.0 以降の Python クライアントが必要です。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリング前)。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたデータグラムの数。
テレメトリーを無効にするには、disable_telemetry メソッドを次のように使用します。
statsd.disable_telemetry()
クライアントコンフィギュレーションについて詳しくは、DataDog/datadogpy を参照してください。
バージョン 4.6.0 以降の Ruby クライアントが必要です。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリング前)。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたデータグラムの数。
テレメトリーを無効にするには、 disable_telemetry パラメーターを true に設定します。
Datadog::Statsd.new('localhost', 8125, disable_telemetry: true)
クライアントコンフィギュレーションについて詳しくは、DataDog/dogstatsd-ruby を参照してください。
バージョン 3.4.0 以降の Go クライアントが必要です。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリングおよび集計前)。 datadog.dogstatsd.client.metrics_by_type- メトリクスタイプ: カウント
DogStatsD クライアントが送信した、サンプリングと集計前の metrics の数で、メトリクスタイプ (gauge、set、count、timing、histogram または distribution) によってタグ付けされています。Go クライアントの v5.0.0 から搭載されています。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントがドロップしたバイト数 (これには datadog.dogstatsd.client.bytes_dropped_queue と datadog.dogstatsd.client.bytes_dropped_writer が含まれます)。 datadog.dogstatsd.client.bytes_dropped_queue- メトリクスタイプ: カウント
DogStatsD クライアントのキューが一杯だったためにドロップされたバイト数。 datadog.dogstatsd.client.bytes_dropped_writer- メトリクスタイプ: カウント
Datadog への書き込み時に、ネットワークのタイムアウトやエラーによりドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントがドロップしたデータグラム数 (これには datadog.dogstatsd.client.packets_dropped_queue と datadog.dogstatsd.client.packets_dropped_writer が含まれます)。 datadog.dogstatsd.client.packets_dropped_queue- メトリクスタイプ: カウント
DogStatsD クライアントのキューが一杯だったためにドロップされたデータグラムの数。 datadog.dogstatsd.client.packets_dropped_writer- メトリクスタイプ: カウント
Datadog への書き込み時に、ネットワークのタイムアウトやエラーによりドロップされたデータグラム数。 datadog.dogstatsd.client.metric_dropped_on_receive- メトリクスタイプ: カウント
内部の受信チャンネルが満杯であるためにドロップされたメトリクスの数 (WithChannelMode() 使用時)。WithChannelMode() が有効な場合の Go クライアントの v3.6.0 以降。 datadog.dogstatsd.client.aggregated_context- メトリクスタイプ: カウント
クライアント側の集計が有効な場合に、クライアントによってフラッシュされるコンテキストの総数。Go クライアントの v5.0.0 以降。このメトリクスは、集計が有効な場合 (デフォルト) にのみ報告されます。 datadog.dogstatsd.client.aggregated_context_by_type- メトリクスタイプ: カウント
クライアント側の集計が有効な場合に、クライアントによってフラッシュされるコンテキストの総数で、メトリクスタイプ (gauge、set、count、timing、histogram または distribution) によってタグ付けされています。Go クライアントの v5.0.0 以降。このメトリクスは、集計が有効な場合 (デフォルト) にのみ報告されます。
テレメトリーを無効にするには、WithoutTelemetry を次のように設定します。
statsd, err: = statsd.New("127.0.0.1:8125", statsd.WithoutTelemetry())
クライアントコンフィギュレーションについて詳しくは、DataDog/datadog-go を参照してください。
バージョン 2.10.0 以降の Java クライアントが必要です。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリング前)。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたデータグラムの数。 datadog.dogstatsd.client.packets_dropped_queue- メトリクスタイプ: カウント
DogStatsD クライアントのキューが一杯だったためにドロップされたデータグラムの数。 datadog.dogstatsd.client.aggregated_context- メトリクスタイプ: カウント
クライアント側の集計が有効な場合に、集計されるコンテキストの数。バージョン v2.11.0 以降。 datadog.dogstatsd.client.aggregated_context_by_type- メトリクスタイプ: カウント
クライアント側の集計が有効な場合に、タイプ別に集計されるコンテキストの数。バージョン v2.13.0 以降。このメトリクスは v3.0.0 からはデフォルトで有効ですが、v2.13.0 では enableDevMode(true) が必要です。このメトリクスは metrics_type によってタグ付けされています。 datadog.dogstatsd.client.metrics_by_type- メトリクスタイプ: カウント
アプリケーションから DogStatsD クライアントに送信されたメトリクスの数で、タイプ別にタグ付けされています (サンプリング前)。enableDevMode(true) が使われたバージョン v2.13.0 以降で、v3.0.0 以降はデフォルトです。このメトリクスは metrics_type によってタグ付けされています。
テレメトリーを無効にするには、enableTelemetry(false) ビルダーオプションを使用します。
StatsDClient client = new NonBlockingStatsDClientBuilder()
.hostname("localhost")
.port(8125)
.enableTelemetry(false)
.build();
クライアントコンフィギュレーションについて詳しくは、DataDog/java-dogstatsd-client を参照してください。
PHP クライアントのバージョン 1.5.0 以降、テレメトリーは BatchedDogStatsd クライアントに対してデフォルトで有効になり、DogStatsd クライアントに対してデフォルトで無効になります。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリング前)。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたデータグラムの数。
テレメトリーを有効または無効にするには、disable_telemetry 引数を使用します。DogStatsd クライアントでテレメトリーを使用すると、ネットワークの使用量が大幅に増加するので注意してください。テレメトリーを使用する場合は、BatchedDogStatsd を使用することをお勧めします。
DogStatsd クライアントで有効にするには
use DataDog\DogStatsd;
$statsd = new DogStatsd(
array('host' => '127.0.0.1',
'port' => 8125,
'disable_telemetry' => false,
)
);
BatchedDogStatsd クライアントでテレメトリーを無効にするには
use DataDog\BatchedDogStatsd;
$statsd = new BatchedDogStatsd(
array('host' => '127.0.0.1',
'port' => 8125,
'disable_telemetry' => true,
)
);
クライアントコンフィギュレーションについて詳しくは、DataDog/php-datadogstatsd を参照してください。
バージョン 5.0.0 以降の .NET クライアントが必要です。
datadog.dogstatsd.client.metrics- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された metrics の数 (サンプリング前)。 datadog.dogstatsd.client.events- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された events の数。 datadog.dogstatsd.client.service_checks- メトリクスタイプ: カウント
アプリケーションによって DogStatsD クライアントに送信された service_checks の数。 datadog.dogstatsd.client.bytes_sent- メトリクスタイプ: カウント
Agent に正常に送信されたバイト数。 datadog.dogstatsd.client.bytes_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたバイト数。 datadog.dogstatsd.client.packets_sent- メトリクスタイプ: カウント
Agent に正常に送信されたデータグラムの数。 datadog.dogstatsd.client.packets_dropped- メトリクスタイプ: カウント
DogStatsD クライアントによってドロップされたデータグラムの数。 datadog.dogstatsd.client.packets_dropped_queue- メトリクスタイプ: カウント
DogStatsD クライアントのキューが一杯だったためにドロップされたデータグラムの数。 datadog.dogstatsd.client.aggregated_context_by_type- メトリクスタイプ: カウント
クライアント側の集計が有効な場合に、タイプ別に集計されるコンテキストの数。バージョン 7.0.0 以降。
テレメトリーを無効にするには、TelemetryFlushInterval を null に設定します。
var dogstatsdConfig = new StatsdConfig
{
StatsdServerName = "127.0.0.1",
StatsdPort = 8125,
};
// テレメトリーを無効にする
dogstatsdConfig.Advanced.TelemetryFlushInterval = null;
クライアントコンフィギュレーションについて詳しくは、DataDog/dogstatsd-csharp-client を参照してください。
その他の参考資料
