Monitorování aplikací Spring Boot pomocí agenta New Relic Java

Poznámka:

Azure Spring Apps je nový název služby Azure Spring Cloud. Přestože má služba nový název, na některých místech uvidíte starý název, protože pracujeme na aktualizaci prostředků, jako jsou snímky obrazovky, videa a diagramy.

Tento článek se vztahuje na: ✔️ Využití standardu a vyhrazené (Preview) ✔️ Basic/Standard ❌ Enterprise

V tomto článku se dozvíte, jak monitorovat aplikace Spring Boot v Azure Spring Apps pomocí agenta New Relic Java.

Pomocí agenta New Relic Java můžete:

  • Využití agenta New Relic Java
  • Nakonfigurujte agenta New Relic Java pomocí proměnných prostředí.
  • Zkontrolujte všechna data monitorování z řídicího panelu New Relic.

Následující video popisuje, jak aktivovat a monitorovat aplikace Spring Boot v Azure Spring Apps pomocí New Relic One.


Požadavky

Aktivace Javy New Relic v agentu procesu

Pro přístup k agentu použijte následující postup:

  1. Vytvořte instanci Azure Spring Apps.

  2. Vytvořte aplikaci.

    az spring app create \
        --resource-group <resource-group-name> \
        --service <Azure-Spring-Apps-instance-name> \
        --name <app-name> \
        --is-public true \
    
  3. Vytvořte nasazení pomocí agenta New Relic a proměnných prostředí.

    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 předinstaluje agenta New Relic Java na /opt/agents/newrelic/java/newrelic-agent.jar. Zákazníci můžou agenta aktivovat z možností JVM aplikací a nakonfigurovat agenta pomocí proměnných prostředí prostředí prostředí New Relic Java.

portál Azure

Tento agent můžete aktivovat také z webu Azure Portal pomocí následujícího postupu.

  1. V instanci Azure Spring Apps vyberte Aplikace v navigačním podokně.

    Screenshot of the Azure portal showing the Apps page for an Azure Spring Apps instance.

  2. V seznamu vyberte aplikaci a pak v navigačním podokně vyberte Možnost Konfigurace .

  3. K aktualizaci hodnot, jako jsou možnosti JVM, použijte kartu Obecné nastavení.

    Screenshot of the Azure portal showing the Configuration page for an app with the General settings tab selected.

  4. Výběrem proměnných prostředí přidejte nebo aktualizujte proměnné používané vaší aplikací.

    Screenshot of the Azure portal showing the Configuration page for an app with the Environment variables tab selected.

  5. Na řídicím panelu New Relic zobrazte stránku souhrnu rozhraní API/brány aplikace.

    Screenshot of the New Relic dashboard showing the API Gateway summary page.

  6. Na řídicím panelu New Relic zobrazte stránku Souhrn služeb zákazníkům aplikace.

    Screenshot of the New Relic dashboard showing the Customers Service page.

  7. Zobrazte stránku Service Map z řídicího panelu New Relic.

    Screenshot of the New Relic dashboard showing the Service Map page.

  8. Zobrazte stránku prostředí JVM aplikace z řídicího panelu New Relic.

    Screenshot of the New Relic dashboard showing the JVM page.

  9. Zobrazte profil aplikace z řídicího panelu New Relic.

    Screenshot of the New Relic dashboard showing the Application Profile page.

Automatizace zřizování

Kanál automatizace zřizování můžete spustit také pomocí Terraformu, Bicep nebo šablony Azure Resource Manageru (šablona ARM). Tento kanál může poskytovat kompletní praktické prostředí pro instrumentaci a monitorování všech nových aplikací, které vytvoříte a nasadíte.

Automatizace zřizování pomocí Terraformu

Pokud chcete nakonfigurovat proměnné prostředí v šabloně Terraformu, přidejte do šablony následující kód a nahraďte <> zástupné symboly vlastními hodnotami. Další informace najdete v tématu Správa aktivního nasazení služby Azure Spring Apps.

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

Automatizace zřizování pomocí souboru Bicep

Pokud chcete nakonfigurovat proměnné prostředí v souboru Bicep, přidejte do šablony následující kód a nahraďte <> zástupné symboly vlastními hodnotami. Další informace najdete v tématu Microsoft.AppPlatform Spring/apps/deployments.

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',
  ...
}

Automatizace zřizování pomocí šablony ARM

Pokud chcete nakonfigurovat proměnné prostředí v šabloně ARM, přidejte do šablony následující kód a zástupné symboly ...> nahraďte <vlastními hodnotami. Další informace najdete v tématu Microsoft.AppPlatform Spring/apps/deployments.

"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",
  ...
}

Předávání aplikačních protokolů do New Relic

Agent New Relic může shromažďovat protokoly aplikací přímo z vašich aplikací a předávat je do New Relic. Další informace najdete v tématu Předávání protokolů do New Relic a protokolů APM v kontextu.

Zobrazení protokolů agenta Java New Relic

Azure Spring Apps ve výchozím nastavení vytiskne protokoly agenta New Relic Java do STDOUT. Protokoly jsou smíšené s protokoly aplikace. Explicitní verzi agenta najdete v protokolech aplikace.

Protokoly agenta New Relic můžete získat také z následujících umístění:

  • Protokoly Azure Spring Apps
  • Přehledy aplikace Azure Spring Apps
  • Azure Spring Apps LogStream

Některé proměnné prostředí, které poskytuje New Relic, můžete použít ke konfiguraci protokolování nového agenta, například NEW_RELIC_LOG_LEVEL k řízení úrovně protokolů. Další informace naleznete v tématu Konfigurace protokolování New Relic.

Poznámka:

finer Nepoužívejte nebo finest pokud vás podpora New Relic nepožádá o to. Tyto úrovně protokolování můžou generovat nadměrnou režii. Ve většině situací použijte info.

Upozornění

Důrazně doporučujeme nepřepsat výchozí chování protokolování poskytované službou Azure Spring Apps for New Relic. Pokud to uděláte, dříve popsané scénáře protokolování se zablokují a soubory protokolů můžou být ztraceny. Například do aplikací byste neměli předávat následující proměnné prostředí. Po restartování nebo opětovném nasazení aplikací může dojít ke ztrátě souborů protokolu.

  • NEW_RELIC_LOG
  • NEW_RELIC_LOG_FILE_PATH

Nová aktualizace nebo upgrade agenta Java Relic

Agent New Relic Java pravidelně aktualizuje nebo upgraduje sadu JDK. Aktualizace nebo upgrade agenta může mít vliv na následující scénáře.

  • Stávající aplikace, které používají agenta New Relic Java před aktualizací nebo upgradem, se nezmění.
  • Existující aplikace, které před aktualizací nebo upgradem používají agenta New Relic Java, vyžadují restartování nebo opětovné nasazení, aby se zapojily do nové verze agenta New Relic Java.
  • Nové aplikace vytvořené po aktualizaci nebo upgradu používají novou verzi agenta New Relic Java.

Konfigurace odchozího provozu instance injektáže virtuální sítě

V případě instance injektáže virtuální sítě služby Azure Spring Apps musíte zajistit, aby byl odchozí provoz správně nakonfigurovaný pro agenta New Relic Java. Další informace naleznete v tématu Sítě New Relic.

Další kroky

Používání vnitroprocesového agenta Java Application Insights ve službě Azure Spring Apps