Spring Boot-apps bewaken met Dynatrace Java OneAgent

  • Artikel

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: ✔️ Standaardverbruik en toegewezen (preview) ✔️ Basic/Standard ❌± Enterprise

In dit artikel leest u hoe u Dynatrace OneAgent gebruikt om Spring Boot-toepassingen in Azure Spring Apps te bewaken.

Met de Dynatrace OneAgent kunt u het volgende doen:

  • Apps bewaken met de Dynatrace OneAgent.
  • Configureer de Dynatrace OneAgent met behulp van omgevingsvariabelen.
  • Controleer alle bewakingsgegevens van het Dynatrace-dashboard.

In de volgende video maakt u kennis met Dynatrace OneAgent.


Vereisten

Dynatrace OneAgent activeren

In de volgende secties wordt beschreven hoe u Dynatrace OneAgent activeert.

Uw Azure Spring Apps-omgeving voorbereiden

  1. Maak een exemplaar van Azure Spring Apps.
  2. Maak een toepassing die u aan Dynatrace wilt rapporteren door de volgende opdracht uit te voeren. Vervang de tijdelijke aanduidingen <...> door uw eigen waarden. 
    az spring app create \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --is-public true

De waarden voor de vereiste omgevingsvariabelen bepalen

Als u Dynatrace OneAgent wilt activeren in uw Azure Spring Apps-exemplaar, moet u vier omgevingsvariabelen configureren: DT_TENANT, DT_TENANTTOKEN, DT_CONNECTION_POINTen DT_CLUSTER_ID. Zie OneAgent integreren met Azure Spring Apps voor meer informatie.

Voor toepassingen met meerdere exemplaren heeft Dynatrace verschillende manieren om ze te groeperen. DT_CLUSTER_ID is een van de manieren. Zie Detectie van procesgroepen voor meer informatie.

De omgevingsvariabelen toevoegen aan uw toepassing

U kunt de sleutel-waardeparen van de omgevingsvariabele toevoegen aan uw toepassing met behulp van Azure Portal of de Azure CLI.

Optie 1: Azure CLI

Als u de sleutel-waardeparen wilt toevoegen met behulp van de Azure CLI, voert u de volgende opdracht uit, waarbij u de tijdelijke aanduidingen <vervangt door> de waarden die in de vorige stappen zijn bepaald.

az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --artifact-path app.jar \
    --env \
        DT_TENANT=<your-environment-ID> \
        DT_TENANTTOKEN=<your-tenant-token> \
        DT_CONNECTION_POINT=<your-communication-endpoint>

Optie 2: Azure Portal

Gebruik de volgende stappen om de sleutel-/waardeparen toe te voegen met behulp van Azure Portal:

  1. Selecteer apps in uw Azure Spring Apps-exemplaar in het navigatiedeelvenster.

    Schermopname van Azure Portal met de pagina Apps voor een Azure Spring Apps-exemplaar.

  2. Selecteer de toepassing in de lijst en selecteer vervolgens Configuratie in het navigatiedeelvenster.

  3. Gebruik het tabblad Omgevingsvariabelen om de variabelen toe te voegen of bij te werken die door uw toepassing worden gebruikt.

    Schermopname van Azure Portal met de pagina Configuratie voor een app met het tabblad Omgevingsvariabelen geselecteerd.

Inrichting automatiseren

Met behulp van een Terraform-, Bicep- of Azure Resource Manager-sjabloon (ARM-sjabloon) kunt u ook een pijplijn voor inrichtingsautomatisering uitvoeren. Deze pijplijn kan een volledige hands-off ervaring bieden voor het instrumenteren en bewaken van nieuwe toepassingen die u maakt en implementeert.

Inrichting automatiseren met Terraform

Als u de omgevingsvariabelen in een Terraform-sjabloon wilt configureren, voegt u de volgende code toe aan de sjabloon, waarbij u de <tijdelijke aanduidingen voor ...> vervangt door uw eigen waarden. Zie Een actieve Implementatie van Azure Spring Apps beheren voor meer informatie.

environment_variables = {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Inrichting automatiseren met behulp van een Bicep-bestand

Als u de omgevingsvariabelen in een Bicep-bestand wilt configureren, voegt u de volgende code toe aan het bestand, waarbij u de <tijdelijke aanduidingen voor ...> vervangt door uw eigen waarden. Zie Microsoft.AppPlatform Spring/apps/deployments voor meer informatie.

environmentVariables: {
  DT_TENANT: '<your-environment-ID>'
  DT_TENANTTOKEN: '<your-tenant-token>'
  DT_CONNECTION_POINT: '<your-communication-endpoint>'
  DT_CLUSTER_ID: '<your-cluster-ID>'
}

Inrichting automatiseren met behulp van een ARM-sjabloon

Als u de omgevingsvariabelen in een ARM-sjabloon wilt configureren, voegt u de volgende code toe aan de sjabloon, waarbij u de <tijdelijke aanduidingen voor ...> vervangt door uw eigen waarden. Zie Microsoft.AppPlatform Spring/apps/deployments voor meer informatie.

"environmentVariables": {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Rapporten weergeven in Dynatrace

In deze sectie wordt beschreven hoe u verschillende rapporten in Dynatrace kunt vinden.

Notitie

Het Dynatrace-menu en de gebruikersinterface zullen geleidelijk worden ontwikkeld. Daarom kan het dashboard worden verplaatst naar andere secties op de Dynatrace-website en worden de volgende schermopnamen mogelijk niet weergegeven in de huidige versie van de gebruikersinterface.

Nadat u de omgevingsvariabelen aan uw toepassing hebt toegevoegd, begint Dynatrace met het verzamelen van gegevens. Als u rapporten wilt weergeven, gebruikt u het Dynatrace-menu, gaat u naar Services en selecteert u vervolgens uw toepassing.

U vindt de servicestroom in< uw-app-naam>/details/servicestroom:

Schermopname van het Dynatrace Service-stroomrapport.

U vindt de methode-hotspots op basis van< uw app-naam>/Details/Method hotspots:

Schermopname van het rapport Dynatrace Method Hotspots.

U vindt de database-instructies in de analyse van <uw app-naam>/details/reactietijd:

Schermopname van het rapport Reactietijd van Dynatrace en de sectie Database-instructies.

Ga vervolgens naar de sectie Multidimensionale analyse .

U vindt de belangrijkste database-instructies uit multidimensionale analyse/topdatabase-instructies:

Schermopname van het rapport Dynatrace Top-database-instructies.

U vindt het overzicht uitzonderingen in het overzicht van multidimensionale analyses/uitzonderingen:

Schermopname van het overzichtsrapport Dynatrace-uitzonderingen.

Ga vervolgens naar de sectie Profilering en optimalisatie .

U vindt de CPU-analyse uit Profilering en optimalisatie/CPU-analyse:

Schermopname van het rapport Dynatrace CPU-analyse.

Ga vervolgens naar de sectie Databases .

U vindt Backtrace uit databases/details/backtrace:

Schermopname van het Rapport Dynatrace Backtrace.

Dynatrace OneAgent-logboeken weergeven

Standaard worden in Azure Spring Apps de logboeken op informatieniveau van de Dynatrace OneAgent afgedrukt naar STDOUT. De logboeken worden gecombineerd met de toepassingslogboeken. U vindt de expliciete agentversie in de toepassingslogboeken.

U kunt ook de logboeken van de Dynatrace-agent ophalen op de volgende locaties:

  • Azure Spring Apps-logboeken
  • Azure Spring Apps Application Insights
  • Azure Spring Apps LogStream

U kunt enkele omgevingsvariabelen van Dynatrace toepassen om logboekregistratie voor de Dynatrace OneAgent te configureren. Bepaalt bijvoorbeeld DT_LOGLEVELCON het niveau van logboeken. De standaardwaarde is DT_LOGLEVELCONinfo. U kunt de logboeken van de agent uitschakelen door deze in te offstellen DT_LOGLEVELCON op . Als logboekregistratie is uitgeschakeld, vraagt Dynatrace ondersteuningsaanvragen die u eerst inschakelt om logboekregistratie in te schakelen om problemen met agents effectief vast te stellen. Vervolgens moet u de app opnieuw starten, wat nodig is om de wijziging van kracht te laten worden. Raadpleeg het ondersteuningsteam van Dynatrace voor andere logboekniveaus.

Let op

We raden u ten zeerste aan het standaardgedrag voor logboekregistratie van Azure Spring Apps voor Dynatrace niet te overschrijven. Als u dit doet, worden de eerder beschreven logboekscenario's geblokkeerd en kunnen de logboekbestanden verloren gaan. U moet bijvoorbeeld de DT_LOGLEVELFILE omgevingsvariabele niet uitvoeren naar uw toepassingen.

Dynatrace OneAgent-upgrade

De auto-upgrade van Dynatrace OneAgent is uitgeschakeld en wordt elk kwartaal bijgewerkt met de JDK. Agentupgrade kan van invloed zijn op de volgende scenario's:

  • Bestaande toepassingen die Dynatrace OneAgent gebruiken voordat de upgrade wordt uitgevoerd, zijn ongewijzigd, maar vereisen opnieuw opstarten of opnieuw implementeren om de nieuwe versie van Dynatrace OneAgent in te schakelen.
  • Toepassingen die zijn gemaakt na de upgrade, gebruiken de nieuwe versie van Dynatrace OneAgent.

Configuratie van uitgaand verkeer van het virtuele netwerkinjectie-exemplaar

Voor een exemplaar van een virtuele netwerkinjectie van Azure Spring Apps moet u ervoor zorgen dat het uitgaande verkeer voor Dynatrace-communicatie-eindpunten correct is geconfigureerd voor Dynatrace OneAgent. Zie Implementatie-API - GET-verbindingsgegevens voor OneAgent voor informatie over hoe u deze kunt ophalen.communicationEndpoints Zie Klantverantwoordelijkheden voor het uitvoeren van Azure Spring Apps in een virtueel netwerk voor meer informatie.

Dynatrace-ondersteuningsmodel

Voor informatie over beperkingen bij het implementeren van Dynatrace OneAgent in de modus alleen voor toepassingen raadpleegt u de sectie Cloudtoepassingsplatformen van het OneAgent-platform en de ondersteuningsmatrix voor mogelijkheden.

Volgende stappen

De Java-in-process-agent van Application Insights in Azure Spring Cloud Apps gebruiken