Application Real-Time Monitoring Service:Integrar Zabbix

Requisitos previos

Solo se admite Zabbix 5.x.

Paso 1: Crear una integración de Zabbix

1. Inicie sesión en la consola de ARMS. En el panel de navegación izquierdo, seleccione Alert Management > Integrations.

2. En la pestaña Alert Integration, haga clic en Zabbix.

3. En el asistente Create Zabbix Integration, introduzca un nombre y una descripción para la integración, especifique el tiempo de recuperación automática y haga clic en Save.

   Nota

   Tiempo de recuperación automática tras agotar el tiempo de espera: si no se vuelve a desencadenar un evento de alerta dentro del periodo especificado, el sistema borra automáticamente dicho evento.

4. En la pestaña Alert Integration, busque la integración de Zabbix que creó y copie la URL de integración.

Paso 2: Configurar Zabbix

1. Inicie sesión en el servidor donde se despliega Zabbix y ejecute el siguiente comando para localizar la ruta de los scripts de Zabbix:

   cat /etc/zabbix/zabbix_server.conf | grep alert

   Respuesta de ejemplo:

   [root@localhost ~]# cat /etc/zabbix/zabbix_server.conf | grep alert
   #       Number of pre-forked instances of alerters.
   #       Full path to location of custom alert scripts.
   # AlertScriptsPath=${datadir}/zabbix/alertscripts
   AlertScriptsPath=/usr/lib/zabbix/alertscripts
   [root@localhost ~]#

2. Ejecute el comando cd para cambiar a la ruta de los scripts de Zabbix.

3. Ejecute el siguiente comando para descargar el paquete de instalación de la gestión de alertas de ARMS.

   wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz

4. Ejecute el siguiente comando para descomprimir el paquete de instalación.

   tar -xzvf aliyunalertmanager.tgz

5. Vaya al directorio bin del paquete de instalación.

   cd aliyunalertmanager/bin

6. Ejecute el siguiente comando para instalar la gestión de alertas de ARMS.

   sh install.sh <integration_url>

   Reemplace <integration_url> con la URL de integración que obtuvo en Step 1.

7. Durante la instalación, introduzca la URL de administración de Zabbix, el nombre de usuario del administrador y la contraseña cuando se le solicite.

(Opcional) Paso 3: Editar la integración

La gestión de alertas de ARMS incluye asignaciones de campos predeterminadas desde el origen de alertas de Zabbix hacia las alertas de ARMS. También puede agregar o modificar las asignaciones en la página Edit Integration según sea necesario.

Origen de alerta de ejemplo:

{
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Used space in Zabbix server value is 81 GB, triggered an alarm disk usage trigger",
    "hostname":"Zabbix server",
    "ip":"127.0.0.1",
    "severity":"Warning",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Used space",
    "alertname":"disk usage trigger",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}

1. En la pestaña Alert Integration, localice la integración que desea gestionar y haga clic en Edit en la columna Actions.

2. En la sección Event Mapping, haga clic en Send Test Data.

3. En el cuadro de diálogo Send Test Data, introduzca el contenido de alerta de un origen de alertas de terceros en formato JSON y haga clic en Send.

   Nota

   • Si aparece el mensaje Uploaded. No events are generated. Configure mappings based on the original data., significa que los campos del origen de alertas no están asignados a los campos de los eventos de alerta de ARMS. Los datos enviados se muestran en el cuadro izquierdo, lo cual permite seleccionar los campos de origen al configurar las asignaciones.

   • Si aparece el mensaje Uploaded., el contenido de la alerta se reporta en la página de historial de eventos de alerta. Para obtener más información, consulte View alert event history.

4. En el cuadro de diálogo Send Test Data, haga clic en Disable.

5. En la parte izquierda de la sección Event Mapping, haga clic en los registros de datos para los que desea configurar asignaciones y así consultar sus detalles.

6. En el panel derecho de la sección Event Mapping, asigne los campos de origen a los campos de alerta de ARMS.

   1. Opcional:En la sección Select Root Node, especifique si desea habilitar el procesamiento por lotes.

      Si existe un nodo de matriz en los datos de alerta, puede especificarlo como nodo raíz. Los datos pertenecientes al nodo raíz se procesan por lotes.

      Después de seleccionar Use Batch Processing, seleccione el nodo de matriz que se procesará por lotes como nodo raíz.

      Nota

      Si existen varios nodos de matriz en los datos de alerta, solo puede seleccionar uno de ellos para el procesamiento por lotes.

   2. En la sección Map Source Fields to Target Fields, asigne los campos del origen de alertas a los campos de alerta de ARMS.

      Haga clic en el icono de asignación para cambiar el método de asignación de campos.

      • Directa: el campo especificado del origen de alertas se asigna directamente al campo de alerta de ARMS correspondiente.

      • Serie: permite usar delimitadores para concatenar varios campos del origen de alertas en un solo campo y luego asignar este campo al campo de alerta de ARMS especificado. Solo se pueden utilizar caracteres especiales como delimitadores.

      • Condicional: los campos del origen de alertas especificados se asignan a los campos de alerta de ARMS únicamente cuando los valores de los campos cumplen las condiciones establecidas.

      • Tabla de asignación: la gravedad del origen de alertas se asigna a la gravedad de la alerta de ARMS. La tabla de asignación contiene únicamente el campo de gravedad.

      La siguiente tabla describe los campos de alerta de ARMS.

      Campo de alerta	Descripción
      alertname	Nombre de la alerta personalizada.
      severity	Nivel de gravedad de la alerta. Debe configurar asignaciones para este campo. El método de asignación debe establecerse en Directa.
      message	Descripción de la alerta. Se utiliza como contenido del mensaje de alerta y no puede superar los 15 000 caracteres.
      value	Valor de muestra de una métrica.
      imageUrl	URL del gráfico de líneas que contiene métricas de Grafana. Se usa para asignar el gráfico de líneas.
      check	Elemento de comprobación de la alerta. Ejemplos: CPU, JVM, fallo de aplicación y despliegue.
      source	Origen de la alerta.
      class	Tipo de objeto que desencadena el evento de alerta; por ejemplo, host.
      service	Servicio de origen de la alerta. Ejemplo: Login Service.
      startat	Marca de tiempo que representa la hora de inicio del evento.
      endat	Marca de tiempo que representa la hora de finalización del evento.
      generatorUrl	URL de los detalles del evento.

7. Configure la deduplicación de campos para los eventos de alerta.

   Para reducir datos duplicados, el sistema utiliza campos relevantes como base para la deduplicación. La gestión de alertas de ARMS permite previsualizar los resultados de agrupación por deduplicación de datos históricos de eventos que se muestran en la sección Event Mapping. Puede modificar los campos que se deduplicarán.

   Nota

   Solo puede configurar la deduplicación para eventos que no se han borrado.

   1. En la sección Event Deduplication de la página Integration Details, seleccione los campos que se usarán para la deduplicación.

      Si varios eventos tienen el mismo valor para un campo especificado, se fusionan en una sola notificación de alerta.

   2. Haga clic en Deduplication Test para previsualizar el grupo de alertas después de la deduplicación.

      Nota

      La prueba de deduplicación solo surte efecto en los últimos 10 registros de datos cargados en la parte izquierda de la sección Event Mapping.

8. Una vez configurados los ajustes, haga clic en Save.

Verificar la integración

Siga estos pasos para comprobar que la gestión de alertas de ARMS se instaló correctamente.

1. Inicie sesión en la consola de Zabbix.

2. En la barra de menú superior, seleccione Manage > Users.

   En la página Users, compruebe que se creó el usuario Aliyun Alert User, que su tipo es Zabbix Super Admin, que pertenece al grupo Aliyun Alert Group y que su estado es Enabled.

3. En la barra de menú superior, seleccione Manage > User groups.

   En la página User groups, compruebe que existe un grupo de usuarios llamado Aliyun Alert Group, que incluye a Aliyun Alert User como miembro y que su estado es Enabled.

4. En la barra de menú superior, seleccione Manage > Media types.

   En la página Media types, compruebe que existe un tipo de medio llamado Aliyun Alert Media, que su tipo es Script, que su estado es Enabled y que el nombre del script es aliyunalertmanager/bin/alert.sh.

5. En la barra de menú superior, seleccione Configurations > Action.

   En la página Action, compruebe que se creó una acción llamada Aliyun Alert Action, que su estado es Enabled y que su operación envía mensajes al usuario Aliyun Alert User a través de todos los medios.

   Nota

   Puede personalizar el contenido de alerta reportado en la acción Aliyun Alert Action según sus necesidades.

Consultar los detalles de un evento de alerta

1. En el panel de navegación izquierdo de la consola de ARMS, seleccione Alert Management > Alert Event History.

2. En la página Alert Event History, haga clic en el nombre del evento de alerta para consultar sus detalles. Para obtener más información, consulte View alert event history.

Gestionar integraciones

En el panel de navegación izquierdo, seleccione Alert Management > Integrations. En la pestaña Alert Integration, puede realizar las siguientes operaciones en las integraciones que haya creado:

• Consultar los detalles de una integración: localice la integración y haga clic en la fila correspondiente. En la página Integration Details, revise la información detallada de la integración.

• Actualizar clave: para actualizar la clave de una integración, localícela, seleccione More > Update Key en la columna Actions y luego haga clic en Confirm en el cuadro de diálogo que aparece.

  Importante

  Después de actualizar la clave, debe reinstalar la gestión de alertas de ARMS siguiendo las instrucciones de Step 2.

• Modificar una integración: localice la integración y haga clic en Edit en la columna Actions. En la página Integration Details, modifique la información de la integración y haga clic en Save.

• Habilitar o deshabilitar una integración: localice la integración y haga clic en Disable o Enable en la columna Actions.

• Eliminar una integración: localice la integración y haga clic en Delete en la columna Actions. En el mensaje que aparece, haga clic en OK.

• Agregar un flujo de procesamiento de eventos a una integración: localice la integración y haga clic en Add Event Processing Flow en la columna Actions. Para obtener más información, consulte Event processing flow.

• Crear una directiva de notificación: localice la integración para la que desea crear una directiva de notificación y haga clic en More en la columna Actions. En la lista que aparece, haga clic en Create Notification Policy. Para obtener más información, consulte Notification policies.

Siguientes pasos

Después de crear una directiva de notificación, el sistema genera alertas y envía notificaciones para los eventos de alerta reportados basándose en dicha directiva. Para obtener más información, consulte Notification policies. En la página Alert Sending History, puede consultar las alertas generadas según la directiva de notificación configurada. Para obtener más información, consulte View alert sending history.