Application Real-Time Monitoring Service:Integrar alertas de Simple Log Service

Contexto

Alert Management se integra con Simple Log Service mediante webhooks, lo que permite gestionar las alertas de forma centralizada.

Crear una integración de Simple Log Service

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

2. En la página Integrations, haga clic en la pestaña Alert Integration y luego haga clic en Log Service.

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

   Nota

   Tiempo de recuperación automática tras el tiempo de espera: si un evento de alerta no se activa nuevamente dentro del período especificado, el evento se borra automáticamente.

4. En la sección Projects Enabling Alert Events, bajo All Projects, se muestran todos sus proyectos de Simple Log Service. Seleccione los proyectos cuyas alertas desea integrar, haga clic en el icono y luego haga clic en Save.

   Nota

   Esta función itera automáticamente por todas las reglas de alerta configuradas en los proyectos seleccionados y agrega la URL de solicitud para las alertas como https://alerts.aliyuncs.com/api/v1/events/{{token}}. La variable {{token}} es una clave que se genera automáticamente al crear la integración.

   Una vez completada la configuración, puede consultar la integración de Simple Log Service creada en la pestaña Alert Integration. Aparecerá un registro llamado Simple Log Service Integration en la lista de integraciones. Su estado será Enabled y su actividad Ready. Haga clic en Copy junto a la dirección de integración para copiar la dirección de la clave de integración. La columna Actions admite operaciones como Edit, Delete y Disable.

Integrar reglas de alerta específicas de Simple Log Service

1. En la página Integrations, en la pestaña Alert Integration, copie la URL de integración de la integración de Simple Log Service deseada.

2. Inicie sesión en la consola de Simple Log Service.

3. En el área Project, haga clic en el proyecto deseado. En el panel de navegación izquierdo, haga clic en el icono de alerta .

4. En la página Alert Center, seleccione Notification Objects > Webhook Integration. En la página Webhook Integration, haga clic en Create .

5. En el cuadro de diálogo que aparece, agregue el webhook general para ARMS Alert Management; para ello, establezca el nombre como ARMS Alert Management, seleccione General Webhook como tipo y configure los demás parámetros según las indicaciones de la interfaz.

6. En la página Alert Center, seleccione Notification Policies > Content Template. En la columna Actions de la plantilla deseada, haga clic en Modify. En el cuadro de diálogo que aparece, haga clic en la pestaña WebHook-Custom, configure el contenido del mensaje y luego haga clic en Confirm.

   {
   "uid": "{{ alert.aliuid }}",
   "project": "{{ alert.project }}(https://sls.console.alibabacloud.com/#/project/{{ alert.project }}/categoryList)",
   "trigger": "{{ alert.alert_name }}",
   "condition": "{{ alert.condition }}",
   "context": {{ alert.results[0].raw_results | to_json | quote }},
   "message": " [Uid] {{ alert.aliuid }}\n\n> [Project] [{{ alert.project }}](https://sls.console.alibabacloud.com/#/project/{{alert.project }}/categoryList)\n\n> [Trigger] {{ alert.alert_name }}\n\n> [Condition] {{ alert.alert_name }}\n\n> [Message] Notification content\n\n> [Context] {{ alert.results[0].raw_results | to_json | quote | removeprefix('"') | removesuffix('"') }}\n\n> [View details]({{ alert.query_url }})"
   }

7. En la página Alert Center, haga clic en la pestaña Alert rules. En la columna Actions de la regla deseada, haga clic en Edit. En el cuadro de diálogo que aparece, expanda Advanced Settings. En la sección Output Target, seleccione SLS Notification. En la sección Alert Policy, seleccione Simple Mode. Configure el canal de notificación para el webhook universal según las indicaciones y luego haga clic en OK.

Editar una integración

Alert Management proporciona asignaciones de campos predefinidas entre el origen de alertas de Simple Log Service y Alert Management. También puede agregar o modificar las asignaciones de campos en la página Edit Integration según sea necesario.

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 alertas externo 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 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 Alert Event History. 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 a fin de ver los detalles.

6. En la parte derecha de la sección Event Mapping, configure las asignaciones de campos entre el origen de alertas y 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 especificar dicho nodo como nodo raíz. Los datos pertenecientes al nodo raíz se procesan en 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. Opcional:Seleccione Configure Alert Recovery Events y configure las condiciones de campo para borrar alertas.

      Cuando ARMS recibe eventos, busca alertas que contengan valores de campo específicos y las borra. El campo que especifique para borrar alertas debe ser equivalente a la gravedad de la alerta en el evento. No puede usar el campo $.severity para borrar alertas. Por ejemplo, si el campo que especifica para borrar alertas es {$.eventType ="resolved"}, el sistema borrará automáticamente todas las alertas cuyo valor de eventType sea resolved en la integración.

   3. 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: puede 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 correspondiente. Solo se pueden usar caracteres especiales como delimitadores.

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

      • 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. La descripción 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 utiliza para asignar el gráfico de líneas.
      check	Elemento de comprobación de la alerta. Ejemplos: CPU, JVM, Application Crash y Deployment.
      source	Origen de la alerta.
      class	Tipo de objeto que activa 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. ARMS Alert Management le 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 cambiar los campos que se van a deduplicar.

   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 utilizarán para la deduplicación.

      Si varios eventos tienen el mismo valor para un campo especificado, los eventos 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. Después de configurar los ajustes, haga clic en Save.

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 ver los detalles del evento. Para obtener más información, consulte View alert event history.

Agregar proyectos a la integración

Para agregar alertas de nuevos proyectos a una integración existente de Simple Log Service, siga estos pasos:

1. En la página Integrations, busque la integración de Simple Log Service deseada y seleccione More > Select Service en la columna Actions.

2. En el cuadro de diálogo que aparece, seleccione los proyectos de los que desea recibir alertas, haga clic en el icono y luego haga clic en Save.

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: busque la integración y haga clic en la fila correspondiente. En la página Integration Details, consulte los detalles de la integración.

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

  Importante

  Después de actualizar la clave, vuelva a agregar la alerta de proyecto para Simple Log Service. Para obtener más información, consulte Add a product.

• 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 de la integración y luego 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 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 según la directiva configurada. 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.