Wyświetlanie dzienników błędów portalu

Uwaga

12 października 2022 r. funkcja Portale usługi Power Apps została przekształcona w usługę Power Pages. Więcej informacji: Usługa Microsoft Power Pages jest teraz ogólnie dostępna (blog)
Wkrótce zmigrujemy i scalimy dokumentację funkcji Portale usługi Power Apps z dokumentacją usługi Power Pages.

Administratorzy i programiści portali używają portali Power Apps do tworzenia stron internetowych dla swoich klientów. Programiści często rozwiązują problemy podczas tworzenia portalu. Aby pomóc w debugowaniu, możesz uzyskać dostęp do szczegółowych dzienników błędów dla dowolnych problemów w portalu. Istnieje wiele sposobów na pobranie dzienników błędów dla portali.

Uwaga

Dzienniki błędów portalu Power Apps są również używane dla Power Pages. Więcej informacji: Co to jest Power Pages

Napiwek

Aby dowiedzieć się więcej o rolach wymaganych do wykonania zadań w tym artykule, należy przeczytać Role administracyjne wymagane do zadań administracyjnych portalu.

Błąd niestandardowy

Gdy w portalu występuje jakikolwiek wyjątek na serwerze, strona błędu niestandardowego z przyjaznym użytkownikowi komunikatem o błędzie jest wyświetlana domyślnie. Aby skonfigurować komunikat o błędzie, zobacz Wyświetlanie komunikatu o błędzie niestandardowym.

Lepiej jednak zobaczyć szczegółową stronę błędów ASP.NET, znaną również jako Żółty ekran śmierci (YSOD), do celów debugowania. Szczegółowa strona błędów pomaga uzyskać pełny stos błędów serwera.

Aby włączyć YSOD, należy wyłączyć błędy niestandardowe w portalu.

Uwaga

Zaleca się wyłączenie błędów niestandardowych tylko w fazie projektowania i włączenie błędów niestandardowych po uruchomieniu.

Więcej informacji na temat błędów niestandardowych: Wyświetlanie strony błędów niestandardowych

Wyłącz błędy niestandardowe

Możesz wyłączyć błędy niestandardowe dla portali, aby wyświetlić szczegółową wiadomość dotyczącą wyjątku jeśli jakikolwiek wyjątek na serwerze nastąpi w portalu.

1. Otwórz Centrum administracyjne portali Power Apps.

2. Przejdź do Akcje portalu > Wyłącz błędy niestandardowe.

   

3. Wybierz Wyłącz w komunikacie potwierdzenia. Podczas gdy błędy niestandardowe są wyłączane, portal jest restartowany i nie będzie dostępny. Po wyłączeniu błędów niestandardowych pojawia się wiadomość.

Włącz błąd niestandardowy

Można włączyć błędy niestandardowe dla portali, aby wyświetlać stronę wyglądającą profesjonalnie, zamiast YSOD. Ta strona zapewnia znaczące informacje w przypadku wystąpienia w aplikacji jakiegokolwiek wyjątku.

1. Otwórz Centrum administracyjne portali Power Apps.

2. Przejdź do Akcje portalu > Włącz błędy niestandardowe.

   

3. Wybierz Włącz w komunikacie potwierdzenia. Podczas gdy błędy niestandardowe są włączane, portal jest restartowany i nie będzie dostępny. Po włączeniu błędów niestandardowych pojawia się wiadomość.

Uwaga

• Jeśli zmienisz wystąpienie, z którym Twój portal jest połączony, błędy ustawienie błędy niestandardowe jest ustawiane na włączony. Błędy niestandardowe należy wyłączyć ponownie, jeśli jest to wymagane.
• Nie należy włączać ani wyłączać błędów niestandardowych jeśli wystąpienie, z którym Twój portal jest połączony ma być zmieniane; w przeciwnym razie zostanie wyświetlony komunikat o błędzie.

Wyświetl komunikat o błędzie niestandardowym

Możesz skonfigurować portal, aby wyświetlał profesjonalnie wyglądający komunikat o błędzie niestandardowym zamiast o błędzie ogólnym.

Aby zdefiniować błąd niestandardowy użyj fragmentu kodu zawartości Portal Generic Error. Zawartość zdefiniowana w tym fragmencie kodu jest wyświetlana na stronie błędów. Ten fragment kodu zawartości nie jest dostępny razem z oprogramowaniem, należy go utworzyć. Fragmentem kodu zawartości Typ może być Tekst lub HTML. Aby utworzyć lub edytować fragment zawartości, zobacz Dostosuj zawartość za pomocą fragmentów kodu zawartości.

Uwaga

Jeśli kod Liquid zostanie wpisany w fragment kodu zawartości, zostanie on pominięty i nie będzie renderowany.

Po włączeniu błędów niestandardowych pojawi się wiadomość o następującej strukturze na stronie błędów:

<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>

Poniżej przedstawiono przykład wiadomości o błędzie niestandardowym, przy użyciu fragment kodu zawartości typu HTML:

Jest to błąd niestandardowy, zgłoś żądanie pomocy technicznej ze zrzutem ekranu błędu, klikając tutaj

Uwaga

Jeśli portal nie może odzyskać fragmentu kodu zawartości, ponieważ nie może nawiązać połączenia z Microsoft Dataverse, lub jeśli fragment kodu nie jest dostępny w Dataverse, zostanie wyświetlona wiadomość o błędzie.

Dostęp do dzienników błędów portalu

Po opracowywaniu i opublikowaniu portalu, nadal musisz mieć dostęp do dzienników portalu, aby debugować problemy zgłaszane przez klientów. Aby uzyskać dostęp do dzienników możesz skonfigurować portal, aby wysłać wszystkie błędy aplikacji do konta w Azure Blob storage należącego do Ciebie. Po uzyskaniu dostępu do dzienników błędów portalu, możesz efektywnie odpowiadać na kwerendy klienta, ponieważ posiadasz szczegółowe informacje dotyczące tego problemu. Aby uzyskać dzienniki błędów portalu do Azure Blob Storage musisz włączyć rejestrowanie diagnostyczne z poziomu Centrum administracyjnego portali Power Apps.

Uwaga

Jeśli zmienisz wystąpienie Dataverse, z którym portal jest połączony, rejestrowanie diagnostyczne zostanie wyłączone. Należy ponownie włączyć rejestrowanie diagnostyczne.

Włącz rejestrowanie diagnostyczne

1. Otwórz Centrum administracyjne portali Power Apps.

2. Przejdź do Akcje portalu > Włącz rejestrowanie diagnostyczne.

   

3. W oknie Włącz rejestrowanie diagnostyczne wprowadź następujące wartości:

   • Ciąg połączenia usługi Azure Blob Storage: URL usługi Azure Blob Storage do przechowywania dzienników błędów portalu. Maksymalna długość URL to 2048 znaków. Jeśli adres URL jest dłuższy niż 2048 znaków, zostanie wyświetlony komunikat o błędzie. Więcej informacji na temat ciągu połączenia: Skonfiguruj ciągi połączenia Azure Storage
   • Wybierz okres przechowywania: Czas przechowywania dzienników błędów portalu w magazynie obiektów blob. Dzienniki błędów są usuwane po wybranym czasie przechowywania ich. Można wybrać jedną z następujących wartości:
     • Jeden dzień
     • Siedem dni
     • 30 dni
     • 60 dni
     • 90 dni
     • 180 dni
     • Zawsze

   Domyślnie okres przechowywania wynosi 30 dni.

   

4. Wybierz Skonfiguruj.

Po skonfigurowaniu rejestrowania diagnostycznego nowy kontener dzienniki telemetryczne jest tworzony w ramach Twojego konta Azure Storage a dzienniki są zapisywane w plikach obiektów blob przechowywanych w kontenerze. Poniższy zrzut ekranu przedstawia kontener obiektów blob dzienników telemetrycznych w Azure Storage Explorer:

Po pomyślnym włączeniu rejestrowania diagnostycznego dostępna będzie następująca czynność:

• Aktualizuj konfigurację rejestrowania diagnostycznego: Pozwala na aktualizowanie i usuwanie konfiguracji rejestrowania diagnostycznego dla portalu.
• Wyłącz rejestrowania diagnostyczne: Pozwala na wyłączenie konfiguracji rejestrowania diagnostycznego dla portalu.

Zaktualizuj rejestrowanie diagnostyczne

1. Otwórz Centrum administracyjne portali Power Apps.

2. Przejdź do Akcje portalu > Aktualizuj konfigurację rejestrowania diagnostycznego.

   

3. W oknie konfiguracji Aktualizuj konfigurację rejestrowania diagnostycznego wprowadź następujące wartości:

   • Czy chcesz zaktualizować ciąg połączenia usługi Azure Blob Storage?: Pozwala określić, czy aktualizować ciąg połączenia usługi Azure Blob Storage. Domyślnie jest ona zaznaczona.
   • Ciąg połączenia usługi Azure Blob Storage: URL usługi Azure Blob Storage do przechowywania dzienników błędów portalu. Maksymalna długość URL to 2048 znaków. Jeśli adres URL jest dłuższy niż 2048 znaków, zostanie wyświetlony komunikat o błędzie. To pole jest wyświetlane tylko wtedy, gdy pole wyboru Czy chcesz zaktualizować parametry połączenia z usługą Azure Blob Storage? zostało zaznaczone. Więcej informacji na temat ciągu połączenia: Skonfiguruj ciągi połączenia Azure Storage
   • Wybierz okres przechowywania: Czas przechowywania dzienników błędów portalu w magazynie obiektów blob. Dzienniki błędów są usuwane po wybranym czasie przechowywania ich. Można wybrać jedną z następujących wartości:
     • Jeden dzień
     • Siedem dni
     • 30 dni
     • 60 dni
     • 90 dni
     • 180 dni
     • Zawsze

   Domyślnie okres przechowywania wynosi 30 dni.

   

4. Wybierz Aktualizuj.

Wyłącz rejestrowanie diagnostyczne

1. Otwórz Centrum administracyjne portali Power Apps.

2. Przejdź do Akcje portalu > Wyłącz rejestrowanie diagnostyczne.

   

3. Wybierz Wyłącz w komunikacie potwierdzenia.

Wyświetl błąd wtyczki

Inny scenariusz, często występujący podczas opracowywania portalu to błąd generowany przez niestandardowe dodatki plug-in i logikę biznesową napisaną w środowisku Dataverse. Te błędy są zazwyczaj dostępne po wyłączeniu błędów niestandardowych lub włączeniu rejestrowania diagnostycznego. W niektórych przypadkach szybciej jest wyświetlić te błędy bezpośrednio na portalu, by szybciej zdiagnozować problem. Możesz to osiągnąć, konfigurując swój portal tak, by wyświetlał na ekranie portalu błędy niestandardowych wtyczek z Dataverse.

Aby wyświetlić niestandardowe błędy dodatków plug-in, utwórz ustawienie witryny Site/EnableCustomPluginError i ustawić wartość na Prawda. Na ekranie zamiast błędu ogólnego zostaną wyświetlone niestandardowe błędu dodatku plug-in. Błąd wyświetli tylko część wiadomości o błędzie dodatku plug-in, nie pełny stos.

Poniżej przedstawiono ekrany, na których pojawią się niestandardowe błędy dodatków plug-in:

• Lista
  • Odzyskiwanie rekordów
• Formularz podstawowy
  • Retrieve
  • Tworzenie/aktualizowanie itd.
• Formularze obejmujące wiele kroków
  • Retrieve
  • Tworzenie/aktualizowanie itd.

Jeśli nie ma ustawienia witryny, będzie domyślnie traktowane jako fałsz, a dodatki plug-in nie będą renderowane.

Zobacz też

Utrzymywanie i rozwiązywanie problemów portalu Power App

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).