Använda Azure Monitor Application Insights med Spring Boot

Det finns två alternativ för att aktivera Application Insights Java med Spring Boot: JVM-argument (Java Virtual Machine) och programmatiskt.

Aktivera med JVM-argument

Lägg till JVM arg -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" någonstans före -jar, till exempel:

java -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" -jar <myapp.jar>

Spring Boot via Docker-startpunkt

Se dokumentationen som gäller containrar.

Konfiguration

Se konfigurationsalternativ.

Aktivera programmatiskt

Om du vill aktivera Application Insights Java programmatiskt måste du lägga till följande beroende:

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>applicationinsights-runtime-attach</artifactId>
    <version>3.7.5</version>
</dependency>

Och anropa metoden för attach() klassen com.microsoft.applicationinsights.attach.ApplicationInsights som finns i början av din main() metod.

Exempel:

@SpringBootApplication
public class SpringBootApp {

  public static void main(String[] args) {
    ApplicationInsights.attach();
    SpringApplication.run(SpringBootApp.class, args);
  }
}

Konfiguration

Programmatisk aktivering stöder samma konfigurationsalternativ som JVM-argumentaktivering, med de skillnader som beskrivs i nästa avsnitt.

Plats för konfigurationsfil

När du aktiverar Application Insights Java programmatiskt läss konfigurationsfilen applicationinsights.json som standard från classpath (src/main/resources, src/test/resources).

Från 3.4.3 kan du konfigurera namnet på en JSON-fil i klassökvägen med systemegenskapen applicationinsights.runtime-attach.configuration.classpath.file . Till exempel använder Application Insights -Dapplicationinsights.runtime-attach.configuration.classpath.file=applicationinsights-dev.json-filen för konfiguration. Så här konfigurerar du en annan fil i klassbanan programmatiskt:

public static void main(String[] args) {
    System.setProperty("applicationinsights.runtime-attach.configuration.classpath.file", "applicationinsights-dev.json");
    ApplicationInsights.attach();
    SpringApplication.run(PetClinicApplication.class, args);
}

Se konfigurationsalternativ för konfiguration av filsökväg för att ändra platsen för en fil utanför klassökvägen.

Så här konfigurerar du programmatiskt en fil utanför klassökvägen:

public static void main(String[] args) {
    System.setProperty("applicationinsights.configuration.file", "{path}/applicationinsights-dev.json");
    ApplicationInsights.attach();
    SpringApplication.run(PetClinicApplication.class, args);
}

Konfigurera anslutningssträng programmatiskt

Lägg först till beroendet applicationinsights-core :

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>applicationinsights-core</artifactId>
    <version>3.7.5</version>
</dependency>

Anropa därefter ConnectionString.configure-metoden efter ApplicationInsights.attach():

public static void main(String[] args) {
    ApplicationInsights.attach();
    ConnectionString.configure("<Your Connection String>");
    SpringApplication.run(PetClinicApplication.class, args);
}

Alternativt kan du anropa ConnectionString.configure metoden från en Spring-komponent.

Aktivera anslutningssträng som konfigureras under körning:

{
  "connectionStringConfiguredAtRuntime": true
}

Plats för självdiagnostikens loggfil

När du aktiverar Application Insights Java programmatiskt applicationinsights.log finns filen som innehåller agentloggarna som standard i katalogen där JVM startas (användarkatalog).

Information om hur du ändrar den här platsen finns i konfigurationsalternativen för självdiagnostik.