Spring Boot-alkalmazások monitorozása a New Relic Java-ügynökkel

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: ✔️ Standard felhasználás és dedikált (előzetes verzió) ✔️ Basic/Standard ❌ Enterprise

Ez a cikk bemutatja, hogyan monitorozhat Spring Boot-alkalmazásokat az Azure Spring Appsben a New Relic Java-ügynökkel.

Az Új Relic Java-ügynökkel a következőt teheti:

  • Használja az Új Relic Java-ügynököt.
  • Konfigurálja az Új Relic Java-ügynököt környezeti változók használatával.
  • Ellenőrizze az összes monitorozási adatot a New Relic irányítópultról.

Az alábbi videó bemutatja, hogyan aktiválhatja és figyelheti a Spring Boot-alkalmazásokat az Azure Spring Appsben a New Relic One használatával.


Előfeltételek

Az Új Relic Java aktiválása a folyamatügynökben

Az ügynök eléréséhez használja az alábbi eljárást:

  1. Hozzon létre egy Azure Spring Apps-példányt.

  2. Hozzon létre egy alkalmazást.

    az spring app create \
        --resource-group <resource-group-name> \
        --service <Azure-Spring-Apps-instance-name> \
        --name <app-name> \
        --is-public true \
    
  3. Hozzon létre egy üzembe helyezést az Új Relic-ügynökkel és a környezeti változókkal.

    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
    

Az Azure Spring Apps előretelepíti a New Relic Java-ügynököt az /opt/agents/newrelic/java/newrelic-agent.jar. Az ügyfelek aktiválhatják az ügynököt az alkalmazások JVM-beállításaiból, és konfigurálhatják az ügynököt az Új Relic Java-ügynök környezeti változóinak használatával.

Azure Portalra

Ezt az ügynököt az Alábbi eljárással is aktiválhatja az Azure Portalon.

  1. Az Azure Spring Apps-példányban válassza az Alkalmazások lehetőséget a navigációs panelen.

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

  2. Válassza ki az alkalmazást a listából, majd a navigációs panelen válassza a Konfiguráció lehetőséget .

  3. Az Általános beállítások lapon frissítheti az értékeket, például a JVM-beállításokat.

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

  4. Válassza ki a környezeti változókat az alkalmazás által használt változók hozzáadásához vagy frissítéséhez.

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

  5. Tekintse meg az alkalmazás api/átjáró összegzési oldalát az Új Relic irányítópulton.

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

  6. Tekintse meg az alkalmazás ügyfél-szolgáltatás összegzési lapját az Új Relic irányítópulton.

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

  7. A Szolgáltatástérkép lap megtekintése az Új Relic irányítópulton.

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

  8. Tekintse meg az alkalmazás JVM-oldalát az Új Relic irányítópulton.

    Screenshot of the New Relic dashboard showing the JVM page.

  9. Tekintse meg az alkalmazásprofilt az Új Relic irányítópulton.

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

Kiépítés automatizálása

Kiépítési automatizálási folyamatot terraform, Bicep vagy Azure Resource Manager-sablon (ARM-sablon) használatával is futtathat. Ez a folyamat teljes körű gyakorlati élményt nyújt a létrehozott és üzembe helyezhető új alkalmazások eszközzéséhez és monitorozásához.

Kiépítés automatizálása a Terraform használatával

A környezeti változók Terraform-sablonban való konfigurálásához adja hozzá a következő kódot a sablonhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: Active Azure Spring Apps-telepítés kezelése.

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

Kiépítés automatizálása Bicep-fájl használatával

A környezeti változók Bicep-fájlban való konfigurálásához adja hozzá a következő kódot a sablonhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: 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',
  ...
}

Kiépítés automatizálása ARM-sablonnal

A környezeti változók ARM-sablonban való konfigurálásához adja hozzá a következő kódot a sablonhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: 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",
  ...
}

Alkalmazásnaplók továbbítása a New Relicbe

Az Új Relic-ügynök közvetlenül az alkalmazásokból gyűjtheti össze az alkalmazásnaplókat, és továbbíthatja őket a New Relicbe. További információ: Naplók továbbítása a New Relic - és APM-naplókba a kontextusban.

Új Relic Java-ügynöknaplók megtekintése

Alapértelmezés szerint az Azure Spring Apps kinyomtatja a New Relic Java-ügynök STDOUTnaplóit. A naplók keverednek az alkalmazásnaplókkal. Az explicit ügynök verzióját az alkalmazásnaplókban találja.

Az Új Relic-ügynök naplóit a következő helyekről is lekérheti:

  • Azure Spring Apps-naplók
  • Azure Spring Apps-alkalmazás Elemzések
  • Azure Spring Apps LogStream

A New Relic által biztosított környezeti változók segítségével konfigurálhatja az Új ügynök naplózását, NEW_RELIC_LOG_LEVEL például a naplók szintjének szabályozásához. További információ: Új Relic naplózási konfiguráció.

Feljegyzés

Ezt ne használja finer , vagy finest ha a New Relic ügyfélszolgálata erre kéri. Ezek a naplózási szintek túlzott többletterhelést okozhatnak. A legtöbb esetben használja infoa .

Figyelem

Határozottan javasoljuk, hogy ne bírálja felül az Azure Spring Apps for New Relic naplózási alapértelmezett viselkedését. Ha így tesz, a korábban ismertetett naplózási forgatókönyvek le lesznek tiltva, és a naplófájl(ok) elveszhetnek. Ne adja át például a következő környezeti változókat az alkalmazásoknak. Előfordulhat, hogy a naplófájl(ok) elvesznek az alkalmazás(ok) újraindítása vagy ismételt üzembe helyezése után.

  • NEW_RELIC_LOG
  • NEW_RELIC_LOG_FILE_PATH

Új Relic Java-ügynök frissítése/frissítése

A New Relic Java-ügynök rendszeresen frissíti/frissíti a JDK-t. Az ügynök frissítése/frissítése a következő forgatókönyveket érintheti.

  • A frissítés/frissítés előtt az Új Relic Java-ügynököt használó meglévő alkalmazások változatlanok maradnak.
  • A frissítés/frissítés előtt az Új Relic Java-ügynököt használó meglévő alkalmazások újraindítást vagy ismételt üzembe helyezést igényelnek az Új Relic Java-ügynök új verziójának használatához.
  • A frissítés/frissítés után létrehozott új alkalmazások a New Relic Java-ügynök új verzióját használják.

Virtuális hálózat injektálási példányának kimenő forgalom konfigurációja

Az Azure Spring Apps virtuális hálózatinjektálási példányához meg kell győződnie arról, hogy a kimenő forgalom megfelelően van konfigurálva az Új Relic Java-ügynökhöz. További információ: Networks of New Relic.

Következő lépések

Az Application Insights Java-folyamatbeli ügynök használata az Azure Spring Appsben