Logboeken en metrische gegevens analyseren met diagnostische instellingen

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

Dit artikel is van toepassing op: ✔️ Java ✔️ C#

Dit artikel is van toepassing op: ✔️ Basic/Standard ✔️ Enterprise

In dit artikel leest u hoe u diagnostische gegevens analyseert in Azure Spring Apps.

Met behulp van de diagnostische functionaliteit van Azure Spring Apps kunt u logboeken en metrische gegevens analyseren met een van de volgende services:

• Gebruik Azure Log Analytics. Er is een vertraging bij het exporteren van logboeken naar Log Analytics.
• Sla logboeken op in een opslagaccount voor controle of handmatige inspectie. U kunt de bewaartijd (in dagen) opgeven.
• Stream logboeken naar uw Event Hub voor opname door een service van derden of een aangepaste analyseoplossing.

Kies de logboekcategorie en de metrische categorie die u wilt bewaken.

Tip

Als u alleen uw logboeken wilt streamen, kunt u de Azure CLI-opdracht az spring app logs gebruiken.

Logboeken

Logboek	Beschrijving
ApplicationConsole	Consolelogboek van alle klanttoepassingen.
SystemLogs	De beschikbare LogType waarden zijn ConfigServer(alleen Basic/Standard), ServiceRegistry(alle abonnementen), ApiPortal(alleen Enterprise-abonnement), ApplicationConfigurationService(alleen Enterprise-abonnement), (alleen Enterprise-abonnement) SpringCloudGateway en SpringCloudGatewayOperator (alleen Enterprise-abonnement)
IngressLogs	Logboeken voor inkomend verkeer van alle toepassingen van de klant, hebben alleen toegang tot logboeken.
BuildLogs	Bouw logboeken van alle toepassingen van de klant voor elke buildfase.

Metrische gegevens voor

Zie de sectie Metrische gegevens van gebruikers van Metrische gegevens voor Azure Spring Apps voor een volledige lijst met metrische gegevens.

Om aan de slag te gaan, schakelt u een van deze services in om de gegevens te ontvangen. Zie Aan de slag met Log Analytics in Azure Monitor voor meer informatie over het configureren van Log Analytics.

Diagnostische instellingen configureren

1. Ga in Azure Portal naar uw Azure Spring Apps-exemplaar.

2. Selecteer de optie Diagnostische instellingen en selecteer vervolgens Diagnostische instellingen toevoegen.

3. Voer een naam in voor de instelling en kies waar u de logboeken wilt verzenden. U kunt een combinatie van de volgende drie opties selecteren:

   • Archiveren naar een opslagaccount
   • Streamen naar een Event Hub
   • Verzenden naar Log Analytics
   • Verzenden naar partneroplossing

4. Kies welke logboekcategorie en metrische categorie u wilt bewaken en geef vervolgens de bewaartijd (in dagen) op. De bewaartijd is alleen van toepassing op het opslagaccount.

5. Selecteer Opslaan.

Notitie

Er kan een tussenruimte van maximaal 15 minuten zijn tussen het moment waarop logboeken of metrische gegevens worden verzonden en wanneer ze worden weergegeven in uw opslagaccount, uw Event Hub of Log Analytics. Als het Azure Spring Apps-exemplaar wordt verwijderd of verplaatst, wordt de bewerking niet trapsgewijs verplaatst naar de resources voor diagnostische instellingen . De resources voor diagnostische instellingen moeten handmatig worden verwijderd voordat de bewerking wordt uitgevoerd op basis van het bovenliggende exemplaar van Azure Spring Apps. Als een nieuw Azure Spring Apps-exemplaar wordt ingericht met dezelfde resource-id als de verwijderde instantie, of als het Azure Spring Apps-exemplaar terug wordt verplaatst, blijven de vorige resources voor diagnostische instellingen deze uitbreiden.

De logboeken en metrische gegevens weergeven

Er zijn verschillende methoden om logboeken en metrische gegevens weer te geven, zoals beschreven onder de volgende koppen.

De blade Logboeken gebruiken

1. Ga in Azure Portal naar uw Azure Spring Apps-exemplaar.

2. Als u het deelvenster Zoeken in logboeken wilt openen, selecteert u Logboeken.

3. In het zoekvak Tabellen

   • Als u logboeken wilt weergeven, voert u een eenvoudige query in, zoals:

   AppPlatformLogsforSpring
   | limit 50
   

   • Als u metrische gegevens wilt weergeven, voert u een eenvoudige query in, zoals:

   AzureMetrics
   | limit 50
   

4. Als u het zoekresultaat wilt weergeven, selecteert u Uitvoeren.

Log Analytics gebruiken

1. Selecteer Log Analytics in azure Portal in het linkerdeelvenster.

2. Selecteer de Log Analytics-werkruimte die u hebt gekozen bij het toevoegen van uw diagnostische instellingen.

3. Als u het deelvenster Zoeken in logboeken wilt openen, selecteert u Logboeken.

4. In het zoekvak Tabellen ,

   • als u logboeken wilt weergeven, voert u een eenvoudige query in, zoals:

   AppPlatformLogsforSpring
   | limit 50
   

   • als u metrische gegevens wilt weergeven, voert u een eenvoudige query in, zoals:

   AzureMetrics
   | limit 50
   

5. Als u het zoekresultaat wilt weergeven, selecteert u Uitvoeren.

6. U kunt in de logboeken van de specifieke toepassing of het specifieke exemplaar zoeken door een filtervoorwaarde in te stellen:

   AppPlatformLogsforSpring
   | where ServiceName == "YourServiceName" and AppName == "YourAppName" and InstanceName == "YourInstanceName"
   | limit 50
   

   Notitie

   == is hoofdlettergevoelig, maar =~ niet.

Zie Azure Monitor-logboekquery's voor meer informatie over de querytaal die wordt gebruikt in Log Analytics. Als u een query wilt uitvoeren op al uw Log Analytics-logboeken vanaf een gecentraliseerde client, bekijkt u Azure Data Explorer.

Uw opslagaccount gebruiken

1. Zoek in Azure Portal opslagaccounts in het linkernavigatievenster of zoekvak.
2. Selecteer het opslagaccount dat u hebt gekozen toen u uw diagnostische instellingen hebt toegevoegd.
3. Als u het deelvenster Blobcontainer wilt openen, selecteert u Blobs.
4. Als u toepassingslogboeken wilt bekijken, zoekt u naar een container met de naam insights-logs-applicationconsole.
5. Als u metrische gegevens van toepassingen wilt bekijken, zoekt u naar een container met de naam insights-metrics-pt1m.

Zie Diagnostische gegevens opslaan en weergeven in Azure Storage voor meer informatie over het verzenden van diagnostische gegevens naar een opslagaccount.

Uw Event Hub gebruiken

1. Zoek in Azure Portal Event Hubs in het linkernavigatievenster of zoekvak.

2. Zoek en selecteer de Event Hub die u hebt gekozen bij het toevoegen van uw diagnostische instellingen.

3. Als u het deelvenster Event Hub-lijst wilt openen, selecteert u Event Hubs.

4. Als u toepassingslogboeken wilt bekijken, zoekt u naar een Event Hub met de naam insights-logs-applicationconsole.

5. Als u metrische gegevens van toepassingen wilt bekijken, zoekt u naar een Event Hub met de naam insights-metrics-pt1m.

Voor meer informatie over het verzenden van diagnostische gegevens naar een Event Hub, raadpleegt u Streaming Azure Diagnostics-gegevens in het dynamische pad met behulp van Event Hubs.

De logboeken analyseren

Azure Log Analytics wordt uitgevoerd met een Kusto-engine, zodat u query's kunt uitvoeren op uw logboeken voor analyse. Raadpleeg de Log Analytics-zelfstudie voor een korte inleiding tot het uitvoeren van query's op logboeken met behulp van Kusto.

Toepassingslogboeken bieden essentiële informatie en uitgebreide logboeken over de status, prestaties en meer van uw toepassing. In de volgende secties vindt u enkele eenvoudige query's om inzicht te krijgen in de huidige en eerdere statussen van uw toepassing.

Toepassingslogboeken van Azure Spring Apps weergeven

Als u een lijst met toepassingslogboeken van Azure Spring Apps wilt bekijken, gesorteerd op tijd met de meest recente logboeken die eerst worden weergegeven, voert u de volgende query uit:

AppPlatformLogsforSpring
| project TimeGenerated , ServiceName , AppName , InstanceName , Log
| sort by TimeGenerated desc

Logboekvermeldingen met fouten of uitzonderingen weergeven

Als u niet-gesorteerde logboekvermeldingen met een fout of uitzondering wilt bekijken, voert u de volgende query uit:

AppPlatformLogsforSpring
| project TimeGenerated , ServiceName , AppName , InstanceName , Log
| where Log contains "error" or Log contains "exception"

Gebruik deze query om fouten te vinden of wijzig de querytermen om specifieke foutcodes of uitzonderingen te vinden.

Het aantal fouten en uitzonderingen weergeven dat in het afgelopen uur door uw toepassing is gerapporteerd

Als u een cirkeldiagram wilt maken waarin het aantal fouten en uitzonderingen wordt weergegeven dat in het afgelopen uur door uw toepassing is geregistreerd, voert u de volgende query uit:

AppPlatformLogsforSpring
| where TimeGenerated > ago(1h)
| where Log contains "error" or Log contains "exception"
| summarize count_per_app = count() by AppName
| sort by count_per_app desc
| render piechart

Vermeldingen in het toegangsbeheerlogboek met een specifieke host weergeven

Als u logboekvermeldingen wilt bekijken die door een specifieke host worden gegenereerd, voert u de volgende query uit:

AppPlatformIngressLogs
| where TimeGenerated > ago(1h) and Host == "ingress-asc.test.azuremicroservices.io" 
| project TimeGenerated, RemoteIP, Host, Request, Status, BodyBytesSent, RequestTime, ReqId, RequestHeaders
| sort by TimeGenerated

Gebruik deze query om antwoord Statuste vinden, RequestTimeen andere eigenschappen van de logboeken voor inkomend verkeer van deze specifieke host.

Vermeldingen in inkomend logboek weergeven voor een specifieke requestId

Als u logboekvermeldingen voor een specifieke requestId waarde <request_ID> wilt bekijken, voert u de volgende query uit:

AppPlatformIngressLogs
| where TimeGenerated > ago(1h) and ReqId == "<request_ID>" 
| project TimeGenerated, RemoteIP, Host, Request, Status, BodyBytesSent, RequestTime, ReqId, RequestHeaders
| sort by TimeGenerated

Vermeldingen in het buildlogboek voor een specifieke app weergeven

Als u logboekvermeldingen voor een specifieke app tijdens het buildproces wilt bekijken, voert u de volgende query uit:

AppPlatformBuildLogs
| where TimeGenerated > ago(1h) and PodName contains "<app-name>"
| sort by TimeGenerated

Vermeldingen in het buildlogboek weergeven voor een specifieke app in een specifieke buildfase

Als u logboekvermeldingen voor een specifieke app in een specifieke buildfase wilt bekijken, voert u de volgende query uit. Vervang de tijdelijke aanduiding door de <app-name> naam van uw toepassing. Vervang de <build-stage> tijdelijke aanduiding door een van de volgende waarden, die de fasen van het buildproces vertegenwoordigen: prepare, , detectrestore, analyze, , buildof completionexport.

AppPlatformBuildLogs
| where TimeGenerated > ago(1h) and PodName contains "<app-name>" and ContainerName == "<build-stage>"
| sort by TimeGenerated

VMware Spring Cloud Gateway-logboeken weergeven in het Enterprise-abonnement

Voer de volgende query uit om logboekvermeldingen voor VMware Spring Cloud Gateway-logboeken in het Enterprise-abonnement te bekijken:

AppPlatformSystemLogs 
| where LogType == "SpringCloudGateway"
| project TimeGenerated , LogType, Level , ServiceName , Thread , Stack , Log , _ResourceId 
| limit 100

Een ander onderdeel, genaamd Spring Cloud Gateway Operator, bepaalt de levenscyclus van Spring Cloud Gateway en routes. Als u problemen ondervindt waarbij de route niet van kracht wordt, controleert u de logboeken voor dit onderdeel. Voer de volgende query uit om logboekvermeldingen voor VMware Spring Cloud Gateway Operator in het Enterprise-abonnement te bekijken:

AppPlatformSystemLogs 
| where LogType == "SpringCloudGatewayOperator"
| project TimeGenerated , LogType, Level , ServiceName , Thread , Stack , Log , _ResourceId 
| limit 100

Toepassingsconfiguratieservice voor Tanzu-logboeken weergeven in het Enterprise-abonnement

Voer de volgende query uit om logboekvermeldingen voor de Toepassingsconfiguratieservice voor Tanzu-logboeken in het Enterprise-abonnement te bekijken:

AppPlatformSystemLogs 
| where LogType == "ApplicationConfigurationService"
| project TimeGenerated , LogType, Level , ServiceName , Thread , Stack , Log , _ResourceId 
| limit 100

Tanzu Service Registry-logboeken weergeven in het Enterprise-plan

Voer de volgende query uit om logboekvermeldingen voor tanzu-serviceregisterlogboeken in het Enterprise-abonnement te bekijken:

AppPlatformSystemLogs 
| where LogType == "ServiceRegistry"
| project TimeGenerated , LogType, Level , ServiceName , Thread , Stack , Log , _ResourceId 
| limit 100

API-portal weergeven voor VMware Tanzu-logboeken in het Enterprise-plan

Voer de volgende query uit om logboekvermeldingen voor API-portal voor VMware Tanzu-logboeken in het Enterprise-abonnement te bekijken:

AppPlatformSystemLogs 
| where LogType == "ApiPortal"
| project TimeGenerated , LogType, Level , ServiceName , Thread , Stack , Log , _ResourceId 
| limit 100

Meer informatie over het uitvoeren van query's op toepassingslogboeken

Azure Monitor biedt uitgebreide ondersteuning voor het opvragen van toepassingslogboeken met behulp van Log Analytics. Zie Aan de slag met logboekquery's in Azure Monitor voor meer informatie over deze service. Zie Overzicht van logboekquery's in Azure Monitor voor meer informatie over het bouwen van query's voor het analyseren van uw toepassingslogboeken.

Veelgestelde vragen

Hoe kan ik java-stacktraceringen met meerdere regels converteren naar één regel?

Er is een tijdelijke oplossing om uw traceringen met meerdere regels te converteren naar één regel. U kunt de Uitvoer van het Java-logboek wijzigen om stacktraceringsberichten opnieuw op te maken, waarbij u newlinetekens vervangt door een token. Als u de Java Logback-bibliotheek gebruikt, kunt u traceringsberichten van stacks opnieuw opmaken door deze als volgt toe te voegen %replace(%ex){'[\r\n]+', '\\n'}%nopex :

<configuration>
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>
                level: %level, message: "%logger{36}: %msg", exceptions: "%replace(%ex){'[\r\n]+', '\\n'}%nopex"%n
            </pattern>
        </encoder>
    </appender>
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

U kunt het token vervolgens vervangen door nieuwe regeltekens in Log Analytics, zoals hieronder:

AppPlatformLogsforSpring
| extend Log = array_strcat(split(Log, '\\n'), '\n')

Mogelijk kunt u dezelfde strategie gebruiken voor andere Java-logboekbibliotheken.

Volgende stappen

• Quickstart: Uw eerste Spring Boot-app implementeren in Azure Spring Apps