Application Real-Time Monitoring Service:Integración de alertas de Cloud Monitor

Contexto

Alert Management en ARMS admite el uso de un webhook para ingerir las alertas que genera Cloud Monitor. Una vez integradas, se gestionan desde una ubicación central. Esto centraliza las configuraciones de alerta que, de otro modo, estarían dispersas en sistemas con distintas capacidades de manejo.

Creación de una integración de Cloud Monitor

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 CloudMonitor.

3. En el cuadro de diálogo Create Cloud Monitor Integration, introduzca un nombre y una descripción para la integración. Luego, especifique el tiempo de recuperación automática de los eventos de alerta.

   Nota

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

4. En la sección Products Enabling Alert Events, el área All Products muestra los productos compatibles con Cloud Monitor que se pueden integrar en Alert Management. Seleccione los productos cuyas alertas desea integrar, haga clic en el icono y, a continuación, haga clic en Save.

   Nota

   Esta función recorre automáticamente todas las reglas de alerta configuradas para los productos seleccionados. Además, cambia la URL de devolución de llamada de dichas reglas a https://alerts.aliyuncs.com/api/v1/cm/callback/{{token}}. En la URL, {{token}} es la clave que se genera automáticamente al crear la integración.

   Una vez completada la configuración, la nueva integración de Cloud Monitor aparece en la pestaña Alert Integration. La lista de integraciones muestra el nombre, la URL de integración (que incluye la clave generada automáticamente), el tipo y la hora de creación. Su estado es Enabled y su nivel de actividad es Ready. En la columna Actions, puede Edit, Delete o Disable la integración.

Integración de una regla de alerta específica de Cloud Monitor

1. En la página Integration, vaya a la pestaña Alert Integration y copie la URL de integración de la integración de Cloud Monitor deseada.

2. Inicie sesión en la consola de Cloud Monitor.

3. En el panel de navegación izquierdo, seleccione Alerts > Alert Rules.

4. En la página Alert Rules, busque la regla de alerta que desea modificar y haga clic en Modify en la columna Actions.

5. En la sección Advanced Settings, establezca la URL de devolución de llamada de la alerta con la URL de integración que copió.

6. Haga clic en Confirm.

Edición de una integración

Alert Management en ARMS proporciona asignaciones predefinidas entre los campos de origen de alerta de Cloud Monitor y los campos de alerta de ARMS. También puede agregar o modificar estas asignaciones de campos según sus necesidades en la página Edit Integration.

1. En la pestaña Alert Integration, busque 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 alerta 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 alerta no están asignados a los campos de los eventos de alerta de ARMS. Los datos enviados se muestran en el cuadro izquierdo, lo que le 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 la parte derecha de la sección Event Mapping, configure las asignaciones entre los campos del origen de alerta y los campos de alerta de ARMS.

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

      Si los datos de alerta contienen un nodo de matriz, puede especificarlo como nodo raíz. Los datos que pertenecen a dicho nodo se procesan en lotes.

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

      Nota

      Si los datos de alerta contienen varios nodos de matriz, 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 alerta 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.

      • Direct: el campo especificado del origen de alerta se asigna directamente al campo de alerta indicado de ARMS.

      • Series: utiliza delimitadores para concatenar varios campos del origen de alerta en uno solo. Después, este campo se asigna al campo de alerta especificado de ARMS. Solo se permiten caracteres especiales como delimitadores.

      • Conditional: los campos del origen de alerta se asignan a los campos de alerta de ARMS únicamente cuando sus valores cumplen las condiciones especificadas.

      • Mapping table: la gravedad del origen de alerta se asigna a la gravedad de la alerta de ARMS. Esta tabla de asignación solo contiene el campo de gravedad.

      A continuación se describen 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 y establecer el método de asignación en Direct.
      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 las métricas de Grafana. Se usa para asignar dicho gráfico.
      check	Elemento de comprobación de la alerta. Por ejemplo: CPU, JVM, Application Crash y Deployment.
      source	Origen de la alerta.
      class	Tipo de objeto que activa el evento de alerta; por ejemplo, un host.
      service	Servicio de origen de la alerta. Por 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 los datos duplicados, el sistema utiliza los campos relevantes como base de deduplicación. Alert Management de ARMS le permite previsualizar los resultados de agrupación por deduplicación de los datos de eventos históricos mostrados en la sección Event Mapping. Puede cambiar los campos que se van a deduplicar.

   Nota

   La deduplicación solo se configura 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 en un campo especificado, se combinan 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 terminada la configuración, haga clic en Save.

Consulta de 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.

Adición de productos

Siga estos pasos para agregar alertas de nuevos productos a una integración de Cloud Monitor existente:

1. En la consola de ARMS, busque la integración de Cloud Monitor deseada en la página Integration y seleccione More > Select Service.

2. En el cuadro de diálogo que aparece, seleccione los servicios de Cloud Monitor de los que desea ingerir alertas, haga clic en el icono y, a continuación, haga clic en Save.

Gestión de integraciones

En el panel de navegación izquierdo, seleccione Alert Management > Integrations. En la pestaña Alert Integration, puede llevar a cabo las siguientes operaciones con las integraciones que creó:

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

• Actualizar una clave: busque la integración deseada, seleccione More > Update Key en la columna Actions y haga clic en Confirm.

  Importante

  Después de actualizar la clave, debe volver a agregar los productos de Cloud Monitor. Para obtener más información, consulte Add products.

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

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

• Eliminar una integración: busque 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: busque 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: busque la integración para la que desea crearla 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.

Pasos siguientes

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