Uppgradera från Application Insights Java 2.x SDK

Det finns vanligtvis inga kodändringar när du uppgraderar till 3.x. 3.x SDK-beroenden är no-op API-versioner av 2.x SDK-beroenden. Men när den används med 3.x Java-agenten tillhandahåller 3.x Java-agenten implementeringen för dem. Därför korreleras din anpassade instrumentation med all ny autoinstrumentation som tillhandahålls av 3.x Java-agenten.

Steg 1: Uppdatera beroenden

Steg 2: Lägg till 3.x Java-agenten

Lägg till Java-agenten version 3.x i kommandoradsargumenten för din Java Virtual Machine (JVM), till exempel:

-javaagent:path/to/applicationinsights-agent-3.7.5.jar

Om du använder Application Insights 2.x Java-agenten ersätter du bara din befintliga -javaagent:... med föregående exempel.

Steg 3: Konfigurera din Application Insights-anslutningssträng

Se konfigurera anslutningssträng.

Andra noteringar

Resten av det här dokumentet beskriver begränsningar och ändringar som du kan stöta på när du uppgraderar från 2.x till 3.x och några lösningar som du kan ha nytta av.

telemetriinitialiserare

2.x SDK TelemetryInitializers körs inte när du använder 3.x-agenten. Många av de användningsfall som tidigare krävde att skriva en TelemetryInitializer kan lösas i Application Insights Java 3.x genom att konfigurera anpassade dimensioner. Eller använda ärvda attribut.

Telemetribearbetare

2.x SDK TelemetryProcessors körs inte när du använder 3.x-agenten. Många av de användningsfall som tidigare krävde skrivning av en TelemetryProcessor kan lösas i Application Insights Java 3.x genom att konfigurera samplingsåtsidosättningar.

Flera program i en enda JVM

Det här användningsfallet stöds i Application Insights Java 3.x med åsidosättningar av molnrollnamn (förhandsversion) och/eller åsidosättningar av anslutningssträngar (förhandsversion).

Åtgärdsnamn

I Application Insights Java 2.x SDK innehöll åtgärdsnamnen i vissa fall den fullständiga sökvägen, till exempel:

Åtgärdsnamn i Application Insights Java 3.x har ändrats för att i allmänhet ge en bättre aggregerad vy i Application Insights Portal U/X, till exempel:

Men för vissa program kanske du fortfarande föredrar den aggregerade vyn i U/X som tillhandahölls av de tidigare åtgärdsnamnen. I det här fallet kan du använda telemetriprocessorfunktionen (förhandsversion) i 3.x för att replikera det tidigare beteendet.

Följande kodfragment konfigurerar tre telemetriprocessorer som kombineras för att replikera det tidigare beteendet. Telemetriprocessorerna utför följande åtgärder (i ordning):

1. Den första telemetriprocessorn är en attributprocessor (har typen attribute), vilket innebär att den gäller för all telemetri som har attribut (för närvarande requests och dependencies, men snart också traces).

   Den matchar all telemetri som har attribut med namnet http.request.method och url.path.

   Sedan extraheras url.path attributet till ett nytt attribut med namnet tempName.

2. Den andra telemetriprocessorn är en span-processor (har typen span), vilket innebär att den gäller för requests och dependencies.

   Den matchar alla intervall som har ett attribut med namnet tempPath.

   Sedan uppdateras span-namnet från attributet tempPath.

3. Den sista telemetriprocessorn är en attributprocessor, samma typ som den första telemetriprocessorn.

   Den matchar all telemetri som har ett attribut med namnet tempPath.

   Sedan raderas attributet med namnet tempPath. Attributet visas som en anpassad dimension.

{
  "preview": {
    "processors": [
      {
        "type": "attribute",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "http.request.method" },
            { "key": "url.path" }
          ]
        },
        "actions": [
          {
            "key": "url.path",
            "pattern": "https?://[^/]+(?<tempPath>/[^?]*)",
            "action": "extract"
          }
        ]
      },
      {
        "type": "span",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "tempPath" }
          ]
        },
        "name": {
          "fromAttributes": [ "http.request.method", "tempPath" ],
          "separator": " "
        }
      },
      {
        "type": "attribute",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "tempPath" }
          ]
        },
        "actions": [
          { "key": "tempPath", "action": "delete" }
        ]
      }
    ]
  }
}

Sampling och saknade loggar

Hastighetsbegränsad sampling är aktiverad som standard från och med agent 3.4, vilket kan orsaka att loggar saknas oväntat.

Projektexempel

Det här Java 2.x SDK-projektet migreras till ett nytt projekt med hjälp av 3.x Java-agenten.