<METRIC_NAME>:<VALUE>|<TYPE>|@<SAMPLE_RATE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>
Parámetro | Obligatorio | Descripción |
---|
<METRIC_NAME> | Sí | Cadena que sólo contiene caracteres alfanuméricos ASCII, guiones bajos y puntos. Consulta la política relativa a los nombres de métricas. |
<VALUE> | Sí | Número entero o flotante. |
<TYPE> | Sí | c para COUNT (Recuento), g para GAUGE (Indicador), ms para TIMER (Temporizador), h para HISTOGRAM (Histograma), s para SET (Conjunto), d para DISTRIBUTION (Distribución). Para ver más detalles, consulta Tipos de métricas. |
<SAMPLE_RATE> | No | Un valor flotante entre 0 y 1 , inclusive. Sólo funciona con las métricas COUNT, HISTOGRAM, DISTRIBUTION, y TIMER. El valor por defecto es 1 , que muestrea el 100% del tiempo. |
<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2> | No | Lista de cadenas separadas por comas. Utiliza dos puntos para etiquetas (tags) (env:prod ) de clave/valor. Para más información sobre la definición de etiquetas, consulta Empezando con las etiquetas. |
Los siguientes son algunos ejemplos de datagramas:
page.views:1|c
: incrementa la métrica COUNT page.views
.fuel.level:0.5|g
: registra que el depósito de combustible está medio vacío.song.length:240|h|@0.5
: muestra el histograma song.length
como si se enviara la mitad del tiempo.users.uniques:1234|s
: realiza un seguimiento de los visitantes únicos del sitio.users.online:1|c|#country:china
: incrementa la métrica y la etiqueta COUNT de los usuarios activos por país de origen.users.online:1|c|@0.5|#country:china
: realiza un seguimiento de los usuarios activos de China y utiliza una frecuencia de muestreo.
Protocolo de DogStatsD v1.1
A partir del Agent >=v6.25.0
y <v7.0.0
o >=v7.25.0
, es posible empaquetar valores. Esta opción
es compatible con todos los tipos de métricas, excepto SET
. Los valores se separan mediante un :
, por ejemplo:
<METRIC_NAME>:<VALUE1>:<VALUE2>:<VALUE3>|<TYPE>|@<SAMPLE_RATE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>
TYPE
, SAMPLE_RATE
y TAGS
se comparten entre todos los valores. Esto genera las mismas métricas que el envío de múltiples
mensajes con un valor en cada uno. Esto es útil para las métricas HISTOGRAM, TIMING y DISTRIBUTION.
Ejemplo de datagramas
page.views:1:2:32|d
: realiza un muestreo de la métrica DISTRIBUTION page.views
tres veces con los valores 1
, 2
y 32
.song.length:240:234|h|@0.5
: realiza un muestreo del histograma song.length
como si se enviara la mitad del tiempo, dos veces. A cada valor se le aplica la frecuencia de muestreo de 0.5
.
Protocolo de DogStatsD v1.2
A partir del Agent >=v6.35.0
y <v7.0.0
o >=v7.35.0
, se admite un nuevo campo de ID de contenedor.
El Datadog Agent utiliza el valor del ID de contenedor para enriquecer las métricas de DogStatsD con etiquetas de contenedor adicionales.
El ID de contenedor lleva el prefijo c:
, por ejemplo:
<METRIC_NAME>:<VALUE>|<TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>|c:<CONTAINER_ID>
Nota: Configura dogstatsd_origin_detection_client
como true
en tu archivo datadog.yaml
o la variable de entorno DD_DOGSTATSD_ORIGIN_DETECTION_CLIENT=true
para indicar al Datadog Agent que extraiga el campo del ID de contenedor y adjunte las etiquetas de contenedor correspondientes.
Ejemplo de datagramas
page.views:1|g|#env:dev|c:83c0a99c0a54c0c187f461c7980e9b57f3f6a8b0c918c8d93df19a9de6f3fe1d
: el Datadog Agent añade etiquetas de contenedor como image_name
y image_tag
a la métrica page.views
.
Para obtener más información sobre las etiquetas de contenedor, consulta la documentación sobre el etiquetado en Kubernetes y Docker.
Protocolo de DogStatsD v1.3
Los Agents v6.40.0 y v7.40.0 y posteriores admiten un campo de marca de tiempo Unix opcional.
Cuando se proporciona este campo, el Datadog Agent no procesa ninguna métrica (sin agregación) y sólo se limita a enriquecer los métricas con etiquetas. Esto puede ser útil si ya estabas agregando tus métricas en tu aplicación y quieres enviarlas a Datadog sin ningún procesamiento adicional.
La marca de tiempo Unix debe ser un número positivo válido en el pasado. Sólo se admiten métricas GAUGE y COUNT.
El valor es una marca de tiempo Unix (UTC) y debe llevar el prefijo T
, por ejemplo:
<METRIC_NAME>:<VALUE>|<TYPE>|#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2>|T<METRIC_TIMESTAMP>
Ejemplo de datagramas
page.views:15|c|#env:dev|T1656581400
: una métrica COUNT que indica que 15 vistas de páginas ocurrieron el 30 de junio de 2022 a las 9:30 UTC
_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>
Parámetro | Obligatorio | Descripción |
---|
_e | Sí | El datagrama debe comenzar por _e . |
<TITLE> | Sí | Título del evento. |
<TEXT> | Sí | Texto del evento. Inserta saltos de línea con: \\n . |
<TITLE_UTF8_LENGTH> | Sí | Longitud (en bytes) del <TITLE> del archivo codificado en UTF-8 |
<TEXT_UTF8_LENGTH> | Sí | Longitud (en bytes) del <TEXT> del archivo codificado en UTF-8 |
d:<TIMESTAMP> | No | Añade una marca de tiempo al evento. El valor predeterminado es la marca temporal Unix actual. |
h:<HOSTNAME> | No | Añade un nombre de host al evento. Por defecto es la instancia del Datadog Agent. |
k:<AGGREGATION_KEY> | No | Añade una clave de agregación para agrupar el evento con otros que tengan la misma clave. No existen valores por defecto. |
p:<PRIORITY> | No | Configura como normal o low . El valor por defecto es normal . |
s:<SOURCE_TYPE_NAME> | No | Añade un tipo de origen al evento. No existen valores por defecto. |
t:<ALERT_TYPE> | No | Configura como error , warning , info o success . El valor por defecto es info . |
#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2> | No | Los dos puntos en las etiquetas forman parte de la cadena de la lista de etiquetas y no tienen ningún propósito de análisis, lo que sí sucede en los otros parámetros. No existen valores por defecto. |
Los siguientes son algunos ejemplos de datagramas:
``text
Enviar una excepción
_e{21,36}:Se ha producido una excepción. No se puede analizar el archivo CSV de 10.0.0.17|t:warning|#err_type:bad_file
Enviar un evento con una nueva línea en el texto
Se ha producido una excepción. No se puede analizar la solicitud:\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>
Parámetro | Obligatorio | Descripción |
---|
_sc | Sí | El datagrama debe comenzar por _sc . |
<NAME> | Sí | Nombre del check de servicio. |
<STATUS> | Sí | Número entero correspondiente al estado del check (OK = 0 , WARNING (Advertencia) = 1 , CRITICAL (Crítico) = 2 , UNKNOWN (Desconocido) = 3 ). |
d:<TIMESTAMP> | No | Añade una marca de tiempo al check. El valor predeterminado es la marca de tiempo Unix actual. |
h:<HOSTNAME> | No | Añade un nombre de host al evento (no existen valores por defecto). |
#<TAG_KEY_1>:<TAG_VALUE_1>,<TAG_2> | No | Configura las etiquetas del evento. Una lista de cadenas separadas por comas (no existen valores por defecto). |
m:<SERVICE_CHECK_MESSAGE> | No | Mensaje que describe el estado actual del check de servicio. Este campo debe situarse en último lugar entre los campos de metadatos (no existen valores por defecto). |
El siguiente es un ejemplo de datagrama:
# Enviar un estado CRITICAL para una conexión remota
_sc|Redis connection|2|#env:dev|m:La conexión a Redis ha expirado después de 10s