Dynatrace en Jira integreren voor meer waarneembaarheid

Want to learn more?

Bekijk de sprint-tutorial voor meer informatie over werken met sprints in Jira.

Heb je vragen? Vraag het de Atlassian Community.

Overzicht

Deze tutorial is afhankelijk van verschillende componenten die met elkaar samenwerken. In deze tutorial zul je:

1. Jira Automaton configureren om een opmerking bij de Dynatrace-probleemkaart te maken met een URL terug naar de Jira-issue.

2. Dynatrace configureren om problemen naar Jira te pushen.

3. Een issue activeren in de voorbeeldtoepassing en bekijken hoe Dynatrace het probleem detecteert en automatisch een Jira-issue aanmaakt.

4. Vragen over Jira-issues configureren op de releasepagina van Dynatrace.

5. Je omgeving opschonen.

Dit diagram toont de componenten van deze tutorial en de basisinteractie hiertussen.

1. Toepassing monitoren met Dynatrace; voor deze tutorial verzamelt Dynatrace statistieken van een Dynatrace-agent die is geïnstalleerd op de host die de voorbeeldtoepassing uitvoert. Alle gegevens worden gecentraliseerd in de centrale Dynatrace-tenant, die ook de webinterface levert voor beheer en AI-aangedreven probleemdetectie.

2. Probleemmelding met gedetailleerde context; Dynatrace's AI Engine, Davis, maakt gebruik van uitermate betrouwbare statistieken, traces, logs en echte gebruikersgegevens toegewezen aan een uniform entiteitsmodel. Het gebruikt Davis' deterministische AI om de precieze oorzaken van problemen aan het licht te brengen. Davis vindt niet alleen de precieze oorzaak, maar levert ook direct waardevolle context. Je weet of een probleem het gevolg is van een knelpunt of een verandering in de implementatie, en zelfs wie er achter zit. Je kunt problemen opnieuw afspelen om volledig te begrijpen waarom ze zijn ontstaan en hoe je ze oplost.

3. Jira-issues automatisch aanmaken; de integratie met Dynatrace en Jira maakt automatisch issues aan voor alle nieuwe problemen die automatisch worden gedetecteerd in je Dynatrace-omgevingen.

4. Jira Automation updatet Dynatrace; Automation in Jira is een „no-code”-functie die eenvoudige bouwregels met een paar klikken mogelijk maakt. Een webverzoek aan de Dynatrace API gebruikt de Dynatrace-probleem-ID om de opmerkingen van de Dynatrace-probleemkaart bij te werken.

5. Probleem oplossen en de Jira-issue afsluiten

2. Gebruik in Dynatrace het menu aan de linkerkant en klik op de optie Transacties en services om de lopende services te bekijken. Als het goed is zie je dat er meerdere lopen, waaronder de frontend- en orderservice.

3. Klik op de frontendservice. Klik op de servicepagina op de knop Dynamische verzoeken weergeven.

Als het goed is, staan hier verzoeken aan de service zoals hieronder weergegeven.

2. Vouw in het submenu Instellingen het submenu Integratie uit en selecteer vervolgens de optie Dynatrace API.

3. Kies op de pagina Dynatrace API de knop Token genereren.

4. Geef een naam voor de token op, zoals Jira Tutorial.

5. Breid de sectie API v1 uit en schakel de scope Toegang tot probleemfeed, statistieken en topologie in. Laat alle andere scopes eraf.

6. Klik op de knop Genereren.

7. BELANGRIJK: sla de gegenereerde token op een veilige plek op. Je hebt deze waarde later in deze tutorial nodig en je kunt deze niet nogmaals bekijken. Gebruik de knop Kopiëren om er zeker van te zijn dat je de volledige string krijgt.

8. Zodra de token op een veilige plek is opgeslagen, klik je op de knop Sluiten.

3. BELANGRIJK: vergeet niet om de Jira-projectcode op te schrijven. Je hebt deze waarde nodig in de Dynatrace-configuratie. In het bovenstaande voorbeeld is de code DT.

4. Klik rechtsboven op de knop Regel maken.

5. Kies op de pagina Nieuwe trigger de trigger met de naam Opmerking bij Issue en vervolgens Opslaan op de volgende pagina.

6. Klik in de regel Component toevoegen op de optie Nieuwe actie.

7. Kies op de pagina Nieuwe actie de meldingsoptie Webrequest verzenden.

8. Voer de onderstaande informatie in. Het volgende is een voorbeeld van hoe het eruit zal zien als het voltooid is:

• Webhook-URL: dit is de URL naar het Dynatrace API-eindpunt. Vervang de [JE-OMGEVING-ID] in deze string door je eigen omgeving. Zie de URL van je Dynatrace-omgeving om deze waarde te krijgen.
  
  https://[JE-OMGEVING-ID]/api/v1/problem/details/{{issue.description.match(".*pid=(.*)")}}/comments
  
  TECHNISCHE OPMERKING: de uitdrukking Jira Match slimme waarde zal het Dynatrace-probleem of PID ophalen uit de Probleem-URL die zich in de probleembeschrijving bevindt. Een website als regex101 kan je helpen deze uitdrukkingen op te bouwen.

• Koptekst: dit bevat de waarde van Dynatrace API Token die je eerder hebt gemaakt. Gebruik voor de naam van de koptekst de waarde Autorisatie. Gebruik voor de waarde van de koptekst deze reeks tekens en vervang deze door de tokenwaarde: Api-Token [JOUW-DYNATRACE-API-TOKEN]. OPMERKING: neem ook Api-Token mee, met een spatie voor de tekenreeks.

• HTTP-methode: kies de optie POST.

• Webhook-body: kies in de keuzelijst Aangepaste body en plak daar de volledige JSON-body.

  { "message": "Opened Jira Issue: [{{issue.key}}]({{issue.url}})", "context": "Jira" }
  
  *** Protip: zie voor meer informatie over slimme waarden: https://support.atlassian.com/jira-software-cloud/docs/smart-values-general/

9. Klik op de knop Opslaan.

10. Voer op de volgende pagina een naam in, zoals Opmerking naar Dynatrace versturen bij aanmaken issue en klik op de knop Inschakelen.

11. Eenmaal opgeslagen, klik je rechtsboven op de link Terug naar lijst en zie je de nieuwe regel ingeschakeld.

1. Klik in Dynatrace in het menu aan de linkerkant op de optie Instellingen.

2. Vouw in het submenu Instellingen het submenu Integraties uit en selecteer vervolgens de optie Probleemmeldingen

3. Selecteer Meldingen instellen.

4. Selecteer Jira uit de beschikbare meldingstypen.

5. Configureer de melding:

• Weergavenaam: voer een waarde in zoals 'Jira tutorial'

• Jira-endpoint-URI: werk deze waarde bij zodat het naar je Jira-account verwijst

  https://[JE-JIRA-ACCOUNT].atlassian.net/rest/api/2/

• Gebruikersnaam: de gebruikers-id die je hebt gebruikt om de Atlassian API Token aan te maken

• API-token: de Atlassian API Token-regel

• Projectcode: de code (niet de naam van het project) van het Jira-project waar nieuwe issues worden aangemaakt en gevolgd. Als je dezelfde hebt gebruikt als in het bovenstaande voorbeeld, is dit DT

• Samenvatting: laat staan op de standaardwaarde

• Beschrijving van issue: laat staan op de standaardwaarde
  
  *** Protip: de sectie Beschikbare placeholders op de configuratiepagina bevat placeholders die je voor deze integratie kunt gebruiken. Placeholders worden automatisch vervangen door informatie die bij het probleem hoort.

6. Selecteer Testmelding verzenden om er zeker van te zijn dat je Jira-integratie werkt. Je wilt het volgende zien:

En in Jira ziet het testissue er als volgt uit:

7. Klik op de knop Opslaan.