Visa felloggar för portalen

Anteckning

Från och med den 12 oktober 2022 byter Power Apps-portaler namn till Power Pages. Mer information: Microsoft Power Pages är nu allmänt tillgänglig (blogg)
Vi kommer snart migrera och sammanfoga dokumentationen för Power Apps-portaler med Power Pages-dokumentationen.

Portaladministratörer och utvecklare använder Power Apps-portaler för att skapa webbplatser för sina kunder. Utvecklare felsöker problem när du arbetar med portalen. För att felsöka kan du komma åt detaljerade felloggar för eventuella problem på portalen. Det finns flera sätt att få felloggar för din portaler.

Anteckning

Power Apps portalfelloggar används också för Power Pages. Mer information: Vad är Power Pages

Dricks

Om du vill veta mer om de roller som krävs för att utföra uppgifter i den här artikeln läser du Administratörsroller som krävs för administrativa uppgifter i portalen.

Anpassat fel

Om ett serverundantag uppstår i din portal visas ett anpassat meddelande med ett användarvänligt felmeddelande som standard. Om du vill konfigurera felmeddelandet, se visa ett anpassat felmeddelande.

Det är emellertid bättre att se ASP.NET detaljerade felsida, även kallad gul skärm (YSOD), för felsökning. Den detaljerad felsidan hjälper dig att få den fullständiga högen med serverfel.

![Yellow Screen of Death.](../media/ysod.png ""Yellow Screen of Death"")

Om du vill använda YSOD måste du inaktivera anpassade fel på portalen.

Anteckning

Du rekommenderas att endast inaktivera anpassade fel i utvecklingsfasen och aktivera anpassade felmeddelanden när du publicerar.

Mer information om anpassade fel: Visa en anpassad felsida

Inaktivera anpassade fel

Du kan inaktivera anpassade felmeddelanden på portaler för att visa detaljerat undantagsmeddelandet om alla serverundantag som uppstår i portalen.

  1. Öppna administratörscenter för Power Apps‑portaler.

  2. Gå till Portalåtgärder > Inaktivera anpassade fel.

    Inaktivera anpassade fel

  3. Välj Inaktivera i bekräftelsemeddelandet. När anpassade fel inaktiveras startar portalen om och blir otillgänglig. Ett meddelande visas när anpassade fel är inaktiverat.

Aktivera anpassade fel

Du kan aktivera anpassade felmeddelanden på portaler för att visa en professionella sida i stället för YSOD. Den här sidan innehåller beskrivande information om eventuella undantag som uppstår i programmet.

  1. Öppna administratörscenter för Power Apps‑portaler.

  2. Gå till Portalåtgärder > Aktivera anpassade fel.

    Aktivera anpassade fel

  3. Välj Aktivera i bekräftelsemeddelandet. När anpassade fel aktiveras startar portalen om och blir otillgänglig. Ett meddelande visas när anpassade fel är aktiverade.

Anteckning

  • Om du ändrar instansen som portalen är ansluten till, anges inställningen av anpassade fel till aktiverad. Du måste inaktivera anpassade fel igen om det behövs.
  • Du får inte aktivera eller inaktivera anpassade fel när instansen som portalen är kopplad till ändras, annars visas ett felmeddelande.

Visa ett anpassat felmeddelande

Du kan konfigurera portalen om du vill visa ett professionellt anpassat fel i stället för ett allmänt fel.

Definiera ett anpassat fel genom att använda innehållskodavsnittet Portal Generic Error. Innehållet som har definierats i den här kodavsnittet visas på felsidan. Det här innehållskodavsnittet medföljer inte och måste du skapa det. Innehållskodavsnittet Typ kan vara Text eller HTML. Om du vill skapa eller redigera innehållskodavsnitt, se Anpassa innehåll med hjälp av innehållskodavsnitt.

Anteckning

Om flytande kod skrivs i innehållskodavsnittet kommer de hoppas över och inte återges.

När du aktiverar anpassade fel visas ett meddelande i följande struktur på felsidan:

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

Nedan följer ett exempel på ett anpassat felmeddelande med hjälp av ett innehållskodavsnitt av typen HTML:

Det här är ett anpassat felmeddelande, skicka in ett supportärende med skärmbild av felet genom att klicka här

Anpassat felmeddelande.

Anteckning

Om portalen inte kan hämta ett innehållskodavsnitt eftersom det inte går att ansluta till Microsoft Dataverse eller om innehållskodavsnittet inte finns i Dataverse, visas ett felmeddelande.

Åtkomst till portalens felloggar

När du har utvecklat och publicerat portalen behöver du fortfarande komma åt portalloggarna om du vill felsöka problem som rapporteras av kunder. För att få åtkomst till loggarna kan du konfigurera portalen om du vill skicka alla programfel till ett Azure Blob Storage-konto som ägs av dig. Genom att gå till portalens felloggar, kan du besvara kundfrågor effektivt eftersom det finns information om problemet. Om du vill skicka portalens felloggar till din Azure Blob-lagring måste du aktivera diagnostikloggning från administrationscentralen för Power Apps-portal.

Anteckning

Om du ändrar Dataverse-instansen som portalen är ansluten till, kommer diagnostikloggning att inaktiveras. Du måste aktivera diagnostikloggning igen.

Aktivera diagnostikloggning

  1. Öppna administratörscenter för Power Apps‑portaler.

  2. Gå till Portalåtgärder > Aktivera diagnostikloggning.

    Aktivera diagnostikloggning.

  3. I fönstret Aktivera diagnostikloggning anger du följande värden:

    • Anslutningssträng för Azure Blob Storage-tjänsten: URL för Azure Blob Storage-tjänsten för att lagra portalens felloggar. Den maximala längden på URL är 2048 tecken. Om URL-adressen är längre än 2048 tecken, visas ett felmeddelande. Mer information om anslutningssträngen: Konfigurera Azure Storage anslutningssträngar
    • Välj kvarhållningsperiod: varaktighet för att behålla portalens felloggar i blob storage. Felloggarna tas bort efter valda varaktighet. Välj något av följande värden:
      • En dag
      • Sju dagar
      • 30 dagar
      • 60 dagar
      • 90 dagar
      • 180 dagar
      • Alltid

    Som standard är kvarhållningsperioden 30 dagar.

    Fönstret Aktivera diagnostikloggning.

  4. Välj Konfigurera.

När diagnostikloggning har konfigurerats kan en ny telemetriloggar Blob-behållare skapas i ditt Azure Storage-konto och loggarna skrivs i de blob-filer som lagras i behållaren. I följande skärmbild visas blobbehållaren telemetriloggar i Azure Storage Explorer:

Lagringskonto för Azure-blogg.

När diagnostikloggning är aktiverad, blir följande åtgärd tillgänglig:

  • Uppdatera konfiguration av diagnostikloggning: gör att du kan uppdatera eller ta bort konfigurationen av diagnostikloggning för portalen.
  • Inaktivera diagnostikloggning: gör att du kan inaktivera konfigurationen av diagnostikloggning för portalen.

Uppdatera diagnostikloggning

  1. Öppna administratörscenter för Power Apps‑portaler.

  2. Gå till Portalåtgärder > Uppdatera konfigurationen av diagnostikloggning.

    Uppdatera konfiguration för diagnostikloggning.

  3. I fönstret Uppdatera konfigurationen av diagnostikloggning anger du följande värden:

    • Vill du uppdatera anslutningssträngen till Azure Blob Storage-tjänsten?: Låter dig ange om du vill uppdatera anslutningssträngen för tjänsten Azure Blob Storage. Det är markerat som standard.
    • Anslutningssträng för Azure Blob Storage-tjänsten: URL för Azure Blob Storage-tjänsten för att lagra portalens felloggar. Den maximala längden på URL kan vara 2048 tecken. Om URL-adressen är längre än 2048 tecken, visas ett felmeddelande. Det här fältet visas endast om kryssrutan Vill du uppdatera anslutningssträngen för Azure Blob Storage-tjänsten? är markerad. Mer information om anslutningssträngen: Konfigurera Azure Storage anslutningssträngar
    • Välj kvarhållningsperiod: varaktighet för att behålla portalens felloggar i blob storage. Felloggarna tas bort efter valda varaktighet. Välj något av följande värden:
      • En dag
      • Sju dagar
      • 30 dagar
      • 60 dagar
      • 90 dagar
      • 180 dagar
      • Alltid

    Som standard är kvarhållningsperioden 30 dagar.

    Fönstret Uppdatera konfiguration för diagnostikloggning.

  4. Välj Uppdatera.

Inaktivera diagnostikloggning

  1. Öppna administratörscenter för Power Apps‑portaler.

  2. Gå till Portalåtgärder > Inaktivera diagnostikloggning.

    Inaktivera diagnostikloggning.

  3. Välj Inaktivera i bekräftelsemeddelandet.

Visa fel i plugin-program

Ett annat scenario som ofta uppstår i samband med utvecklingen av portaler är ett fel som genereras av anpassade plugin-program och anpassad logik skriven i din Dataverse-miljö. Dessa fel kan vanligtvis nås genom inaktivera anpassade fel eller aktivera diagnostikloggning. I vissa fall kan går det snabbare att visa felen direkt på portalen för att hitta orsaken till problemet snabbare. Du kan åstadkomma detta genom att konfigurera din portal för att visa anpassade plugin-fel från Dataverse på portalens skärm.

Om du vill visa anpassade plugin-fel, skapa webbplatsinställningen Site/EnableCustomPluginErroroch ange värdet SANT. De anpassade plugin-felen visas på skärmen i stället för ett allmänt fel. Felmeddelandet visar endast meddelandedelen av plugin-felet och inte hela stackspårningen.

Nedan följer de skärmar där anpassade plugin-fel visas:

  • List
    • Hämtning av poster
  • Grundläggande formulär
    • Retrieve
    • Skapa/uppdatera, etc.
  • Flerstegsformulär
    • Retrieve
    • Skapa/uppdatera, etc.

Om webbplatsinställningen inte finns kommer den att behandlas som FALSK som standard och plugin-program kommer inte att visas.

Se även

Power App-portalens underhållning och felsökning

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).