Utiliser l’agent In-process Java d’Application Insights dans Azure Spring Apps

Activez l’agent Java In-Process à l’aide de la procédure suivante.

1. Accédez à la page Service | Vue d’ensemble de votre instance de service, puis sélectionnez Application Insights dans la section Monitoring.

2. Sélectionnez Activer Application Insights pour activer Application Insights dans Azure Spring Apps.

3. Sélectionnez une instance d’Application Insights ou créez-en une.

4. Une fois Application Insights activé, vous pouvez configurer un taux d’échantillonnage facultatif (10,0 % par défaut).

   

5. Sélectionnez Enregistrer pour enregistrer la modification.

Vous pouvez utiliser le portail pour vérifier ou mettre à jour les paramètres actuels dans Application Insights.

Activer Application Insights à l’aide du portail Azure

1. Sélectionnez Application Insights.

2. Activez Application Insights en sélectionnant Modifier la liaison ou le lien hypertexte Non liée.

   

3. Modifiez Application Insights ou taux d’échantillonnage, puis sélectionnez Enregistrer.

Désactiver Application Insights

1. Sélectionnez Application Insights.

2. Sélectionnez Annuler la liaison pour désactiver Application Insights.

   

Modifier les paramètres d'Application Insights

Sélectionnez le nom sous la colonne Application Insights pour ouvrir la section Application Insights.

Modifier les liaisons des Buildpacks Application Insights dans le service de Build

Pour vérifier et mettre à jour les paramètres actuels des liaisons des Buildpacks Application Insights dans le service de Build, procédez comme suit :

1. Sélectionnez Build Service.
2. Choisissez votre générateur.
3. Sélectionnez Modifier dans la colonne Liaisons.

Les paramètres Application Insights se trouvent dans l’élément ApplicationInsights répertorié sous la colonne Type de liaison.

1. Sélectionnez le lien hypertexte Liée, ou l’option Modifier la liaison sous l’ellipse, pour ouvrir ou modifier les liaisons de Buildpacks Application Insights.

   

2. Modifiez les paramètres de liaison, puis sélectionnez Enregistrer.

   

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

Vérifier les paramètres d'Application Insights

Pour vérifier les paramètres Application Insights d’une instance existante Azure Spring Apps, utilisez la commande suivante :

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

Mettre à jour Application Insights

Pour mettre à jour Application Insights afin d’utiliser une chaîne de connexion (choix par défaut) ou une clé d’instrumentation, utilisez la commande suivante :

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>

Pour mettre à jour Application Insights afin d’utiliser le nom ou de l’ID de ressource, utilisez la commande suivante :

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

Désactiver Application Insights avec la commande update

Pour désactiver Application Insights dans une instance Azure Spring Apps existante, utilisez la commande suivante :

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

Gérer les liaisons des Buildpacks Application Insights

Cette section s’applique uniquement au plan Entreprise et fournit des instructions qui complètent la section précédente.

Le plan Entreprise d’Azure Spring Apps utilise des liaisons de buildpack pour intégrer Azure Application Insights au type ApplicationInsights. Pour plus d’informations, consultez Comment configurer l’intégration APM et les certificats d’autorité de certification.

Pour créer une liaison de Buildpack Application Insights, utilisez la commande suivante :

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>

Pour répertorier toutes les liaisons de Buildpacks et rechercher les liaisons Application Insights pour le type ApplicationInsights, utilisez la commande suivante :

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

Pour remplacer une liaison de Buildpack Application Insights, utilisez la commande suivante :

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>

Pour obtenir une liaison de Buildpack Application Insights, utilisez la commande suivante :

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>

Pour supprimer une liaison de Buildpack Application Insights, utilisez la commande suivante :

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>

Les sections suivantes décrivent l’automatisation de votre déploiement à l’aide de Bicep, de modèles Azure Resource Manager (modèles ARM) ou de Terraform.

Bicep

Pour effectuer un déploiement à l’aide d’un fichier Bicep, copiez le contenu suivant dans un fichier main.bicep. Pour plus d’informations, consultez 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
  }
}

Modèles ARM

Pour effectuer un déploiement à l’aide d’un modèle ARM, copiez le contenu suivant dans un fichier azuredeploy.json. Pour plus d’informations, consultez 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

Pour un déploiement Terraform, utilisez le modèle suivant. Pour plus d’informations, consultez 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’automatisation du plan Entreprise est en attente de prise en charge. La documentation sera ajoutée dès qu’elle sera disponible.

L’agent Java est régulièrement mis à jour/mis à niveau avec le JDK, ce qui peut affecter les scénarios suivants.

• Les applications existantes qui utilisent l’agent Java avant la mise à jour/mise à niveau ne sont pas affectées.
• Les applications créées après la mise à jour/mise à niveau utilisent la nouvelle version de l’agent Java.
• Les applications existantes qui n’utilisaient pas l’agent Java précédemment nécessitent un redémarrage ou un redéploiement pour utiliser la nouvelle version de l’agent Java.

L’agent Java est mis à jour/mis à niveau en même temps que le buildpack.

Chargement à chaud de la configuration de l’agent Java

Azure Spring Apps a un mécanisme de chargement à chaud pour ajuster les paramètres de configuration de l’agent sans redémarrer les applications.

• Si l’agent Java est déjà activé, les changements de l’instance Application Insights ou de la valeur SamplingRate ne nécessitent pas le redémarrage de l’application.

• Si vous activez l’agent Java, vous devez redémarrer les applications.

• Quand vous désactivez l’agent Java, les applications arrêtent d’envoyer toutes les données de monitoring après un retard indiqué en minutes. Vous pouvez redémarrer les applications pour supprimer l’agent de l’environnement de runtime Java.