Toepassingslogboekbestanden ophalen

  • 6 minuten

Logboekbestanden vormen een geweldige informatiebron voor webontwikkelaars, maar alleen als u weet u de vastgelegde informatie kunt vinden en gebruiken. Hier bekijkt u de methoden die u kunt gebruiken om vastgelegde gegevens op te halen voor offlineanalyse.

Opslaglocaties voor logboekbestanden

De Azure-infrastructuur voor het uitvoeren van Azure Web Apps in Windows is niet hetzelfde als voor Linux-apps en logboekbestanden worden niet op dezelfde locaties opgeslagen.

Logboekbestanden van Windows-apps

Voor Windows-apps worden logboekbestanden van het bestandssysteem opgeslagen in een virtueel station dat is gekoppeld aan uw web-app. Het adres van dit station is D:\Home. Hier vindt u de map LogFiles met daarin een of meer submappen:

  • Toepassing: bevat berichten die door de toepassing zijn gegenereerd, als logboekregistratie van bestandssysteemtoepassingen is ingeschakeld.
  • DetailedErrors : bevat gedetailleerde webserverfoutlogboeken, als gedetailleerde foutberichten zijn ingeschakeld.
  • http: bevat logboeken op IIS-niveau, als Webserverlogboeken is ingeschakeld.
  • W3SVC-nummer<>: bevat details van alle mislukte HTTP-aanvragen, als tracering van mislukte aanvragen is ingeschakeld.

Waar opslag naar een Blob-container is ingeschakeld, worden logboeken opgeslagen in jaar-, maand-, datum- en uurmappen, bijvoorbeeld:

2019
  01
   10
    08 - log entries for the period 08:00:00 to 08:59:59 on January 10th 2019
    09 - log entries for the period 09:00:00 to 09:59:59 on January 10th 2019

Binnen de uurmap bevinden zich een of meer CSV-bestanden met berichten die binnen die periode van 60 minuten zijn opgeslagen.

Logboekbestanden van Linux-apps

Voor Linux Web Apps ondersteunen de Azure-hulpprogramma's momenteel minder logboekregistratieopties dan voor Windows-apps. Omleidingen naar STDERR en STDOUT worden beheerd via de onderliggende Docker-container waarmee de app wordt uitgevoerd. Deze berichten worden in de Docker-logboekbestanden opgeslagen. Als u berichten wilt zien die zijn geregistreerd door onderliggende processen, zoals Apache, moet u een SSH-verbinding met de Docker-container openen.

Methoden om logboekbestanden op te halen

Hoe u logboekbestanden ophaalt, is afhankelijk van het type logboekbestand en van uw voorkeursomgeving. Voor bestandssysteemlogboeken kunt u de Azure CLI of de Kudu-console gebruiken. Kudu is de engine achter veel functies in Azure-app Service met betrekking tot implementatie op basis van broncodebeheer.

Azure-CLI

Als u logboekbestanden van het bestandssysteem wilt downloaden met behulp van de Azure CLI, kopieert u eerst de logboekbestanden van het bestandssysteem van de app naar Cloud Shell-opslag en voert u vervolgens de volgende opdracht uit.

az webapp log download --log-file \<_filename_\>.zip  --resource-group \<_resource group name_\> --name \<_app name_\>

Als u de zip-logboekbestanden naar uw lokale computer wilt downloaden, gebruikt u het hulpprogramma voor het downloaden en uploaden van bestanden op de werkbalk van Cloud Shell. Zodra de bestanden zijn gedownload, kunnen ze worden geopend in Microsoft Excel of andere apps.

Notitie

De Azure CLI-download bevat alle app-logboekbestanden, met uitzondering van traceringen van mislukte aanvragen.

Kudu

Er is een gekoppelde SCM-servicesite (Source Control Management) die is gekoppeld aan alle Azure Web Apps. Op deze site wordt de Kudu-service en andere site-extensies uitgevoerd. Het is Kudu dat de implementatie en probleemoplossing voor Azure Web Apps beheert, inclusief opties voor het weergeven en downloaden van logboekbestanden. De specifieke functionaliteit die beschikbaar is in Kudu en hoe u logboeken downloadt, is afhankelijk van het type web-app. Voor Windows-apps kunt u naar de locatie van het logboekbestand bladeren en vervolgens de logboeken downloaden. Voor Linux-apps is er mogelijk een downloadkoppeling.

Een manier om toegang te krijgen tot de Kudu-console is door naar https://< app name.scm.azurewebsites.net> te navigeren en u vervolgens aan te melden met behulp van implementatiereferenties.

U hebt ook toegang tot Kudu vanuit Azure Portal. Selecteer Geavanceerde hulpprogramma's in het menu App Service onder Ontwikkelhulpprogramma's en selecteer vervolgens in het deelvenster Geavanceerde hulpprogramma's de optie Ga om een nieuw Kudu Services-tabblad te openen.

U kunt de logboekbestanden van Windows-apps als volgt downloaden:

  1. Selecteer Foutopsporingsconsole en selecteer vervolgens CMD.

    Screenshot of Kudu's environment page with a callout highlighting the Debug Console cmd menu option.

  2. Selecteer LogFiles in de sectie Verkenner en selecteer voor de toepassingsmap Downloaden. De logboeken worden naar uw computer gedownload als Application.zip.

    Screenshot of Kudu's user interface. It displays a file and folder listing with a highlight next to the download icon for the Application folder.

    Voor Linux-apps selecteert u de downloadkoppeling op de pagina Omgeving.

    Screenshot of Kudu's user environment page with a callout highlighting the link to download a zip file containing the current Docker logs.

Azure Storage-browser

Voor toegang tot Windows-logboeken die zijn opgeslagen in een Azure Blob Storage-container, kunt u Azure Portal gebruiken. Als u de inhoud van de container met logboekbestanden wilt weergeven en downloaden, selecteert u Opslagaccounts in het portalmenu. Selecteer uw opslagaccount en selecteer vervolgens Opslagbrowser. Open het type opslagcontainer (bijvoorbeeld Blob-containers) en selecteer de naam van de blobcontainer die het logboekbestand bevat. Open in de container de relevante map jaar, maand, datum en uur en dubbelklik vervolgens op een CSV-bestand om het naar uw computer te downloaden.

Screenshot of the Storage browser to download Windows app logs from blob containers.

Als u Microsoft Excel op uw computer hebt, wordt het logboekbestand automatisch geopend als een Excel-werkblad. Anders kunt u het bestand openen met behulp van een teksteditor, zoals Kladblok.