Integracja elementu roboczego

Integracja elementów roboczych umożliwia tworzenie problemów, usterek lub zadań w usłudze GitHub lub Azure DevOps bezpośrednio z środowisk Application Insights. Szablony osadzają zapytania języka zapytań Kusto (KQL) i zawartość skoroszytu, aby nowe zadania robocze zawierały istotne dane telemetryczne.

Szablony elementów roboczych Azure Monitor Workbooks są zapisywane jako Microsoft.Insights/workbooks typ zasobu. Twórz i automatyzuj te skoroszyty tak jak każdy inny skoroszyt.

Integracja elementu roboczego obejmuje następujące funkcje:

• Określ, czy szablon jest przeznaczony dla usługi GitHub , czy usługi Azure DevOps przy użyciu ikon repozytorium.
• Obsługa wielu konfiguracji dla dowolnej liczby repozytoriów lub elementów roboczych.
• Wdrażanie przy użyciu szablonów usługi Azure Resource Manager (ARM).
• Uwzględnij wstępnie utworzone i dostosowywalne zapytania języka Kusto Query Language (KQL), które dodają dane usługi Application Insights do elementów roboczych.
• Udostępnij dostosowywalne szablony skoroszytów.

Permissions

Aby utworzyć lub edytować szablon elementu roboczego, użyj roli platformy Azure z elementem Microsoft.Insights/workbooks/write, takim jak Współautor skoroszytu lub Współautor monitorowania.

Aby utworzyć sam element roboczy, potrzebujesz wystarczających uprawnień w systemie docelowym (GitHub lub Azure DevOps). Element zostanie utworzony w tym systemie po otworzie nowej karty portalu.

Tworzenie i konfigurowanie szablonu elementu roboczego

1. Otwórz zasób usługi Application Insights . W obszarze Konfiguruj otwórz pozycję Elementy robocze, a następnie wybierz pozycję Utwórz nowy szablon.
2. Możesz też zacząć od szczegółów transakcji end-to-end, kiedy nie istnieje żaden szablon. Wybierz zdarzenie, wybierz pozycję Utwórz element roboczy, a następnie wybierz pozycję Rozpocznij od szablonu skoroszytu.
3. Po wybraniu pozycji Utwórz nowy szablon wybierz system śledzenia, nadaj skoroszytowi nazwę, połącz się z systemem śledzenia i wybierz region przechowywania szablonów. Wprowadź domyślny adres URL repozytorium, taki jak https://github.com/myusername/reponame lub https://dev.azure.com/{org}/{project}. Lokalizacja wybranego regionu to lokalizacja platformy Azure dla zapisanego zasobu skoroszytu. Nie zmienia to miejsca, w którym przechowywane są dane Application Insights lub z którego są one odpytane (pobierane).
4. Ustaw domyślne właściwości elementu roboczego w szablonie. Właściwości obejmują przypisywanie, ścieżkę iteracji i projekty. Dostępne właściwości zależą od systemu śledzenia.

Uwaga / Notatka

W przypadku lokalnych środowisk Azure DevOps użyj adresu URL symbolu zastępczego, np. https://dev.azure.com/test/test podczas tworzenia szablonu. Po utworzeniu otwórz wygenerowany skoroszyt platformy Azure, zmodyfikuj parametr tekstowy adresu URL repozytorium i dodaj regułę weryfikacji (wyrażenie regularne), która jest zgodna z hostem usługi Azure DevOps Server, na przykład ^https://devops\.contoso\.corp/.*$.

Tworzenie elementów roboczych

Użyj szablonu z kompleksowych szczegółów transakcji, które są dostępne na kartach Wydajność, Błędy, Dostępność i innych.

Uwaga / Notatka

Po pierwszym wybraniu pozycji Utwórz element roboczy zostanie wyświetlony monit o połączenie usługi Application Insights z organizacją i projektem usługi Azure DevOps.

1. Otwórz szczegóły transakcji kompleksowej, wybierz zdarzenie, a następnie wybierz pozycję Utwórz element roboczy.
2. Wybierz szablon. Jeśli szablon nie istnieje, wybierz pozycję Rozpocznij od szablonu skoroszytu , aby go utworzyć.
3. Ukończ okienko Nowy element roboczy . Usługa Application Insights wstępnie wypełnia dane kontekstowe z wybranego zdarzenia, na przykład szczegóły wyjątku, nazwę operacji i link z powrotem do transakcji. Dodaj wszelkie potrzebne dodatkowe informacje, a następnie zapisz.
4. Zostanie otwarta nowa karta przeglądarki w systemie śledzenia. W usłudze Azure DevOps utwórz usterkę lub zadanie. W usłudze GitHub utwórz problem w repozytorium. Element roboczy zawiera kontekst z usługi Application Insights.

Edytowanie szablonu

1. Otwórz Elementy robocze w obszarze Konfiguruj, a następnie wybierz ikonę ołówka obok książki roboczej aby zaktualizować.
2. Wybierz pozycję Edytuj na górnym pasku narzędzi.
3. Aby ustandaryzować wdrażanie skoroszytu w różnych środowiskach, użyj szablonów usługi Azure Resource Manager (ARM). Utwórz wiele konfiguracji dla różnych scenariuszy.

Rozwiązywanie problemów

Zobacz dedykowany artykuł dotyczący rozwiązywania problemów.