Webhely hibanaplóinak megtekintése

A webhely rendszergazdái és fejlesztői a Power Pages használatával webhelyeket hozhatnak létre ügyfeleik számára. A fejlesztők gyakran hibakeresést folytatnak a webhely fejlesztése során. A hibakereséshez részletes hibanaplókat lehet elérni a webhely bármely problémájához. A webhelyek hibanaplóit többféle módon lehet megkapni.

Tipp.

A cikkben található feladatok elvégzéséhez szükséges szerepkörök megismeréséhez olvassa el a Portál felügyeleti feladataihoz szükséges rendszergazdai szerepkörök részt.

Egyéni hiba

A webhelyen bármely kiszolgálóoldali kivétel esetén alapértelmezés szerint testreszabott hibalap jelenik meg felhasználóbarát hibaüzenettel. A hibaüzenet konfigurálásához lásd: Egyéni hibaüzenetet megjelenítése.

Azonban célszerűbb az ASP.NET részletes hibaoldala (más néven sárga halál képernyő, YSOD) felkeresése hibakeresés céljából. A részletes hibaoldal segít a kiszolgáló hibái teljes sorának beszerzésében.

Az YSOD engedélyezéséhez le kell tiltani az egyéni hibákat a webhelyen.

Feljegyzés

• Az egyéni hibákat csak a fejlesztési fázisban ajánlott letiltani, és engedélyezni az egyéni hibákat a rendszer beüzemelése során.
• Az egyéni hibák következetesen megjelennek a privát webhelyen, és nem kapcsolhatók ki.

További tájékoztatás: Egyéni hibaoldal megjelenítése

Egyéni hibák letiltása

Az egyéni hibákat letilthatja a Power Pages-webhelyen a részletes kivételüzenet megjelenítése érdekében - ha szerveroldali kivétel történik a webhelyen.

1. A Power Platform felügyeleti központ megnyitása.

2. Válassza az Erőforrások szakaszban a Power Pages-webhelyek lehetőséget.

3. Válassza ki a webhelyet.

4. Válassza a Webhelyműveletek menü Egyéni hibák letiltása parancsát.

1. A jóváhagyást kérő üzenetnél válassza a Letiltás lehetőséget. Az egyéni hibák letiltása alatt a webhely újraindul, és nem lesz elérhető.

Egyéni hibák engedélyezése

A webhelyeken engedélyezheti az egyéni hibákat, hogy egy professzionális megjelenésű oldal jelenjen meg az YSOD helyett. Ez az oldal értelmes információt nyújt, ha bármilyen kivétel történik az alkalmazásban.

1. A Power Platform felügyeleti központ megnyitása.

2. Válassza az Erőforrások szakaszban a Power Pages-webhelyek lehetőséget.

3. Válassza ki a webhelyet.

4. Válassza a Webhelyműveletek menü Egyéni hibák engedélyezése parancsát.

5. A jóváhagyást kérő üzenetnél válassza az Engedélyezés lehetőséget. Az egyéni hibák engedélyezése alatt a webhely újraindul, és nem lesz elérhető.

Feljegyzés

• Ha módosítja a példányt, amelyhez a webhely csatlakozik, az egyéni hibák beállítása engedélyezve van. Ha szükséges, újra le kell tiltania az egyéni hibákat.
• Ne engedélyezze vagy tiltsa le az egyéni hibákat, ha a példány, amelyhez a webhely csatlakozik, módosítás alatt áll; ellenkező esetben hibaüzenet jelenik meg.

Egyéni hibaüzenetet megjelenítése

Konfigurálhatja a webhelyet, hogy professzionális megjelenésű, egyéni hibaüzeneteket jelenítsen meg általános hiba helyett.

Egyéni hiba meghatározásához használja a Portal Generic Error tartalom-kódrészletet. Az ebben a kódrészletben meghatározott hiba jelenik meg a hibaoldalon. Ez a tartalom-kódrészlet nem érhető el készen, Önnek kell létrehoznia. A tartalom-kódrészlet Típusa lehet Szöveg vagy HTML. Tartalomrészlet létrehozásához vagy szerkesztéséhez lásd: Tartalom testreszabása tartalomrészletek segítségével.

Feljegyzés

Ha egy tartalom-kódrészletbe folyékony kód kerül, az a rendszer kihagyja, és nem hajtja végre.

Ha engedélyezi a egyéni hibákat, a hiba a következő felépítéssel jelenik meg a hibaoldalon:

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

Az alábbiakban egy egyéni hibaüzenet példája látható, HTML típusú tartalom-kódrészlet alkalmazásával:

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

Feljegyzés

Ha a webhely nem tud letölteni egy tartalomrészletet, mert nem tud csatlakozni a Microsoft Dataverse szolgáltatáshoz, vagy a tartalomrészlet nem elérhető a Dataverse szolgáltatásban, hibaüzenet jelenik meg.

Hozzáférés a webhely hibanaplóihoz

A webhely fejlesztése és közzététele után továbbra is hozzá kell férnie a webhelynaplókhoz a felhasználók által jelentett problémák hibakereséséhez. A naplók eléréséhez állítsa be a webhelyet, hogy minden alkalmazáshibát küldjön el az Ön Azure Blob Storage-fiókjába. A webhely-hibanaplók alapján hatékonyan válaszolhat a felhasználó megkereséseire, mert ténylegesen rálát a probléma részleteire. A webhely-hibanaplók az Azure Blob Storage-be való eljuttatásához engedélyezni kell a diagnosztikai naplózást a Power Platform felügyeleti központjában.

Feljegyzés

Ha módosítja a Dataverse példányát, amelyhez a webhely kapcsolódik, a diagnosztikai naplózás le lesz tiltva. Újra engedélyeznie kell a diagnosztikai naplózást.

Diagnosztikai naplózás engedélyezése

1. A Power Platform felügyeleti központ megnyitása.

2. Válassza az Erőforrások szakaszban a Power Pages-webhelyek lehetőséget.

3. Válassza ki a webhelyet.

4. Válassza a Webhelyműveletek menü Diagnosztikai naplók engedélyezése parancsát.

5. Megjelenik egy Diagnosztikai naplózás engedélyezése című oldalsó panel, amelybe be kell írnia a következő értékeket:

   • Válassza ki a megőrzési időt: A portál hibanaplóinak a blobtárolóban történő megőrzési ideje. A hibanaplók a kijelölt időtartam után törlődnek. Az alábbi értékek közül választhat:

     • Egy nap
     • Hét nap
     • 30 nap
     • 60 nap
     • 90 nap
     • 180 nap
     • Mindig

     Alapértelmezés szerint a megőrzési időtartam 30 nap.

   • Az Azure Blob Storage szolgáltatás kapcsolati sztringje: A webhely hibanaplóinak tárolására használandó Azure Blob Storage szolgáltatás URL-je. Az URL maximális hossza 2048 karakter. Ha az URL meghaladja a 2048 karaktert, hibaüzenet jelenik meg. További tájékoztatás a kapcsolati karakterláncról: Azure Storage kapcsolati karakterláncok konfigurálása

     

6. Válassza ki az Engedélyezés lehetőséget.

Ha a diagnosztikai naplózás konfigurálva van, új telemetria-naplók blobtároló jön létre az Azure Storage-fiókban, és a naplók kiírásra kerülnek a tárolóban tárult blobfájlokba. Az alábbi képernyőképen látható a telemetria-naplók blobtároló az Azure Storage Explorerben:

A diagnosztikai naplózás sikeres engedélyezése esetén a következő műveletet elérhetővé válnak a Webhelyműveletek menüből:

• Diagnosztikai naplózás letiltása: Lehetővé teszi a portál diagnosztikai naplózási konfigurációjának letiltását.
• Diagnosztikai naplózás konfigurációjának frissítése: Lehetővé teszi a portál diagnosztikai naplózási konfigurációjának frissítését vagy eltávolítását.

Diagnosztikai naplózás frissítése

1. A Power Platform felügyeleti központ megnyitása.

2. Válassza az Erőforrások szakaszban a Power Pages-webhelyek lehetőséget.

3. Válassza ki a webhelyet.

4. Válassza a Webhelyműveletek menü Diagnosztikai naplózás konfigurációjának frissítése parancsát.

5. A Diagnosztikai naplózás konfigurációjának frissítése panelben adja meg a következő értékeket:

   • Biztosan módosítja az Azure Blob Storage szolgáltatás kapcsolati sztringjét?: Segítségével megadhatja, kívánja-e frissíteni az Azure Blob Storage szolgáltatás kapcsolati sztringjét. Alapértelmezés szerint ez nincs bejelölve.

   • Válassza ki a megőrzési időt: A webhely hibanaplóinak a blobtárolóban történő megőrzési ideje. A hibanaplók a kijelölt időtartam után törlődnek. Az alábbi értékek közül választhat:

     • Egy nap
     • Hét nap
     • 30 nap
     • 60 nap
     • 90 nap
     • 180 nap
     • Mindig

     Alapértelmezés szerint a megőrzési időtartam 30 nap.

   • Az Azure Blob Storage szolgáltatás kapcsolati sztringje: A webhely hibanaplóinak tárolására használandó Azure Blob Storage szolgáltatás URL-je. Az URL maximális hossza 2048 karakter lehet. Ha az URL meghaladja a 2048 karaktert, hibaüzenet jelenik meg. Ez a mező csak akkor jelenik meg, ha a Biztosan módosítja az Azure Blob Storage szolgáltatás kapcsolati karakterláncát? jelölőnégyzet be van jelölve. További tájékoztatás a kapcsolati karakterláncról: Azure Storage kapcsolati karakterláncok konfigurálása

Diagnosztikai naplózás letiltása

1. A Power Platform felügyeleti központ megnyitása.

2. Válassza az Erőforrások szakaszban a Power Pages-webhelyek lehetőséget.

3. Válassza ki a webhelyet.

4. Válassza a Webhelyműveletek menü Diagnosztikai naplók letiltása parancsát.

5. A jóváhagyást kérő üzenetnél válassza a Letiltás lehetőséget.

Beépülőmodul-hiba megjelenítése

Egy másik forgatókönyv, amely gyakran előfordul egy webhely fejlesztésénél, a Dataverse-környezetben írt egyéni bővítmények és üzleti logika által generált hibák megjelenése. Ezek a hibák általában az egyéni hibák letiltásával vagy az egyéni hibák engedélyezésével érhetők el. Bizonyos esetekben gyorsabb közvetlenül a webhelyen megjeleníteni ezeket a hibákat a probléma gyorsabb diagnosztizálásához. Ezt megteheti a webhely konfigurálásával, hogy Dataverse szolgáltatásból származó egyéni beépülő modulok hibáit megjelenítse a weboldalon.

Egyéni beépülőmodul-hibák megjelenítéséhez hozzon létre egy webhelybeállítást (Site/EnableCustomPluginError), és állítsa az értékét Igaz értékre. Általános hiba helyett az egyéni beépülőmodul-hibák jelennek meg a képernyőn. A hibaüzenet a beépülőmodul-hibának csak az üzenetrészét jeleníti meg, és nem a teljes hívásláncot.

Az alábbiakban láthatók a képernyők, ahol egyéni beépülőmodul-hibák megjelennek:

• Lista
  • Rekordok lehívása
• Alapűrlap
  • Retrieve
  • Létrehozás/frissítés stb.
• Többlépéses űrlapok
  • Retrieve
  • Létrehozás/frissítés stb.

Ha a webhelybeállítás nincs jelen, akkor alapértelmezés szerint hamisnak minősül, és a beépülőmodul-hibák nem jelennek meg.