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.
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) |
| 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 |
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. |
https://your-jira.atlassian.net
Après avoir installé l’intégration JIRA, créez un ticket personnalisé dans Datadog.
<KEY:VALUE>.Remarque : si le champ obligatoire Severity est affiché (comme ci-dessus), Jira limite les valeurs autorisées à :
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. |
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.
L’intégration JIRA n’inclut aucune métrique.
Tous les tickets JIRA créés apparaissent en tant qu’événement dans Datadog.
L’intégration JIRA n’inclut aucun check de service.
Besoin d’aide ? Contactez l’assistance Datadog.
