Dela via

Visa loggar för användardatafunktioner

Loggar hjälper dig att förstå hur dina användardatafunktioner kör och diagnostiserar problem när funktioner inte fungerar som förväntat. Du kan visa loggar på två sätt:

  • Under testning – Visa realtidsloggar i testpanelen när du testar funktioner i utvecklingsläge
  • Efter anrop – Visa historiska loggar för publicerade funktioner som har anropats

Den här artikeln beskriver hur du visar och använder loggar för att övervaka funktionskörning och felsöka problem.

Visa loggar under testning

När du testar funktioner kan du se loggar i realtid när funktionen körs:

  • Testpanel i utvecklingsläge – Visa loggar när du testar opublicerade eller publicerade funktioner
  • Kör panelen i läget Kör endast – Visa loggar när du kör publicerade funktioner

Båda panelerna visar loggutdata omedelbart, så att du kan se körningsinformation och felsöka problem när de inträffar. Mer information om testningsfunktioner finns i Testa dina användardatafunktioner.

Visa historiska loggar för anropade funktioner

När dina publicerade funktioner har anropats kan du visa historiska loggar för att analysera tidigare körningar.

Så här kommer du åt historiska loggar:

  1. Växla till Läget Kör endast med hjälp av lägesväxlaren.

  2. Hovra över funktionsnamnet i funktionslistan.

  3. Välj ellipsikonen (...) och välj sedan Visa historisk logg.

    Skärmbild som visar hur du granskar historiska loggar i en funktion.

Förstå den historiska loggens vy

Vyn historiska loggar visar de senaste anropen för den valda funktionen. Du kan se upp till 50 poster och loggar behålls i 30 dagar. Välj datumlänken i kolumnen Datum (UTC) för att visa detaljerade loggar för ett specifikt anrop.

Skärmbild som visar hur du visar alla anrop för funktionerna ordnade efter datum.

Fönstret Alla historiska loggar innehåller följande information per anrop:

  • Datum (UTC) Tidsstämpeln som visar början av funktionsanropet. Välj länken för att granska alla loggar för det anropet. Den visar information om anropet med alla meddelanden som loggas av användaren eller tjänsten.
  • Status. Anger om anropet lyckades eller misslyckades.
  • Varaktighet(ms). Varaktigheten för funktionskörningen i millisekunder.
  • Återkallelse-ID. ID:t för det specifika funktionsanropet. Anrops-ID returneras som en del av ett HTTP-huvud. Om det finns några problem kan användarna referera till det här anrops-ID:t i en supportbegäran för att hämta mer information om anropet.

Visa detaljerade loggar för ett specifikt anrop

När du har öppnat vyn historiska loggar (enligt beskrivningen i föregående avsnitt) kan du granska enskilda anrop mer detaljerat. När du väljer en tidsstämpellänk i kolumnen Datum (UTC) öppnas fönstret Anropsinformation för att visa alla loggar för anropet. Du kan visa

  • Alla loggar som har lagts till i funktionskoden med hjälp av modulen logging
  • Systemgenererade loggar om utförande av funktion
  • Eventuella fel eller undantag som har inträffat

Varje loggpost innehåller tidsstämpeln, loggmeddelandet och loggnivån (Information, Varning, Fel, Kritisk).

Skärmbild som visar åtkomst till detaljerade loggar för ett visst funktionsanrop.

Lägga till loggning i dina funktioner

Du kan lägga till anpassade logginstruktioner i dina funktioner med hjälp av Pythons standardmodul logging . Loggar hjälper dig att spåra funktionsbeteende, övervaka databehandling och diagnostisera problem.

Importera loggningsmodulen

Importera först modulen logging i funktionskoden:

import logging

Anmärkning

Modulen logging importeras som standard när du skapar ett nytt Användardatafunktioner-objekt i Infrastrukturportalen eller med hjälp av VS Code-tillägget.

Använda lämpliga loggnivåer

Python tillhandahåller olika loggnivåer för olika situationer. Använd lämplig nivå för att göra loggarna mer meningsfulla:

# INFO - Track normal function execution and key steps
logging.info('Processing started for customer ID: 12345')
logging.info('Successfully retrieved 150 records from database')

# WARNING - Log potentially problematic situations that don't prevent execution
logging.warning('API response time exceeded 2 seconds')
logging.warning('Using cached data because fresh data is unavailable')

# ERROR - Log errors that affect functionality but don't crash the function
logging.error('Failed to connect to external API: Connection timeout')
logging.error('Invalid data format in row 42')

# CRITICAL - Log severe errors that may cause function failure
logging.critical('Database connection lost')
logging.critical('Required configuration parameter missing')

Metodtips för loggning

Följ dessa metoder för att göra loggarna mer effektiva:

  • Log meningsfull information – Inkludera relevant information som ID,antal eller parametervärden som hjälper dig att diagnostisera problem
  • Använd lämpliga loggnivåer – Logga inte allt som INFO eller ERROR; använda rätt nivå för situationen
  • Logga vid viktiga punkter – Lägg till loggar i början av funktioner, före och efter externa anrop och vid bearbetning av data
  • Undvik att logga känsliga data – Logga inte lösenord, token, personlig information eller andra känsliga data
  • Håll meddelandena koncisa – Skriv tydliga, korta loggmeddelanden som är enkla att skanna
  • Tänk på volymen – Överdriven loggning kan påverka prestanda och nå den dagliga inmatningsgränsen

Mer information om hur du skriver funktionskod finns i Python-programmeringsmodellen.

Begränsningar och loggkvarhållning

Tänk på följande begränsningar när du arbetar med loggar:

  • Loggkvarhållning – Historiska anropsloggar behålls som standard i 30 dagar
  • Synliga poster – Den historiska loggvyn visar upp till 50 poster per funktion
  • Loggtillgänglighet – Det kan ta några minuter att visa anropsloggar. uppdatera sidan om du inte ser de senaste loggarna
  • Daglig inmatningsgräns – 250 MB per dag; gränsen återställs dagligen
  • Sampling – Loggar kan samplas för att minska volymen samtidigt som statistiskt korrekta analyser bevaras
  • Loggtyper som stöds – information, fel, varning och spårning

Fullständig information om tjänstbegränsningar finns i Tjänstinformation och begränsningar.

Relaterat innehåll

  • Last updated on