JIRA est un système de suivi de tickets et de projets pour les équipes logicielles. Cette intégration vous permet de créer des tickets lorsque des alertes se déclenchent dans Datadog et de mettre à jour les tickets existants en tenant compte des dernières informations. De plus, les tickets créés avec JIRA sont ajoutés en tant qu’événements dans Datadog, ce qui vous permet de les superposer à vos métriques.
Configuration
Installation
Accédez à votre compte Jira.
Cliquez sur l’icône en forme d’engrenage (en haut à droite) pour accéder aux paramètres, puis sur Products.
Sous INTEGRATIONS dans le menu de gauche, sélectionnez Application links.
Saisissez l’URL https://app.datadoghq.com/ et cliquez sur Create new link. Remarque : si vous voyez l’avertissement No response was received from the URL you entered, ignorez-le et cliquez sur Continue.
Remplissez le formulaire comme suit, puis cliquez sur Continue.
Champ
Entrée
Application Name
Le nom de votre choix (utilisé pour l’identification)
Après avoir installé l’intégration JIRA, créez un ticket personnalisé dans Datadog.
Pour commencer, cliquez sur le bouton Add Issue.
Saisissez la clé du projet et le type de ticket. Remarque : chaque ticket possède une combinaison unique composée de l’ID du projet et du type de ticket.
Si vous le souhaitez, ajoutez des tags Datadog au format <KEY:VALUE>.
Vous devez remplir tous les champs requis (Required fields) pour ce ticket.
Les autres champs proposés sont facultatifs.
Cliquez sur le bouton Save.
Remarque : si le champ obligatoire Severity est affiché (comme ci-dessus), Jira limite les valeurs autorisées à :
Critical
Major
Minor
Les valeurs et variables brutes de l’événement d’alerte peuvent être utilisées pour remplir les champs du ticket. Voici la liste complète des variables :
Variable
Description
$ID
ID de l’événement (p. ex., 1234567)
$EVENT_TITLE
Titre de l’événement (p. ex., [Triggered] [Memory Alert])
$EVENT_MSG
Texte de l’événement (p. ex., @webhook-url Envoi au webhook)
$EVENT_TYPE
Type de l’événement (p. ex., metric_alert_monitor)
$LAST_UPDATED
Date de la dernière mise à jour de l’événement
$DATE
Date (epoch) à laquelle l’événement s’est produit (p. ex., 1406662672000)
$AGGREG_KEY
ID pour agréger des événements connexes (p. ex., 9bd4ac313a4d1e8fae2482df7b77628)
$ORG_ID
ID de votre organisation (p. ex., 11023)
$ORG_NAME
Nom de votre organisation (p. ex., Datadog)
$USER
Utilisateur publiant l’événement qui a déclenché le webhook (p. ex., thomas)
$SNAPSHOT
URL de l’image si l’événement contient un snapshot (p. ex., https://url.vers.snapshot.com/)
$LINK
URL de l’événement (p. ex., https://app.datadoghq.com/event/jump_to?event_id=123456)
$PRIORITY
Priorité de l’événement (p. ex., normal)
$TAGS
Liste des tags associés à l’événement, séparés par des virgules (p. ex., monitor, name:myService, role:computing-node)
$TEXT_ONLY_MSG
Texte de l’événement sans mise en forme markdown
$ALERT_ID
ID de l’alerte (p. ex., 1234)
$ALERT_METRIC
Nom de la métrique s’il s’agit d’une alerte (p. ex., system.load.1)
$ALERT_QUERY
Requête du monitor qui a déclenché le webhook
$ALERT_STATUS
Résumé du statut d’alerte (p. ex., system.load.1 over host:my-host était > 0 au moins une fois lors de la dernière minute)
$ALERT_TRANSITION
Type de notification d’alerte (p. ex. : Triggered)
$HOSTNAME
Le hostname du serveur associé à l’événement (le cas échéant).
$ALERT_CYCLE_KEY
ID permettant d’associer des événements depuis le déclenchement d’une alerte jusqu’à sa résolution.
$LOGS_SAMPLE
Échantillon de logs provenant d’alertes de log monitor.
Cas d’utilisation
Créer automatiquement des tickets à partir d’alertes Datadog
Pour créer automatiquement des tickets JIRA au sein des alertes Datadog, utilisez la commande @jira-<NOM_PROJET>-<TYPE_TICKET> dans la section « Say what’s happening » du processus de création de monitor.
Lorsque cette alerte se déclenche, un ticket est créé.
La commande @jira-update peut être utilisée pour mettre à jour les tickets existants. Cette commande ajoute un commentaire au ticket JIRA avec le texte suivi de la commande @jira-update.
Conseil : vous pouvez aussi utiliser la commande @jira dans une variable #is_alert ou #is_warning.
Données collectées
Métriques
L’intégration JIRA n’inclut aucune métrique.
Événements
Tous les tickets JIRA créés apparaissent en tant qu’événement dans Datadog.
Checks de service
L’intégration JIRA n’inclut aucun check de service.