기본적으로 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 클라이언트를 사용합니다. 버퍼링을 사용하면 패킷 크기 제한에서 300 밀리초마다 (설정 가능) 자동 플러싱이 수행됩니다.

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"])

아래 예제는 Datadog의 공식 Ruby 라이브러리 [dogstatsd-ruby][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("DogstatsD를 초기화할 수 없습니다. 자세한 내용을 위해 `Configure` 방식에서 optionalExceptionHandler 인수를 설정하세요.");

            // Counter and Gauge are sent in the same datagram
            dogStatsdService.Counter("example_metric.count", 2, tags: new[] { "environment:dev" });
            dogStatsdService.Gauge("example_metric.gauge", 100, tags: new[] { "environment:dev" });
        }
    }
}

아래 예제는 Datadog의 공식 PHP 라이브러리 php-datadogstatsd를 사용하여 블록이 완료될 때 하나의 패킷으로 메트릭을 전송하는 버퍼링된 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'));

클라이언트 사이드 애그리게이션은 v5.0.0부터 시작되는 Go 클라이언트에서만 사용할 수 있습니다.

자세한 내용은 클라이언트 사이드 애그리게이션을 참조하세요.

클라이언트 사이드 애그리게이션은 java-dogstatsd-client 버전 2.11.0 이상에서 사용할 수 있으며, 버전 3.0.0부터 기본적으로 활성화되어 있습니다.

StatsDClient Statsd = new NonBlockingStatsDClientBuilder()
    // regular setup
    .enableAggregation(true)
    .build();

클라이언트 사이드 애그리게이션은 게이지, 카운터 및 세트에 사용할 수 있습니다.

자세한 내용은 클라이언트 사이드 애그리게이션을 참조하세요.

클라이언트 사이드 애그리게이션은 DogStatsD C# 클라이언트 v7.0.0 이상에서 사용할 수 있으며 기본적으로 활성화되어 있습니다. 클라이언트 사이드 애그리게이션은 게이지, 카운터 및 세트에 사용할 수 있습니다.

var dogstatsdConfig = new StatsdConfig
{
    StatsdServerName = "127.0.0.1",
    StatsdPort = 8125,
    ClientSideAggregation = new ClientSideAggregationConfig()
};

자세한 내용은 C#용 DogStatsD 리포지토리를 참조하세요.

Python 클라이언트 0.34.0 버전으로 시작합니다.

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

메트릭 유형: 카운트
에이전트에 성공적으로 전송된 바이트 수입니다.

datadog.dogstatsd.client.bytes_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 바이트 수입니다.

datadog.dogstatsd.client.packets_sent

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

datadog.dogstatsd.client.packets_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 데이터그램의 수입니다.

텔레메트리를 비활성화하려면 disable_telemetry 방법을 사용합니다:

statsd.disable_telemetry()

클라이언트 설정에 대한 자세한 내용은 DataDog/datadogpy을 참조하세요.

Ruby 클라이언트의 4.6.0 버전으로 시작합니다.

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

메트릭 유형: 카운트
에이전트에 성공적으로 전송된 바이트 수입니다.

datadog.dogstatsd.client.bytes_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 바이트 수입니다.

datadog.dogstatsd.client.packets_sent

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

datadog.dogstatsd.client.packets_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 데이터그램의 수입니다.

텔레메트리를 비활성화하려면, disable_telemetry 매개 변수를 true로 설정합니다:

Datadog::Statsd.new('localhost', 8125, disable_telemetry: true)

클라이언트 설정에 대한 자세한 내용은 DataDog/dogstatsd-ruby를 참조하세요.

Go 클라이언트 3.4.0 버전으로 시작합니다.

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

메트릭 유형: 카운트
에이전트에 성공적으로 전송된 바이트 수입니다.

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

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

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를 참조하세요.

Java 클라이언트 2.10.0 버전으로 시작합니다.

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

메트릭 유형: 카운트
에이전트에 성공적으로 전송된 바이트 수입니다.

datadog.dogstatsd.client.bytes_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 바이트 수입니다.

datadog.dogstatsd.client.packets_sent

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

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

메트릭 유형: 카운트
에이전트에 성공적으로 전송된 바이트 수입니다.

datadog.dogstatsd.client.bytes_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 바이트 수입니다.

datadog.dogstatsd.client.packets_sent

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

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을 참조하세요.

.NET 클라이언트 5.0.0으로 시작합니다.

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

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 바이트 수입니다.

datadog.dogstatsd.client.bytes_dropped

메트릭 유형: 카운트
DogStatsD 클라이언트가 삭제한 바이트 수입니다.

datadog.dogstatsd.client.packets_sent

메트릭 유형: 카운트
에이전트에게 성공적으로 전송된 데이터그램의 수입니다.

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,
};

// Disable Telemetry
dogstatsdConfig.Advanced.TelemetryFlushInterval = null;

클라이언트 설정에 대한 자세한 내용은 DataDog/dogstatsd-csharp-client를 참조하세요.