Supported OS Linux Windows Mac OS

Información general

Utiliza la integración de SIGNL4 para enviar alertas de Datadog a los equipos de SIGNL4 y tomar medidas sin problemas sobre estas alertas dentro de la aplicación SIGNL4.

Conecta SIGNL4 a Datadog para:

  • Desencadenar y resolver incidencias de Datadog
  • Abordar las incidencias y establecer políticas de escalada a medida que se producen
  • Establecer un recordatorio diario de quién está de guardia

SIGNL4 App

Configuración

SIGNL4

Sigue estos pasos en SIGNL4:

  1. Utiliza tu cuenta existente o crea una cuenta SIGNL4 en signl4.com.

  2. En tu aplicación SIGNL4, encuentra la dirección de tu webhook SIGNL4 incluyendo el secreto de tu equipo en Teams -> Your Team -> Secret (Equipos -> Tu equipo -> Secreto).

Alertas de Datadog

Puedes alertar a tu equipo de SIGNL4 sobre nuevas alertas en Datadog. Las alertas que se resuelven en Datadog cierran automáticamente la alerta en SIGNL4. Para ello es necesario configurar:

  1. Navega hasta el cuadro de integración de webhooks.

  2. En la pestaña Configuration (Configuración), ve a webhooks y haz clic en New (Nuevo).

  3. En New Webhook (Nuevo webhook), introduce un Name significativo y utiliza la URL de webhook de SIGNL4 (creada anteriormente) incluyendo el secreto de tu equipo, por ejemplo:

    https://connect.signl4.com/webhook/[team-secret]?ExtIDParam=alertId&ExtStatusParam=alertTransition&ResolvedStatus=Recovered
    

    Sustituye aquí [team-secret] por el secreto de tu equipo de SIGNL4.

    Webhook de alertas de SIGNL4

  4. Copia y pega el siguiente JSON en el cuadro de texto Payload:

    {
        "title": "$EVENT_TITLE",
        "message": "$TEXT_ONLY_MSG",
        "link": "$LINK",
        "priority": "$ALERT_PRIORITY",
        "host": "$HOSTNAME",
        "alertScope": "$ALERT_SCOPE",
        "alertStatus": "$ALERT_STATUS",
        "alertId": "$ALERT_ID",
        "alertTransition": "$ALERT_TRANSITION",
        "X-S4-SourceSystem": "Datadog",
        "date": "$DATE",
        "org": {
            "id": "$ORG_ID",
            "name": "$ORG_NAME"
        },
        "id": "$ID"
    }
    

Puedes adaptar los parámetros según tus necesidades, pero deja alertId, alertTransition y X-S4-SourceSystem sin cambios.

  1. Haz clic en Save (Guardar) para crear el webhook.

Para más detalles, consulta Alerta móvil con el seguimiento y escalamiento para Datadog.

Ahora puedes utilizar tu webhook como un canal de notificación en tu monitor. Suponiendo que el nombre de tu webhook sea SIGNL4, envía notificaciones utilizando @webhook-SIGNL4. Cuando las condiciones del monitor se cumplen, tu equipo recibe una nueva alerta de SIGNL4.

Incidencias de Datadog

Puedes alertar a tu equipo de SIGNL4 sobre nuevas incidencias en Datadog. Las incidencias que se resuelven en Datadog cierran automáticamente la alerta en SIGNL4. Para ello es necesario configurar lo siguiente:

  1. Navega hasta el cuadro de integración de webhooks.

  2. En la pestaña Configuration (Configuración), ve a webhooks y haz clic en New (Nuevo).

  3. En New Webhook (Nuevo webhook), introduce un Name significativo y utiliza la URL de webhook de SIGNL4 (creada anteriormente) incluyendo el secreto de tu equipo, por ejemplo:

    https://connect.signl4.com/webhook/[team-secret]?ExtIDParam=s4ExternalId&ExtStatusParam=incidentStatus&ResolvedStatus=resolved
    

    Sustituye [team-secret] en la URL por el secreto de tu equipo de SIGNL4.

    Webhook de incidencias de SIGNL4

  4. Copia y pega el siguiente JSON en el cuadro de texto Payload:

    {
        "title": "$EVENT_TITLE",
        "message": "$TEXT_ONLY_MSG",
        "link": "$LINK",
        "priority": "$ALERT_PRIORITY",
        "host": "$HOSTNAME",
        "alertScope": "$ALERT_SCOPE",
        "alertStatus": "$ALERT_STATUS",
        "alertId": "$ALERT_ID",
        "incidentPublicId": "$INCIDENT_PUBLIC_ID",
        "incidentStatus": "$INCIDENT_STATUS",
        "alertTransition": "$ALERT_TRANSITION",
        "s4ExternalId": "DATADOG-INCIDENT-$INCIDENT_PUBLIC_ID",
        "X-S4-SourceSystem": "Datadog",
        "date": "$DATE",
        "org": {
            "id": "$ORG_ID",
            "name": "$ORG_NAME"
        },
        "id": "$ID"
    }
    

Adapta los parámetros según tus necesidades, pero deja incidentStatus, s4ExternalId y X-S4-SourceSystem sin cambios.

  1. Haz clic en Save (Guardar) para crear el webhook.

Para más detalles, consulta Alerta móvil con el seguimiento y escalamiento para Datadog.

Regla sobre incidencias

Puedes crear una regla en Datadog en Monitors -> Settings (Incidents) Rules (Monitores -> Reglas de configuración (incidencias). En la regla se especifican los criterios, por ejemplo, la gravedad, servicio, etc. Para “Other attributes” (Otros atributos), es recomendado utilizar “state:active” para activar una nueva alerta y “state:resolved” para cerrar la alerta. En “Notify” (Notificar), selecciona tu webhook de incidencias de SIGNL4 tal y como se ha creado anteriormente.

![Regla de incidencias de SIGNL4] [7

Si creas una nueva incidencia, tu equipo de SIGNL4 recibe una alerta. Si reconoce o cierras la alerta en la aplicación de SIGNL4, el estado de la incidencia se establece en Estable o Resuelta.

Además, si estableces el estado de la incidencia en Resuelta en Datadog, esto cierra la alerta en SIGNL4.

Actualización del estado de las incidencias en Datadog

Para las incidencias de Datadog, puedes actualizar el estado a Estable o Resuelta directamente desde tu aplicación de SIGNL4 reconociendo o cerrando la alerta respectiva.

Con el fin de configurar este canal de retorno, ve a tu portal web de SIGNL4 y luego a Teams -> Apps (Equipos -> Aplicaciones). Busca la aplicación del conector de Datadog y haz clic en “Create” (Crear) allí. Puedes encontrar más información directamente en la configuración de la aplicación.

Aplicación del conector de Datadog

Tienes que configurar lo siguiente:

  • URL de Datadog: la URL de tu instancia de Datadog, por ejemplo, https://app.datadoghq.com/ o https://app.datadoghq.eu/.
  • Clave de API de Datadog: tu clave de API en Datadog. Puedes encontrar o crear una clave de API en Datadog en tu cuenta, Organization Settings -> API Keys (Parámetros de organización -> Claves de API).
  • Clave de aplicación de Datadog: tu clave de aplicación en Datadog. Puedes encontrar o crear una clave de aplicación en Datadog en tu cuenta, Organization Settings -> Application Keys (Parámetros de organización -> Claves de aplicación).
  • Reconocimiento como Estable: los reconocimientos establecen el estado de la incidencia como Estable.

Datos recopilados

Métricas

La integración de SIGNL4 no incluye ninguna métrica.

Eventos

Los eventos activados y resueltos por SIGNL4 aparecen en tu aplicación y portal web de SIGNL4.

Checks de servicio

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

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el Soporte de SIGNL4.

PREVIEWING: piotr_wolski/update-dsm-docs