Integrar SkyWalking con ARMS - Application Real-Time Monitoring Service

Este tema describe cómo integrar SkyWalking con el subservicio de gestión de alertas de Application Real-Time Monitoring Service (ARMS).

Paso 1: Crear una integración de SkyWalking

Inicie sesión en la consola de ARMS. En el panel de navegación izquierdo, seleccione Alert Management > Integrations.
En la pestaña Alert Integration, haga clic en SkyWalking.
En el asistente Create SkyWalking Integration, introduzca un nombre y una descripción para la integración, establezca el tiempo de recuperación automática para los eventos de alerta y luego haga clic en Save.

Nota
Tiempo de recuperación automática tras agotar el tiempo de espera: si un evento de alerta no se activa nuevamente dentro del periodo especificado, el sistema lo borra automáticamente.
En la pestaña Alert Integration, busque la integración de SkyWalking que creó y copie su URL de webhook.

Paso 2: Configurar SkyWalking

Inicie sesión en el servidor donde está desplegado SkyWalking y vaya al directorio donde se encuentran los scripts de SkyWalking:
```
cd /opt/sky/apache-skywalking-apm-bin/
```
Ejecute el siguiente comando para ver la carpeta config en el directorio:
```
ls config/
```
Ejecute el siguiente comando para modificar el archivo alarm-settings.yml en la carpeta config:
```
vim config/alarm-settings.yml
```

Agregue la URL que obtuvo en Step 1 al campo webhook:

webhook
- https://alerts.aliyuncs.com/api/v1/skywalking/event/******

Ejecute el comando :wq para guardar los cambios en el archivo alarm-settings.yml.

(Opcional) Paso 3: Modificar la integración

ARMS proporciona asignaciones de campos predeterminadas entre los orígenes de alertas de SkyWalking y las alertas de ARMS. También puede agregar o modificar las asignaciones en la página Edit Integration.

Ejemplo de origen de alerta:

{
    "startTime":1630408697583,
    "scope":"SERVICE_INSTANCE",
    "scopeId":2,
    "name":"932******@127.0.XX.XX of testApp",
    "alarmMessage":"instance_jvm_cpu of 932******@127.0.XX.XX of testApp is more than 80 in 2 minutes of last 3 minutes",
    "ruleName":"instance_jvm_cpu_rule",
    "id1":"",
    "id0":"YnNtLXdlYg==.1_OTMyYjU1NmVmM2Y1NGR====--7p862kYTliODA4MTk0ZTJlODcxMWFAMTAuMS4xMS4xNg=="
}

En la pestaña Alert Integration, busque la integración que desea gestionar y haga clic en Edit en la columna Actions.
En la sección Event Mapping, haga clic en Send Test Data.
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 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.
En el cuadro de diálogo Send Test Data, haga clic en Disable.
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í ver los detalles.

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

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.

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.

Directa: el campo especificado del origen de alerta se asigna directamente al campo de alerta de ARMS correspondiente.
Serie: puede usar delimitadores para concatenar varios campos del origen de alerta 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 alerta 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 severidad del origen de alerta se asigna a la severidad de la alerta de ARMS. La tabla de asignación contiene únicamente el campo de severidad.

La siguiente tabla describe los campos de alerta de ARMS.

Campo de alerta	Descripción
alertname	El nombre de la alerta personalizada.
severity	El nivel de severidad de la alerta. Debe configurar asignaciones para este campo. El método de asignación debe establecerse en Directa.
message	La descripción de la alerta. Esta descripción se utiliza como contenido del mensaje de alerta y no puede exceder los 15,000 caracteres.
value	El valor de muestra de una métrica.
imageUrl	La URL del gráfico de líneas que contiene métricas de Grafana. Se utiliza para asignar el gráfico de líneas.
check	El elemento de comprobación de la alerta. Ejemplos: CPU, JVM, fallo de aplicación y despliegue.
source	El origen de la alerta.
class	El tipo de objeto que activa el evento de alerta; por ejemplo, host.
service	El servicio de origen de la alerta. Ejemplo: Login Service.
startat	La marca de tiempo que representa la hora de inicio del evento.
endat	La marca de tiempo que representa la hora de finalización del evento.
generatorUrl	La URL de los detalles del evento.

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 le permite previsualizar los resultados de agrupación por deduplicación de los 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, estos 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.
Después de configurar los ajustes, haga clic en Save.

Ver los detalles de un evento de alerta

En el panel de navegación izquierdo de la consola de ARMS, seleccione Alert Management > Alert Event History.
En la página Alert Event History, haga clic en el nombre del evento de alerta para ver sus detalles. Para obtener más información, consulte View alert event history.

Gestionar la integración

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:

Ver 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 la integración que desea modificar, 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 modificar el archivo

alarm-settings.yml

tal como se describe en

Step 2

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

Una vez creada la 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 ver las alertas generadas según la directiva de notificación configurada. Para obtener más información, consulte View alert sending history.