Vizualizarea jurnalelor de eroare pentru site-ul web

Administratorii de site-uri sau dezvoltatorii, utilizeazăa Power Pages pentru a crea site-uri web pentru clienții lor. Dezvoltatorii depanează problemele în timp ce dezvoltă site-ul. Pentru a ajuta la depanare, puteți accesa jurnalele de eroare detaliate pentru orice probleme cu site-ul dvs. Există mai multe moduri de a obține jurnalele de eroare pentru site-urile dvs.

Sfat

Pentru a afla despre rolurile necesare îndeplinirii sarcinilor din acest articol, citiți Roluri de administrator necesare pentru sarcinile administrative ale portalului.

Eroare particularizată

În cazul în care se produce orice excepție pe partea de server din site, se afișează în mod implicit o pagină de eroare particularizată cu un mesaj de eroare prietenos. Pentru a configura mesajul de eroare, consultați Afișarea unui mesaj de eroare particularizat.

Cu toate acestea, este mai bine să consultați pagina de eroare detaliată ASP.NET, denumită și Ecranul galben mortal - Yellow Screen of Death (YSOD), pentru scopuri de depanare. Pagina de eroare detaliată vă ajută să obțineți pachetul complet de erori de server.

Pentru a activa YSOD, trebuie să dezactivați erorile particularizate pe site-ul dvs.

Notă

• Se recomandă să dezactivați erorile particularizate numai atunci când sunteți în faza de dezvoltare și să activați erorile particularizate odată ce intrați live.
• Erorile particularizate sunt afișate în mod constant pe site-ul privat și nu pot fi dezactivate.

Mai multe informații despre eroarea particularizată: Afișarea unei pagini de eroare particularizată

Dezactivați eroarea particularizată

Aveți posibilitatea să dezactivați erorile particularizate pe site-urile Power Pages pentru a afișa mesajul de excepție detaliat în cazul în care se produce orice excepție pe partea de server în site.

1. Deschideți centrul de administrare Power Platform.

2. În secțiunea Resurse, selectați site-urile Power Pages.

3. Selectați-vă site-ul web.

4. Din meniul Acțiuni site, selectați Dezactivați erorile personalizate.

1. Selectați Dezactivare în mesajul de confirmare. În timp ce erorile particularizate sunt dezactivate, site-ul repornește și nu va fi disponibil.

Activați eroarea particularizată

Aveți posibilitatea să activați erorile particularizate pe site-uri pentru a afișa o pagină cu aspect profesionist în loc de YSOD. Această pagină furnizează informații semnificative în cazul în care apare orice excepție în aplicație.

1. Deschideți centrul de administrare Power Platform.

2. În secțiunea Resurse, selectați site-urile Power Pages.

3. Selectați-vă site-ul web.

4. Din meniul Acțiuni site, selectați Activați erorile personalizate.

5. Selectați Activare în mesajul de confirmare. În timp ce erorile particularizate sunt activate, site-ul repornește și nu va fi disponibil.

Notă

• Dacă modificați instanța la care este conectat site-ul, setarea erorilor particularizate este activată. Trebuie să dezactivați din nou erorile particularizate, dacă este necesar.
• Nu trebuie să activați sau să dezactivați erorile particularizate atunci când este modificată instanța la care este conectat site-ul; în caz contrar, apare un mesaj de eroare.

Afișați un mesaj de eroare particularizat

Aveți posibilitatea să configurați site-ul astfel încât să afișeze o eroare particularizată cu aspect profesionist în locul unei erori generice.

Pentru a defini o eroare particularizată, utilizați fragmentul de conținut Portal Generic Error. Conținutul definit în acest fragment este afișat pe pagina de eroare. Acest fragment de conținut nu este disponibil predefinit, deci trebuie să îl creați. Fragmentul de conținut Tip poate fi Text sau HTML. Pentru a crea sau a edita fragmentul de conținut, consultați Particularizarea conținutului utilizând fragmente de conținut.

Notă

În cazul în care este scris cod Liquid în fragmentul de conținut, va fi omis și nu se va reda.

Când activați erori particularizate, mesajul apare în următoarea structură pe pagina de eroare:

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

Mai jos este un exemplu de mesaj de eroare particularizat ce utilizează un fragment de conținut de tip HTML:

This is a custom error, file a support ticket with screenshot of error by clicking here

Notă

Dacă site-ul nu poate regăsi un fragment de conținut pentru că nu se poate conecta la Microsoft Dataverse sau dacă fragmentul nu este disponibil în Dataverse, apare un mesaj de eroare.

Accesați jurnalele de eroare pentru site-ul web

După dezvoltarea și publicarea site-ului, trebuie în continuare să puteți accesa jurnalele site-ului pentru a depana problemele raportate de utilizatorii dvs. Pentru a accesa jurnalele, configurați site-ul pentru a trimite toate erorile de aplicații într-un cont de stocare de bloburi Azure deținut de dvs. Prin accesarea jurnalelor de eroare ale site-ului, puteți răspunde eficient la întrebările utilizatorilor, deoarece aveți detalii despre problemă. Pentru a obține jurnalele de eroare despre site în spațiul de stocare de bloburi Azure, trebuie să activați înregistrarea în jurnal a diagnosticelor din centrul de administrare Power Platform.

Notă

Dacă modificați instanța Dataverse la care este conectat site-ul, înregistrarea în jurnal a diagnosticelor este dezactivată. Trebuie să activați din nou înregistrarea în jurnal a diagnosticelor.

Activați înregistrarea în jurnal a diagnosticelor

1. Deschideți centrul de administrare Power Platform.

2. În secțiunea Resurse, selectați site-urile Power Pages.

3. Selectați-vă site-ul web.

4. Din meniul Acțiuni site, selectați Activați jurnalele de diagnostice.

5. Va apărea un panou lateral, cu titlul Activați înregistrarea în jurnal a diagnosticelor, introduceți următoarele valori:

   • Selectați perioada de reținere: durata de păstrare a jurnalelor de eroare ale portalului în stocarea de bloburi. Jurnalele de eroare sunt șterse după durata selectată. Puteți selecta una dintre următoarele valori:

     • O zi
     • Șapte zile
     • 30 de zile
     • 60 zile
     • 90 de zile
     • 180 zile
     • Întotdeauna

     În mod implicit, perioada de reținere este de 30 de zile.

   • Șirul de conectare al serviciului de stocare de bloburi Azure: URL-ul serviciului de stocare de bloburi Azure pentru a stoca jurnalele de eroare ale site-ului. Lungimea maximă a adresei URL este de 2048 de caractere. Dacă adresa URL este mai lungă de 2048 de caractere, apare un mesaj de eroare. Mai multe informații despre șirul de conexiune: Configurarea șirurilor de conexiune pentru stocarea Azure

     

6. Selectați Activare.

Odată ce este configurată înregistrarea în jurnal a diagnosticelor, se creează un nou container de bloburi de jurnale de telemetrie în contul de stocare Azure și jurnalele sunt scrise în fișierele blob stocate în container. Următoarea captură de ecran afișează containerul de bloburi de jurnale de telemetrie în Azure Storage Explorer:

Atunci când înregistrarea în jurnal pentru diagnosticare este activată, următoarele acțiuni devin disponibile din meniul Acțiuni site:

• Dezactivați configurația de înregistrare în jurnal a diagnosticelor: vă permite să dezactivați configurația de înregistrare în jurnal a diagnosticelor pentru portal.
• Actualizați configurația de înregistrare în jurnal a diagnosticelor: vă permite să actualizați sau să eliminați configurația de înregistrare în jurnal a diagnosticelor pentru portal.

Actualizați înregistrarea în jurnal a diagnosticelor

1. Deschideți centrul de administrare Power Platform.

2. În secțiunea Resurse, selectați site-urile Power Pages.

3. Selectați-vă site-ul web.

4. Din meniul Acțiuni site, selectați Actualizați configurația înregistrării de diagnosticare.

5. În panoul Actualizați configurația de înregistrare în jurnal a diagnosticelor, introduceți următoarele valori:

   • Doriți să actualizați șirul de conexiune al serviciului Stocare de bloburi Azure?: vă permite să specificați dacă să actualizați șirul de conexiune al serviciului Stocare de bloburi Azure. În mod implicit nu este selectat.

   • Selectați perioada de reținere: durata a păstrare a jurnalelor de eroare ale site-ului în stocarea de bloburi. Jurnalele de eroare sunt șterse după durata selectată. Puteți selecta una dintre următoarele valori:

     • O zi
     • Șapte zile
     • 30 de zile
     • 60 zile
     • 90 de zile
     • 180 zile
     • Întotdeauna

     În mod implicit, perioada de reținere este de 30 de zile.

   • Șirul de conectare al serviciului de stocare de bloburi Azure: URL-ul serviciului de stocare de bloburi Azure pentru a stoca jurnalele de eroare ale site-ului. Lungimea maximă a adresei URL poate fi de 2048 de caractere. Dacă adresa URL este mai lungă de 2048 de caractere, apare un mesaj de eroare. Acest câmp se afișează numai dacă este bifată caseta de selectare Doriți să actualizați șirul de conexiune al serviciului Stocare de bloburi Azure?. Mai multe informații despre șirul de conexiune: Configurarea șirurilor de conexiune pentru stocarea Azure

Dezactivați înregistrarea în jurnal a diagnosticelor

1. Deschideți centrul de administrare Power Platform.

2. În secțiunea Resurse, selectați site-urile Power Pages.

3. Selectați-vă site-ul web.

4. Din meniul Acțiuni site, selectați Dezactivați jurnalele de diagnostice.

5. Selectați Dezactivare în mesajul de confirmare.

Afișare eroare plugin

Un alt scenariu care apare adesea pe parcursul dezvoltării unui site este o eroare generată de pluginuri particularizate și logica de afaceri scrisă în mediul dvs. Dataverse. Aceste erori pot fi accesate în general prin dezactivarea erorilor particularizate sau prin activarea înregistrării în jurnal a diagnosticelor. În unele cazuri, este mai rapid să afișați aceste erori direct pe site pentru a diagnostica problema mai rapid. Aveți posibilitatea să configurați site-ul pentru a afișa erorile de plugin particularizate din Dataverse pe pagina web.

Pentru a afișa erorile de plugin particularizate, creați setarea de site Site/EnableCustomPluginError și setați valoarea sa la Adevărat. Erorile de plugin particularizate vor fi afișate pe ecran în locul unei erori generice. Eroarea va afișa numai partea de mesaj a erorii de plugin, nu trasarea de stivă completă.

Iată ecranele unde vor apărea erori de plugin particularizate:

• Listă
  • Regăsirea înregistrărilor
• Formular de bază
  • Regăsiți
  • Creare/Actualizare, etc.
• Formulare cu mai mulți pași
  • Regăsiți
  • Creare/Actualizare, etc.

Dacă setarea de site nu este prezentă, va fi tratată ca falsă implicit și erorile de plugin nu se vor reda.