Az Azure Monitor Application Insights használata a Spring Boot használatával

Feljegyzés

A Spring Boot natív rendszerkép-alkalmazásaival ezt a projektet használhatja.

Az Application Insights Java a Spring Boot használatával való engedélyezésére két lehetőség közül választhat: a Java Virtual Machine (JVM) argumentumot és programozott módon.

Engedélyezés JVM-argumentummal

Adja hozzá a JVM arg-et -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" valahol korábban -jar, például:

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

Spring Boot a Docker belépési ponton keresztül

Tekintse meg a tárolókkal kapcsolatos dokumentációt.

Konfiguráció

Lásd a konfigurációs beállításokat.

Programozott engedélyezés

Az Application Insights Java programozott engedélyezéséhez a következő függőséget kell hozzáadnia:

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

És hívja meg annak az attach() osztálynak a com.microsoft.applicationinsights.attach.ApplicationInsights metódusát, amely a metódus első sorában main() található.

Figyelmeztetés

A meghívásnak a metódus elején main kell lennie.

Figyelmeztetés

A JRE nem támogatott.

Figyelmeztetés

Az operációs rendszer ideiglenes könyvtárának írhatónak kell lennie.

Példa:

@SpringBootApplication
public class SpringBootApp {

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

Konfiguráció

A programozott engedélyezés ugyanazokat a konfigurációs beállításokat támogatja, mint a JVM-argumentum engedélyezése, a következő szakaszokban ismertetett különbségekkel.

Konfigurációs fájl helye

Alapértelmezés szerint az Application Insights Java programozott engedélyezésekor a konfigurációs fájl applicationinsights.json az osztályútról (src/main/resources, src/test/resources).

A 3.4.3-tól konfigurálhatja egy JSON-fájl nevét az osztályúton a applicationinsights.runtime-attach.configuration.classpath.file rendszertulajdonság használatával. Az Application Insights például -Dapplicationinsights.runtime-attach.configuration.classpath.file=applicationinsights-dev.jsona fájlt használja a applicationinsights-dev.json konfigurációhoz. Egy másik fájl programozott konfigurálása az osztályúton:

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

Feljegyzés

A Spring-fájlok application.propertiesapplication.yaml nem támogatottak az Application Insights Java-konfigurációjának forrásaiként.

A konfigurációs fájl elérési útjának konfigurációs beállításaival módosíthatja a fájl helyét az osztályútvonalon kívül.

A classpathon kívüli fájl programozott konfigurálása:

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

Programozott módon konfigurálja a kapcsolati sztring

Először adja hozzá a applicationinsights-core függőséget:

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

Ezután hívja meg a metódust a ConnectionString.configure következő után ApplicationInsights.attach():

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

Másik lehetőségként hívja meg a ConnectionString.configure metódust egy Spring-összetevőből.

A futtatókörnyezetben konfigurált kapcsolati sztring engedélyezése:

{
  "connectionStringConfiguredAtRuntime": true
}

Öndiagnosztikai naplófájl helye

Alapértelmezés szerint az Application Insights Java programozott engedélyezésekor az applicationinsights.log ügynöknaplókat tartalmazó fájl abban a könyvtárban található, ahonnan a JVM elindul (felhasználói könyvtár).

Ha meg szeretné tudni, hogyan módosíthatja ezt a helyet, tekintse meg az öndiagnosztikai konfigurációs beállításokat.