Ogled dnevnikov napak portala

  • Članek
  • 6 min za branje

Kot skrbnik ali razvijalec portala lahko s portali Power Apps ustvarite spletno mesto za svoje stranke. Običajno opravilo razvijalcev pri razvoju portala je odpravljanje napak. Pri odpravljanju napak si lahko pomagate s podrobnimi dnevniki napak, ki zajemajo vse težave na portalu. Dnevnike napak za portale lahko pridobite na več načinov.

Nasvet

Če želite izvedeti več o vlogah, potrebnih za izvedbo opravil v tem članku, preberite Vloge skrbnika, potrebne za skrbniška opravila portala.

Sporočilo o napaki po meri

Če na portalu pride do strežniške izjeme, se privzeto prikaže stran o napaki po meri, ki vsebuje uporabniku prijazno sporočilo o napaki. Za konfiguracijo sporočila o napaki glejte Prikaz sporočila o napaki po meri.

Vendar je bolje videti stran s podrobnimi napakami ASP.NET, znano tudi kot Rumeni zaslon smrti (YSOD), za namene odpravljanja napak. Ta podrobna stran o napaki vsebuje celoten sklad strežniških napak.

Rumeni zaslon o napaki.

Če želite omogočiti rumeni zaslon o napaki, morate na portalu onemogočiti sporočila o napaki po meri.

Opomba

Priporočljivo je, da sporočila o napaki po meri onesposobite le v fazi razvoja, ko je portal objavljen, pa sporočila o napaki po meri omogočite.

Če želite več informacij o sporočilih o napaki po meri: Prikaz sporočila o napaki po meri

Onemogočanje sporočil o napaki po meri

Če na portalih onemogočite sporočila o napaki po meri, bo na voljo prikaz podrobnih sporočil o izjemi, če na portalu pride do strežniške izjeme.

  1. Odprto Power Apps skrbniško središče portalov.

  2. Odprite Dejanja za portal > Onemogoči napake po meri.

    Onemogočanje napak po meri.

  3. V potrditvenem sporočilu izberite Onemogoči. Ko so sporočila o napaki po meri onemogočena, se portal znova zažene in ni na voljo. Ko so sporočila o napaki po meri onemogočena, se prikaže sporočilo.

Omogočanje sporočil o napaki po meri

Omogočite lahko sporočila o napaki po meri, s katerimi se v primeru napake namesto rumenega zaslona prikaže sporočilo profesionalnega videza. Ta stran vsebuje pomembne informacije, če v aplikaciji pride do kakršne koli izjeme.

  1. Odprto Power Apps skrbniško središče portalov.

  2. Odprite Dejanja za portal > Omogoči napake po meri.

    Omogočanje napak po meri.

  3. V potrditvenem sporočilu izberite Omogoči. Ko so sporočila o napaki po meri omogočena, se portal znova zažene in ni na voljo. Ko so sporočila o napaki po meri omogočena, se prikaže sporočilo.

Opomba

  • Če spremenite primerek, s katerim je povezan vaš portal, se nastavitev sporočil o napaki po meri nastavi kot omogočena. Po potrebi znova onemogočite sporočila o napaki po meri.
  • V postopku spremembe primerka, s katerim je povezan vaš portal, ne omogočajte ali onemogočajte sporočil o napaki po meri, sicer se prikaže sporočilo o napaki.

Prikaz sporočila o napaki po meri

Portal lahko konfigurirate tako, da namesto generičnega sporočila o napaki prikaže sporočilo po meri profesionalnega videza.

Za definicijo sporočila o napaki po meri uporabite izrezek vsebine Portal Generic Error. Vsebina, opredeljena v tem izrezku, se prikaže strani s sporočilom o napaki. Ta izrezek vsebine ni privzeto na voljo, ampak ga morate ustvariti. Vrsta izrezka vsebine je lahko Besedilo ali HTML. Če želite ustvariti ali urediti izrezek, glejte Prilagajanje vsebine z uporabo izrezkov vsebine.

Opomba

Če je v izrezku vsebine zapisana koda »Liquid«, bo preskočen in ne bo upodobljen.

Ko omogočite sporočila o napaki po meri, se sporočilo na strani z napako prikaže v tej strukturi:

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

Spodaj je primer sporočila o napaki po meri, ki uporablja izrezek vsebine vrste HTML:

To je sporočilo o napaki po meri, pošljite zahtevo za podporo s posnetkom zaslona napake tako, da kliknete tukaj

Sporočilo o napaki po meri.

Opomba

Če portal ne more pridobiti vsebine izrezek, ker se ne more povezati z Microsoft Dataverse ali če izrezek ni na voljo v Dataverse, se prikaže sporočilo o napaki.

Dostop do dnevnikov napak portala

Ko portal razvijete in ga objavite, še vedno potrebujete dostop do dnevnikov napak portala, da lahko odpravljate napake, o katerih poročajo stranke. Za dostop do dnevnikov lahko portal konfigurirate tako, da pošilja podatke o vseh napakah aplikacij v račun za shrambo zbirke dvojiških podatkov Azure v vaši lasti. Z dostopom do dnevnikov napak portala se lahko hitreje odzovete na poizvedbe strank, saj so vam na voljo vse podrobnosti o težavi. Če želite pridobiti dnevnike napak portala v shrambo Azure Blob, morate omogočiti diagnostično beleženje iz skrbniškega centra Power Apps portalov.

Opomba

Če spremenite primerek Dataverse, s katerim je povezan vaš portal, je diagnostično beleženje onemogočeno. V tem primeru morate diagnostično pisanje dnevnika znova omogočiti.

Omogoči diagnostično pisanje dnevnika

  1. Odprto Power Apps skrbniško središče portalov.

  2. Izberite Dejanja za portal > Omogoči diagnostično pisanje dnevnika.

    Omogoči diagnostično pisanje dnevnika.

  3. V okno Omogoči diagnostično pisanje dnevnika vnesite naslednje vrednosti:

    • Niz za povezavo storitve shrambe zbirke dvojiških podatkov Azure: URL storitve shrambe zbirke dvojiških podatkov Azure za shranjevanje dnevnikov napak portala. Najdaljša dovoljena dolžina URL-ja je 2048 znakov. Če je URL daljši od 2048 znakov, se prikaže sporočilo o napaki. Več informacij o nizu za povezavo: Konfiguracija nizov za povezavo s shrambo Azure
    • Izbira obdobja shranjevanja: obdobje ohranjanja dnevnikov napak portala v shrambi zbirke dvojiških podatkov. Po preteku izbranega obdobja se dnevniki napak izbrišejo. Izberete lahko eno od teh vrednosti:
      • 1 dan
      • 7 dni
      • 30 dni
      • 60 dni
      • 90 dni
      • 180 dni
      • Vedno

    Privzeto obdobje shranjevanja je 30 dni.

    Okno za omogočanje diagnostičnega pisanja dnevnika.

  4. Kliknite Konfiguriraj.

Ko je diagnostično pisanje dnevnika konfigurirano, se ustvari vsebnik za zbirko dvojiških podatkov za telemetrične dnevnike v vašem računu za shrambo Azure in dnevniki se zapisujejo v datoteke zbirke dvojiških podatkov, shranjene v vsebniku. Naslednji posnetek zaslona prikazuje vsebnik za zbirko dvojiških podatkov za telemetrične dnevnike v raziskovalcu prostora za shranjevanje Azure:

Račun za shrambo spletnega dnevnika Azure.

Ko je diagnostično pisanje dnevnika uspešno omogočeno, postane na voljo naslednje dejanje:

  • Posodobi konfiguracijo diagnostičnega pisanja dnevnika: omogoča vam, da posodobite ali odstraniti konfiguracijo diagnostičnega pisanja dnevnikov za portal.
  • Onemogoči diagnostično pisanje dnevnika: omogoča vam, da onemogočite konfiguracijo diagnostičnega pisanja dnevnikov za portal.

Posodobitev diagnostičnega pisanja dnevnika

  1. Odprto Power Apps skrbniško središče portalov.

  2. Izberite Dejanja za portal > Posodobi konfiguracijo diagnostičnega pisanja dnevnika.

    Posodobitev konfiguracije diagnostičnega pisanja dnevnika.

  3. V okno za posodobitev konfiguracije diagnostičnega pisanja dnevnika vnesite naslednje vrednosti:

    • Ali želite posodobiti niz za povezavo storitve shrambe zbirke dvojiških podatkov Azure?: omogoča, da določite, ali želite posodobiti niz za povezavo storitve shrambe zbirke dvojiških podatkov Azure. Privzeto je to izbrano.
    • Niz za povezavo storitve shrambe zbirke dvojiških podatkov Azure: URL storitve shrambe zbirke dvojiških podatkov Azure za shranjevanje dnevnikov napak portala. Največja dolžina URL-ja je 2048 znakov. Če je URL daljši od 2048 znakov, se prikaže sporočilo o napaki. To polje je prikazano le, če je izbrana možnost Ali želite posodobiti niz za povezavo storitve shrambe zbirke dvojiških podatkov Azure?. Več informacij o nizu za povezavo: Konfiguracija nizov za povezavo s shrambo Azure
    • Izbira obdobja shranjevanja: obdobje ohranjanja dnevnikov napak portala v shrambi zbirke dvojiških podatkov. Po preteku izbranega obdobja se dnevniki napak izbrišejo. Izberete lahko eno od teh vrednosti:
      • 1 dan
      • 7 dni
      • 30 dni
      • 60 dni
      • 90 dni
      • 180 dni
      • Vedno

    Privzeto obdobje shranjevanja je 30 dni.

    Okno za posodobitev konfiguracije diagnostičnega pisanja dnevnika.

  4. Kliknite Posodobi.

Onemogoči diagnostično pisanje dnevnika

  1. Odprto Power Apps skrbniško središče portalov.

  2. Izberite Dejanja za portal > Onemogoči diagnostično pisanje dnevnika.

    Onemogoči diagnostično pisanje dnevnika.

  3. V potrditvenem sporočilu kliknite Onemogoči.

Prikaz napake vtičnika

Drug scenarij, ki se pogosto pojavi pri razvoju portala, je napaka, ki jo ustvarijo vtičniki po meri in poslovna logika, napisana v vašem okolju Dataverse. Do teh sporočil o napakah je običajno mogoče dostopati tako, da onemogočite sporočila o napakah po meri ali omogočite diagnostično pisanje dnevnika. Vendar je v nekaterih primerih hitreje, če ta sporočila o napakah prikažete neposredno na portalu za hitrejšo diagnostiko težave. Če želite to narediti, lahko konfigurirate svoj portal za prikaz napak vtičnikov po meri iz Dataverse na zaslonu vašega portala.

Če želite prikazati sporočila o napakah vtičnika po meri, ustvarite nastavitev mesta Site/EnableCustomPluginError in za vrednost določite »true«. Sporočila o napakah vtičnika po meri bodo na zaslonu prikazana namesto generičnega sporočila o napaki. V sporočilu o napaki bo prikazan samo del s sporočilom napake vtičnika in ne celotna sled sklada.

Sporočila o napakah vtičnika po meri bodo prikazana na naslednjih zaslonih:

  • Seznam
    • Pridobivanje zapisov
  • Osnovni obrazec
    • Pridobi
    • Ustvarjanje/posodabljanje itd.
  • Napredni obrazci
    • Pridobi
    • Ustvarjanje/posodabljanje itd.

Če nastavitve mesta ni, se vrednost privzeto obravnava kot »false« in sporočila o napakah vtičnika niso prikazana.

Glejte tudi

Microsoft Learn: Vzdrževanje in odpravljanje težav portala Power App