Analyser les journaux avec Elastic (ELK) à l’aide des paramètres de diagnostic

Remarque

Les abonnements Basic, Standard et Enterprise sont entrés dans une période de retraite le 17 mars 2025. Pour plus d’informations, consultez l’annonce de retrait Azure Spring Apps.

Cet article s'applique à : ✅ Java ✅ C#

Cet article s’applique à :✅ Essentiel/Standard ✅ Entreprise

Cet article explique comment utiliser les fonctionnalités de diagnostic de Azure Spring Apps pour analyser les journaux avec Elastic (ELK).

La vidéo suivante présente l’observabilité unifiée des applications Spring Boot grâce à Elastic.


Configurer les paramètres de diagnostic

Pour configurer les paramètres de diagnostic, effectuez les étapes suivantes :

  1. Dans le Azure portal, accédez à votre instance Azure Spring Apps.
  2. Sélectionnez l’option Paramètres de diagnostic, puis Ajouter un paramètre de diagnostic.
  3. Entrez un nom pour le paramètre, choisissez Envoyer à la solution partenaire, puis sélectionnez Elastic et un déploiement Elastic dans lequel vous souhaitez envoyer les logs.
  4. Sélectionnez Enregistrer.

Screenshot du Azure portal qui affiche la page de paramètres de diagnostic avec les options sélectionnées et le nom spécifié pour le paramètre.

Remarque

Il peut y avoir un écart jusqu’à 15 minutes entre le moment où les journaux sont émis et le moment où ils apparaissent dans votre déploiement Elastic. Si l'instance Azure Spring Apps est supprimée ou déplacée, l'opération n'est pas en cascade vers les ressources des paramètres de diagnostic. Vous devez supprimer manuellement les ressources des paramètres de diagnostic avant d’effectuer l’opération sur son parent, l’instance Azure Spring Apps. Sinon, si vous approvisionnez une nouvelle instance Azure Spring Apps avec le même ID de ressource que celui supprimé, ou si vous déplacez l’instance Azure Spring Apps, les ressources de paramètres de diagnostic précédentes continueront de l’étendre.

Analyser les journaux avec Elastic

Pour en savoir plus sur le déploiement d’Elastic sur Azure, consultez How to deploy and manage Elastic on Microsoft Azure.

Pour analyser les journaux, effectuez les étapes suivantes :

  1. Dans la page vue d’ensemble du déploiement élastique dans le Azure portal, ouvrez Kibana.

    Capture d'écran du portail Azure qui affiche la page Elasticsearch (Elastic Cloud) avec le lien Kibana de l’URL de déploiement mis en surbrillance.

  2. Dans Kibana, dans la barre Rechercher en haut, tapez Spring Cloud type:dashboard.

    Capture d’écran Elastic/Kibana illustrant les résultats de recherche pour Spring Cloud type:dashboard.

  3. Sélectionnez [Journaux Azure] Vue d’ensemble des journaux Azure Spring Apps dans les résultats.

    Capture d'écran d'Elastic/Kibana affichant les journaux de console de l'application Azure Spring Apps.

  4. Recherchez sur les tableaux de bord Azure Spring Apps prêts à l'emploi en utilisant des requêtes comme celles-ci :

    azure.springcloudlogs.properties.app_name : "visits-service"

Analyser les journaux avec le langage de requête Kibana dans Discover

Les journaux d'application fournissent des informations critiques et des logs détaillés sur la santé de votre application, ses performances, et bien plus. Pour analyser les journaux, effectuez les étapes suivantes :

  1. Dans Kibana, dans la barre Rechercher en haut, tapez Discover et sélectionnez le résultat.

    Capture d’écran Elastic/Kibana illustrant les résultats de recherche pour Discover.

  2. Dans l’application Discover, sélectionnez le modèle d’index logs- si ce n’est pas déjà fait.

    Capture d’écran d’Elastic/Kibana présentant la page des journaux d’activité dans l’application Discover.

  3. Utilisez des requêtes telles que celles qui sont dans les sections suivantes pour vous aider à comprendre les états actuels et passés de votre application.

Pour plus d’informations sur les différentes requêtes, consultez Guide du langage de requête Kibana.

Afficher tous les journaux d’activité de Azure Spring Apps

Pour consulter la liste des journaux d’application de Azure Spring Apps, triés par heure avec les journaux les plus récents affichés en premier, exécutez la requête suivante dans la zone Search :

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring"

Capture d’écran d'Elastic / Kibana montrant l'application Discover avec tous les journaux affichés.

Afficher des types de journaux spécifiques de Azure Spring Apps

Pour consulter la liste des journaux d’application de Azure Spring Apps, triés par heure avec les journaux les plus récents affichés en premier, exécutez la requête suivante dans la zone Search :

azure.springcloudlogs.category : "ApplicationConsole"

Capture d’écran d’Elastic/Kibana affichant l’application Discover avec des journaux d’activité spécifiques.

Afficher les entrées de journal contenant des erreurs ou des exceptions

Pour examiner les entrées de journal non triées qui mentionnent une erreur ou une exception, exécutez la requête suivante :

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring" and (log.level : "ERROR" or log.level : "EXCEPTION")

Capture d’écran d’Elastic/Kibana montrant l’application Discover avec les journaux d’erreurs et d’exceptions.

Le langage de requête Kibana vous aide à former des requêtes en fournissant une autocomplétion et des suggestions qui vous permettront d’obtenir des insights des journaux. Utilisez votre requête pour rechercher des erreurs, ou modifiez les termes de la requête afin de rechercher des codes d’erreur ou des exceptions spécifiques.

Afficher les entrées de journal d’un service spécifique

Pour consulter les entrées de journal générées par un service spécifique, exécutez la requête suivante :

azure.springcloudlogs.properties.service_name : "sa-petclinic-service"

Capture d’écran d’Elastic/Kibana illustrant l’application Discover avec des journaux propres à certains services.

Afficher les journaux Config Server contenant des avertissements ou des erreurs

Pour consulter les journaux de Config Server, exécutez la requête suivante :

azure.springcloudlogs.properties.type : "ConfigServer" and (log.level : "ERROR" or log.level : "WARN")

Capture d’écran Elastic/Kibana montrant l'application Discover avec les journaux du serveur de configuration affichés.

Afficher les journaux du Registre de services

Pour consulter les journaux du Registre de services, exécutez la requête suivante :

azure.springcloudlogs.properties.type : "ServiceRegistry"

Capture d’écran d’Elastic/Kibana présentant l’application Discover avec les journaux d’activité du registre de services.

Visualisation des journaux d’Azure Spring Apps avec Elastic

Kibana vous permet de visualiser les données avec des tableaux de bord et un écosystème riche de visualisations. Pour plus d’informations, consultez Tableau de bord et visualisation.

Suivez les étapes ci-dessous pour afficher les différents niveaux de journalisation dans vos journaux et pouvoir évaluer l’intégrité globale des services.

  1. Dans la liste des champs disponibles à gauche dans Discover, recherchez log.level dans la zone de recherche sous le modèle d’index logs-.

  2. Sélectionnez le champ log.level. Dans le volet d’informations flottant sur log.level, sélectionnez Visualiser.

    Capture d’écran d’Elastic/Kibana montrant l’application Discover avec les différents niveaux de journalisation.

  3. À partir de là, vous pouvez choisir d’ajouter des données dans le volet gauche, ou choisir parmi plusieurs suggestions sur la façon dont vous voulez visualiser vos données.

    Capture d’écran Elastic/Kibana illustrant l’application Discover avec des options de visualisation.

Étapes suivantes

  • Last updated on