Close

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

Zdjęcie portretowe Phillipa Jonesa
Rob Jahn

Kierownik techniczny ds. partnerów i ewangelista DevOps w Dynatrace

W tym samouczku opisano sposób automatycznego generowania zgłoszeń Jira dotyczących problemów wykrytych automatycznie w środowiskach monitorowanych za pomocą platformy Dynatrace. Dowiesz się, jak utworzyć dwukierunkową integrację za pomocą funkcji Jira Automation, aby móc zarządzać problemami.

Why should you integrate your observability platform with Jira?

The easy, out-of-the-box integration of Dynatrace and Jira cuts down manual work by completely automating the reporting of Dynatrace-detected problems in your monitored environment. It then sends reports directly to your organization's Jira project.

Time

15-minute read. Complete over 2-3 hours.

Audience

You're familiar with how scrum and/or kanban works in Jira.

You have administrator projects permission for all projects on your scrum or kanban board. See Managing project permissions for more information.

You have administration permission for your Dynatrace environment. See Get started with Dynatrace for more information.

You have a basic knowledge of Linux commands.

Prerequisites

You have a Jira account and basic proficiency in Jira. Get started with Jira here

You have a Dynatrace environment - Get a 15-day trial of Dynatrace.

A Linux host is required to run a Dynatrace provided sample application. Follow the installation instructions found in this README for requirements and instructions to install on a virtual machine.

This same Linux host needs to have the Dynatrace OneAgent installed.

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.

Schemat wykorzystania połączenia rozwiązań Dynatrace i Jira

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.

Konfiguracja

Przed przystąpieniem do wykonania przypadków użycia zawartych w tym samouczku trzeba wykonać kilka czynności konfiguracyjnych.

Krok 1: Upewnienie się, że aplikacja jest monitorowana przez system Dynatrace

1. Podana przykładowa aplikacja powinna być widoczna w przeglądarce. Strona główna wygląda następująco:

Strona główna Dynatrace

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.

Okno usług

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

Okno usług frontendowych

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

Okno czasu reakcji

Krok 2: Utworzenie tokena API Dynatrace

Do uwierzytelnienia w celu skorzystania z interfejsu API Dynatrace potrzebny jest ważny token API. Interfejs API Dynatrace jest interfejsem szczegółowym, co oznacza, że do tokena trzeba przypisać odpowiednie uprawnienia. Do skonfigurowania reguły automatyzacji Jira w kroku 4 potrzebny będzie token API Dynatrace.

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

Opcja ustawień w obszarze stanu wdrożenia

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

Interfejs API Dynatrace w ustawieniach tokena

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.

Włączanie dostępu do kanału, wskaźników i topologii problemu

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).

Krok 3: Tworzenie projektu Jira

Jeśli na potrzeby tego samouczka utworzony został specjalny projekt Jira, po zakończeniu można go usunąć. Każdy projekt Jira ma nazwę i klucz projektu. Klucz projektu Jira jest potrzebny do konfiguracji powiadomień o problemach w Dynatrace w kroku 6.

1. Na koncie Jira przejdź do menu Projects (Projekty) i wybierz opcję Create Project (Utwórz projekt).

2. Wprowadź nazwę „Dynatrace Tutorial”, wybierz szablon Kanban i kliknij przycisk Create (Utwórz).

Okno tworzenia projektu

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”.

Krok 4: Tworzenie reguły automatyzacji Jira

Ten krok polega na skonfigurowaniu reguły automatyzacji wyzwalanej przy każdym nowym komentarzu w systemie Jira. Po wyzwoleniu reguła automatyzacji Jira kieruje interfejs API problemu Dynatrace tak, aby tekst komentarzy z systemu Jira został dodany do problemu w aplikacji Dynatrace.

1. Z menu projektu po lewej stronie wybierz opcję Project settings (Ustawienia projektu).

2. W menu ustawień projektu po lewej stronie wybierz opcję Automation (Automatyzacja).

3. Na stronie Automation (Automatyzacja) kliknij kartę Rules (Reguły) w górnej części, aby uzyskać dostęp do reguł z obszaru Project (Projekt).

Opcja automatyzacji w panelu nawigacji z lewej strony i karta reguł po prawej stronie

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.

Utworzono zgłoszenie

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

Nowa czynność z okna dodawania komponentów

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

Send web request (Wyślij żądanie internetowe)

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

Wysyłanie żądania sieciowego za pomocą komentarza
  • 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.
Wyróżniony kod
  • 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).

Dodawanie komponentu lub wysyłanie komentarza do Dynatrace

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

Okno narzędzia Automation

Krok 5: Utworzenie tokena API Jira

Token API Atlassian służy do uwierzytelniania skryptu lub innego procesu za pomocą produktu Atlassian Cloud. Token jest generowany z Twojego konta Atlassian. Ten token API Jira jest potrzeby do skonfigurowania powiadomienia o problemach z systemu Dynatrace w kroku 6.

1. Zaloguj się na stronie https://id.atlassian.com/manage/api-tokens.

2. Kliknij przycisk Create API token (Utwórz token API).

3. W wyświetlonym oknie dialogowym wprowadź łatwą do zapamiętania i krótką treść w polu Etykieta swojego tokena, na przykład „Dynatrace Tutorial” (Samouczek Dynatrace), i kliknij przycisk Create (Utwórz).

4. WAŻNE: Kliknij przycisk Copy (Kopiuj), a następnie wklej i zapisz token API w bezpiecznym miejscu, ponieważ wartość ta będzie potrzebna w dalszych krokach samouczka. Zapisany token API będzie wyglądał następująco:

Okno tokenów API

Krok 6: Konfiguracja reguły powiadamiania o problemach Dynatrace

Dzięki integracji rozwiązań Dynatrace i Jira zgłoszenia są generowane automatycznie dla wszystkich nowych problemów wykrywanych automatycznie w Twoich środowiskach Dynatrace. Przykładowy widok po zakończeniu:

Konfiguracja integracji z systemem Jira

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

Strzałka wskazująca na ustawienia w lewym panelu nawigacyjnym

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

Powiadomienia o problemach w sekcji integracji w lewym panelu nawigacyjnym

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:

Pomyślny wynik testu integracji z systemem Jira

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

Uruchamianie testu powiadomień o problemach Dynatrace

7. Kliknij przycisk Save (Zapisz).

Dowiedz się więcej

Pobierz wtyczkę Dynatrace Problem Integration for Jira ze sklepu Atlassian Marketplace.
Zadawaj pytania (i udzielaj porad) naszej społeczności Dynatrace.
Więcej informacji na temat możliwości, jakie daje połączenie rozwiązań Dynatrace + Atlassian, znajdziesz tutaj.
Poczytaj więcej na temat kombinacji Dynatrace + Atlassian (i dowiedz się, jak pracować sprytniej, a nie ciężej) tutaj.
Zobacz Atlassian, Dynatrace i Keptn w akcji w Dynatrace Performance Clinic.
Zobacz więcej integracji dla Atlassian Open DevOps.

Procedurę automatycznego tworzenia zgłoszenia w oprogramowaniu Jira Software na podstawie problemu wykrytego w systemie Dynatrace znajdziesz w naszym drugim samouczku.

Rob Jahn
Rob Jahn

Udostępnij ten artykuł
Następny temat

Zalecane lektury

Dodaj te zasoby do zakładek, aby dowiedzieć się więcej na temat rodzajów zespołów DevOps lub otrzymywać aktualności na temat metodyki DevOps w Atlassian.

Ilustracja DevOps

Społeczność DevOps

Ilustracja DevOps

Ścieżka szkoleniowa DevOps

Ilustracja przedstawiająca mapę

Zacznij korzystać za darmo

Zapisz się do newslettera DevOps

Thank you for signing up