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.

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.

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. Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .

3. Válassza ki a webhelyet.

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

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

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. Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .

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 közben a webhely újraindul, és átmenetileg nem érhető el.

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.

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ábbi üzenet egy HTML típusú tartalom-kódrészlet használó egyéni hibaüzenetre mutat példát:

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

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.

Diagnosztikai naplózás engedélyezése

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

2. Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .

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 nevűoldalsó panel, amely a következő értékeket adja meg:

   • Válassza ki a megőrzési időszakot: Időtartam a portál hibanaplóinak blobtárolóban való megőrzéséhez. 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.

     Feljegyzés

     A felhasználói felület jelenleg csak az alapértelmezett 30 napos megőrzési időszakot jeleníti meg. A megőrzési időszak módosításai nem jelennek meg a felhasználói felületen.

   • A Azure Blob Storage szolgáltatás kapcsolati sztringje: A Azure Blob Storage szolgáltatás URL-címe a webhely hibanaplóinak tárolásához. 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.

A diagnosztikai naplózás konfigurálása után létrejön egy új telemetriai naplók blobtároló a Azure tárfiókban, és a naplók a tárolóban tárolt blobfájlokba lesznek írva. 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ási konfiguráció 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. Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .

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:

   • Frissíteni szeretné a Azure Blob Storage szolgáltatás kapcsolati sztringjét?: Lehetővé teszi annak megadását, hogy frissítse-e a Azure Blob Storage szolgáltatás kapcsolati sztringjét. Ez a beállítás alapértelmezés szerint nincs bejelölve.

   • Megőrzési időszak kiválasztása: A webhely hibanaplóinak blobtárolóban való megőrzésének időtartama. 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.

   • A Azure Blob Storage szolgáltatás kapcsolati sztringje: A Azure Blob Storage szolgáltatás URL-címe a webhely hibanaplóinak tárolásához. 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. Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .

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 a feladatot úgy hajthatja végre, hogy webhelyét úgy konfigurálja, hogy egyéni bővítményhibákat jelenítsen meg a weboldaláról Dataverse .

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. Az egyéni bővítményhibák általános hiba helyett jelennek meg a képernyőn. A hiba csak a beépülő modul hibájának üzenet részét jeleníti meg, és nem a teljes veremkövetést.

Az alábbiakban bemutatjuk azokat a képernyőket, ahol egyéni bővítményhibák jelennek meg:

• 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 a rendszer alapértelmezés szerint hamisként kezeli, és a beépülő modul hibái nem jelennek meg.

Kiszolgálóoldali hibák megtekintése a DevTools bővítményben

A kiszolgálóoldali hibaüzeneteket és a lehetséges megoldásokat a Power Pages DevTools bővítmény használatával tekintheti meg. A kiszolgálóoldali kód hibakeresését egyéni üzenetek naplózásával is elvégezheti. További információ: DevTools bővítmény: Power Pages egyéni üzenetek naplózása folyadékkal.