Integracja rozwiązań Dynatrace i Jira w celu zwiększenia przejrzystości

Want to learn more?

Szczegółowe informacje na temat pracy ze sprintami w systemie Jira zawiera samouczek dotyczący sprintów.

Masz pytania? Zadaj pytanie społeczności Atlassian.

Informacje ogólne

Ten samouczek opiera się na kilku komponentach, które są od siebie zależne. W tym samouczku:

1. Skonfigurujesz narzędzie Jira Automation do tworzenia na kartach problemów w Dynatrace komentarzy zawierających adres URL przekierowujący z powrotem do zgłoszenia Jira.

2. Skonfigurujesz aplikację Dynatrace do wypychania problemów do systemu Jira.

3. Wyzwolisz problem w aplikacji próbnej i sprawdzisz, jak platforma Dynatrace wykrywa problem i automatycznie tworzy zgłoszenie w systemie Jira.

4. Skonfigurujesz zapytania o zgłoszenia Jira na stronie wydań na platformie Dynatrace.

5. Wyczyścisz swoje środowisko.

Poniższy schemat przedstawia komponenty wykorzystane w tym samouczku oraz podstawowe interakcje między nimi.

1. Monitorowanie aplikacji za pomocą platformy Dynatrace — na potrzeby tego samouczka platforma Dynatrace będzie gromadzić wskaźniki z agenta Dynatrace zainstalowanego na hoście, na którym uruchomiona jest przykładowa aplikacja. Wszystkie dane są przesyłane do centralnej dzierżawy Dynatrace, która udostępnia również interfejs sieciowy do administrowania i wykrywania problemów wspomaganego sztuczną inteligencją.

2. Powiadomienie o problemie z uwzględnieniem szczegółowego kontekstu — silnik AI Dynatrace, Davis, wykorzystuje wskaźniki o wysokim stopniu wierności, ślady, dzienniki oraz rzeczywiste dane użytkowników odwzorowane w ujednoliconym modelu obiektu. Zastosowanie deterministycznej sztucznej inteligencji silnika Davis pozwala precyzyjnie ujawnić główną przyczynę problemów. Silnik Davis nie tylko lokalizuje dokładną przyczynę, ale także natychmiast dostarcza cenny kontekst. Będziesz wiedzieć, czy problem jest wynikiem wąskiego gardła w zasobach, czy zmiany wdrożeniowej, a nawet dowiesz się, kto za niego odpowiada. Możesz odtworzyć problemy, aby dokładnie zrozumieć mechanizm ich powstawania i opracować rozwiązania.

3. Automatyczne utworzenie zgłoszenia Jira — integracja rozwiązań Dynatrace i Jira automatycznie tworzy zgłoszenia dotyczące wszystkich nowych problemów wykrytych automatycznie w Twoich środowiskach Dynatrace.

4. Aktualizacja platformy Dynatrace za pomocą funkcji Jira Automation — Jira Automation to funkcja pozwalająca z łatwością tworzyć reguły zaledwie kilkoma kliknięciami, bez pisania kodu. Żądanie sieciowe wysyłane do interfejsu API Dynatrace wykorzystuje identyfikator problemu na platformie Dynatrace do aktualizacji komentarzy na karcie problemu w Dynatrace.

5. Rozwiązanie problemu i zamknięcie zgłoszenia w systemie Jira.

2. W serwisie Dynatrace przejdź do menu z lewej strony i kliknij opcję Transactions and services (Transakcje i usługi), aby wyświetlić uruchomione usługi. Powinno pojawić się kilka uruchomionych usług, w tym usługi frontend i order.

3. Kliknij usługę frontend. Na stronie usługi kliknij przycisk View dynamic requests (Wyświetl dynamiczne żądania).

W usłudze powinny pojawić się żądania, jak na poniższym ekranie.

2. W menu podrzędnym ustawień rozwiń menu podrzędne Integration (Integracja), a następnie wybierz opcję Dynatrace API (Interfejs API Dynatrace).

3. Na stronie Dynatrace API (Interfejs API Dynatrace) kliknij przycisk Generate Token (Generuj token).

4. Podaj nazwę tokena, na przykład Samouczek Jira.

5. Rozwiń sekcję API v1 (Interfejs API wersja 1) i włącz zakres Access problem feed, metrics, and topology (Przejdź do kanału, wskaźników i topologii problemu). Wszystkie inne zakresy pozostaw wyłączone.

6. Kliknij przycisk Generate (Generuj).

7. WAŻNE: Musisz zapisać wygenerowany token w bezpiecznym miejscu. Będzie on potrzebny w dalszej części samouczka, ale nie będzie możliwości, aby ponownie go wyświetlić. Użyj przycisku Copy (Kopiuj), aby mieć pewność, że cały ciąg znaków został zapisany.

8. Po zapisaniu tokena w bezpiecznym miejscu kliknij przycisk Close (Zamknij).

3. WAŻNE: Pamiętaj, aby zapisać klucz projektu Jira. Wartość ta będzie potrzebna w konfiguracji Dynatrace. W powyższym przykładzie kluczem jest „DT”.

4. W prawym górnym rogu kliknij przycisk Create rule (Utwórz regułę).

5. Na stronie New trigger (Nowy wyzwalacz) wybierz wyzwalacz o nazwie Issue commented (Skomentowane zgłoszenie), a następnie kliknij przycisk Save (Zapisz) na kolejnej stronie.

6. W regule na stronie Add component (Dodaj komponent) kliknij opcję New action (Nowa czynność).

7. Na stronie New action (Nowa czynność) wybierz opcję powiadomień Send Web Request (Wyślij żądanie sieciowe).

8. Wprowadź poniższe dane szczegółowe. Przykładowy widok po zakończeniu będzie wyglądał następująco:

• Webhook URL (Adres URL elementu webhook) — jest to adres URL punktu końcowego interfejsu API Dynatrace. W tym ciągu frazę [IDENTYFIKATOR-TWOJEGO-ŚRODOWISKA] musisz zastąpić własnym środowiskiem. Wartość tę znajdziesz w adresie URL Twojego środowiska Dynatrace.
  
  https://[TWOJE-ŚRODOWISKO]/api/v1/problem/details/{{issue.description.match(".*pid=(.*)")}}/comments
  
  UWAGA TECHNICZNA: wyrażenie wartości inteligentnej Jira Match spowoduje wyodrębnienie problemu Dynatrace lub identyfikatora PID z adresu URL problemu zapisanego w polu Issue Description (Opis zgłoszenia). Dla ułatwienia przy tworzeniu takich wyrażeń można skorzystać na przykład z witryny regex101.

• Headers (Nagłówki) — ta opcja zawiera wartość utworzonego wcześniej tokena API Dynatrace. W nazwie nagłówka użyj wartości Authorization (Autoryzacja). Jako wartość nagłówka wprowadź następujący ciąg, zastępując odpowiedni fragment wartością tokena: Api-Token [TWÓJ-TOKEN-API-DYNATRACE]. UWAGA: W przypadku właściwości Api-Token ciąg tokena należy poprzedzić spacją.

• HTTP Method (Metoda HTTP) — wybierz opcję POST.

• Webhook Body (Treść elementu webhook) — z listy rozwijanej wybierz opcję Custom Body (Treść niestandardowa) i wklej pełną treść pliku JSON.

  { "message": "Opened Jira Issue: [{{issue.key}}]({{issue.url}})", "context": "Jira" }
  
  *** Porada eksperta: więcej na temat wartości inteligentnych można znaleźć tutaj: https://support.atlassian.com/jira-software-cloud/docs/smart-values-general/

9. Kliknij przycisk Save (Zapisz).

10. Na następnej stronie wprowadź nazwę, na przykład „Send Comment to Dynatrace on Issue Creation” (Wysyłanie do Dynatrace komentarza o utworzeniu zgłoszenia) i kliknij przycisk Turn it on (Włącz).

11. Po zapisaniu kliknij łącze Return to list (Powrót do listy) w prawym górnym rogu. Nowa reguła powinna być włączona.

1. W oknie Dynatrace, w menu po lewej stronie, kliknij opcję Settings (Ustawienia).

2. W menu podrzędnym ustawień rozwiń menu podrzędne Integrations (Integracje), a następnie wybierz opcję Problem notifications (Powiadomienia o problemach).

3. Wybierz pozycję Set up notifications (Konfiguruj powiadomienia).

4. Spośród dostępnych typów powiadomień wybierz opcję Jira.

5. Skonfiguruj powiadomienie:

• Display name (Nazwa wyświetlana) — wprowadź wartość, na przykład „Jira Tutorial” (Samouczek Jira)

• Jira endpoint URI (Identyfikator URI punktu końcowego Jira) — zaktualizuj tę wartość zgodnie z Twoim kontem Jira

  https://[TWOJE-KONTO-JIRA].atlassian.net/rest/api/2/

• Username (Nazwa użytkownika) — identyfikator użytkownika używany do tworzenia tokena API Atlassian

• API token (Token API) — ciąg tokena API Atlassian

• Project key (Klucz projektu) — klucz (nie nazwa) projektu Jira, w którym będą tworzone i śledzone nowe zgłoszenia. Jeśli tego samego użyto w powyższym przykładzie, brzmiał on „DT”

• Summary (Podsumowanie) — pozostaw wartość domyślną

• Issue description (Opis zgłoszenia) — pozostaw wartość domyślną
  
  *** Porada eksperta — w sekcji Available placeholders (Dostępne symbole zastępcze) na stronie konfiguracji znajduje się lista symboli zastępczych, których można użyć do tej integracji. Symbole zastępcze są automatycznie zastępowane informacjami dotyczącymi problemów.

6. Wybierz opcję Send test notification (Wyślij powiadomienie testowe), aby sprawdzić poprawność działania integracji Jira. Powinien się pojawić następujący widok:

Z kolei w systemie Jira zgłoszenie testowe będzie wyglądało następująco:

7. Kliknij przycisk Save (Zapisz).