Datadog

Monitoriza infraestructura, aplicaciones y registros con Datadog

Configuración

Enviar métricas

Operación
Enviar métricas
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Datos de métricas (JSON)*
json
[ { "metric": "custom.app.response_time", "type": "gauge", "points": [{"timestamp": 1700000000, "value": 0.85}], "tags": ["env:production", "service:api"] } ]
Enviar métricas (datadog_submit_metrics)

Envía métricas personalizadas a Datadog. Úsalo para el seguimiento del rendimiento de la aplicación, métricas de negocio o datos de monitorización personalizados.

Entrada
ParámetroTipoRequeridoDescripción
seriesstringSíArray JSON de series de métricas para enviar. Cada serie debe incluir el nombre de la métrica, el tipo (gauge/rate/count), los puntos (pares timestamp/valor) y etiquetas opcionales.
apiKeystringSíClave de API de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
successbooleanIndica si las métricas se enviaron correctamente
errorsarrayCualquier error que se produjo durante el envío

Consultar series temporales

Operación
Consultar series temporales
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Consulta*
avg:system.cpu.user{*}
Desde (timestamp Unix)*
p. ej., 1701360000
Hasta (timestamp Unix)*
p. ej., 1701446400
Clave de aplicación*
••••••••
Consultar series temporales (datadog_query_timeseries)

Consultar datos de series temporales de métricas de Datadog. Úsalo para analizar tendencias, crear informes u obtener valores de métricas.

Entrada
ParámetroTipoObligatorioDescripción
querystringYesConsulta de métricas de Datadog (e.g., "avg:system.cpu.user{*}")
fromnumberYesHora de inicio como marca de tiempo Unix en segundos
tonumberYesHora de finalización como marca de tiempo Unix en segundos
apiKeystringYesClave de API de Datadog
applicationKeystringYesClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
seriesarrayMatriz de datos de series temporales con nombre de métrica, etiquetas y puntos de datos
statusstringEstado de la consulta

Crear evento

Operación
Crear evento
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Título del evento*
Implementación completada
Texto del evento*
Describe el evento...
Tipo de alerta
Información
Prioridad
Normal
Etiquetas
env:production, service:api
Crear evento (datadog_create_event)

Publica un evento en el flujo de eventos de Datadog. Úsalo para notificaciones de despliegue, alertas o cualquier suceso significativo.

Entrada
ParámetroTipoRequeridoDescripción
titlecadenaSíTítulo del evento
textcadenaSíCuerpo/descripción del evento. Admite markdown.
alertTypecadenaNoTipo de alerta: error, warning, info, success, user_update, recommendation o snapshot
prioritycadenaNoPrioridad del evento: normal o low
hostcadenaNoNombre del host a asociar con este evento
tagscadenaNoLista de etiquetas separadas por comas (p. ej., "env:production,service:api")
aggregationKeycadenaNoClave para agrupar eventos
sourceTypeNamecadenaNoNombre del tipo de origen para el evento
dateHappenednúmeroNoMarca de tiempo Unix cuando ocurrió el evento (por defecto, ahora)
apiKeycadenaSíClave de API de Datadog
sitecadenaNoSitio/región de Datadog (por defecto: datadoghq.com)
Salida
ParámetroTipoDescripción
eventobjetoDetalles del evento creado

Crear monitor

Operación
Crear monitor
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Nombre del monitor*
Alerta de uso alto de CPU
Tipo de monitor*
Alerta de métrica
Consulta del monitor*
avg(last_5m):avg:system.cpu.idle{*} < 20
Mensaje de notificación
¡Alerta! El uso de CPU es alto. @slack-alerts
Etiquetas
team:backend, priority:high
Prioridad (1-5)
3
Opciones (JSON)
json
{"notify_no_data": true, "thresholds": {"critical": 90}}
Clave de aplicación*
••••••••
Crear monitor (datadog_create_monitor)

Crea un nuevo monitor/alerta en Datadog. Los monitores pueden monitorear métricas, comprobaciones de servicio, eventos y más.

Entrada
ParámetroTipoObligatorioDescripción
namestringSíNombre del monitor
typestringSíTipo de monitor: alerta de métrica, comprobación de servicio, alerta de evento, alerta de proceso, alerta de registro, alerta de consulta, compuesto, alerta de sintéticos, alerta de SLO
querystringSíConsulta del monitor (p. ej., "avg(last_5m):avg:system.cpu.idle{*} < 20")
messagestringNoMensaje para incluir con las notificaciones. Puede incluir @-menciones y markdown.
tagsstringNoLista de etiquetas separadas por comas
prioritynumberNoPrioridad del monitor (1-5, donde 1 es la más alta)
optionsstringNoCadena JSON de opciones del monitor (thresholds, notify_no_data, renotify_interval, etc.)
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
monitorobjectLos detalles del monitor creado

Obtener monitor

Operación
Obtener monitor
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
ID del monitor*
12345678
Clave de aplicación*
••••••••
Obtener monitor (datadog_get_monitor)

Recuperar detalles de un monitor específico por ID.

Entrada
ParámetroTipoObligatorioDescripción
monitorIdstringSíEl ID del monitor a recuperar
groupStatesstringNoEstados de grupo separados por comas a incluir: alert, warn, no data, ok
withDowntimesbooleanNoIncluir datos de tiempo de inactividad con el monitor
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
monitorobjectLos detalles del monitor

Listar monitores

Operación
Listar monitores
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Filtrar por nombre
CPU
Filtrar por etiquetas
env:production
Clave de aplicación*
••••••••
Listar monitores (datadog_list_monitors)

Lista todos los monitores en Datadog con filtrado opcional por nombre, etiquetas o estado.

Entrada
ParámetroTipoObligatorioDescripción
groupStatesstringNoEstados de grupo separados por comas para filtrar: alert, warn, no data, ok
namestringNoFiltrar monitores por nombre (coincidencia parcial)
tagsstringNoLista de etiquetas separadas por comas para filtrar
monitorTagsstringNoLista de etiquetas de monitor separadas por comas para filtrar
withDowntimesbooleanNoIncluir datos de tiempo de inactividad con los monitores
pagenumberNoNúmero de página para paginación (indexado desde 0)
pageSizenumberNoNúmero de monitores por página (máx. 1000)
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
monitorsarrayLista de monitores

Silenciar monitor

Operación
Silenciar monitor
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
ID de monitor*
12345678
Ámbito
host:myhost (opcional)
Hora de finalización (marca de tiempo Unix)
Dejar vacío para indefinido
Clave de aplicación*
••••••••
Silenciar monitor (datadog_mute_monitor)

Silencia un monitor para suprimir temporalmente las notificaciones.

Entrada
ParámetroTipoRequeridoDescripción
monitorIdstringSíEl ID del monitor a silenciar
scopestringNoÁmbito para silenciar (p. ej., "host:myhost"). Si no se especifica, silencia todos los ámbitos.
endnumberNoMarca de tiempo Unix de cuándo debe finalizar el silencio. Si no se especifica, silencia indefinidamente.
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
successbooleanIndica si el monitor se silenció correctamente

Consultar registros

Operación
Consultar registros
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Consulta de búsqueda*
service:web-app status:error
Desde*
now-1h
Hasta*
now
Límite
50
Clave de aplicación*
••••••••
Consultar registros (datadog_query_logs)

Busca y recupera registros de Datadog. Úsalo para solución de problemas, análisis o monitoreo.

Entrada
ParámetroTipoRequeridoDescripción
querystringSíConsulta de búsqueda de registros (e.g., "service:web-app status:error")
fromstringSíHora de inicio en formato ISO-8601 o relativa (e.g., "now-1h")
tostringSíHora de finalización en formato ISO-8601 o relativa (e.g., "now")
limitnumberNoNúmero máximo de registros a devolver (por defecto: 50, máx.: 1000)
sortstringNoOrden de clasificación: timestamp (más antiguo primero) o -timestamp (más reciente primero)
indexesstringNoLista separada por comas de índices de registros para buscar
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (por defecto: datadoghq.com)
Salida
ParámetroTipoDescripción
logsarrayLista de entradas de registro
nextLogIdstringCursor para paginación

Enviar registros

Operación
Enviar registros
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Registros (JSON)*
json
[ { "message": "Application started successfully", "service": "my-app", "ddsource": "custom", "ddtags": "env:production" } ]
Enviar registros (datadog_send_logs)

Enviar entradas de registro a Datadog para registro y análisis centralizados.

Entrada
ParámetroTipoObligatorioDescripción
logsstringSíMatriz JSON de entradas de registro. Cada entrada debe tener message y, opcionalmente, ddsource, ddtags, hostname, service.
apiKeystringSíClave de API de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
successbooleanSi los registros se enviaron correctamente

Crear tiempo de inactividad

Operación
Crear tiempo de inactividad
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Ámbito*
host:myhost o env:production o *
Mensaje
Mantenimiento programado
Hora de inicio (marca de tiempo Unix)
Dejar vacío por ahora
Hora de finalización (marca de tiempo Unix)
p. ej., 1701450000
ID de monitor (opcional)
12345678
Clave de aplicación*
••••••••
Crear tiempo de inactividad (datadog_create_downtime)

Programar un tiempo de inactividad para suprimir las notificaciones de monitor durante las ventanas de mantenimiento.

Entrada
ParámetroTipoRequeridoDescripción
scopestringSíAlcance al que aplicar el tiempo de inactividad (p. ej., "host:myhost", "env:production", o "*" para todos)
messagestringNoMensaje para mostrar durante el tiempo de inactividad
startnumberNoMarca de tiempo Unix para el inicio del tiempo de inactividad (por defecto, ahora)
endnumberNoMarca de tiempo Unix para el fin del tiempo de inactividad
timezonestringNoZona horaria para el tiempo de inactividad (p. ej., "America/New_York")
monitorIdstringNoID de monitor específico a silenciar
monitorTagsstringNoEtiquetas de monitor separadas por comas para coincidir (p. ej., "team:backend,priority:high")
muteFirstRecoveryNotificationbooleanNoSilenciar la primera notificación de recuperación
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
downtimeobjectLos detalles del tiempo de inactividad creado

Listar tiempos de inactividad

Operación
Listar tiempos de inactividad
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
Solo actuales
Disabled
Clave de aplicación*
••••••••
Listar tiempos de inactividad (datadog_list_downtimes)

Lista todos los tiempos de inactividad programados en Datadog.

Entrada
ParámetroTipoObligatorioDescripción
currentOnlybooleanNoDevolver solo los tiempos de inactividad activos actualmente
monitorIdstringNoFiltrar por ID de monitor
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
downtimesarrayLista de tiempos de inactividad

Cancelar tiempo de inactividad

Operación
Cancelar tiempo de inactividad
Clave de API*
••••••••
Sitio de Datadog
US1 (datadoghq.com)
ID de tiempo de inactividad*
abc123
Clave de aplicación*
••••••••
Cancelar downtime (datadog_cancel_downtime)

Cancela un downtime programado.

Entrada
ParámetroTipoObligatorioDescripción
downtimeIdstringSíEl ID del downtime que se va a cancelar
apiKeystringSíClave de API de Datadog
applicationKeystringSíClave de aplicación de Datadog
sitestringNoSitio/región de Datadog (predeterminado: datadoghq.com)
Salida
ParámetroTipoDescripción
successbooleanIndica si el downtime se canceló correctamente

Instrucciones de uso

Integra la monitorización de Datadog en los workflows. Envía métricas, gestiona monitores, consulta logs, crea eventos, gestiona downtimes y más.

Notas

  • Categoría: tools
  • Tipo: datadog