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.
Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .
Válassza ki a webhelyet.
Válassza a Webhelyműveletek menü Egyéni hibák letiltása parancsát.
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.
Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .
Válassza ki a webhelyet.
Válassza a Webhelyműveletek menü Egyéni hibák engedélyezése parancsát.
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.
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á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
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
Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .
Válassza ki a webhelyet.
Válassza a Webhelyműveletek menü Diagnosztikai naplók engedélyezése parancsát.
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
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
Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .
Válassza ki a webhelyet.
Válassza a Webhelyműveletek menü Diagnosztikai naplózás konfigurációjának frissítése parancsát.
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
Az Erőforrások szakaszban válassza a webhelyek lehetőséget Power Pages .
Válassza ki a webhelyet.
Válassza a Webhelyműveletek menü Diagnosztikai naplók letiltása parancsát.
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.