​
Por qué

Prometheus Alertmanager le permitirá enviar un webhook a Rootly como una alerta entrante. La alerta entrante puede usarse luego para crear un incidente, notificar canales o llamar a objetivos de guardia.

​
Instalación

Localice Alertmanager en el catálogo de Integraciones y seleccione Setup. Se le presentará el siguiente pop-up.

​
Recibiendo Alertas Generales

Para enviar alertas generales (no de llamada) a Rootly, necesitará modificar el archivo de configuración alert-manager.yml como se muestra a continuación:

route:
  receiver: default
  group_by:
  - job
  routes:
  - receiver: rootly
    match:
      alertname: Rootly
    repeat_interval: 1m 

receivers:
 - name: rootly
   webhook_configs:
   - url: 'https://webhooks.rootly.com/webhooks/incoming/alertmanager_webhooks'
     send_resolved: true
     http_config:
       authorization:
         type: Bearer
         credentials: a0b9fcad1aae0689cfa05c17df497b2bc5c56d26d3e253503438864dbd6697ee

Copie el campo URL del Webhook y el secreto del pop-up anterior, y establézcalos como los parámetros url y credentials, respectivamente.

Si pierde el pop-up anterior, puede encontrarlo nuevamente desde su página de integración de Prometheus en Rootly (Integraciones > Prometheus > Configurar).

​
Para Llamar al Servicio de Guardia de Rootly

Prometheus (Alertmanager) se puede configurar de dos maneras diferentes para llamar al Servicio de Guardia de Rootly.

​
A través de la URL del Receptor en Alertmanager

De manera similar a la configuración de alerta sin llamada anterior, necesitará modificar el archivo de configuración alertmanager.yml como se muestra a continuación. La principal diferencia aquí es que el objetivo de notificación debe especificarse como parte de la URL de receivers.

route:
  receiver: default
  group_by:
  - job
  routes:
  - receiver: rootly
    match:
      alertname: Rootly
    repeat_interval: 1m 

receivers:
 - name: rootly
   webhook_configs:
   - url: 'https://webhooks.rootly.com/webhooks/incoming/alertmanager_webhooks/notify/User/27854'
     send_resolved: true
     http_config:
       authorization:
         type: Bearer
         credentials: a0b9fcad1aae0689cfa05c17df497b2bc5c56d26d3e253503438864dbd6697ee

Copie el campo URL del Webhook y el secreto del modal de configuración de Prometheus (Alertmanager) en Rootly, y establézcalos como los parámetros url y credentials, respectivamente.

Luego establezca el objetivo de notificación agregando lo siguiente al final de la url.

notify/<resource\_type>/<resource\_id>

El objetivo de notificación consta de lo siguiente:

  • resource_type - esto define el tipo de recurso de Rootly que se utilizará para la llamada.
    • Los siguientes son los valores disponibles: User | Group (Equipo) | EscalationPolicy | Service
  • resource_id - esto especifica el recurso exacto que será objetivo de la llamada.
    • El id del recurso se puede encontrar al editar cada recurso.

​
A través de la Anotación de Reglas de Prometheus

Si está utilizando las reglas de alerta de Prometheus, puede establecer el objetivo de notificación a través de las anotaciones en su archivo prometheus.rules.yml.

groups:
- name: ./rules.conf
  rules:

  # heartbeat alert
  - alert: Heartbeat
    expr: vector(1)
    labels:
      event: "Heartbeat"
      instance: "prometheus"
      monitor: "prometheus"
      severity: "major"
      timeout: "120"
    annotations:
      summary: "Heartbeat from prometheus"
      description: "Heartbeat from from prometheus"
      rootly: "{\"notification_target\":{\"type\":\"User\",\"id\":\"27854\"}}"

Los valores del objetivo de notificación se pueden establecer de la siguiente manera bajo el campo rootly:

  • Type - esto define el tipo de recurso de Rootly que se utilizará para la llamada.
    • Los siguientes son los valores disponibles: User | Group (Equipo) | EscalationPolicy | Service
  • id - esto especifica el recurso exacto que será objetivo de la llamada.
    • El id del recurso se puede encontrar al editar cada recurso.

​
Soporte

Por favor, visite https://prometheus.io/docs/alerting/latest/configuration/ para obtener más información sobre Prometheus Alertmanager.

Si necesita ayuda o más información sobre esta integración, por favor contacte a support@rootly.com o inicie un chat navegando a Ayuda > Chatear con Nosotros.