Honeycomb
Descripción general
Honeycomb se puede configurar 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ás iniciar sesión en Honeycomb como un usuario administrador.
Una vez que hayas iniciado sesión, asegúrate de estar en el entorno que deseas integrar con Rootly y selecciona el icono de configuración ⚙️.
Luego, selecciona la pestaña API Keys > Configuration > Create Configuration API Key.
Honeycomb tiene dos tipos de claves API: Configuration y Management API keys.
La que Rootly requiere es una clave API de Configuration (también conocida como Environment-level).
En el modal Create API Key, ingresa una descripción Name y marca cualquiera de los permisos. Una vez completado, guarda la clave API.
La integración con una clave API es puramente para autenticar a Rootly como cliente en tu entorno de Honeycomb, para que podamos generar una combinación de URL de webhook + secreto exclusiva para tu organización. Rootly NO realizará ninguna llamada directa a Honeycomb para leer o escribir. Rootly solo recibirá 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, copia tu clave API recién generada de Honeycomb y pégala en el modal de integración de Honeycomb en Rootly y selecciona Connect.
Para acceder al modal de integración de Honeycomb, debes ser un usuario Admin en Rootly y navegar a Integrations > Honeycomb > Setup
Una integración exitosa te proporcionará la combinación de URL de webhook + secreto necesaria para configurar webhooks en tu cuenta de Honeycomb.
Crear un Webhook
Ahora que tienes tu combinación específica de URL de webhook + secreto para tu organización, vamos a tu cuenta de Honeycomb para crear un webhook.
Una vez que hayas iniciado sesión, navega a la página de Team settings.
Luego selecciona la pestaña Integrations y haz clic en Add Integration.
En el modal Add Integration, establece el Provider a Webhook y dale una descripción Name (por ejemplo, Notificar al equipo de ingeniería de guardia, Notificar al equipo de infraestructura, Alertas de Rootly, etc.).
El valor que pongas en el campo Webhook URL dependerá del tipo de alerta que quieras que este webhook en particular envíe a Rootly.
Para Alerta General (también conocida como Alerta No Urgente)
Las alertas no urgentes 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:
La URL del webhook y el secreto se pueden obtener de tu página de integración de Honeycomb en Rootly (Integrations > Honeycomb > Configure).
Sí, el secreto debe existir tanto como parte de la ruta Webhook URL COMO en el Shared Secret campo. Asegúrese de que el secreto en ambos lugares sea exactamente el mismo.
Para Notificar al Equipo de Guardia de Rootly (también conocido como Alerta de Paginació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 consiste en 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
- Los siguientes son los valores disponibles:
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 la URL del webhook, secreto y objetivo de notificación en el siguiente formato en el campo Webhook URL en Honeycomb:
Sí, el secreto debe existir tanto como parte de la ruta de la URL del Webhook COMO en el campo Secreto Compartido. Asegúrese de que el secreto 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.