Usare l'agente Java In-Process di Application Insights in Azure Spring Apps

Abilitare l'agente In-Process Java usando la procedura seguente.

1. Andare alla pagina servizio | Panoramica dell'istanza del servizio quindi selezionare Application Insights nella sezione Monitoraggio.

2. Selezionare Abilita Application Insights per abilitare Application Insights in Azure Spring Apps.

3. Selezionare un'istanza esistente di Application Insights o crearne una nuova.

4. Quando Application Insights è abilitato, è possibile configurare una frequenza di campionamento facoltativa (10,0%).

   

5. Selezionare Salva per salvare le modifiche.

È possibile usare il portale per controllare o aggiornare le impostazioni correnti in Application Insights.

Abilitare Application Insights tramite il portale di Azure

1. Selezionare Application Insights.

2. Abilitare Application Insights selezionando Modifica associazione o il collegamento ipertestuale Non associato.

   

3. Modificare Application Insights o Frequenza di campionamento, quindi selezionare Salva.

Disabilitare Application Insights

1. Selezionare Application Insights.

2. Selezionare Annulla associazione per disabilitare Application Insights.

   

Modificare le impostazioni di Application Insights

Selezionare il nome nella colonna Application Insights per aprire la sezione Application Insights.

Modificare le associazioni buildpack di Application Insights nel servizio di compilazione

Per controllare e aggiornare le impostazioni correnti per le associazioni buildpack di Application Insights nel servizio di compilazione, seguire questa procedura:

1. Selezionare Compila servizio.
2. Scegliere il generatore.
3. Selezionare Modifica nella colonna Associazioni.

Le impostazioni di Application Insights sono disponibili nell'elemento ApplicationInsights elencato nella colonna Tipo di associazione.

1. Selezionare il collegamento ipertestuale Associato, oppure selezionare Modifica associazione sotto i puntini di sospensione per aprire e modificare le associazioni buildpack di Application Insights.

   

2. Modificare le impostazioni di associazione quindi selezionare Salva.

   

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

Verificare le impostazioni di Application Insights

Per controllare le impostazioni di Application Insights di un'istanza di Azure Spring Apps esistente, usare il comando seguente:

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

Aggiornare Application Insights

Per aggiornare Application Insights per usare una stringa di connessione (preferita) o una chiave di strumentazione, usare il comando seguente:

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>

Per aggiornare Application Insights per usare il nome o l'ID della risorsa, usare il comando seguente:

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

Disabilitare Application Insights con il comando di aggiornamento

Per disabilitare Application Insights in un'istanza di Azure Spring Apps esistente, usare il comando seguente:

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

Gestire le associazioni buildpack di Application Insights

Questa sezione si applica solo al piano Enterprise e fornisce istruzioni che integrano la sezione precedente.

Il piano Enterprise di Azure Spring Apps usa associazioni buildpack per integrare Azure Application Insights con il tipo ApplicationInsights. Per altre informazioni, vedere Come configurare l'integrazione di APM e i certificati CA.

Per creare un'associazione buildpack di Application Insights, usare il comando seguente:

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>

Per elencare tutte le associazioni buildpack e trovare associazioni di Application Insights del tipo ApplicationInsights, usare il comando seguente:

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

Per sostituire un'associazione buildpack di Application Insights, usare il comando seguente:

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>

Per ottenere un'associazione buildpack di Application Insights, usare il comando seguente:

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>

Per eliminare un'associazione buildpack di Application Insights, usare il comando seguente:

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>

Le sezioni seguenti descrivono come automatizzare la distribuzione usando Bicep, i modelli di Azure Resource Manager (modelli di ARM) o Terraform.

Bicep

Per eseguire la distribuzione usando un file Bicep, copiare il contenuto seguente in un file main.bicep. Per altre informazioni, vedere 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
  }
}

Modelli di Gestione risorse di Azure

Per eseguire la distribuzione usando un modello di ARM, copiare il contenuto seguente in un file azuredeploy.json. Per altre informazioni, vedere 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

Per una distribuzione Terraform, usare il modello seguente. Per altre informazioni, vedere 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"
  }
}

L'automazione nel piano Enterprise è in sospeso. La documentazione viene aggiunta non appena è disponibile.

L'agente Java viene aggiornato/aggiornato regolarmente con JDK, che può influire sugli scenari seguenti.

• Le applicazioni esistenti che usano l'agente Java prima dell'aggiornamento o dell'aggiornamento non sono interessate.
• Le applicazioni create dopo l'aggiornamento/aggiornamento usano la nuova versione dell'agente Java.
• Le applicazioni esistenti che in precedenza non usano l'agente Java richiedono il riavvio o la ridistribuzione per usare la nuova versione dell'agente Java.

L'agente Java viene aggiornato/aggiornato quando viene aggiornato il pacchetto di compilazione.

Caricamento rapido della configurazione dell'agente Java

Azure Spring Apps include un meccanismo di caricamento frequente per modificare le impostazioni della configurazione dell'agente senza riavviare le applicazioni.

• Se l'agente Java è già abilitato, le modifiche apportate all'istanza o al valore SamplingRate di Application Insights non richiedono il riavvio dell'applicazione.

• Se si abilita l'agente Java, è necessario riavviare le applicazioni.

• Quando si disabilita l'agente Java, le applicazioni arresteranno l'invio di tutti i dati di monitoraggio dopo un ritardo in minuti. È possibile riavviare le applicazioni per rimuovere l'agente dall'ambiente di runtime Java.