Options de stockage et de supervision des journaux dans Azure Container Apps

Configurer les options de journalisation

Procédez comme suit pour configurer les options de journalisation de votre environnement dans le portail Azure :

1. Accédez à votre environnement Container Apps dans le portail.

2. Sélectionnez Surveillance>Options de journalisation.

3. Vous pouvez toutefois choisir parmi les options Destination des journaux suivantes :

   • Azure Log Analytics : avec cette option, vous sélectionnez un espace de travail Log Analytics pour stocker vos données de journal. Vos journaux peuvent être consultés via des requêtes Log Analytics. Pour en savoir plus sur Log Analytics, consultez Azure Monitor Log Analytics.
   • Azure Monitor : Azure Monitor route vos journaux vers une destination. Lorsque vous sélectionnez cette option, vous devez sélectionner Paramètres de diagnostic pour terminer la configuration après avoir sélectionné Enregistrer sur cette page.
   • N’enregistrez pas les journaux : cette option désactive le stockage des données des journaux.

4. Sélectionnez Enregistrer.

Paramètres de diagnostic

Si vous avez sélectionné Azure Monitor comme destination des journaux d’activité, vous devez également configurer les paramètres de diagnostic. Vous pouvez configurer les paramètres de diagnostic au niveau de l’environnement et au niveau de l’application conteneur.

Configurer les paramètres de diagnostic au niveau de l’environnement

Procédez comme suit pour configurer les paramètres de diagnostic de votre environnement :

1. Accédez à votre environnement dans le portail.

2. Sélectionnez Supervision>Paramètres de diagnostic. Si vous venez de définir la destination des journaux de votre environnement sur Azure Monitor, vous devrez peut-être actualiser la page pour que cet élément de configuration apparaisse.

Les détails de destination sont enregistrés en tant que paramètres de diagnostic. Vous pouvez créer jusqu’à cinq paramètres de diagnostic pour votre environnement. Vous pouvez configurer différentes catégories de journaux pour chaque paramètre de diagnostic. Par exemple, créez un paramètre de diagnostic pour envoyer la catégorie des journaux système vers une destination et une autre pour envoyer la catégorie de journaux de console de conteneur vers une autre destination.

Pour créer un paramètre de diagnostic :

1. Sélectionnez Ajouter le paramètre de diagnostic.

2. Dans le nom du paramètre de diagnostic, entrez un nom pour votre paramètre de diagnostic.

3. Sélectionnez le journal Groupes de catégories ou Catégories que vous souhaitez envoyer à cette destination. Vous pouvez sélectionner une ou plusieurs catégories.

4. Si vous souhaitez envoyer des métriques au niveau de l’application, sélectionnez Metrics>AllMetrics.

5. Sélectionner un ou plusieurs Détails de destination :

   • Envoyer à l’espace de travail Log Analytics : Sélectionnez parmi les espaces de travail Log Analytics existants.
   • Archiver dans un compte de stockage : sélectionnez des comptes de stockage Azure.
   • Diffuser en continu vers un Event Hub : effectuez une sélection parmi les Event Hubs Azure.
   • Envoyer vers une solution de partenaire : effectuez une sélection parmi des solutions de partenaires Azure.

6. Sélectionnez Enregistrer.

Pour plus d’informations sur les paramètres de diagnostic, consultez Paramètres de diagnostic dans Azure Monitor.

Configurer les paramètres de diagnostic au niveau de l’application conteneur

Procédez comme suit pour configurer les paramètres de diagnostic de votre application conteneur :

1. Accédez à votre application conteneur dans le portail.

2. Sélectionnez Supervision>Paramètres de diagnostic. Si vous venez de définir la destination des journaux d’activité de votre environnement d’application conteneur sur Azure Monitor, vous devrez peut-être actualiser la page pour que cet élément de configuration apparaisse.

3. Sélectionnez Ajouter le paramètre de diagnostic.

4. Dans le nom du paramètre de diagnostic, entrez un nom pour votre paramètre de diagnostic.

5. Sous Métriques, sélectionnez AllMetrics.

6. Sélectionner un ou plusieurs Détails de destination :

   • Envoyer à l’espace de travail Log Analytics : Sélectionnez parmi les espaces de travail Log Analytics existants.
   • Archiver dans un compte de stockage : sélectionnez un compte de stockage.
   • Diffuser en continu vers un Event Hub : effectuez une sélection parmi les Event Hubs Azure.
   • Envoyer vers une solution de partenaire : effectuez une sélection parmi des solutions de partenaires Azure.

7. Sélectionnez Enregistrer.

Configurer les options de journalisation

Configurez la destination des journaux pour votre environnement Container Apps à l’aide des commandes Azure CLI az containerapp create et az containerapp update avec l’argument --logs-destination.

Commencez par inscrire l’espace de noms Microsoft.Insights.

az provider register --namespace Microsoft.Insights

Envoyer à un espace de travail Log Analytics

Pour créer un environnement Container Apps à l’aide d’un espace de travail Log Analytics existant comme destination des journaux, exécutez la commande suivante. Remplacez les <PLACEHOLDERS> par vos valeurs. Vous pouvez obtenir l’ID de ressource de l’espace de travail Log Analytics à partir de la page de l’espace de travail Log Analytics dans le portail Azure ou à partir de la az monitor log-analytics workspace show commande.

az containerapp env create \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination log-analytics \
  --logs-workspace-id <LOG_ANALYTICS_WORKSPACE_ID>

L’argument --logs-destination accepte les valeurs log-analytics, azure-monitoret none.

Envoyer à Azure Monitor

Pour mettre à jour un environnement Container Apps existant pour utiliser Azure Monitor comme destination des journaux d’activité, exécutez la commande suivante. Remplacez les <PLACEHOLDERS> par vos valeurs :

az containerapp env update \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination azure-monitor

Configurer les paramètres de diagnostic

Quand --logs-destination est défini sur azure-monitor, vous devez créer des paramètres de diagnostic pour configurer les détails de la destination des catégories de journaux à l’aide de la commande az monitor diagnostics-settings. Vous pouvez configurer ces paramètres de diagnostic au niveau de l’environnement et au niveau de l’application conteneur.

Pour créer des paramètres de diagnostic au niveau de l’environnement, exécutez la commande suivante. Remplacez les <PLACEHOLDERS> par vos valeurs. Vous pouvez obtenir l’ID d’environnement à partir de la page Environnement dans le portail Azure ou à partir de la az containerapp env show commande.

az monitor diagnostic-settings create \
  --name "AllMetricsToLogAnalytics" \
  --resource <ENVIRONMENT_ID> \
  --logs '[{"categoryGroup":"allLogs","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]' \
  --workspace <LOG_ANALYTICS_RESOURCE_ID>

Assurez-vous qu’il n’existe aucun espace dans les valeurs JSON fournies aux paramètres --logs et --metrics.

Pour le --logs paramètre, vous pouvez spécifier category ou categoryGroup, mais pas les deux à la fois. Pour categoryGroup, les valeurs disponibles sont audit et allLogs. Pour category, les valeurs disponibles sont ContainerAppConsoleLogs et ContainerAppSystemLogs.

Pour le --metrics paramètre, la seule catégorie disponible est AllMetrics.

Pour plus d’informations, consultez LogSettings et MetricSettings.

Pour créer des paramètres de diagnostic au niveau de l’application conteneur, exécutez la commande suivante. Remplacez les <PLACEHOLDERS> par vos valeurs. Vous pouvez obtenir l’ID d’application conteneur à partir du portail Azure ou à partir de la az containerapp show commande.

Lors de la création de paramètres de diagnostic au niveau de l’application conteneur, le --logs paramètre n’est pas pris en charge et pour le --metrics paramètre, la seule catégorie disponible est AllMetrics.

az monitor diagnostic-settings create \
--name "AllMetricsToLogAnalytics" \
--resource <CONTAINER_APP_ID> \
--metrics '[{"category":"AllMetrics","enabled":true}]' \
--workspace <LOG_ANALYTICS_RESOURCE_ID>

Pour plus d’informations sur les commandes des paramètres de diagnostic Azure Monitor, consultez az monitor diagnostic-settings.