Application Real-Time Monitoring Service:Integración de Jira mediante credenciales de cuenta

Configurar la integración de Jira en ARMS

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

2. En la página Integrations, haga clic en la pestaña Notification Integration y luego haga clic en JIRA.

3. En el asistente Add Integration, complete los siguientes pasos:

   1. En la página Basic Information, introduzca un nombre para la integración y la URL de la instancia de Jira. Establezca Verification method en Log on with Jira account e introduzca el nombre de usuario y la contraseña de Jira. De forma opcional, agregue una descripción y haga clic en Test Connectivity.

   2. Una vez que aparezca el mensaje Connection Succeeded, haga clic en Next.

      Nota

      Si la conexión falla, es posible que la URL de Jira, el nombre de usuario o la contraseña sean incorrectos. Corrija la configuración y haga clic nuevamente en Test Connectivity.

   3. En la página Alert Source Configuration, configure los ajustes de sincronización de alertas como se describe en la siguiente tabla y haga clic en Save.

      Parámetro	Descripción	Ejemplo
      Project	El proyecto de Jira donde se crean las incidencias cuando se activa una alerta.	Proyecto de monitoreo, gestión y control integrados
      Type	El tipo de incidencia de Jira para la alerta. Task Subtask Improvement New feature Bug Epic Story	Bug
      Issue closed status	El estado que marca una incidencia de Jira como cerrada. Una vez que una incidencia alcanza este estado, las operaciones posteriores de la alerta ya no se sincronizan con ella. Estados disponibles: To Do In Progress In Review Done Nota Se recomienda seleccionar Done. Si selecciona un estado diferente, las operaciones de la alerta seguirán sincronizándose con la incidencia correspondiente en Jira incluso después de que su estado cambie a Done.	Done
      Priority	Asigna los niveles de gravedad de las alertas a las prioridades de las incidencias en Jira. Importante Si no configura una asignación para un nivel de gravedad de alerta, las alertas de ese nivel no se sincronizarán con Jira. El nivel de gravedad de la alerta se sincroniza según esta asignación solo cuando se envía a Jira por primera vez. Los cambios posteriores en el nivel de gravedad de la alerta en ARMS Alert Management no se sincronizan con la incidencia de Jira.	P1: Hightest P2: High P3: Medium P4: Low P5: Lowest

   Después de guardar la configuración, puede consultar la nueva integración de Jira en la pestaña Notification Integration. La lista muestra información como Name, Integration key, Type y Creation time. Puede gestionar la integración desde la columna Actions.

Enviar alertas a Jira

Después de configurar la integración de Jira, puede enviar alertas a Jira de tres maneras:

Método 1

Configure una directiva de notificación para crear automáticamente una incidencia en Jira cuando se active una alerta.

1. En el panel de navegación izquierdo, vaya a Alert Management > Notification Policies.

2. En la página Notification Policies, haga clic en Create Notification Policy o edite una directiva de notificación existente.

3. En la sección When an alert is triggered, , especifique los Contacts. Debe seleccionar como mínimo un contacto o grupo de contactos.

   Importante

   • Jira asigna la incidencia a un usuario cuya dirección de correo electrónico o nombre de usuario coincida con los del primer contacto en la directiva de notificación.

   • Si el primer contacto en la directiva de notificación no tiene un usuario correspondiente en Jira, la alerta no se sincronizará con Jira.

4. Para Ticket system, seleccione la integración de Jira que creó. Configure otros parámetros según sea necesario. Para obtener más información, consulte Notification policies.

5. Haga clic en Save.

   Una vez completada la configuración, las alertas que coincidan con esta directiva de notificación se enviarán a Jira.

Método 2

Desde la página Alert Sending History, puede enviar manualmente una alerta existente a Jira para crear una incidencia.

1. En el panel de navegación izquierdo, vaya a Alert Management > Alert Sending History.

2. En la página Alert Sending History, seleccione un operador en la esquina superior derecha para que actúe como responsable de la incidencia en Jira y haga clic en el nombre de la alerta objetivo.

   Importante

   • Jira asigna la incidencia a un usuario cuya dirección de correo electrónico o nombre de usuario coincida con los del operador seleccionado.

   • Si el operador no tiene un usuario correspondiente en Jira, la alerta no se puede sincronizar con Jira.

3. En la página de detalles de la alerta, haga clic en el icono en la esquina superior derecha y luego haga clic en Push Alerts.

4. En el cuadro de diálogo que aparece, para Ticket system, seleccione la integración de Jira que creó y haga clic en Confirm.

   Después de enviar correctamente la alerta, aparecerá un enlace a la incidencia correspondiente en Jira, como AL-6, en la página de detalles de la alerta.

Método 3

Cuando reciba una tarjeta de alerta en un grupo de DingTalk, puede enviar la alerta correspondiente a Jira directamente desde la tarjeta.

• En la tarjeta de alerta que recibe en el grupo de DingTalk, haga clic en Push Alerts y seleccione la integración de Jira que creó.

• En la tarjeta de alerta, haga clic en el nombre de la alerta. En el panel de detalles de la alerta, haga clic en Settings, haga clic en Push ticket y seleccione la integración de Jira que creó.

Después de enviar correctamente la alerta, aparecerá un enlace a la incidencia correspondiente en Jira en la página de detalles de la alerta.

Supported alert operations for synchronization

Una vez configurada, las siguientes operaciones de alerta en ARMS Alert Management se sincronizan con el sistema de tickets de Jira.

Operaciones en la página Alert Sending History:

• Reclamar alerta: Actualiza el responsable de la incidencia en Jira.

  Nota

  El usuario que reclama la alerta debe tener una cuenta de usuario correspondiente en Jira.

• Comentar en la alerta: Agrega el comentario a la incidencia de Jira.

• Resolver alerta: Agrega la resolución como comentario a la incidencia de Jira.

Operaciones en la tarjeta de alerta en un grupo de DingTalk:

Reclamar alerta: Actualiza el responsable de la incidencia en Jira.

Sincronizar acciones de Jira con ARMS

1. En ARMS Alert Management, vaya a la página Integrations, haga clic en la pestaña Notification Integration y copie la clave de integración de su integración de Jira.

2. Inicie sesión en su sistema de tickets de Jira. En la esquina superior derecha de la página de Jira, haga clic en el icono de configuración y luego haga clic en OsType.

3. Introduzca su contraseña de administrador y haga clic en Confirm para ir a la página de configuración del sistema.

4. En el panel de navegación izquierdo de la página OsType, vaya a Alerts > Webhook.

5. En la página Webhooks, haga clic en + Create a webhook.

6. En la página Create a webhook, establezca la URL en http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}. Reemplace {token} con la clave de integración de Jira de Step 1.

   Establezca Name en ARMS Alert Management y cambie el Status a Enabled. En la sección Issue related events, seleccione All issues. En la columna Issue, seleccione created, updated y deleted. En la columna Comment, seleccione created, updated y deleted.

7. Configure otros parámetros según sea necesario. Para obtener más información, consulte la documentación oficial de Jira. Luego, haga clic en Create .

   Después de completar estos pasos, las siguientes operaciones de incidencias de Jira se sincronizan con ARMS Alert Management.

   • Cambiar el responsable de la incidencia: Se actualiza el responsable de la alerta correspondiente.

   • Agregar un comentario a una incidencia: Se agrega un comentario a la alerta correspondiente.