​
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 ⚙️.
Document Image
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).
Document Image
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.
Document Image
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
Document Image
Una integración exitosa le proporcionará la combinación de URL de webhook + secreto necesaria para configurar webhooks en su cuenta de Honeycomb.
Document Image

​
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.
Document Image
Luego seleccione la pestaña Integrations y haga clic en Add Integration.
Document Image
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.).
Document Image
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).
Document Image
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>
Document Image
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.
Document Image
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.