Workflow Dynatrace Jira ou ServiceNow : ouvrir un ticket automatiquement sur problème

Workflow Dynatrace Jira ou ServiceNow : ouvrez un ticket dès qu’un problème Davis apparaît, sans doublon, avec contexte, puis vérifiez l’exécution.
Workflow Dynatrace Jira ou ServiceNow : ouvrir un ticket automatiquement sur problème

Un problème Davis s’ouvre, l’astreinte le voit, puis quelqu’un recopie à la main le titre, l’entité touchée et le lien dans Jira ou ServiceNow. Ce geste prend cinq minutes, se fait mal à trois heures du matin et s’oublie une fois sur dix. Un workflow Dynatrace Jira (ou ServiceNow) supprime ce toil : le ticket s’ouvre seul, avec le contexte, dès que le problème est confirmé.

Le gain est concret pour la fiabilité : le ticket existe avant même que l’ingénieur se connecte, l’horodatage d’ouverture est exact, et le calcul du MTTR repose sur des données propres plutôt que sur des saisies tardives.

Objectif de ce tutoriel : construire un workflow qui crée un ticket Jira ou un incident ServiceNow à l’ouverture d’un problème, sans doublon, puis vérifier qu’il fonctionne. Périmètre : les Workflows (AutomationEngine) existent sur Dynatrace SaaS. Sur Dynatrace Managed, le même besoin passe par les intégrations de notification de problèmes, décrites en fin d’article.

Prérequis

  • Un environnement Dynatrace SaaS avec l’application Workflows et les droits pour créer et exécuter un workflow.
  • Côté Jira : une URL de site, un compte de service, un token API Jira et un projet cible. Côté ServiceNow : une instance, un compte d’intégration avec le droit de créer des incidents.
  • L’application de connexion correspondante installée depuis le Hub (connecteur Jira ou ServiceNow). Les noms exacts des applications et des actions peuvent varier selon les versions : vérifiez-les dans le Hub et sur la documentation des Workflows.
  • Des problèmes correctement ciblés : si votre environnement en génère trop, commencez par réduire le bruit des alertes Davis. Un ticket automatique sur une alerte bruyante ne fait que déplacer le bruit.

Construire le workflow Dynatrace Jira pas à pas

Étape 1 : créer la connexion

Dans les réglages de l’application de connexion Jira, ajoutez une connexion : URL du site (par exemple https://votre-societe.atlassian.net), e-mail du compte de service et token API Jira. Pour ServiceNow, renseignez l’URL de l’instance et les identifiants du compte d’intégration.

Utilisez un compte de service dédié, pas un compte personnel : le jour où la personne quitte l’équipe, les tickets continuent de s’ouvrir. Limitez ses droits au seul projet cible.

Étape 2 : choisir le déclencheur

Créez un workflow et choisissez le déclencheur d’événement de problème Davis. Réglez-le pour ne réagir qu’aux problèmes actifs et filtrez le périmètre :

  • catégorie de problème : disponibilité et erreurs, par exemple, plutôt que toutes les catégories ;
  • entités concernées : filtre sur un tag comme team:paiement, pour que chaque équipe ait son workflow et son projet.

Ce filtrage est la décision la plus importante du tutoriel. Un workflow qui ouvre un ticket pour chaque problème mineur produit une file que personne ne lit.

Étape 3 : éviter les doublons

Un problème peut être mis à jour plusieurs fois et redéclencher le workflow selon les réglages. Ajoutez une tâche « Run JavaScript » qui lit l’événement déclencheur et prépare une clé de déduplication :

import { execution } from '@dynatrace-sdk/automation-utils';

export default async function ({ execution_id }) {
  const ex = await execution(execution_id);
  const event = ex.params.event;

  return {
    displayId: event['display_id'],
    label: 'dt-' + String(event['display_id']).toLowerCase(),
    title: event['event.name'],
    category: event['event.category'],
  };
}

Ligne critique : ex.params.event contient l’événement qui a déclenché le workflow. La clé label (par exemple dt-p-240123) sert d’étiquette Jira ou de référence de corrélation ServiceNow : on cherche un ticket qui la porte avant d’en créer un.

Ensuite, ajoutez une tâche de recherche dans Jira (action de recherche de tickets par JQL si votre connecteur la propose) avec la requête :

project = OPS AND labels = "{{ result("prepare_key").label }}" AND statusCategory != Done

Donnez à la tâche de création une condition qui ne la lance que si la recherche ne renvoie aucun ticket. L’éditeur de conditions de la tâche accepte une expression ; vérifiez sa forme exacte dans l’aide contextuelle de l’éditeur.

Étape 4 : créer le ticket Jira

Ajoutez l’action de création de ticket Jira, sélectionnez la connexion de l’étape 1, puis remplissez les champs avec des expressions :

Projet      : OPS
Type        : Incident
Résumé      : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
Étiquettes  : {{ result("prepare_key").label }}, dynatrace
Description :
  Problème Dynatrace {{ event()["display_id"] }}
  Catégorie : {{ event()["event.category"] }}
  Début : {{ event()["event.start"] }}
  Ouvert automatiquement par un workflow. Analyse et cause racine dans Dynatrace.

Ajoutez dans la description le lien vers le problème dans votre environnement. Le format exact de l’URL dépend de l’application Problems de votre version ; copiez-en un depuis l’interface pour construire le modèle.

Étape 4 bis : la variante ServiceNow

Avec le connecteur ServiceNow, remplacez l’action Jira par l’action de création d’incident. Les champs usuels de la table incident :

short_description : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
description       : Problème Dynatrace {{ event()["display_id"] }}, catégorie {{ event()["event.category"] }}
correlation_id    : {{ result("prepare_key").label }}
urgency           : 2
impact            : 2
assignment_group  : <votre-groupe>

Le champ correlation_id remplace l’étiquette Jira pour la déduplication. Faites correspondre urgence et impact à votre matrice de priorité ITSM, plutôt que de tout envoyer en priorité 1.

Étape 5 : réagir à la fermeture du problème

Créez un second workflow, déclenché sur les problèmes fermés, qui retrouve le ticket par son étiquette et ajoute un commentaire « résolu côté Dynatrace ». Laissez la clôture du ticket à un humain : c’est le moment de compléter la cause et de décider d’un postmortem. Pour structurer cette revue, voir le postmortem sans blâme avec DQL.

Comment vérifier que ça fonctionne

  1. Lancez une exécution manuelle du workflow depuis l’éditeur, en choisissant un problème récent comme événement d’exemple si l’option est disponible.
  2. Ouvrez l’historique des exécutions : chaque tâche doit être au vert. Une tâche en échec affiche l’erreur renvoyée par Jira ou ServiceNow (401 = identifiants, 400 = champ obligatoire manquant, souvent le type de ticket).
  3. Vérifiez dans Jira qu’un ticket porte l’étiquette dt-p-…. Relancez l’exécution : aucun second ticket ne doit apparaître.
  4. En SaaS, comparez avec les problèmes réels :
    fetch dt.davis.problems, from:now()-24h
    | filter event.status == "ACTIVE"
    | fields display_id, event.name, event.category

    Chaque problème du périmètre filtré doit avoir son ticket.

Bonnes pratiques

  • Un workflow par équipe, filtré par tag, plutôt qu’un workflow global : chaque ticket arrive dans le bon projet.
  • Toujours dédupliquer par l’identifiant du problème : une file pleine de doublons perd la confiance des équipes.
  • Du contexte, pas du volume : ajoutez une requête DQL des logs d’erreur de l’entité concernée, comme dans le module Workflows du parcours SaaS, plutôt qu’un texte générique.
  • Superviser le workflow lui-même : un token Jira expiré arrête silencieusement la création de tickets. Une notification sur échec d’exécution suffit.
  • Tester en projet bac à sable avant de pointer vers le projet de production.

Questions fréquentes

Comment faire la même chose sur Dynatrace Managed ?

Managed n’a pas les Workflows. Utilisez les intégrations de notification de problèmes (Jira, ServiceNow ou webhook personnalisé), associées à un profil d’alerte qui filtre le périmètre. La démarche est détaillée dans profils d’alerte et intégrations de notification.

Faut-il garder l’intégration de notification si j’ai un workflow ?

Non, pas pour le même périmètre : les deux créeraient des tickets en double. Migrez équipe par équipe et désactivez l’ancienne intégration une fois le workflow validé.

Puis-je appeler l’API Jira directement avec une requête HTTP ?

Oui, l’action de requête HTTP le permet, avec les identifiants stockés de façon sécurisée et le domaine Jira autorisé dans les réglages de l’environnement. Le connecteur reste plus simple à maintenir ; la requête HTTP sert pour un champ ou un point d’accès qu’il ne couvre pas.

Conclusion

Un workflow bien filtré et dédupliqué transforme chaque problème Davis en ticket exploitable, sans saisie manuelle. L’astreinte gagne quelques minutes par incident, le MTTR devient mesurable, et la revue d’incident part de données fiables. Commencez par une équipe et un projet, puis étendez.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Jira et ServiceNow sont des marques de leurs propriétaires respectifs. Les noms d’actions évoluent : vérifiez-les dans la documentation officielle.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Requêtes DQL exemples : 15 requêtes prêtes à copier avec DQL summarize, filter et timeseries

Requêtes DQL exemples : 15 requêtes prêtes à copier avec DQL summarize, filter et timeseries

Next Post
OpenTelemetry Python FastAPI : instrumenter une API vers Dynatrace sans OneAgent

OpenTelemetry Python FastAPI : instrumenter une API vers Dynatrace sans OneAgent

Related Posts