Använda Application Insights Java In-Process Agent i Azure Spring Apps

Aktivera Java In-Process Agent med hjälp av följande procedur.

1. Gå till tjänsten | Översiktssida för tjänstinstansen och välj sedan Application Insights i avsnittet Övervakning .

2. Välj Aktivera Application Insights för att aktivera Application Insights i Azure Spring Apps.

3. Välj en befintlig instans av Application Insights eller skapa en ny.

4. När Application Insights är aktiverat kan du konfigurera en valfri samplingsfrekvens (standardvärdet 10,0 %).

   

5. Spara ändringarna genom att klicka på Spara.

Du kan använda portalen för att kontrollera eller uppdatera de aktuella inställningarna i Application Insights.

Aktivera Application Insights med hjälp av Azure Portal

1. Välj Application Insights.

2. Aktivera Application Insights genom att välja Redigera bindning eller hyperlänken Obundet.

   

3. Redigera Application Insights eller Samplingsfrekvens och välj sedan Spara.

Inaktivera Application Insights

1. Välj Application Insights.

2. Välj Ta bort bindning för att inaktivera Application Insights.

   

Ändra Application Insights-inställningar

Välj namnet under kolumnen Application Insights för att öppna avsnittet Application Insights.

Redigera Application Insights buildpack-bindningar i Build Service

Följ dessa steg för att kontrollera och uppdatera de aktuella inställningarna för Application Insights buildpack-bindningar i Build Service:

1. Välj Byggtjänst.
2. Välj din byggare.
3. Välj Redigera under kolumnen Bindningar.

Application Insights-inställningar finns i applicationinsights-objektet som visas under kolumnen Bindningstyp.

1. Välj den bundna hyperlänken eller välj Redigera bindning under ellipsen för att öppna och redigera Application Insights buildpack-bindningar.

   

2. Redigera bindningsinställningarna och välj sedan Spara.

   

az spring create \
    --resource-group <resource-group-name> \
    --name "service-instance-name" \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate>

az spring create \
    --resource-group <resource-group-name> \
    --name "service-instance-name" \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate> \
    --sku Enterprise

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate>

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate> \
    --sku Enterprise

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable-app-insights

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable-app-insights \
    --sku Enterprise

Kontrollera Application Insights-inställningarna

Om du vill kontrollera Application Insights-inställningarna för en befintlig Azure Spring Apps-instans använder du följande kommando:

az spring app-insights show \
    --resource-group <resource-group-name> \
    --name <service-instance-name>

Uppdatera Application Insights

Om du vill uppdatera Application Insights till att använda en anslutningssträng (önskad) eller instrumentationsnyckel använder du följande kommando:

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate>

Om du vill uppdatera Application Insights för att använda resursnamnet eller ID:t använder du följande kommando:

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate>

Inaktivera Application Insights med uppdateringskommandot

Om du vill inaktivera Application Insights på en befintlig Azure Spring Apps-instans använder du följande kommando:

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable

Hantera Application Insights buildpack-bindningar

Det här avsnittet gäller endast enterprise-planen och innehåller instruktioner som kompletterar föregående avsnitt.

Azure Spring Apps Enterprise-planen använder buildpack-bindningar för att integrera Azure Application Insights med typen ApplicationInsights. Mer information finns i Konfigurera APM-integrering och CA-certifikat.

Om du vill skapa en Application Insights buildpack-bindning använder du följande kommando:

az spring build-service builder buildpack-binding create \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Om du vill visa en lista över alla buildpack-bindningar och hitta Application Insights-bindningar av typen ApplicationInsightsanvänder du följande kommando:

az spring build-service builder buildpack-binding list \
    --resource-group <your-resource-group-name> \
    --service <your-service-resource-name> \
    --builder-name <your-builder-name>

Om du vill ersätta en Application Insights buildpack-bindning använder du följande kommando:

az spring build-service builder buildpack-binding set \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Använd följande kommando för att hämta en Application Insights buildpack-bindning:

az spring build-service builder buildpack-binding show \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name>

Om du vill ta bort en Application Insights buildpack-bindning använder du följande kommando:

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name>

I följande avsnitt beskrivs hur du automatiserar distributionen med hjälp av Bicep, Azure Resource Manager-mallar (ARM-mallar) eller Terraform.

Bicep

Om du vill distribuera med en Bicep-fil kopierar du följande innehåll till en main.bicep-fil . Mer information finns i Microsoft.AppPlatform Spring/monitoringSettings.

param springName string
param location string = resourceGroup().location

resource spring 'Microsoft.AppPlatform/Spring@2020-07-01' = {
  name: springName
  location: location
  properties: {}
}

resource monitorSetting 'Microsoft.AppPlatform/Spring/monitoringSettings@2020-11-01-preview' = {
  parent: spring
  name: 'default'
  properties: {
    appInsightsInstrumentationKey: '00000000-0000-0000-0000-000000000000'
    appInsightsSamplingRate: 88
  }
}

ARM-mallar

Om du vill distribuera med hjälp av en ARM-mall kopierar du följande innehåll till en azuredeploy.json fil. Mer information finns i Microsoft.AppPlatform Spring/monitoringSettings.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "springName": {
      "type": "string"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.AppPlatform/Spring",
      "apiVersion": "2020-07-01",
      "name": "[parameters('springName')]",
      "location": "[parameters('location')]",
      "properties": {}
    },
    {
      "type": "Microsoft.AppPlatform/Spring/monitoringSettings",
      "apiVersion": "2020-11-01-preview",
      "name": "[format('{0}/{1}', parameters('springName'), 'default')]",
      "properties": {
        "appInsightsInstrumentationKey": "00000000-0000-0000-0000-000000000000",
        "appInsightsSamplingRate": 88
      },
      "dependsOn": [
        "[resourceId('Microsoft.AppPlatform/Spring', parameters('springName'))]"
      ]
    }
  ]
}

Terraform

Använd följande mall för en Terraform-distribution. Mer information finns i azurerm_spring_cloud_service.

provider "azurerm" {
  features {}
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_application_insights" "example" {
  name                = "tf-test-appinsights"
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name
  application_type    = "web"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "example-springcloud"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  sku_name            = "S0"

  config_server_git_setting {
    uri          = "https://github.com/Azure-Samples/piggymetrics"
    label        = "config"
    search_paths = ["dir1", "dir2"]
  }

  trace {
    connection_string = azurerm_application_insights.example.connection_string
    sample_rate       = 10.0
  }

  tags = {
    Env = "staging"
  }
}

Automation i Enterprise-planen väntar på support. Dokumentationen läggs till så snart den är tillgänglig.

Java-agenten uppdateras/uppgraderas regelbundet med JDK:t, vilket kan påverka följande scenarier.

• Befintliga program som använder Java-agenten innan de uppdaterar/uppgraderar påverkas inte.
• Program som skapats efter uppdatering/uppgradering använder den nya versionen av Java-agenten.
• Befintliga program som inte tidigare använde Java-agenten kräver omstart eller omdistribution för att använda den nya versionen av Java-agenten.

Java-agenten uppdateras/uppgraderas när buildpack uppdateras.

Frekvent inläsning av Java-agentkonfiguration

Azure Spring Apps har en mekanism för snabb inläsning för att justera inställningarna för agentkonfigurationen utan omstart av program.

• Om Java-agenten redan är aktiverad kräver ändringar i Application Insights-instansen eller SamplingRate värdet inte att programmet startas om.

• Om du aktiverar Java-agenten måste du starta om program.

• När du inaktiverar Java-agenten slutar program att skicka alla övervakningsdata efter en fördröjning på några minuter. Du kan starta om program för att ta bort agenten från Java-körningsmiljön.