Usar o Agente Java em processo do Application Insights no Azure Spring Apps

Habilite o agente em processo do Java usando o procedimento a seguir.

1. Vá para a página serviço | Visão geral da instância de serviço e, em seguida, selecione Application Insights na seção Monitoramento.

2. Selecione Habilitar Application Insights para habilitar o Application Insights no Azure Spring Apps.

3. Escolha uma instância existente do Application Insights ou crie uma nova.

4. Quando o Application Insights está habilitado, você pode configurar uma taxa de amostragem opcional (padrão 10%).

   

5. Selecione Salvar para salvar as alterações.

Você pode usar o Portal para verificar ou atualizar as configurações atuais no Application Insights.

Habilitar o Application Insights usando o portal do Azure

1. Selecione Application Insights.

2. Habilitar o Insights aplicativo selecionando Editar vinculação ou o hiperlink Desvincular.

   

3. Edite o Application Insights ou a Taxa de Amostragem e selecione Salvar.

Desabilitar o Application Insights

1. Selecione Application Insights.

2. Selecione Desvincular associação para desabilitar o Application Insights.

   

Alterar as configurações do Application Insights

Selecione o nome na coluna Aplicativo Insights para abrir a seção do Aplicativo Insights.

Editar as associações de buildpack do Application Insights no Serviço Build

Para verificar e atualizar as configurações atuais das associações de buildpack do Application Insights no Serviço Build, siga estas etapas:

1. Selecione Build Service.
2. Escolha seu construtor.
3. Selecione Editar na coluna Associações.

As configurações do Application Insights são encontradas no item ApplicationInsights listado na coluna Tipo de associação.

1. Selecione o hiperlink Associado ou selecione Editar Associação na elipse para abrir e editar as associações de buildpack do Application Insights.

   

2. Edite as configurações de associação e selecione Salvar.

   

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

Verificar as configurações do Application Insights

Para verificar as configurações do Application Insights de uma instância existente do Azure Spring Apps, use o seguinte comando:

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

Atualizar o Application Insights

A fim de atualizar o Application Insights para usar uma cadeia de conexão (preferencial) ou uma chave de instrumentação, use o comando a seguir:

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>

A fim de atualizar o Application Insights para usar o nome ou a ID do recurso, use o comando a seguir:

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

Desabilitar o Application Insights com o comando update

Para desabilitar o Application Insights em uma instância existente do Azure Spring Apps, use o seguinte comando:

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

Gerenciar associações de buildpack do Application Insights

Esta seção se aplica somente ao plano Enterprise e fornece instruções que complementam a seção anterior.

O plano Enterprise dos Aplicativos Spring do Azure usa associações de buildpack para integrar o Azure Application Insights ao tipo ApplicationInsights. Para obter mais informações, consulte Como configurar a integração do APM e os certificados de AC.

Para criar uma associação de buildpack do Application Insights, use o seguinte comando:

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>

Para listar todas as associações de buildpack e encontrar as associações do Application Insights de tipo ApplicationInsights, use o seguinte comando:

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

Para substituir uma associação de buildpack do Application Insights, use o seguinte comando:

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>

Para obter uma associação de buildpack do Application Insights, use o seguinte comando:

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>

Para excluir uma associação de buildpack do Application Insights, use o seguinte comando:

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>

As seções a seguir descrevem como automatizar a implantação usando o Bicep, os modelos do ARM (Azure Resource Manager) ou o Terraform.

Bicep

Para implantar usando um arquivo Bicep, copie o conteúdo a seguir em um arquivo main.bicep. Para obter mais informações, confira 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
  }
}

Modelos do ARM

Para implantar usando um modelo do ARM, copie o conteúdo a seguir em um arquivo azuredeploy.json. Para obter mais informações, confira 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

Para uma implantação do Terraform, use o modelo a seguir. Para obter mais informações, confira 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"
  }
}

A automação no plano Enterprise está com suporte pendente. A documentação é adicionada assim que estiver disponível.

O agente Java é atualizado/atualizado regularmente com o JDK, o que pode afetar os cenários a seguir.

• Aplicativos existentes que usam o agente Java antes da atualização/atualização não são afetados.
• Os aplicativos criados após a atualização/atualização usam a nova versão do agente Java.
• Aplicativos existentes que não usavam anteriormente o agente Java exigem reinicialização ou reimplantação para usar a nova versão do agente Java.

O agente Java é atualizado/atualizado quando o buildpack é atualizado.

Carregamento frequente da configuração do agente Java

Os Aplicativos Spring do Azure têm um mecanismo de carregamento frequente para ajustar as configurações de configuração do agente sem reiniciar aplicativos.

• Se o agente Java já estiver habilitado, as alterações na instância do Application Insights ou valor SamplingRate não exigirão a reinicialização do aplicativo.

• Se habilitar o agente Java, você deve reiniciar os aplicativos.

• Quando você desabilitar o agente Java, os aplicativos param de enviar todos os dados de monitoramento após um atraso em minutos. Você pode reiniciar os aplicativos para remover o agente do ambiente de runtime do Java.