Ansluta till en appinstans för felsökning

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Den här artikeln beskriver hur du kommer åt shell-miljön i dina programinstanser för att utföra avancerad felsökning.

Även om Azure Spring Apps erbjuder olika metoder för hanterad felsökning kanske du vill utföra avancerad felsökning med hjälp av shell-miljön. Du kanske till exempel vill utföra följande felsökningsuppgifter:

• Använd JDK-verktyg (Java Development Kit) direkt.
• Diagnostisera mot en apps serverdelstjänster för nätverksanslutning och svarstid för API-anrop för både virtuella nätverk och instanser som inte är virtuella nätverk.
• Diagnostisera problem med lagringskapacitet, prestanda och CPU/minne.

Förutsättningar

• Azure CLI med Azure Spring Apps-tillägget. Använd följande kommando för att ta bort tidigare versioner och installera det senaste tillägget. Om du tidigare har installerat spring-cloud tillägget avinstallerar du det för att undvika konfigurations- och versionsmatchningar.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Ett distribuerat program i Azure Spring Apps.

• Om du har distribuerat en anpassad container, ett gränssnittsprogram. Standardvärdet är /bin/sh.

Tilldela en Azure-roll

Innan du ansluter till en appinstans måste du beviljas rollen Azure Spring Apps Connect-roll. För att ansluta till en appinstans krävs dataåtgärdsbehörigheten Microsoft.AppPlatform/Spring/apps/deployments/connect/action.

Du kan tilldela en Azure-roll med hjälp av Azure Portal eller Azure CLI.

az role assignment create \
    --role 'Azure Spring Apps Connect Role' \
    --scope '<service-instance-resource-id>' \
    --assignee '<your-identity>'

Ansluta till en appinstans

Du kan ansluta till en appinstans med hjälp av Azure Portal eller Azure CLI.

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name>

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --instance <instance_name>

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --deployment green

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --shell-cmd /bin/bash

Felsöka din appinstans

När du har anslutit till en appinstans kan du kontrollera statusen för heapminnet.

Använd följande kommando för att hitta Java-process-ID:t, vilket vanligtvis 1är :

jps

Utdata bör se ut som i följande exempel:

Använd sedan följande kommando för att köra JDK-verktyget för att kontrollera resultatet:

jstat -gc 1

Utdata bör se ut som i följande exempel:

Koppla från din appinstans

När du är klar med felsökningen exit använder du kommandot för att koppla från appinstansen eller trycker på Ctrl+d.

Verktyg för felsökning

I följande lista beskrivs några av de förinstallerade verktyg som du kan använda för felsökning:

• lsof - Visar öppna filer.
• top – Visar systemsammanfattningsinformation och aktuell användning.
• ps – Hämtar en ögonblicksbild av den pågående processen.
• netstat – Skriver ut nätverksanslutningar och gränssnittsstatistik.
• nslookup – Frågar internetnamnservrar interaktivt.
• ping – Testar om en nätverksvärd kan nås.
• nc – Läser från och skriver till nätverksanslutningar med TCP eller UDP.
• wget – Låter dig ladda ned filer och interagera med REST-API:er.
• df – Visar mängden tillgängligt diskutrymme.

Du kan också använda JDK-paketerade verktyg som jps, jcmdoch jstat.

I följande lista visas de tillgängliga verktygen, som är beroende av din tjänstplan och typ av appdistribution:

• Distribution av källkod, JAR och artefakter:
  • Grundläggande, standard- och standardförbrukning och dedikerad plan:
    • Vanliga verktyg – Ja
    • JDK-verktyg – Ja, endast för Java-arbetsbelastningar.
  • Företagsplan:
    • Vanliga verktyg – Beror på vilken OS Stack du har valt i din byggare. Ja, för full OS Stack. Nej, för os-basstacken.
    • JDK-verktyg – Ja, endast för Java-arbetsbelastningar.
• Distribution av anpassad avbildning: Beror på det installerade verktyget som angetts i avbildningen.

Begränsningar

Användning av gränssnittsmiljön i dina programinstanser har följande begränsningar:

• Eftersom appen körs som en icke-rotanvändare kan du inte utföra vissa åtgärder som kräver rotbehörighet. Du kan till exempel inte installera nya verktyg med hjälp av systempakethanteraren apt / yum.

• Eftersom vissa Linux-funktioner är förbjudna fungerar inte verktyg som kräver särskilda privilegier, till exempel tcpdump, .

Nästa steg

• Självdiagnostisera och lösa problem i Azure Spring Apps