Jira
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
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.
Configuration
- 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
- 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.
- 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 à :
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.
