Application Real-Time Monitoring Service:Intégrer Jira à l'aide des identifiants de compte

Configurer l'intégration Jira dans ARMS

1. Connectez-vous à la console ARMS. Dans le volet de navigation de gauche, accédez à Alert Management > Integrations.

2. Sur la page Integrations, cliquez sur l'onglet Notification Integration, puis cliquez sur JIRA.

3. Dans l'assistant Add Integration, suivez les étapes ci-dessous :

   1. Sur la page Basic Information, saisissez un nom d'intégration et l'URL de l'instance Jira. Définissez Verification method sur Log on with Jira account, puis entrez le nom d'utilisateur et le mot de passe Jira. Ajoutez une description si nécessaire, puis cliquez sur Test Connectivity.

   2. Une fois le message Connection Succeeded affiché, cliquez sur Next.

      Remarque

      Si la connexion échoue, vérifiez l'URL Jira, le nom d'utilisateur et le mot de passe. Corrigez les paramètres et cliquez à nouveau sur Test Connectivity.

   3. Sur la page Alert Source Configuration, configurez les paramètres de synchronisation des alertes comme indiqué dans le tableau suivant, puis cliquez sur Save.

      Paramètre	Description	Exemple
      Project	Le projet Jira dans lequel les tickets sont créés lorsqu'une alerte est déclenchée.	Projet intégré de surveillance, de gestion et de contrôle
      Type	Le type de ticket Jira pour l'alerte. Task Subtask Improvement New feature Bug Epic Story	Bug
      Issue closed status	Le statut qui marque un ticket Jira comme clôturé. Une fois qu'un ticket atteint ce statut, les opérations d'alerte ultérieures ne sont plus synchronisées avec celui-ci. Statuts disponibles : To Do In Progress In Review Done Remarque Nous vous recommandons de sélectionner Done. Si vous sélectionnez un autre statut, les opérations d'alerte continueront d'être synchronisées avec le ticket Jira correspondant, même après que son statut est passé à Done.	Done
      Priority	Mappe les niveaux de gravité des alertes aux priorités des tickets Jira. Important Si vous ne configurez pas de mappage pour un niveau de gravité d'alerte, les alertes de ce niveau ne seront pas synchronisées avec Jira. Le niveau de gravité de l'alerte est synchronisé selon ce mappage uniquement lors de son premier envoi vers Jira. Les modifications ultérieures du niveau de gravité de l'alerte dans ARMS Alert Management ne sont pas synchronisées avec le ticket Jira.	P1 : Hightest P2 : High P3 : Medium P4 : Low P5 : Lowest

   Après avoir enregistré la configuration, consultez la nouvelle intégration Jira dans l'onglet Notification Integration. La liste affiche des informations telles que le Name, la Integration key, le Type et la Creation time. Gérez l'intégration depuis la colonne Actions.

Envoyer des alertes vers Jira

Après avoir configuré l'intégration Jira, vous pouvez envoyer des alertes vers Jira de trois manières :

Méthode 1

Configurez une politique de notification pour créer automatiquement un ticket dans Jira lorsqu'une alerte est déclenchée.

1. Dans le volet de navigation de gauche, accédez à Alert Management > Notification Policies.

2. Sur la page Notification Policies, cliquez sur Create Notification Policy ou modifiez une politique de notification existante.

3. Dans la section When an alert is triggered, , spécifiez les Contacts. Sélectionnez au moins un contact ou un groupe de contacts.

   Important

   • Jira attribue le ticket à un utilisateur dont l'adresse e-mail ou le nom d'utilisateur correspond à celui du premier contact de la politique de notification.

   • Si le premier contact de la politique de notification n'a pas d'utilisateur correspondant dans Jira, l'alerte ne sera pas synchronisée avec Jira.

4. Pour Ticket system, sélectionnez l'intégration Jira que vous avez créée. Configurez les autres paramètres selon vos besoins. Pour plus d'informations, consultez Politiques de notification.

5. Cliquez sur Save.

   Une fois la configuration terminée, les alertes correspondant à cette politique de notification sont envoyées vers Jira.

Méthode 2

Depuis la page Alert Sending History, vous pouvez envoyer manuellement une alerte existante vers Jira pour créer un ticket.

1. Dans le volet de navigation de gauche, accédez à Alert Management > Alert Sending History.

2. Sur la page Alert Sending History, sélectionnez un opérateur dans le coin supérieur droit pour qu'il agisse en tant que responsable du ticket Jira, puis cliquez sur le nom de l'alerte cible.

   Important

   • Jira attribue le ticket à un utilisateur dont l'adresse e-mail ou le nom d'utilisateur correspond à celui de l'opérateur sélectionné.

   • Si l'opérateur n'a pas d'utilisateur correspondant dans Jira, l'alerte ne peut pas être synchronisée avec Jira.

3. Sur la page des détails de l'alerte, cliquez sur l'icône dans le coin supérieur droit, puis cliquez sur Push Alerts.

4. Dans la boîte de dialogue qui s'affiche, pour Ticket system, sélectionnez l'intégration Jira que vous avez créée et cliquez sur Confirm.

   Une fois l'alerte envoyée avec succès, un lien vers le ticket Jira correspondant, tel que AL-6, apparaît sur la page des détails de l'alerte.

Méthode 3

Lorsque vous recevez une carte d'alerte dans un groupe DingTalk, vous pouvez envoyer l'alerte correspondante vers Jira directement depuis la carte.

• Sur la carte d'alerte que vous recevez dans le groupe DingTalk, cliquez sur Push Alerts et sélectionnez l'intégration Jira que vous avez créée.

• Sur la carte d'alerte, cliquez sur le nom de l'alerte. Dans le panneau des détails de l'alerte, cliquez sur Settings, puis sur Push ticket, et sélectionnez l'intégration Jira que vous avez créée.

Une fois l'alerte envoyée avec succès, un lien vers le ticket Jira correspondant apparaît sur la page des détails de l'alerte.

Supported alert operations for synchronization

Une fois configuré, les opérations d'alerte suivantes dans ARMS Alert Management sont synchronisées avec le système de tickets Jira.

Opérations sur la page Alert Sending History :

• S'approprier l'alerte : met à jour le responsable du ticket Jira.

  Remarque

  L'utilisateur qui s'approprie l'alerte doit avoir un compte utilisateur correspondant dans Jira.

• Ajouter un commentaire à l'alerte : ajoute le commentaire au ticket Jira.

• Résoudre l'alerte : ajoute la résolution en tant que commentaire au ticket Jira.

Opérations sur la carte d'alerte dans un groupe DingTalk :

S'approprier l'alerte : met à jour le responsable du ticket Jira.

Synchroniser les actions Jira vers ARMS

1. Dans ARMS Alert Management, accédez à la page Integrations, cliquez sur l'onglet Notification Integration, et copiez la clé d'intégration pour votre intégration Jira.

2. Connectez-vous à votre système de tickets Jira. Dans le coin supérieur droit de la page Jira, cliquez sur l'icône des paramètres, puis cliquez sur OsType.

3. Saisissez votre mot de passe administrateur et cliquez sur Confirm pour accéder à la page de configuration du système.

4. Dans le volet de navigation de gauche de la page OsType, accédez à Alerts > Webhook.

5. Sur la page Webhooks, cliquez sur + Create a webhook.

6. Sur la page Create a webhook, définissez l'URL sur http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}. Remplacez {token} par la clé d'intégration Jira de l'étape Étape 1.

   Définissez Name sur ARMS Alert Management et changez le Status en Enabled. Dans la section Issue related events, sélectionnez All issues. Sous la colonne Issue, sélectionnez created, updated et deleted. Sous la colonne Comment, sélectionnez created, updated et deleted.

7. Configurez les autres paramètres selon vos besoins. Pour plus d'informations, consultez la documentation officielle de Jira. Ensuite, cliquez sur Create .

   Après avoir effectué ces étapes, les opérations de ticket Jira suivantes sont synchronisées avec ARMS Alert Management.

   • Modification du responsable du ticket : le responsable de l'alerte correspondante est mis à jour.

   • Ajout d'un commentaire à un ticket : un commentaire est ajouté à l'alerte correspondante.