Jira

Jira

Crawler Crawler

Présentation

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

  1. Accédez à votre compte Jira.

  2. Cliquez sur l’icône en forme d’engrenage (en haut à droite) pour accéder aux paramètres, puis sur Products.

  3. Sous INTEGRATIONS dans le menu de gauche, sélectionnez Application links.

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

  5. Remplissez le formulaire comme suit, puis cliquez sur Continue.

    Champ Entrée
    Application Name Le nom de votre choix (utilisé pour l’identification)
    Application Type Une application générique
    Service Provider Name [laisser vide]
    Consumer key [laisser vide]
    Shared secret [laisser vide]
    Request Token URL [laisser vide]
    Access token URL [laisser vide]
    Authorize URL [laisser vide]
    Create incoming link Cocher la case
  6. Remplissez le formulaire suivant avec les informations du carré d’intégration Jira Datadog, puis cliquez sur Continue.

    Champ Entrée
    Consumer Key datadog
    Consumer Name Datadog
    Public Key Consultez le carré d’intégration Jira Datadog.

Configuration

  1. Dans le carré d’intégration Jira Datadog, saisissez l’URL de votre compte Jira pour l’étape 2, par exemple :
    https://your-jira.atlassian.net
    
  2. Cliquez ensuite sur le bouton Setup OAuth1.

Ajouter des tickets

Après avoir installé l’intégration JIRA, créez un ticket personnalisé dans Datadog.

  1. Pour commencer, cliquez sur le bouton Add Issue.
  2. 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.
  3. Si vous le souhaitez, ajoutez des tags Datadog au format <KEY:VALUE>.
  4. Vous devez remplir tous les champs requis (Required fields) pour ce ticket.
  5. Les autres champs proposés sont facultatifs.
  6. Cliquez sur le bouton Save.

Remarque : si le champ obligatoire Severity est affiché (comme ci-dessus), Jira limite les valeurs autorisées à :

    1. Critical
    1. Major
    1. 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.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.