Naplók és metrikák elemzése diagnosztikai beállításokkal

Feljegyzés

Az Azure Spring Apps az Azure Spring Cloud szolgáltatás új neve. Bár a szolgáltatásnak új neve van, bizonyos helyeken a régi nevet fogja látni egy darabig, miközben az eszközök, például képernyőképek, videók és diagramok frissítésével dolgozunk.

Ez a cikk a következőre vonatkozik: ✔️ Java ✔️ C#

Ez a cikk a következőre vonatkozik: ✔️ Basic/Standard ✔️ Enterprise

Ez a cikk bemutatja, hogyan elemezheti a diagnosztikai adatokat az Azure Spring Appsben.

Az Azure Spring Apps diagnosztikai funkcióinak használatával a naplókat és metrikákat az alábbi szolgáltatások bármelyikével elemezheti:

• Használja az Azure Log Analyticst. A naplók Log Analyticsbe való exportálása késik.
• Naplókat menthet egy tárfiókba naplózás vagy manuális ellenőrzés céljából. Megadhatja a megőrzési időt (napokban).
• Naplókat streamelhet az eseményközpontba egy külső szolgáltatás vagy egyéni elemzési megoldás általi betöltés céljából.

Válassza ki a figyelni kívánt naplókategóriát és metrikakategóriát.

Tipp.

Ha csak a naplókat szeretné streamelni, használhatja az Azure CLI az spring app logs parancsát.

Naplók

Napló	Leírás
ApplicationConsole	Az összes ügyfélalkalmazás konzolnaplója.
SystemLogs	A rendelkezésre álló LogType értékek ( ConfigServercsak alapszintű/standard), ServiceRegistry(minden csomag), ApiPortal(csak vállalati csomag), ApplicationConfigurationService(csak vállalati csomag), SpringCloudGateway (csak vállalati csomag) és SpringCloudGatewayOperator (csak vállalati csomag esetén)
Bejövő forgalomnaplók	Az ügyfél összes alkalmazásának bejövő naplói , csak a hozzáférési naplók.
Buildlogs	Az egyes buildelési fázisokhoz tartozó összes ügyfélalkalmazás naplóinak összeállítása.

Mérőszámok

A metrikák teljes listáját az Azure Spring Apps metrikáinak Felhasználói metrikák beállítási szakaszában találja.

Első lépésként engedélyezze ezen szolgáltatások egyikének az adatok fogadását. A Log Analytics konfigurálásával kapcsolatos további információkért tekintse meg a Log Analytics használatának első lépéseit az Azure Monitorban.

Diagnosztikai beállítások konfigurálása

1. Az Azure Portalon nyissa meg az Azure Spring Apps-példányt.

2. Válassza a Diagnosztikai beállítások lehetőséget , majd válassza a Diagnosztikai beállítások hozzáadása lehetőséget.

3. Adja meg a beállítás nevét, majd adja meg, hogy hová szeretné elküldeni a naplókat. A következő három lehetőség bármelyikét választhatja:

   • Archiválás tárfiókba
   • Streamelés eseményközpontba
   • Küldés a Log Analyticsnek
   • Küldés partnermegoldásnak

4. Válassza ki a figyelni kívánt naplókategóriát és metrikakategóriát, majd adja meg a megőrzési időt (napokban). A megőrzési idő csak a tárfiókra vonatkozik.

5. Válassza a Mentés parancsot.

Feljegyzés

A naplók vagy metrikák kibocsátása és a tárfiókban, az eseményközpontban vagy a Log Analyticsben való megjelenésük között akár 15 perc is lehet. Ha az Azure Spring Apps-példányt törölték vagy áthelyezték, a művelet nem kaszkádolt a diagnosztikai beállítások erőforrásaira. A diagnosztikai beállítások erőforrásait manuálisan kell törölni, mielőtt a művelet a szülője, az Azure Spring Apps-példány ellen fut. Ellenkező esetben, ha egy új Azure Spring Apps-példány ki van építve ugyanazzal az erőforrás-azonosítóval, mint a törölt, vagy ha az Azure Spring Apps-példány vissza lett helyezve, a korábbi diagnosztikai beállítások erőforrásai tovább bővítik azt.

Naplók és metrikák megtekintése

A naplók és metrikák megtekintésének különböző módjai vannak az alábbi címsorokban leírtak szerint.

A Naplók panel használata

1. Az Azure Portalon nyissa meg az Azure Spring Apps-példányt.

2. A Naplókeresés panel megnyitásához válassza a Naplók lehetőséget.

3. A Táblák keresőmezőben

   • A naplók megtekintéséhez adjon meg egy egyszerű lekérdezést, például:

   AppPlatformLogsforSpring
   | limit 50
   

   • A metrikák megtekintéséhez adjon meg egy egyszerű lekérdezést, például:

   AzureMetrics
   | limit 50
   

4. A keresési eredmény megtekintéséhez válassza a Futtatás lehetőséget.

A Log Analytics használata

1. Az Azure Portal bal oldali ablaktábláján válassza a Log Analytics lehetőséget.

2. Válassza ki a diagnosztikai beállítások hozzáadásakor kiválasztott Log Analytics-munkaterületet.

3. A Naplókeresés panel megnyitásához válassza a Naplók lehetőséget.

4. A Táblák keresőmezőben

   • a naplók megtekintéséhez írjon be egy egyszerű lekérdezést, például:

   AppPlatformLogsforSpring
   | limit 50
   

   • a metrikák megtekintéséhez írjon be egy egyszerű lekérdezést, például:

   AzureMetrics
   | limit 50
   

5. A keresési eredmény megtekintéséhez válassza a Futtatás lehetőséget.

6. Szűrőfeltétel beállításával kereshet az adott alkalmazás vagy példány naplóiban:

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

   Feljegyzés

   == a kis- és nagybetűk megkülönböztetése, de =~ nem.

A Log Analyticsben használt lekérdezési nyelvről további információt az Azure Monitor napló lekérdezései című témakörben talál. Ha egy központi ügyféltől szeretné lekérdezni az összes Log Analytics-naplót, tekintse meg az Azure Data Explorert.

A tárfiók használata

1. Az Azure Portalon keresse meg a Storage-fiókokat a bal oldali navigációs panelen vagy keresőmezőben.
2. Válassza ki a diagnosztikai beállítások hozzáadásakor kiválasztott tárfiókot.
3. A Blob Container panel megnyitásához válassza a Blobok lehetőséget.
4. Az alkalmazásnaplók áttekintéséhez keressen egy insights-logs-applicationconsole nevű tárolót.
5. Az alkalmazásmetrikák áttekintéséhez keressen egy insights-metrics-pt1m nevű tárolót.

A diagnosztikai adatok tárfiókba való küldésével kapcsolatos további információkért lásd : Diagnosztikai adatok tárolása és megtekintése az Azure Storage-ban.

Az eseményközpont használata

1. Az Azure Portalon keresse meg az Event Hubsot a bal oldali navigációs panelen vagy keresőmezőben.

2. Keresse meg és válassza ki azt az eseményközpontot, amelyet a diagnosztikai beállítások hozzáadásakor választott.

3. Az Event Hub Lista panel megnyitásához válassza az Event Hubs lehetőséget.

4. Az alkalmazásnaplók áttekintéséhez keressen egy insights-logs-applicationconsole nevű eseményközpontot.

5. Az alkalmazásmetrikák áttekintéséhez keressen egy insights-metrics-pt1m nevű eseményközpontot.

Ha többet szeretne tudni a diagnosztikai adatok eseményközpontba való küldéséről, tekintse meg az Azure Diagnostics-adatok streamelését a gyakori elérésű útvonalon az Event Hubs használatával.

Naplók elemzése

Az Azure Log Analytics egy Kusto-motorral fut, így lekérdezheti a naplókat elemzés céljából. A naplók Kusto használatával történő lekérdezésének gyors bemutatásához tekintse át a Log Analytics-oktatóanyagot.

Az alkalmazásnaplók kritikus információkat és részletes naplókat tartalmaznak az alkalmazás állapotáról, teljesítményéről és egyebekről. A következő szakaszokban néhány egyszerű lekérdezést találhat, amelyek segítenek megérteni az alkalmazás aktuális és korábbi állapotát.

Alkalmazásnaplók megjelenítése az Azure Spring Appsből

Ha az Azure Spring Apps alkalmazásnaplóinak listáját szeretné áttekinteni, idő szerint rendezve a legutóbbi naplókkal, futtassa a következő lekérdezést:

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

Hibákat vagy kivételeket tartalmazó naplóbejegyzések megjelenítése

Ha egy hibát vagy kivételt említő nem válogatott naplóbejegyzéseket szeretne áttekinteni, futtassa a következő lekérdezést:

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

Ezzel a lekérdezésrel hibákat kereshet, vagy módosíthatja a lekérdezési kifejezéseket adott hibakódok vagy kivételek megkereséséhez.

Az alkalmazás által az elmúlt egy órában jelentett hibák és kivételek számának megjelenítése

Ha olyan kördiagramot szeretne létrehozni, amely megjeleníti az alkalmazás által az elmúlt órában naplózott hibák és kivételek számát, futtassa a következő lekérdezést:

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

Adott gazdagépet tartalmazó bejövő naplóbejegyzések megjelenítése

Egy adott gazdagép által létrehozott naplóbejegyzések áttekintéséhez futtassa a következő lekérdezést:

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

Ezzel a lekérdezésrel megkeresheti az adott gazdagép bejövő naplóinak válaszát StatusRequestTimeés egyéb tulajdonságait.

Adott requestId bejövő naplóbejegyzéseinek megjelenítése

Egy adott requestId request_ID>< naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

Adott alkalmazás buildnapló-bejegyzéseinek megjelenítése

Ha egy adott alkalmazás naplóbejegyzéseit szeretné áttekinteni a buildelési folyamat során, futtassa a következő lekérdezést:

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

Adott alkalmazás buildnapló-bejegyzéseinek megjelenítése egy adott buildelési szakaszban

Ha egy adott alkalmazás naplóbejegyzéseit szeretné áttekinteni egy adott buildelési szakaszban, futtassa az alábbi lekérdezést. Cserélje le a <app-name> helyőrzőt az alkalmazás nevére. Cserélje le a <build-stage> helyőrzőt a következő értékek egyikére, amelyek a buildelési folyamat szakaszait jelölik: prepare, , detect, restoreanalyze, build, exportvagy completion.

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

VMware Spring Cloud Gateway-naplók megjelenítése a Vállalati csomagban

A VMware Spring Cloud Gateway-naplók vállalati csomagban lévő naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

Egy másik, Spring Cloud Gateway-operátor nevű összetevő szabályozza a Spring Cloud Gateway és az útvonalak életciklusát. Ha az útvonal nem érvénybe lépésével kapcsolatos problémákat tapasztal, ellenőrizze az összetevő naplóit. A VMware Spring Cloud Gateway-operátor vállalati csomagbeli naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

Tanzu-naplók alkalmazáskonfigurációs szolgáltatásának megjelenítése a Vállalati csomagban

A Tanzu-naplókhoz készült Application Configuration Service naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

Tanzu szolgáltatásregisztrációs naplók megjelenítése a Vállalati csomagban

A Tanzu Szolgáltatásregisztrációs adatbázis nagyvállalati csomagban lévő naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

VMware Tanzu-naplók API-portáljának megjelenítése az Enterprise-csomagban

A VMware Tanzu-naplókhoz készült API Portal naplóbejegyzéseinek áttekintéséhez futtassa a következő lekérdezést:

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

További információ az alkalmazásnaplók lekérdezéséről

Az Azure Monitor széles körű támogatást nyújt az alkalmazásnaplók Log Analytics használatával történő lekérdezéséhez. A szolgáltatással kapcsolatos további információkért tekintse meg a napló-lekérdezések első lépéseit az Azure Monitorban. Az alkalmazásnaplók elemzéséhez szükséges lekérdezések készítéséről további információt az Azure Monitor napló lekérdezéseinek áttekintése című témakörben talál.

Gyakori kérdések (GYIK)

Hogyan többsoros Java-verem nyomkövetését egyetlen sorba konvertálni?

Van egy áthidaló megoldás a többsoros verem nyomkövetésének egyetlen vonallá alakításához. A Java-napló kimenetét módosíthatja úgy, hogy újraformálja a verem nyomkövetési üzeneteit, és az új karaktereket jogkivonatra cserélje. Ha Java Logback-kódtárat használ, újraformálhatja a verem nyomkövetési üzeneteit a %replace(%ex){'[\r\n]+', '\\n'}%nopex következőképpen:

<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>

Ezt követően a jogkivonatot az alábbi módon lecserélheti új sorkarakterekre a Log Analyticsben:

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

Más Java-naplótárak esetében is használhatja ugyanezt a stratégiát.

Következő lépések

• Rövid útmutató: Az első Spring Boot-alkalmazás üzembe helyezése az Azure Spring Appsben