Monitorowanie działania dodatku Dataverse plug-in i rozwiązywanie problemów (wersja zapoznawcza)

[Ten temat pochodzi ze wstępnej wersji dokumentacji i może ulec zmianie.]

Śledzenie może używać do rozwiązywania problemów z dodatkami plug-in niskiej wersji kodu i kodu pro. Śledzenie pomaga producentom dzięki rejestrowaniu informacji dotyczących czasu uruchomieniowego jako sprzętu służącego do wykrywania przyczyny awarii lub ogólnego sprawdzania poprawności określonych stanów podczas projektowania.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Moduł monitorowania dodatku plug-in akceleratorze Dataverse zapewnia ulepszony widok istniejących funkcji śledzenia i rejestrowania dostępnych w Microsoft Dataverse dla dodatków plug-in. Interfejs pomaga poprawiać rozwiązywanie problemów i debugowanie procesów na etapie projektowania, kolidując ze sobą odpowiednie szczegóły w nowoczesnych procesach.

Wszystkie zdarzenia w aplikacji są odczytywane z tabeli Ślad przez 24 godziny według następujących typów przepływów pracy:

  • Dodatki plug-in
  • Niestandardowe interfejsy API
  • Natychmiastowe i zautomatyzowane niskokodowe dodatki plug-in

Interfejs monitorowania dodatku plug-in

Wymagania wstępne

Musisz mieć następujące przypisanie rola zabezpieczeń i dostęp do aplikacji akceleratora Dataverse:

  • Rola zabezpieczeń: Zarówno rola zabezpieczeń administratora systemu, jak i Administrator systemu mają wymagane uprawnienia umożliwiające włączenie dzienników i domyślne korzystanie z aplikacji.

  • Możesz także utworzyć role niestandardowe z konkretnym dostępem do poszczególnych funkcji, konfigurując następujące uprawnienia:

    • Do odczytu dzienników jest wymagane uprawnienie do odczytu danych na poziomie organizacji do tabeli śledzenia.
    • W celu włączenia rejestrowania się w środowisku jest wymagane uprawnienie do zapisu na poziomie organizacji w tabeli PluginTraceLogSetting.

Kluczowe cechy i funkcje

  • Scentralizowana przeglądarka dzienników: Dataverse uzyskiwanie dostępu do dzienników śledzenia z niestandardowych interfejsów API, dodatek plug-in z kodem niskiego i wykonywanie plug-in pro w środowisku z jednej centralnej lokalizacji.
  • Funkcje filtrowania: można łatwo filtrować historię dzienników, aby szybko znaleźć dzienniki związane z debugowaniem.

Instalacja

Ta funkcja jest dostępna w aplikacji Dataverse akceleratora. Przejdź do artykułu akceleratora Dataverse, aby otrzymać instrukcje instalacji.

Wypróbuj funkcję monitorowania dodatku plug-in

  1. Włącz akcelerator usługi Dataverse.

  2. Przejdź do funkcji monitorowania dodatków plug-in (w lewym okienku nawigacji lub karcie funkcji na ekranie docelowym).

Przejdź do strony monitorowania dodatku plug-in

Włącz rejestrowanie dziennika

Jeśli rejestrowanie dziennika nie jest włączone w środowisku, na stronie docelowej jest wyświetlany stan wyłączenia z dwiema opcjami włączenia rejestrowania: Wszystkie lub Wyjątki. Wybierz odpowiednią opcję w zależności od potrzeb, przejdź do artykułu Rejestrowanie, aby uzyskać więcej informacji.

Włącz ekran rejestrowania z przyciskami, aby włączyć wszystkie dzienniki lub włączyć tylko wyjątki

W razie potrzeby można zmienić te ustawienia na ekranie Ustawienia, który można znaleźć na pasku poleceń na ekranach głównych.

Ekran ustawień dziennika udostępnia formanty aktualizacji ustawień dziennika

Porada

Śledzenie i rejestrowanie są idealne do debugowania podczas projektowania dodatku plug-in. W przypadku przepływów pracy z dodatku plug-in w środowisku produkcyjnym użyj funkcji Wgląd w aplikację systemu Azure w celu monitorowania.

Wyświetl dzienniki

Po włączeniu dzienników zdarzenia dodatku plug-in zaczynają być wyświetlane na liście głównej wyświetlanej na ekranie.

Porada

Jeśli nie ma żadnych dzienników w tym programie, można utworzyć i uruchomić nowy, niskokodowy dodatek plug-in, aby rozpocząć wyświetlanie dzienników.

Filtruj dzienniki

Użyj funkcji filtrowania, aby szybko znaleźć dzienniki dotyczące właśnie pracujących dodatki plug-in.

Aby otworzyć okienko filtrów, wybierz przycisk Filtruj po prawej stronie ekranu. Korzystając z paska wyszukiwania, można też szybko filtrować słowa kluczowe.

Filtruj dzienniki

Filtr Podpis
Nazwa/nazwisko Wybierz logiczną nazwę dla wtyczki.
Rozpoczyna się po / przed Data i godzina wywołania zestawu dodatków plug-in.
Włącz tylko wyjątek Pokazuje przebiegi ze stanem niepowodzenia.
Czas trwania min / maks. Minimalny i maksymalny zakres czasu trwania dodatku plug-in.
Typ Klasyfikacja przepływu pracy dodatku plug-in. Dostępne typy języka obejmują:
  • Błyskawiczna wtyczka niskokodowa
  • Zautomatyzowana wtyczka niskokodowa
  • Dodatki plug-in
  • Niestandardowe dane w formacie API
Tryb Czy wtyczka jest synchroniczna czy asynchroniczna.

Przeczytaj szczegóły dziennika

Wybierz konkretny wpis dziennika, aby wyświetlić szczegółowe informacje o wykonaniu wtyczki. Szczegóły dziennika to między innymi timestamp, nazwa dodatku plug-in, stan wykonywania, parametry wyjściowe, komunikaty o błędach i nie tylko. Pola bloków komunikatów i bloków wyjątków są wyświetlane poniżej podstawowych szczegółów okienka i rozszerzane, jeśli istnieją dane w odpowiednich kolumnach.

Najlepsze rozwiązania

Sprawdź szczegóły dziennika

  • Wybierz konkretny wpis dziennika, aby wyświetlić szczegółowe informacje o wykonaniu wtyczki.
  • Szczegóły dziennika to między innymi sygnatura czasowa, nazwa wtyczki, stan wykonywania, parametry wyjściowe/wejściowe, komunikaty o błędach i nie tylko.

Rozwiązywanie problemów

  • Informacje zawarte w dziennikach śledzenia mogą rozwiązać wszelkie problemy pojawiające się podczas wykonywania dodatku plug-in.
  • Analizowanie komunikatów o błędach, parametrów wejściowych/wyjściowych i szczegółów wykonywania w celu zidentyfikowania głównej przyczyny problemu.
  • W celu podania pomocnych wskaźników można użyć wiadomości śledzenia. Zapisywanie do usługi śledzenia jest dostępne w zestawie SDK Dataverse i we wtyczkach niskokodowych jako funkcja śledzenia w Power Fx.

Podejmij działanie

  • W oparciu o dane zebrane w dziennikach śledzenia należy podjąć odpowiednie działania w celu rozwiązania problemów z wydajnością lub zidentyfikowania śledzenia.
  • Może to obejmować konfiguracje plug-in, aktualizację logiki kodu lub pomoc z zasobów pomocy technicznej.

Zaplanuj test

  • Spraw, które należy użyć do zaplanowania spraw testowych, można wykonywać w dziennikach śledzenia w celu sprawdzenia wydajności wtyczki podczas projektowania.
  • Należy szybko rozwiązać problemy i anomalie Dataverse, aby zapewnić ogólną stabilność i niezawodność tych wtyczek.

Monitorowanie wykorzystania wtyczek

  • Regularnie monitoruj wydajność dodatku plug-in w środowisku produkcyjnym, przeglądając zarejestrowane dzienniki śledzenia Application Insights.
  • Warto śledzić stan wykonywania, komunikaty o błędach i wszelkie anomalie, które mogą wskazywać na problemy z wydajnością lub problemy z wydajnością.

— często zadawane pytania

Jakie uprawnienia są wymagane do uzyskania dostępu do Przeglądarki dzienników śledzenia?

Aby można było wyświetlać dzienniki, należy mieć uprawnienia co najmniej do odczytu dzienników tabeli Śledzenia.

Kto może włączyć rejestrowanie dziennika w środowisku?

Administratorzy systemów z odpowiednim rola zabezpieczeń mogą włączyć rejestrowanie dzienników w ich środowisku. W szczególności do zapisu danych tabeli Organizacja jest potrzebny w celu zaktualizowania wartości kolumny PluginTraceLogSetting .

Czy można filtrować historię dzienników w celu znalezienia określonych dzienników?

Tak, przeglądarka dzienników śledzenia udostępnia funkcje filtrowania, co umożliwia użytkownikom wygodne znajdowanie dzienników odpowiednich dla ich potrzeb w zakresie debugowania.

Czy funkcja monitorowania dodatku plug-in jest dostępna we wszystkich środowiskach?

Ta funkcja jest dostarczana za pośrednictwem akceleratora Dataverse i jest dostępna we wszystkich środowiskach, w których zainstalowano aplikację. Aplikacja jest instalowana automatycznie we wszystkich nowych środowiskach, ale może być również instalowana w starszych środowiskach, zgodnie z instrukcjami dotyczącymi instalowania.

Po włączeniu rejestrowania jest w nim nadal włączony ekran "Rejestrowanie jest wyłączone"

Jeśli masz odpowiednie uprawnienia i masz pewność, że włączono rejestrowanie, odśwież kartę przeglądarki. Można sprawdzić czy rejestrowanie jest włączone, korzystając ze starszego oprogramowania.

Zobacz też

Pobierz funkcje w wersji zapoznawczej na wczesnym etapie pracy z akceleratorem Dataverse (wersja zapoznawcza)