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.

    ChampEntrée
    Application NameLe nom de votre choix (utilisé pour l’identification)
    Application TypeUne 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 linkCocher la case
  6. Remplissez le formulaire suivant avec les informations du carré d’intégration Jira Datadog, puis cliquez sur Continue.

    ChampEntrée
    Consumer Keydatadog
    Consumer NameDatadog
    Public KeyConsultez 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 :

VariableDescription
$IDID de l’événement (p. ex., 1234567)
$EVENT_TITLETitre de l’événement (p. ex., [Triggered] [Memory Alert])
$EVENT_MSGTexte de l’événement (p. ex., @webhook-url Envoi au webhook)
$EVENT_TYPEType de l’événement (p. ex., metric_alert_monitor)
$LAST_UPDATEDDate de la dernière mise à jour de l’événement
$DATEDate (epoch) à laquelle l’événement s’est produit (p. ex., 1406662672000)
$AGGREG_KEYID pour agréger des événements connexes (p. ex., 9bd4ac313a4d1e8fae2482df7b77628)
$ORG_IDID de votre organisation (p. ex., 11023)
$ORG_NAMENom de votre organisation (p. ex., Datadog)
$USERUtilisateur publiant l’événement qui a déclenché le webhook (p. ex., thomas)
$SNAPSHOTURL de l’image si l’événement contient un snapshot (p. ex., https://url.vers.snapshot.com/)
$LINKURL de l’événement (p. ex., https://app.datadoghq.com/event/jump_to?event_id=123456)
$PRIORITYPriorité de l’événement (p. ex., normal)
$TAGSListe des tags associés à l’événement, séparés par des virgules (p. ex., monitor, name:myService, role:computing-node)
$TEXT_ONLY_MSGTexte de l’événement sans mise en forme markdown
$ALERT_IDID de l’alerte (p. ex., 1234)
$ALERT_METRICNom de la métrique s’il s’agit d’une alerte (p. ex., system.load.1)
$ALERT_QUERYRequête du monitor qui a déclenché le webhook
$ALERT_STATUSRé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_TRANSITIONType de notification d’alerte (p. ex. : Triggered)
$HOSTNAMELe hostname du serveur associé à l’événement (le cas échéant).
$ALERT_CYCLE_KEYID 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.