Korzystanie z agenta wewnątrzprocesowego Java usługi Application Insights w usłudze Azure Spring Apps

Włącz agenta przetwarzania w języku Java, korzystając z poniższej procedury.

1. Przejdź do usługi | Strona Przegląd wystąpienia usługi, a następnie wybierz pozycję Aplikacja Szczegółowe informacje w sekcji Monitorowanie.

2. Wybierz pozycję Włącz Szczegółowe informacje aplikacji, aby włączyć Szczegółowe informacje aplikacji w usłudze Azure Spring Apps.

3. Wybierz istniejące wystąpienie aplikacji Szczegółowe informacje lub utwórz nowe.

4. Po włączeniu Szczegółowe informacje aplikacji można skonfigurować jedną opcjonalną częstotliwość próbkowania (domyślnie 10,0%).

   

5. Wybierz przycisk Zapisz, aby zapisać zmiany.

Za pomocą portalu możesz sprawdzić lub zaktualizować bieżące ustawienia w Szczegółowe informacje aplikacji.

Włączanie Szczegółowe informacje aplikacji przy użyciu witryny Azure Portal

1. Wybierz pozycję Application Insights.

2. Włącz Szczegółowe informacje aplikacji, wybierając pozycję Edytuj powiązanie lub hiperlink Unbound.

   

3. Edytuj Szczegółowe informacje aplikacji lub częstotliwość próbkowania, a następnie wybierz pozycję Zapisz.

Wyłączanie Szczegółowe informacje aplikacji

1. Wybierz pozycję Application Insights.

2. Wybierz pozycję Usuń powiązanie, aby wyłączyć Szczegółowe informacje aplikacji.

   

Zmienianie Szczegółowe informacje Ustawienia aplikacji

Wybierz nazwę w kolumnie Application Szczegółowe informacje (Aplikacja), aby otworzyć sekcję Application Szczegółowe informacje (Aplikacja Szczegółowe informacje).

Edytowanie powiązań pakietu buildpack Szczegółowe informacje aplikacji w usłudze Build Service

Aby sprawdzić i zaktualizować bieżące ustawienia powiązań pakietu kompilacji application Szczegółowe informacje w usłudze Build Service, wykonaj następujące kroki:

1. Wybierz pozycję Skompiluj usługę.
2. Wybierz konstruktora.
3. Wybierz pozycję Edytuj w kolumnie Powiązania.

Ustawienia Szczegółowe informacje aplikacji znajdują się w elemencie Application Szczegółowe informacje wymienionym w kolumnie Typ powiązania.

1. Wybierz hiperłącze Powiązane lub wybierz pozycję Edytuj powiązanie w wielokropku, aby otworzyć i edytować powiązania pakietu kompilacji Szczegółowe informacje aplikacji.

   

2. Edytuj ustawienia powiązania, a następnie wybierz pozycję Zapisz.

   

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

Sprawdzanie ustawień Szczegółowe informacje aplikacji

Aby sprawdzić ustawienia aplikacji Szczegółowe informacje istniejącego wystąpienia usługi Azure Spring Apps, użyj następującego polecenia:

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

Aktualizowanie Szczegółowe informacje aplikacji

Aby zaktualizować Szczegółowe informacje aplikacji do używania klucza parametry połączenia (preferowanego) lub instrumentacji, użyj następującego polecenia:

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>

Aby zaktualizować Szczegółowe informacje aplikacji, aby użyć nazwy zasobu lub identyfikatora, użyj następującego polecenia:

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

Wyłączanie Szczegółowe informacje aplikacji za pomocą polecenia update

Aby wyłączyć Szczegółowe informacje aplikacji w istniejącym wystąpieniu usługi Azure Spring Apps, użyj następującego polecenia:

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

Zarządzanie powiązaniami pakietu buildpack Szczegółowe informacje aplikacji

Ta sekcja dotyczy tylko planu Enterprise i zawiera instrukcje uzupełniające poprzednią sekcję.

Plan usługi Azure Spring Apps Enterprise używa powiązań buildpack do integracji aplikacja systemu Azure Szczegółowe informacje z typem ApplicationInsights. Aby uzyskać więcej informacji, zobacz How to configure APM integration and CA certificates (Jak skonfigurować integrację aPM i certyfikaty urzędu certyfikacji).

Aby utworzyć powiązanie pakietu buildpack Szczegółowe informacje aplikacji, użyj następującego polecenia:

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>

Aby wyświetlić listę wszystkich powiązań pakietu buildpack i znaleźć powiązania aplikacji Szczegółowe informacje typu ApplicationInsights, użyj następującego polecenia:

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

Aby zastąpić powiązanie application Szczegółowe informacje buildpack, użyj następującego polecenia:

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>

Aby uzyskać powiązanie pakietu buildpack Szczegółowe informacje aplikacji, użyj następującego polecenia:

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>

Aby usunąć powiązanie pakietu buildpack Szczegółowe informacje aplikacji, użyj następującego polecenia:

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>

W poniższych sekcjach opisano, jak zautomatyzować wdrożenie przy użyciu szablonów Bicep, Azure Resource Manager (szablonów usługi ARM) lub narzędzia Terraform.

Bicep

Aby wdrożyć przy użyciu pliku Bicep, skopiuj następującą zawartość do pliku main.bicep . Aby uzyskać więcej informacji, zobacz Microsoft.AppPlatform Spring/monitoring Ustawienia.

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
  }
}

Szablony usługi ARM

Aby wdrożyć przy użyciu szablonu usługi ARM, skopiuj następującą zawartość do pliku azuredeploy.json . Aby uzyskać więcej informacji, zobacz Microsoft.AppPlatform Spring/monitoring Ustawienia.

{
  "$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

W przypadku wdrożenia programu Terraform użyj następującego szablonu. Aby uzyskać więcej informacji, zobacz 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"
  }
}

Automatyzacja w planie Enterprise oczekuje na pomoc techniczną. Dokumentacja jest dodawana natychmiast po udostępniu.

Agent Języka Java jest regularnie aktualizowany/uaktualniany przy użyciu zestawu JDK, co może mieć wpływ na następujące scenariusze.

• Nie ma to wpływu na istniejące aplikacje korzystające z agenta Java przed aktualizacją/uaktualnieniem.
• Aplikacje utworzone po zaktualizowaniu/uaktualnieniu używają nowej wersji agenta Java.
• Istniejące aplikacje, które wcześniej nie korzystały z agenta Java, wymagają ponownego uruchomienia lub ponownego wdrożenia, aby użyć nowej wersji agenta Języka Java.

Agent Języka Java jest aktualizowany/uaktualniany po zaktualizowaniu pakietu buildpack.

Konfiguracja agenta Java — ładowanie na gorąco

Usługa Azure Spring Apps ma mechanizm ładowania gorącego w celu dostosowania ustawień konfiguracji agenta bez ponownego uruchamiania aplikacji.

• Jeśli agent Java jest już włączony, zmiany w wystąpieniu aplikacji Szczegółowe informacje lub SamplingRate wartości nie wymagają ponownego uruchomienia aplikacji.

• Jeśli włączysz agenta Java, musisz ponownie uruchomić aplikacje.

• Po wyłączeniu agenta Java aplikacje przestają wysyłać wszystkie dane monitorowania po upływie kilku minut. Możesz ponownie uruchomić aplikacje, aby usunąć agenta ze środowiska uruchomieniowego Java.