<METRIC_NAME>:<VALUE>|<TYPE>|@<SAMPLE_RATE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>

다음은 데이터그램의 예입니다:

• page.views:1|c: page.views카운트 메트릭을 증가시켜 줍니다.
• fuel.level:0.5|g: 연료통의 반이 비었음을 기록합니다.
• song.length:240|h|@0.5: song.length히스토그램을 절반만 보낸 것처럼 샘플링합니다.
• users.uniques:1234|s: 사이트에 대한 고유 방문자를 추적합니다.
• users.online:1|c|#country:china: 활성 사용자 카운트 메트릭과 태그를 원산지별로 증가시켜 줍니다.
• users.online:1|c|@0.5|#country:china: 활성화된 중국 사용자를 추적하고 샘플링 속도를 사용합니다.

DogStatsD 프로토콜 v1.1

에이전트>=v6.25.0 && <v7.0.0 또는 >=v7.25.0를 시작으로 값 패킹이 가능합니다. 이것은 SET를 제외한 모든 메트릭 유형을 지원합니다. 값은 다음과 같이 :로 구분됩니다:

<METRIC_NAME>:<VALUE1>:<VALUE2>:<VALUE3>|<TYPE>|@<SAMPLE_RATE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>

TYPE, SAMPLE_RATE 및 TAGS는 모든 값 사이에 공유됩니다. 이렇게 하면 각각 하나의 값으로 여러 개의 메시지를 보내는 보내는 것보다 동일한 메트릭을 생성합니다. 이는 히스토그램, 타이밍 및 분포 메트릭에 유용합니다.

데이터그램 예시

• page.views:1:2:32|d: 값 1,2, 32를 사용하여 page.views분포 메트릭을 세 번 샘플링합니다.
• song.length:240:234|h|@0.5: song.length히스토그램을 절반씩 두 번 보낸 것처럼 샘플링합니다. 각 값에는 0.5의 샘플링 속도가 적용됩니다.

DogStatsD 프로토콜 v1.2

에이전트 >=v6.35.0 && <v7.0.0 또는 >=v7.35.0부터 새 컨테이너 ID 필드가 지원됩니다. Datadog 에이전트는 컨테이너 ID 값을 사용하여 추가 컨테이너 태그로 DogStatsD 메트릭을 강화합니다.

컨테이너 ID에는 다음과 같이 c: 접두사가 붙습니다:

<METRIC_NAME>:<VALUE>|<TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>|c:<CONTAINER_ID>

참고:datadog.yaml파일 또는 환경 변수DD_DOGSTATSD_ORIGIN_DETECTION_CLIENT=true에서 dogstatsd_origin_detection_client를 true로 설정하여 Datadog 에이전트에 컨테이너 ID 필드를 추출하고 해당 컨테이너 태그를 부착하도록 지시합니다.

데이터그램 예시

• page.views:1|g|#env:dev|c:83c0a99c0a54c0c187f461c7980e9b57f3f6a8b0c918c8d93df19a9de6f3fe1d: Datadog 에이전트는 image_name및 image_tag같은 컨테이너 태그를 page.views메트릭에 추가합니다.

컨테이너 태그에 대한 자세한 내용은 쿠버네티스 및 도커 태깅 설명서를 참조하세요.

DogStatsD 프로토콜 v1.3

에이전트 v6.40.0+ 및 v7.40.0+는 부수적인 유닉스 타임스탬프 필드를 지원합니다.

이 필드가 제공되면, Datadog 에이전트는 태그로 메트릭을 보강하는 것 외에는 메트릭에 대해 어떠한 처리도 하지 않습니다(애그리게이션 없음). 이 필드는 애플리케이션에서 이미 메트릭을 집계하고 있으며, 추가 처리 없이 해당 메트릭을 Datadog으로 보내려는 경우에 유용할 수 있습니다.

유닉스 타임스탬프는 과거의 유효한 양수여야 합니다. 게이지 및 카운트 메트릭만 지원됩니다.

값은 유닉스 타임스탬프 (UTC)이며 다음과 같이 T가 접두사로 붙어야 합니다:

<METRIC_NAME>:<VALUE>|<TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>|T<METRIC_TIMESTAMP>

데이터그램 예시

• page.views:15|c|#env:dev|T1656581400: 2022년 6월 30일 오전 9시 30분 UTC에 15페이지가 조회되었음을 나타내는 카운트

_e{<TITLE_UTF8_LENGTH>,<TEXT_UTF8_LENGTH>}:<TITLE>|<TEXT>|d:<TIMESTAMP>|h:<HOSTNAME>|p:<PRIORITY>|t:<ALERT_TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>

다음은 데이터그램의 예시입니다:

## Send an exception
_e{21,36}:An exception occurred|Cannot parse CSV file from 10.0.0.17|t:warning|#err_type:bad_file

## Send an event with a newline in the text
_e{21,42}:An exception occurred|Cannot parse JSON request:\\n{"foo: "bar"}|p:low|#err_type:bad_request

_sc|<NAME>|<STATUS>|d:<TIMESTAMP>|h:<HOSTNAME>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>|m:<SERVICE_CHECK_MESSAGE>

데이터그램 예시입니다:

# 원격 연결에 대한 CRITICAL 상태 전송
_sc|Redis connection|2|#env:dev|m:Redis connection timed out after 10s

메트릭 전송 형식은 다음과 같습니다:

<METRIC_NAME>:<VALUE>|<TYPE>|@<SAMPLE_RATE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>

아래 예시에서는 shell태그와 함께 custom_metric로 호출되는 게이지 메트릭에 대한 데이터 포인트를 전송합니다.

Linux의 경우:

echo -n "custom_metric:60|g|#shell" >/dev/udp/localhost/8125

echo -n "custom_metric:60|g|#shell" | nc -4u -w0 127.0.0.1 8125

echo -n "custom.metric.name:1|c"|nc -4u -w1 localhost 8125

Windows의 경우:

PS C:\> .\send-statsd.ps1 "custom_metric:123|g|#shell"

파이썬(Python)이 있는 모든 플랫폼의 경우 (Windows에서는 에이전트의 내장 파이썬(Python) 인터프리터를 사용할 수 있으며, 에이전트 버전이 6.11 이하면 %ProgramFiles%\Datadog\Datadog Agent\embedded\python.exe에, 에이전트 버전 6.12 이상이면%ProgramFiles%\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe에 위치 ):

파이썬 2

import socket
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) # UDP
sock.sendto("custom_metric:60|g|#shell", ("localhost", 8125))

파이썬 3

import socket
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) # UDP
sock.sendto(b"custom_metric:60|g|#shell", ("localhost", 8125))

이벤트 전송 형식은 다음과 같습니다:

_e{<TITLE>.length,<TEXT>.length}:<TITLE>|<TEXT>|d:<DATE_EVENT>|h:<HOSTNAME>|p:<PRIORITY>|t:<ALERT_TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>.

아래 예시에서는 이벤트 제목과 본문의 크기를 계산합니다.

Linux의 경우:

$ title="셸의 이벤트"

$ text="Bash에서 보냈습니다!"

$ echo "_e{${#title},${#text}}:$title|$text|#shell,bash"  >/dev/udp/localhost/8125

윈도우즈(Windows)의 경우:

PS C:> $title = "셸의 이벤트"
PS C:> $text = "PowerShell에서 보냈습니다!!"
PS C:> .\send-statsd.ps1 "_e{$($title.length),$($text.Length)}:$title|$text|#shell,PowerShell"

서비스 검사를 보내는 형식은 다음과 같습니다:

_sc|<NAME>|<STATUS>|d:<TIMESTAMP>|h:<HOSTNAME>|#<TAG_KEY_1>:<TAG_VALUE_1>|m:<SERVICE_CHECK_MESSAGE>

Linux의 경우:

echo -n "_sc|Redis connection|2|#env:dev|m:Redis connection timed out after 10s" >/dev/udp/localhost/8125

윈도우즈(Windows)의 경우:

PS C:\> .\send-statsd.ps1 "_sc|Redis connection|2|#env:dev|m:Redis connection timed out after 10s"