Delen via

Logboeken van Gebruikersgegevensfuncties weergeven

Logboeken helpen u te begrijpen hoe uw gebruikersgegevensfuncties problemen uitvoeren en diagnosticeren wanneer functies zich niet gedragen zoals verwacht. U kunt logboeken op twee manieren weergeven:

  • Tijdens het testen : realtime logboeken weergeven in het testvenster bij het testen van functies in de ontwikkelmodus
  • Na aanroep : historische logboeken weergeven voor gepubliceerde functies die zijn aangeroepen

In dit artikel wordt uitgelegd hoe u logboeken kunt weergeven en gebruiken om de uitvoering van de functie te bewaken en problemen op te lossen.

Logboeken weergeven tijdens het testen

Wanneer u functies test, kunt u logboeken in realtime zien terwijl uw functie wordt uitgevoerd:

  • Testpaneel in de ontwikkelmodus - Logboeken weergeven bij het testen van niet-gepubliceerde of gepubliceerde functies
  • Uitvoeren-paneel in Alleen uitvoeren-modus - Logboeken bekijken tijdens het uitvoeren van gepubliceerde functies

In beide deelvensters wordt de logboekuitvoer onmiddellijk weergegeven, zodat u uitvoeringsdetails en foutopsporingsproblemen kunt zien wanneer ze optreden. Zie Functies voor gebruikersgegevens testen voor meer informatie over testfuncties.

Historische logboeken voor aangeroepen functies weergeven

Nadat uw gepubliceerde functies zijn aangeroepen, kunt u historische logboeken bekijken om eerdere uitvoeringen te analyseren.

Voor toegang tot historische logboeken:

  1. Schakel over naar de modus Alleen uitvoeren met behulp van de moduswisselaar.

  2. Beweeg de muisaanwijzer over de functienaam in de lijst met functies.

  3. Selecteer het pictogram met weglatingstekens (...) en selecteer vervolgens Historisch logboek weergeven.

    Schermopname van het weergeven van historische logboeken voor een functie.

Inzicht in de weergave van historische logboeken

In de weergave historische logboeken ziet u recente aanroepen voor de geselecteerde functie. U kunt maximaal 50 vermeldingen zien en logboeken worden 30 dagen bewaard. Selecteer de datumkoppeling in de kolom Date (UTC) om gedetailleerde logboeken voor een specifieke aanroep weer te geven.

Schermopname die laat zien hoe u alle aanroepen voor de functies kunt weergeven die op datum zijn gerangschikt.

Het deelvenster Alle historische logboeken bevat de volgende informatie per aanroep:

  • Datum (UTC). Het tijdstempel met het begin van de aanroep van de functie. Selecteer de koppeling om alle logboeken voor die aanroep te controleren. Hierin worden de details van de aanroep weergegeven met alle berichten die zijn geregistreerd door de gebruiker of service.
  • Status. Geeft aan of de aanroep is geslaagd of mislukt.
  • Duration(ms). De duur van de uitvoering van de functie in milliseconden.
  • Aanroep-ID. De ID van die specifieke functie-aanroep. De aanroep-id wordt geretourneerd als onderdeel van een HTTP-header. Als er problemen zijn, kunnen gebruikers verwijzen naar deze aanroep-id in een ondersteuningsaanvraag om meer informatie over de aanroep op te halen.

Gedetailleerde logboeken voor een specifieke aanroep weergeven

Nadat u de weergave historische logboeken hebt geopend (zoals beschreven in de vorige sectie), kunt u inzoomen op afzonderlijke aanroepen. Wanneer u een tijdstempelkoppeling selecteert in de kolom Datum (UTC), wordt het deelvenster Aanroepdetails geopend om alle logboeken voor die aanroep weer te geven. U kunt het volgende weergeven:

  • Alle logboeken die zijn toegevoegd aan uw functiecode met behulp van de logging module
  • Door het systeem gegenereerde logboeken over functie-uitvoering
  • Eventuele fouten of uitzonderingen die zijn opgetreden

Elke logboekvermelding bevat het tijdstempel, logboekbericht en logboekniveau (informatie, waarschuwing, fout, kritiek).

Schermopname die laat zien hoe u gedetailleerde logboeken voor een bepaalde functie kunt bekijken.

Logboekregistratie toevoegen aan uw functies

U kunt aangepaste logboekinstructies toevoegen aan uw functies met behulp van de standaardmodule logging van Python. Logboeken helpen u bij het bijhouden van functiegedrag, het bewaken van gegevensverwerking en het vaststellen van problemen.

De logboekregistratiemodule importeren

Importeer eerst de logging module in uw functiecode:

import logging

Opmerking

De logging module wordt standaard geïmporteerd wanneer u een nieuw User Data Functions-item maakt in de Fabric-portal of met behulp van de VS Code-extensie.

De juiste logboekniveaus gebruiken

Python biedt verschillende logboekniveaus voor verschillende situaties. Gebruik het juiste niveau om uw logboeken zinvoller te maken:

# 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')

Aanbevolen procedures voor logboekregistratie

Volg deze procedures om uw logboeken effectiever te maken:

  • Beschrijvende informatie vastleggen: relevante details opnemen, zoals id's, aantallen of parameterwaarden waarmee problemen kunnen worden vastgesteld
  • Gebruik de juiste logboekniveaus : niet alles registreren als INFO of ERROR; het juiste niveau gebruiken voor de situatie
  • Aanmelden bij belangrijke punten - Logboeken toevoegen aan het begin van functies, vóór en na externe aanroepen en bij het verwerken van gegevens
  • Logboekregistratie van gevoelige gegevens voorkomen : geen wachtwoorden, tokens, persoonlijke gegevens of andere gevoelige gegevens registreren
  • Houd berichten beknopt : schrijf duidelijke, korte logboekberichten die gemakkelijk te scannen zijn
  • Houd rekening met het volume : overmatige logboekregistratie kan van invloed zijn op de prestaties en de dagelijkse opnamelimiet bereiken

Zie het Python-programmeermodel voor meer informatie over het schrijven van functiecode.

Beperkingen en logboekretentie

Houd rekening met de volgende beperkingen bij het werken met logboeken:

  • Logboekretentie : historische aanroeplogboeken worden standaard 30 dagen bewaard
  • Zichtbare vermeldingen : de weergave historische logboeken bevat maximaal 50 vermeldingen per functie
  • Beschikbaarheid van logboeken: het kan enkele minuten duren voordat aanroeplogboeken worden weergegeven; vernieuw de pagina als u geen recente logboeken ziet
  • Dagelijkse opnamelimiet - 250 MB per dag; de limiet wordt dagelijks opnieuw ingesteld
  • Steekproeven - Loggegevens kunnen worden bemonsterd om het volume te verminderen, terwijl een statistisch correcte analyse behouden blijft
  • Ondersteunde logboektypen : informatie, fout, waarschuwing en tracering

Zie Servicedetails en -beperkingen voor volledige informatie over servicelimieten.

Verwante inhoud

  • Last updated on