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ámetro Tipo Requerido Descripción seriesstring Sí 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. apiKeystring Sí Clave de API de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción successboolean Indica si las métricas se enviaron correctamente errorsarray Cualquier error que se produjo durante el envío
Operación
Consultar series temporales 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ámetro Tipo Obligatorio Descripción querystring Yes Consulta de métricas de Datadog (e.g., "avg:system.cpu.user{*}") fromnumber Yes Hora de inicio como marca de tiempo Unix en segundos tonumber Yes Hora de finalización como marca de tiempo Unix en segundos apiKeystring Yes Clave de API de Datadog applicationKeystring Yes Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción seriesarray Matriz de datos de series temporales con nombre de métrica, etiquetas y puntos de datos statusstring Estado de la consulta
Título del evento*
Implementación completada
Texto del evento*
Describe el evento...
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ámetro Tipo Requerido Descripción titlecadena Sí Título del evento textcadena Sí Cuerpo/descripción del evento. Admite markdown. alertTypecadena No Tipo de alerta: error, warning, info, success, user_update, recommendation o snapshot prioritycadena No Prioridad del evento: normal o low hostcadena No Nombre del host a asociar con este evento tagscadena No Lista de etiquetas separadas por comas (p. ej., "env:production,service:api") aggregationKeycadena No Clave para agrupar eventos sourceTypeNamecadena No Nombre del tipo de origen para el evento dateHappenednúmero No Marca de tiempo Unix cuando ocurrió el evento (por defecto, ahora) apiKeycadena Sí Clave de API de Datadog sitecadena No Sitio/región de Datadog (por defecto: datadoghq.com)
Salida
Parámetro Tipo Descripción eventobjeto Detalles del evento creado
Nombre del monitor*
Alerta de uso alto de CPU
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
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ámetro Tipo Obligatorio Descripción namestring Sí Nombre del monitor typestring Sí 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 querystring Sí Consulta del monitor (p. ej., "avg(last_5m):avg:system.cpu.idle{*} < 20") messagestring No Mensaje para incluir con las notificaciones. Puede incluir @-menciones y markdown. tagsstring No Lista de etiquetas separadas por comas prioritynumber No Prioridad del monitor (1-5, donde 1 es la más alta) optionsstring No Cadena JSON de opciones del monitor (thresholds, notify_no_data, renotify_interval, etc.) apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción monitorobject Los detalles del monitor creado
Clave de aplicación*
••••••••
Obtener monitor (datadog_get_monitor)
Recuperar detalles de un monitor específico por ID.
Entrada
Parámetro Tipo Obligatorio Descripción monitorIdstring Sí El ID del monitor a recuperar groupStatesstring No Estados de grupo separados por comas a incluir: alert, warn, no data, ok withDowntimesboolean No Incluir datos de tiempo de inactividad con el monitor apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción monitorobject Los detalles del monitor
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ámetro Tipo Obligatorio Descripción groupStatesstring No Estados de grupo separados por comas para filtrar: alert, warn, no data, ok namestring No Filtrar monitores por nombre (coincidencia parcial) tagsstring No Lista de etiquetas separadas por comas para filtrar monitorTagsstring No Lista de etiquetas de monitor separadas por comas para filtrar withDowntimesboolean No Incluir datos de tiempo de inactividad con los monitores pagenumber No Número de página para paginación (indexado desde 0) pageSizenumber No Número de monitores por página (máx. 1000) apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción monitorsarray Lista de monitores
Á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ámetro Tipo Requerido Descripción monitorIdstring Sí El ID del monitor a silenciar scopestring No Ámbito para silenciar (p. ej., "host:myhost"). Si no se especifica, silencia todos los ámbitos. endnumber No Marca de tiempo Unix de cuándo debe finalizar el silencio. Si no se especifica, silencia indefinidamente. apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción successboolean Indica si el monitor se silenció correctamente
Consulta de búsqueda*
service:web-app status:error
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ámetro Tipo Requerido Descripción querystring Sí Consulta de búsqueda de registros (e.g., "service:web-app status:error") fromstring Sí Hora de inicio en formato ISO-8601 o relativa (e.g., "now-1h") tostring Sí Hora de finalización en formato ISO-8601 o relativa (e.g., "now") limitnumber No Número máximo de registros a devolver (por defecto: 50, máx.: 1000) sortstring No Orden de clasificación: timestamp (más antiguo primero) o -timestamp (más reciente primero) indexesstring No Lista separada por comas de índices de registros para buscar apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (por defecto: datadoghq.com)
Salida
Parámetro Tipo Descripción logsarray Lista de entradas de registro nextLogIdstring Cursor para paginación
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ámetro Tipo Obligatorio Descripción logsstring Sí Matriz JSON de entradas de registro. Cada entrada debe tener message y, opcionalmente, ddsource, ddtags, hostname, service. apiKeystring Sí Clave de API de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción successboolean Si los registros se enviaron correctamente
Operación
Crear tiempo de inactividad Á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ámetro Tipo Requerido Descripción scopestring Sí Alcance al que aplicar el tiempo de inactividad (p. ej., "host:myhost", "env:production", o "*" para todos) messagestring No Mensaje para mostrar durante el tiempo de inactividad startnumber No Marca de tiempo Unix para el inicio del tiempo de inactividad (por defecto, ahora) endnumber No Marca de tiempo Unix para el fin del tiempo de inactividad timezonestring No Zona horaria para el tiempo de inactividad (p. ej., "America/New_York") monitorIdstring No ID de monitor específico a silenciar monitorTagsstring No Etiquetas de monitor separadas por comas para coincidir (p. ej., "team:backend,priority:high") muteFirstRecoveryNotificationboolean No Silenciar la primera notificación de recuperación apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción downtimeobject Los detalles del tiempo de inactividad creado
Operación
Listar tiempos de inactividad Clave de aplicación*
••••••••
Listar tiempos de inactividad (datadog_list_downtimes)
Lista todos los tiempos de inactividad programados en Datadog.
Entrada
Parámetro Tipo Obligatorio Descripción currentOnlyboolean No Devolver solo los tiempos de inactividad activos actualmente monitorIdstring No Filtrar por ID de monitor apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción downtimesarray Lista de tiempos de inactividad
Operación
Cancelar tiempo de inactividad ID de tiempo de inactividad*
abc123
Clave de aplicación*
••••••••
Cancelar downtime (datadog_cancel_downtime)
Cancela un downtime programado.
Entrada
Parámetro Tipo Obligatorio Descripción downtimeIdstring Sí El ID del downtime que se va a cancelar apiKeystring Sí Clave de API de Datadog applicationKeystring Sí Clave de aplicación de Datadog sitestring No Sitio/región de Datadog (predeterminado: datadoghq.com)
Salida
Parámetro Tipo Descripción successboolean Indica si el downtime se canceló correctamente
Integra la monitorización de Datadog en los workflows. Envía métricas, gestiona monitores, consulta logs, crea eventos, gestiona downtimes y más.
Categoría: tools
Tipo: datadog