Supported OS Linux Windows Mac OS

Información general

La integración de Torq te permite desencadenar flujos de trabajo en respuesta a alertas de Datadog, proporcionando una mejora en las alertas. A continuación, puedes devolver eventos directamente desde tus flujos de trabajo de Torq a tu flujo de eventos de Datadog y dashboard de Torq dedicado.

Configuración

Para configurar esta integración, debes tener una cuenta de Torq activa y un rol de Propietario de cuenta en esa cuenta. También debes tener permisos de administrador adecuados en Datadog.

Crear una integración de disparador de Datadog en Torq

  1. Ve a Integrations > Triggers (Integraciones > Disparadores), ubica la tarjeta Datadog y haz clic en Add (Añadir).

  2. Introduce un nombre significativo para la integración y haz clic en Add (Añadir).

  3. Copia la URL del webhook generado. Necesitas esta URL para configurar una integración de webhook en tu inquilino de Datadog.

Definir monitores de Datadog para activar eventos en Torq

  1. Ve a Integrations > Integrations (Integraciones > Integraciones), haz clic en la tarjeta Webhooks y haz clic en New (Nuevo). datadog_webhook

  2. Introduce un nombre significativo para la integración de webhook y pega la URL del webhook generada por Torq. Necesitas el nombre de la integración para asociar el identificador (utilizado para monitores específicos de Datadog para activar Torq) y la URL de webhook generada desde Torq. datadog_webhook_2

  3. Torq recomienda añadir información adicional de alerta a la carga útil. Puedes utilizar partes de la siguiente configuración:

    {
        "body": "$EVENT_MSG",
        "title": "$EVENT_TITLE",
        "date": "$DATE",
        "id": "$ID",
        "metadata": {
            "AGGREG_KEY": "$AGGREG_KEY",
            "ALERT_CYCLE_KEY": "$ALERT_CYCLE_KEY",
            "ALERT_ID": "$ALERT_ID",
            "ALERT_METRIC": "$ALERT_METRIC",
            "ALERT_QUERY": "$ALERT_QUERY",
            "ALERT_SCOPE": "$ALERT_SCOPE",
            "ALERT_STATUS": "$ALERT_STATUS",
            "ALERT_TITLE": "$ALERT_TITLE",
            "ALERT_TRANSITION": "$ALERT_TRANSITION",
            "ALERT_TYPE": "$ALERT_TYPE",
            "EMAIL": "$EMAIL",
            "EVENT_MSG": "$EVENT_MSG",
            "EVENT_TITLE": "$EVENT_TITLE",
            "EVENT_TYPE": "$EVENT_TYPE",
            "HOSTNAME": "$HOSTNAME",
            "ID": "$ID",
            "LAST_UPDATED": "$LAST_UPDATED",
            "LINK": "$LINK",
            "METRIC_NAMESPACE": "$METRIC_NAMESPACE",
            "ORG_ID": "$ORG_ID",
            "ORG_NAME": "$ORG_NAME",
            "PRIORITY": "$PRIORITY",
            "SNAPSHOT": "$SNAPSHOT",
            "TAGS": "$TAGS",
            "TEXT_ONLY_MSG": "$TEXT_ONLY_MSG",
            "USER": "$USER",
            "USERNAME": "$USERNAME",
            "LOGS_SAMPLE": "$LOGS_SAMPLE"
        }
    }
    
  4. Elige monitores para activar manuales de Torq y añade una referencia a la integración de webhook recién creada en el campo Alert Your Team (Alerta a tu equipo). Para más detalles, consulta Gestionar monitores.

Utiliza pasos de Datadog en los flujos de trabajo de Torq

Necesitas crear una clave de API de Datadog y una clave de aplicación para utilizarlas como parámetros de entrada para los pasos de Datadog en Torq.

Nota: Algunos pasos de Datadog en Torq requieren una clave de API y una clave de aplicación, mientras que otros pasos requieren la integración de Datadog.

Crear una clave de API en Datadog

Después de crear la clave de API, cópiala y guárdala porque no podrás acceder a ella más tarde. Para obtener más información, consulta Claves de API y de aplicación.

  1. Pasa el ratón por encima de tu nombre de usuario y selecciona Organization Settings (Parámetros de organización).
  2. En el panel izquierdo, haz clic en API Keys (Claves de API).
  3. Haz clic en + New Key (+ Clave nueva). datadog_api_key
  4. Introduce un nombre significativo para la clave de API, como Torq, y haz clic en Create key (Crear clave).
  5. Copia la Key y guárdala. Necesitas esta clave para crear una integración de Datadog en Torq.

Crear una clave de aplicación en Datadog

Después de crear la clave de aplicación, cópiala y guárdala porque no podrás acceder a ella más tarde. Para obtener más información, consulta Claves de API y de aplicación.

  1. Pasa el ratón por encima de tu nombre de usuario y selecciona Organization Settings (Parámetros de organización).
  2. En el panel izquierdo, haz clic en Application Keys (Claves de aplicación).
  3. Haz clic en + New Key (+ Clave nueva). datadog_app_key
  4. Introduce un nombre significativo para la clave de aplicación, como Torq, y haz clic en Create key (Crear clave).
  5. Copia la Key y guárdala. Necesitas esta clave para crear una integración de Datadog en Torq.

Crear una integración de Datadog en Torq

Esta integración te permite utilizar pasos de Datadog en tus flujos de trabajo de Torq.

  1. Ve a Integrations > Steps (Integraciones > Pasos), ubica la tarjeta Datadog y haz clic en Add (Añadir).

  2. Introduce un nombre significativo para la integración, como Datadog-<monitor_type>, y haz clic en Add (Añadir).

Datos recopilados

Métricas

La integración de Torq no proporciona ninguna métrica.

Eventos

La integración de Torq te permite enviar eventos a tu flujo de eventos de Datadog desde un flujo de trabajo de Torq utilizando el paso Post Event (Publicar evento) de Datadog. Puedes utilizar el paso con tus manuales para notificar a Datadog sobre mitigaciones exitosas y fallos de ejecución. También puedes enviar datos de alerta mejorada a Datadog.

Checks de servicio

La integración de Torq no incluye ningún check de servicio.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el equipo de asistencia de Datadog.