Visión General

Honeycomb puede configurarse para enviar eventos a Rootly como alertas. Las alertas recibidas en Rootly pueden luego ser enrutadas a un canal de Slack, utilizadas para iniciar incidentes, o utilizadas para notificar a los objetivos de guardia de Rootly.

Instalación

Establecer Autenticación

Para configurar Honeycomb, primero deberá iniciar sesión en Honeycomb como un usuario administrador.

Una vez iniciada la sesión, asegúrese de estar en el entorno que desea integrar con Rootly y seleccione el icono de configuración ⚙️.

Luego, seleccione la pestaña API Keys > Configuration > Create Configuration API Key.

Honeycomb tiene dos tipos de claves API: Configuration y Management.

La que Rootly requiere es una clave API de Configuration (también conocida como Environment-level).

En el modal Create API Key, ingrese una descripciónName y marque cualquiera de los permisos. Una vez completado, guarde la clave API.

La integración con una clave API es puramente para autenticar a Rootly como cliente en su entorno de Honeycomb, para que podamos generar una combinación de URL de webhook + secreto exclusiva para su organización. Rootly NO realizará ninguna llamada directa a Honeycomb para leer o escribir. Rootly solo ingresará las alertas entrantes de Honeycomb.

La integración de Honeycomb se moverá a Rootly Alert Sources, por lo que este paso eventualmente quedará obsoleto.

Ahora, copie su clave API recién generada de Honeycomb y péguela en el modal de integración de Honeycomb en Rootly y seleccione Connect.

Para llegar al modal de integración de Honeycomb, necesitará ser un usuario Admin en Rootly y navegar a Integrations > Honeycomb > Setup

Una integración exitosa le proporcionará la combinación de URL de webhook + secreto necesaria para configurar webhooks en su cuenta de Honeycomb.

Crear un Webhook

Ahora que tiene su combinación específica de organización de URL de webhook + secreto, vayamos a su cuenta de Honeycomb para crear un webhook.

Una vez iniciada la sesión, navegue a la página de Team settings.

Luego seleccione la pestaña Integrations y haga clic en Add Integration.

En el modal Add Integration, establezca el Provider a Webhook y dele una descripciónName (por ejemplo, Notificar al Equipo de Ingeniería de Guardia, Notificar al Equipo de Infraestructura, Alertas de Rootly, etc.).

El valor que ponga en el campo Webhook URL dependerá del tipo de alerta que desee que este webhook en particular envíe a Rootly.

Para Alerta General (también conocida como Alerta Sin Notificación)

Las alertas sin notificación llegarán a la página de Alertas de Rootly pero no notificarán a nadie.

Honeycomb requiere que la URL del Webhook y el secreto de Rootly se incluyan en el campo Webhook URL en el siguiente formato:

Webhook URL
https://webhooks.rootly.com/webhooks/incoming/honeycomb\_webhooks?secret=<enter_sercret_here>

La URL del webhook y el secreto se pueden obtener de su página de integración de Honeycomb en Rootly (Integrations > Honeycomb > Configure).

Sí, el secreto debe existir tanto como parte de la Webhook URL ruta COMO en el campo Shared Secret. Asegúrese de que el secreto en ambos lugares sea exactamente el mismo.

Para Notificar al Equipo de Guardia de Rootly (también conocida como Alerta con Notificación)

La notificación a través del Equipo de Guardia de Rootly también se basa en alertas de webhook. La principal diferencia es la inclusión de un objetivo de notificación en el parámetro de consulta.

El objetivo de notificación consta de lo siguiente:

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

Ingrese el URL del webhook, secret y objetivo de notificación en el siguiente formato en el Webhook URL campo en Honeycomb:

Webhook URL
https://webhooks.rootly.com/webhooks/incoming/honeycomb_webhooks/notify/<resource_type>/<resource_id>?secret=<enter_sercret_here>

Sí, el secret debe existir tanto como parte de la ruta del URL del Webhook Y en el campo Shared Secret. Asegúrese de que el secret en ambos lugares sea exactamente el mismo.

Desinstalar

Puede desinstalar esta integración en el panel de integraciones haciendo clic en Configurar > Eliminar.

Asegúrese de eliminar también sus webhooks en Honeycomb. Eliminar la integración en Rootly NO detendrá a Honeycomb de enviar eventos de alerta a Rootly.

Soporte

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.