uno
Descripción general
Las notificaciones de alarma son vitales para las empresas y afectan directamente la estabilidad de la red. Con la plataforma de integración Feishu, puede conectar fácilmente Zabbix con Feishu y configurar de manera flexible varias notificaciones de alarma.
En el trabajo diario, el personal de operación y mantenimiento de TI necesita recibir y procesar información de alarmas de varios sistemas de TI de manera oportuna para garantizar un funcionamiento estable del sistema. En el sistema de monitoreo Zabbix, los usuarios pueden configurar la información de alarma que se enviará al Grupo Feishu para un procesamiento rápido. En este artículo, presentaremos cómo procesar la información de alarma de Zabbix en tarjetas de mensajes y enviarlas a mensajes de chat.
Vista previa del flujo de trabajo
Este proceso tiene los siguientes pasos
Activador de Zabbix: reciba información de devolución de llamada de Zabbix y active la ejecución del flujo de trabajo.
Analizar información de devolución de llamada: analiza información de devolución de llamada de Zabbix, incluida la conversión de formato de datos, empalme de información, etc.
Rama: Determina el tipo de mensaje actual.
Montar tarjeta de alarma: Reúne los datos de la tarjeta de mensaje.
Enviar mensaje de alarma: envía una tarjeta de mensaje de alarma al grupo especificado.
Ensamblar tarjeta de recuperación: Reúna los datos de la tarjeta de envío de mensajes.
Enviar mensaje de recuperación: envía una tarjeta de mensaje de recuperación al grupo especificado.
dos
Pasos
Preparación
1. Configure el tipo de medio Feishu en el sistema Zabbix y asocie usuarios y acciones.
1. Descargue el tipo de medio Zabbix de Feishu
Dirección de descarga: zbx_export_mediatype_feishu.xml
2. Importe el tipo de medio en Zabbix.
En la consola de Zabbix, seleccione Administración > Medios de alarma e importe el tipo de medio. Seleccione "Actualizar existente" y "Crear nuevo" para las reglas de importación.
3. Configure usuarios que admitan tipos de medios Feishu
En el sistema Zabbix, los tipos de medios admitidos por cada usuario deben configurarse por separado, por lo que los usuarios que admiten los tipos de medios Feishu deben configurarse. Recomendamos que cada grupo que recibe información de alarmas corresponda a un usuario del sistema Zabbix.
En la página Administración > Usuario, seleccione el usuario existente para editar o crear una nueva página de usuario, seleccione la página de medios de alarma, seleccione "Feishu" como tipo y complete la dirección de devolución de llamada de Feishu como destinatario.
Nota: El usuario seleccionado debe tener el permiso del host de la alarma; de lo contrario, la información de la alarma no se podrá enviar al usuario. Los permisos se pueden gestionar en grupos de usuarios.
Se puede hacer clic en la dirección de devolución de llamada en el nodo Zabbix en el flujo de trabajo , y la dirección de devolución de llamada se puede ver en la página de configuración a la derecha .
4. Modificar la configuración de la acción
En Configuración > Acción, seleccione la acción que debe enviarse al grupo objetivo para modificarla, seleccione la acción y agregue el objeto de envío en la página de operación (las operaciones, las operaciones de recuperación y las operaciones de actualización se pueden configurar y pueden configurarse según la situación y las necesidades reales). Para enviar al usuario, seleccione el usuario creado en el paso anterior y seleccione Feishu para "Enviar solo a".
Nota: La acción debe estar habilitada y la condición no puede estar vacía.
Nota: La versión de Zabbix debe ser 5.0 y superior para admitir la importación de tipos de medios.
2. Agrega un robot de envío de mensajes al chat grupal.
Vaya al grupo Feishu donde se enviará la información de sincronización, agregue una aplicación de robot de construcción propia (si aún no ha creado un robot, puede completar el " desglose paso a paso " a continuación antes de continuar con este paso). y en la configuración de administración del grupo, seleccione "¿Quién puede?" Hablar en este grupo "está configurado en "Todos los miembros del grupo" (requiere permisos de administrador del grupo).
subdividir gradualmente
1. Configurar las credenciales de la aplicación Zabbix
Haga clic en el nodo Zabbix en el flujo de trabajo y configure la credencial nueva/seleccione la credencial "Autorización de aplicación Zabbix" existente en la página de credenciales derecha. A continuación se utiliza "Nuevo" como ejemplo:
Al crear una nueva credencial de aplicación, complete los campos obligatorios y haga clic en Crear y conectar.
Nota: Si solo usa esta plantilla, los nombres de dominio ApiToken y Zabbix se pueden configurar en cualquier valor y la conexión entrará en vigencia al crear una conexión.
El ApiToken se crea en Zabbix Console>Configuración de usuario>Token API, como se muestra a continuación:
El nombre de dominio de Zabbix se completa con una dirección URL que no necesita contener parámetros de ruta de página y se puede acceder a ella desde la red pública . Por ejemplo, la dirección del panel es https://example.com/zabbix/zabbix.php?action=dashboard.view , luego la dirección completa es: https://example.com/zabbix/
2. Configurar la URL de Zabbix
Haga clic en el parámetro de entrada en el lado derecho del nodo de información de devolución de llamada de análisis y complete la URL de la base del sistema Zabbix en zabbix_url. Para conocer el método de adquisición específico, consulte la descripción en el paso anterior.
3. Configurar credenciales para aplicaciones Feishu
Haga clic en el certificado en el lado derecho del nodo Enviar información de alarma para crear/seleccionar un certificado de "Autorización de aplicación Feishu" existente. A continuación se utiliza "Nuevo" como ejemplo:
a. Haga clic en Nueva credencial de aplicación y haga clic en Nueva aplicación Feishu en la página de creación de credenciales .
Nota: Las aplicaciones Feishu creadas a través de la plataforma integrada enviarán automáticamente una solicitud de publicación. Si la aplicación no pasa la revisión de publicación, se informará un error al ejecutar el flujo de trabajo.
b. Actualice por lotes las credenciales de "Autorización de aplicación Feishu" creadas para los nodos conectores restantes de la "Serie Feishu".
C. Después de seleccionar el certificado, si el certificado requiere permisos de aplicación adicionales, puede hacer clic en Configurar credenciales de aplicación en el mensaje siguiente y enviar la solicitud de configuración con un solo clic.
4. Configurar la ID del grupo Feishu
Haga clic en los parámetros de entrada en el lado derecho del nodo para enviar información de alarma/enviar mensaje de recuperación respectivamente , y complete la identificación del grupo que necesita recibir información en el campo de identificación del receptor (para saber cómo obtener la identificación del grupo, consulte el grupo Descripción de ID - API de servidor - Documentos de desarrollo - Plataforma abierta Feishu ) .
5. Flujo de integración de versiones
Después de terminar de editar el flujo de trabajo, haga clic en Publicar y el flujo de trabajo entrará en vigor.
problema comun
1. ¿Cómo enviar diferentes alarmas a diferentes grupos de Feishu?
Método 1: cree múltiples flujos de integración en la plataforma de integración Feishu y cada flujo de integración tenga una dirección de devolución de llamada diferente. Luego cree varios usuarios en el sistema Zabbix y cada usuario puede especificar una dirección de devolución de llamada diferente.
Método 2: introduzca la lógica de juicio en la plataforma de integración Feishu, emita juicios en función de diferentes parámetros de entrada y envíelos a diferentes grupos de mensajes.
2. ¿Cómo agregar operaciones interactivas a las tarjetas de mensajes?
Si necesita agregar operaciones interactivas, primero debe crear una nueva tarjeta interactiva y agregar operaciones interactivas (para ver la introducción de la tarjeta, consulte Descripción general de la tarjeta de mensaje - Guía de desarrollo - Documentación de desarrollo - Plataforma abierta Feishu y módulos interactivos - Guía de desarrollo - Desarrollo Documentación: plataforma abierta Feishu ).
Después de completar el desarrollo de tarjetas interactivas, reemplace las tarjetas de mensajes en el flujo de trabajo actual.
3. ¿Cómo registrar las operaciones en la tarjeta de mensaje en una tabla multidimensional?
Puede consultar la interacción de la tarjeta de mensaje de plantilla para activar la actualización del contenido de la tarjeta, procesar la lógica de devolución de llamada de la tarjeta de mensaje y realizar los ajustes apropiados.
4. ¿Cómo personalizar el contenido de la información de la alarma en la tarjeta de alarma?
Método 1: la información de alarma en la tarjeta de alarma actual se toma de la macro preestablecida de Zabbix {ALTER.MESSAGE}. Esta información ayuda a los usuarios a personalizarla en los medios y la acción de Zabbix.
在Feishu的媒介类型进入Message templates中编辑消息内容，如下图所示。
在action配置中选择具体的配置，选定操作，在操作细节中选择自定义消息内容，可以按照需求进行定制。
方式二：通过工作流中的JavaScript脚本能力进行定制化处理，可以在工作流中选择 解析回调信息 节点，在入参页面，选择 编辑JavaScript Code进入编辑，按照自己的逻辑进行处理。
五、为什么告警消息没有发送到飞书
首先可以在zabbix的控制台的报表》动作日志中查看是否有相关发送给飞书的日志（如下图）。
如果没有任何相关的日志，则大概率是配置不正确。首先检查告警的人员或者群组是否有对应的主机和主机组的权限、其次按照上面的步骤再检查一遍。
如果存在日志，并显示错误则可以按照错误提示原因进行排查，常见的问题有：Zabbix主机无法访问公网等。
如果存在日志并且日志为已送达，则可以在Anycross的运行日志中进行排查，常见的问题有：应用凭证配置错误、群ID配置错误等。如何处理可以参考前面的步骤检查一遍。
六、如何修改通知卡片的标题
进入工作流的编辑模式，在 组装报警卡片 和 组装恢复卡片 找到event_name参数，对该参数进行调整即可。
点击查看官方原文。若需要更多关于 “Zabbix+飞书” 模板的需求，欢迎与我们联系。
延伸阅读
Z投稿|Zabbix 5.0 企业微信 WebHook 实现故障文本告警
本文分享自微信公众号 - Zabbix开源社区（china_zabbix）。
如有侵权，请联系 [email protected] 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。