Crea automaticamente ticket Jira Software da un problema rilevato in Dynatrace

Di Rob Jahn, Dynatrace Technical Partner Manager e DevOps Evangelist
Questo tutorial illustra come creare automaticamente un ticket Jira in base a un problema rilevato da Dynatrace. Guarda il nostro altro tutorial,Come integrare Dynatrace e Jira per una maggiore osservabilità, per scoprire come configurare l'integrazione di Jira e Dynatrace.
In questo caso d'uso, il servizio di backend "cliente" verrà chiuso causando errori nel servizio di "frontend". Questi errori verranno quindi rilevati da Dynatrace e i ticket Jira verranno creati automaticamente.
Ora
15 minuti. Da completare nell'arco di 2-3 ore.
Pubblico
Utenti con autorizzazione di amministratore di progetto per tutti i progetti. Per ulteriori informazioni, consulta Gestione delle autorizzazioni di progetto.
Utenti con autorizzazione di amministratore per l'ambiente di Dynatrace. Per ulteriori informazioni, consulta Introduzione a Dynatrace.
Utenti con una conoscenza di base dei comandi Linux.
PREREQUISITO
Devi avere un ambiente Dynatrace: ottieni una prova di 15 giorni di Dynatrace.
È necessario un host Linux per eseguire un'applicazione di esempio fornita da Dynatrace. Segui le istruzioni di installazione riportate in questo file LEGGIMI per i requisiti e le istruzioni per l'installazione su una macchina virtuale.
Su questo stesso host Linux deve essere installato Dynatrace OneAgent.
Devi avere un account Jira Software. Inizia a utilizzare Jira qui.
Vuoi saperne di più?
Per informazioni più dettagliate su come usare gli sprint in Jira, dai un'occhiata al tutorial sugli sprint.
Vuoi chiederci qualcosa? Rivolgiti all'Atlassian Community.
Panoramica
Questo tutorial dipende da diversi componenti che interagiscono tra loro. Qui, potrai:
1. Configurare Jira Automation per creare un commento della scheda del problema di Dynatrace con l'URL che reindirizza al ticket Jira.
2. Configurare Dynatrace per il push dei problemi a Jira.
3. Attivare un problema nell'applicazione di esempio e verificare in che modo Dynatrace lo rileva e crea automaticamente un ticket Jira.
4. Configurare le query sui ticket Jira nella pagina dei rilasci di Dynatrace.
5. Pulire l'ambiente.
In questo diagramma sono mostrati i componenti di questo tutorial e l'interazione di base tra di essi.

1. Monitoraggio dell'applicazione con Dynatrace: per questo tutorial, Dynatrace raccoglierà le metriche da un agente di Dynatrace installato sull'host che esegue l'applicazione di esempio. Tutti i dati sono centralizzati nel tenant centrale di Dynatrace, che fornisce anche l'interfaccia web per l'amministrazione e il rilevamento dei problemi basato sull'intelligenza artificiale.
2. Notifica sui problemi con contesto dettagliato: il motore AI di Dynatrace, Davis, utilizza metriche ad alta fedeltà, tracce, log e dati utente reali mappati su un modello di entità unificato. Utilizza l'intelligenza artificiale deterministica di Davis per rivelare le precise cause principali dei problemi. Davis non solo individua la precisa causa principale, ma fornisce immediatamente preziose informazioni sul contesto. Saprai se un problema è il risultato di un collo di bottiglia delle risorse o di una modifica della distribuzione e persino chi c'è dietro. È possibile riprodurre i problemi per comprendere appieno il motivo per cui si sono verificati e come risolverli.
3. Creazione automatica di ticket Jira: l'integrazione tra Dynatrace e Jira crea automaticamente ticket per tutti i nuovi problemi rilevati automaticamente negli ambienti di Dynatrace.
4. L'automazione Jira aggiorna Dynatrace: l'automazione Jira è una funzione "no-code" che consente di creare regole di compilazione semplici in pochi clic. Una richiesta web all'API di Dynatrace utilizza l'ID problema di Dynatrace per aggiornare i commenti alla scheda del problema di Dynatrace.
5. Risoluzione del problema e chiusura del ticket Jira
Passaggio 1. Arresta l'applicazione di esempio e rileva tramite Dynatrace i problemi di disponibilità
Sull'host Linux che esegue l'applicazione di esempio, vai alla directory con il file docker-compose.yaml ed esegui questo comando per arrestare il servizio:
sudo docker-compose -f docker-compose-services.yaml scale customer-service=0
Puoi utilizzare il comando seguente per verificare che non sia in esecuzione:
sudo docker ps
Passaggio 2. Rivedi la scheda del problema in Dynatrace
Dopo alcuni minuti, il problema si verificherà e Dynatrace creerà un ticket. La differenza di Dynatrace risiede nel fatto che non si tratta di un avviso. Dynatrace utilizza l'intelligenza artificiale deterministica per eseguire un'analisi automatica degli alberi di guasto che tiene conto di metriche, log, dati utente reali ed eventi. Il risultato è una scheda del problema che mostra l'impatto aziendale, le applicazioni e i componenti dell'infrastruttura interessati, una cronologia riproducibile dell'evento e la causa principale del problema.

Passaggio 3. Rivedi il ticket Jira generato automaticamente
Jira rivelerà un nuovo ticket con i dettagli del problema e un link URL diretto alla scheda del problema di Dynatrace.

Passaggio 4. Visualizza il commento di Dynatrace
Una volta creato il ticket Jira, clicca sull'URL del problema di Dynatrace per aprire la scheda corrispondente. Scorri verso il basso per visualizzare il commento con l'URL che reindirizza al ticket Jira. Questo processo è reso possibile dagli smart tag dell'automazione Jira aggiunti alla chiamata API di Dynatrace, effettuata dalla regola di automazione di Jira.

** Suggerimento: puoi utilizzare lo stesso concetto per aggiungere eventuali nuovi commenti Jira come commenti di Dynatrace. A tale scopo, crea una nuova regola di automazione utilizzando il trigger "When: Issue commented" (Quando: aggiunta di un commento al ticket) e utilizzalo come corpo del webhook:
{
"comment": "{{issue.comments.last.body}} - Jira Issue: [{{issue.key}}]({{issue.url}})", "user": "{{issue.comments.last.author.displayName}}", "context": "Jira"
}

** Suggerimento: le notifiche sui problemi di Dynatrace possono essere configurate in modo che trasmettano ulteriori informazioni da Dynatrace a Jira, inclusi lo stato del problema, le entità interessate e i tag. Questi dati possono essere ulteriormente utilizzati in un'automazione più sofisticata come l'assegnazione del ticket, l'impostazione della priorità, il collegamento a un componente e il popolamento dei campi Jira personalizzati. L'automazione di Jira "blocco if", ad esempio, può analizzare la corrispondenza con un tag Dynatrace.

Passaggio 5. Risolvi il ticket riavviando il servizio dell'applicazione di esempio
Sull'host Linux che esegue l'applicazione di esempio, vai alla directory con il file docker-compose.yaml ed esegui questo comando per riavviare il servizio:
sudo docker-compose -f docker-compose-services.yaml scale customer-service=1
Puoi utilizzare il comando seguente per verificare che adesso sia in esecuzione:
sudo docker ps
Passaggio 6. Verifica nuovamente l'applicazione in Dynatrace
Esamina la pagina del servizio di frontend e noterai che non ci sono più errori.

Anche la scheda del problema di Dynatrace è stata chiusa automaticamente.

Provare con altri problemi
L'applicazione Dynatrace Orders contiene problemi predefiniti programmati come versioni diverse. L'applicazione è stata programmata con un URL di un flag delle funzioni che può essere utilizzato per modificare la versione e quindi il comportamento dell'applicazione. La versione 1 per i servizi clienti e gli ordini presenta un comportamento "normale" e il problema viene attivato impostando la versione 2.
Per provarle, consulta la pagina di panoramica su Dynatrace Orders.
Configurare le query sui ticket Jira all'interno della pagina dei rilasci di Dynatrace
Nella pagina dei rilasci di Dynatrace sono mostrate le query sullo strumento di rilevamento dei ticket, comprese le statistiche sui ticket relative alle entità monitorate nell'inventario in tempo reale.

Passaggio 1. Definisci il JQL
Nella ricerca dei ticket Jira, costruisci un'espressione Jira Query Language (JQL), come quella mostrata di seguito.
project = DT AND status in (Backlog, "In Progress") AND component = frontend ORDER BY created DESC

Passaggio 2. Crea query dello strumento di rilevamento dei ticket di rilascio
1. In Dynatrace, vai alla pagina dei rilasci utilizzando il menu a sinistra.
2. Nella pagina dei rilasci, clicca sul pulsante Configure (Configura).

3. Nella pagina delle impostazioni delle query dello strumento di rilevamento dei ticket di rilascio, clicca sul pulsante Add new issue tracker query (Aggiungi nuova query dello strumento di rilevamento dei ticket).

4. Nel modulo della nuova query, inserisci i valori come segue:
Etichetta ticket: Ticket di frontend di dt-orders
Query ticket: project = DT AND status in (Backlog, "In Progress") AND component = frontend ORDER BY created DESC
Tema ticket: Errore
Sistema di rilevamento dei ticket: Jira
URL di destinazione: https://TUA-AZIENDA.atlassian.net
Nome utente: l'ID utente Jira, come un indirizzo e-mail
Password: lascia vuoto
Token: il token utente Jira creato in precedenza in questa guida
5. Salva la query.
Passaggio 3: Verifica
1. Torna alla pagina dei rilasci utilizzando il menu a sinistra.
2. Ora dovresti vedere la nuova query con il numero di ticket per tutti i ticket aperti.

3. Se clicchi sulla riga del ticket, verrà aperto Jira per esaminare queste code.
Pulisci
1. Se stai eseguendo un host su richiesta per l'applicazione di esempio, terminalo.
2. Per arrestare l'applicazione di esempio, passa all'host Linux che esegue l'applicazione di esempio, vai alla directory con il file docker-compose.yaml ed esegui questo comando per arrestare l'applicazione:
sudo docker-compose -f docker-compose-services.yaml down
Verifica che non ci siano container in esecuzione con questo comando
sudo docker ps
3. In Jira, elimina il progetto che hai creato per questo tutorial.
4. In Dynatrace, elimina il token API e la regola di notifica sui problemi che hai aggiunto.
Scopri di più
Ottieni il plug-in Dynatrace Problem Integration for Jira nell'Atlassian Marketplace.
Poni domande (e offri consigli) nella nostra community Dynatrace.
Scopri di più sulle funzionalità di Dynatrace + Atlassian qui.
Maggiori informazioni su Dynatrace + Atlassian (e su come lavorare in modo più efficiente, non più duro) sono disponibili qui.
Guarda Atlassian, Dynatrace e Keptn in azione in questa Dynatrace Performance Clinic.
Scopri altre integrazioni per Atlassian Open DevOps
Guarda il nostro altro tutorial, Come integrare Dynatrace e Jira per una maggiore osservabilità, per scoprire come configurare l'integrazione di Jira e Dynatrace.