Spring Boot-apps bewaken met de New Relic Java-agent

Artikel
11/06/2024

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.

Dit artikel is van toepassing op: ✔️ Standaardverbruik en toegewezen (preview) ✔️ Basic/Standard ❌ Enterprise

In dit artikel leest u hoe u Spring Boot-toepassingen in Azure Spring Apps bewaakt met de New Relic Java-agent.

Met de New Relic Java-agent kunt u het volgende doen:

Gebruik de New Relic Java-agent.
Configureer de New Relic Java-agent met behulp van omgevingsvariabelen.
Controleer alle bewakingsgegevens van het New Relic-dashboard.

In de volgende video wordt beschreven hoe u Spring Boot-toepassingen activeert en bewaakt in Azure Spring Apps met behulp van New Relic One.

Vereisten

Een New Relic-account .
Azure CLI versie 2.0.67 of hoger.

De New Relic Java in procesagent activeren

Gebruik de volgende procedure om toegang te krijgen tot de agent:

Maak een exemplaar van Azure Spring Apps.

Maak een toepassing.

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --is-public true \

Maak een implementatie met de New Relic-agent en omgevingsvariabelen.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar" \
    --env NEW_RELIC_APP_NAME=appName \
          NEW_RELIC_LICENSE_KEY=newRelicLicenseKey

Azure Spring Apps installeert de New Relic Java-agent vooraf op /opt/agents/newrelic/java/newrelic-agent.jar. Klanten kunnen de agent activeren vanuit de JVM-opties van toepassingen en de agent configureren met behulp van de omgevingsvariabelen van de New Relic Java-agent.

Azure Portal

U kunt deze agent ook activeren vanuit Azure Portal met de volgende procedure.

Selecteer apps in uw Azure Spring Apps-exemplaar in het navigatiedeelvenster.
Selecteer de toepassing in de lijst en selecteer vervolgens Configuratie in het navigatiedeelvenster.
Gebruik het tabblad Algemene instellingen om waarden zoals de JVM-opties bij te werken.
Selecteer Omgevingsvariabelen om de variabelen toe te voegen of bij te werken die door uw toepassing worden gebruikt.
Bekijk de overzichtspagina van de toepassings-API/gateway vanuit het New Relic-dashboard.
Bekijk de overzichtspagina van de toepassingsklantenservice vanuit het New Relic-dashboard.
Bekijk de pagina Serviceoverzicht vanuit het New Relic-dashboard.
Bekijk de pagina JVM's van de toepassing vanuit het New Relic-dashboard.
Bekijk het toepassingsprofiel vanuit het New Relic-dashboard.

Inrichting automatiseren

U kunt ook een pijplijn voor inrichtingsautomatisering uitvoeren met behulp van Terraform, Bicep of een Arm-sjabloon (Azure Resource Manager). 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.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar"
  ...
    environment_variables = {
      "NEW_RELIC_APP_NAME": "<app-name>",
      "NEW_RELIC_LICENSE_KEY": "<new-relic-license-key>"
  }
}

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 de sjabloon, waarbij u de <tijdelijke aanduidingen voor ...> vervangt door uw eigen waarden. Zie Microsoft.AppPlatform Spring/apps/deployments voor meer informatie.

deploymentSettings: {
  environmentVariables: {
    NEW_RELIC_APP_NAME : '<app-name>',
    NEW_RELIC_LICENSE_KEY : '<new-relic-license-key>'
  },
  jvmOptions: '-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar',
  ...
}

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.

"deploymentSettings": {
  "environmentVariables": {
    "NEW_RELIC_APP_NAME" : "<app-name>",
    "NEW_RELIC_LICENSE_KEY" : "<new-relic-license-key>"
  },
  "jvmOptions": "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar",
  ...
}

Toepassingslogboeken doorsturen naar New Relic

De New Relic-agent kan toepassingslogboeken rechtstreeks vanuit uw apps verzamelen en deze doorsturen naar New Relic. Zie Uw logboeken doorsturen naar New Relic - en APM-logboeken in context voor meer informatie.

Logboeken van New Relic Java Agent weergeven

Standaard worden in Azure Spring Apps de logboeken van de New Relic Java-agent 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 New Relic-agent ophalen op de volgende locaties:

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

U kunt enkele omgevingsvariabelen van New Relic gebruiken om de logboekregistratie van de nieuwe agent te configureren, zoals NEW_RELIC_LOG_LEVEL het niveau van logboeken. Zie de configuratie van new Relic-logboekregistratie voor meer informatie.

Notitie

Gebruik dit niet finer of finest tenzij New Relic Support u vraagt dit te doen. Deze logboekregistratieniveaus kunnen overmatige overhead genereren. Gebruik voor de meeste situaties info.

Let op

We raden u ten zeerste aan het standaardgedrag voor logboekregistratie van Azure Spring Apps for New Relic niet te overschrijven. Als u dit doet, worden de eerder beschreven logboekscenario's geblokkeerd en kunnen de logboekbestanden verloren gaan. U moet bijvoorbeeld de volgende omgevingsvariabelen niet doorgeven aan uw toepassingen. Logboekbestanden kunnen verloren gaan na het opnieuw opstarten of opnieuw implementeren van toepassingen.

NEW_RELIC_LOG
NEW_RELIC_LOG_FILE_PATH

Update/upgrade van New Relic Java Agent

De New Relic Java-agent werkt de JDK regelmatig bij/ upgradet. De update/upgrade van de agent kan van invloed zijn op de volgende scenario's.

Bestaande toepassingen die gebruikmaken van de New Relic Java-agent voordat de update/upgrade wordt bijgewerkt, blijven ongewijzigd.
Bestaande toepassingen die gebruikmaken van de New Relic Java-agent voordat de update/upgrade wordt uitgevoerd, moeten opnieuw worden opgestart of opnieuw worden geïmplementeerd om de nieuwe versie van de New Relic Java-agent in te schakelen.
Nieuwe toepassingen die zijn gemaakt na het bijwerken/upgraden, gebruiken de nieuwe versie van de New Relic Java-agent.

Configuratie van uitgaand verkeer van Vnet-injectieexemplaren

Voor een vnet-injectieexemplaren van Azure Spring Apps moet u ervoor zorgen dat het uitgaande verkeer correct is geconfigureerd voor de New Relic Java-agent. Zie Networks of New Relic voor meer informatie.

Volgende stappen

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

Delen via