Afficher les données télémétriques de l'application

Ce document explique comment afficher les tableaux de bord prêts à l'emploi pour vos applications, services et charges de travail App Hub. Ces tableaux de bord peuvent vous aider à comprendre les performances des ressources de votre application et à diagnostiquer les problèmes.

La télémétrie affichée par ces tableaux de bord prêts à l'emploi inclut des données de journal et de métrique, ainsi que des informations sur les incidents ouverts. Les tableaux de bord des applications fournissent des informations telles que l'emplacement, la criticité et les propriétaires. Les tableaux de bord des services et des charges de travail incluent des informations sur App Hub et les types d'infrastructure.

Libellés spécifiques à l'application

Les libellés spécifiques à App Hub permettent à Google Cloud Observability de construire la hiérarchie des tableaux de bord prêts à l'emploi et de filtrer la télémétrie affichée sur celle d'un service ou d'une charge de travail. Vous pouvez également utiliser ces libellés pour filtrer vos données de journal et de métrique. Ces libellés sont associés lorsque votre application s'exécute sur des Google Cloud ressources intégrées à App Hub. Ces libellés peuvent être associés lors de l'ingestion des métriques Google Cloud Managed Service pour Prometheus.

Libellés de journaux

Les entrées de journal contiennent un champ apphub qui liste les libellés de l'application, ainsi que d'un service ou d'une charge de travail. Le format de ces données est illustré ci-dessous:

apphub: {
  application: {
    id: "my-app"
    location: "my-app-location"
  }
  workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
  }
}

Étiquettes de métriques

Cette section explique comment les libellés spécifiques à l'application sont associés aux données de métrique générées par les ressources Google Cloud et aux métriques Prometheus ingérées à l'aide de Google Cloud Managed Service pour Prometheus. Dans ce qui suit, interprétez a.b.{x,y} comme a.b.x et a.b.y.

Les libellés App Hub suivants sont associés aux données métriques des Google Cloud ressources utilisées par votre application:

  • metadata.system_labels.apphub_application_{container,id,location}
  • metadata.system_labels.apphub_{workload,service}_{criticality_type,environment_type,id}

Les libellés d'application App Hub sont associés aux métriques Google Cloud Managed Service pour Prometheus lorsque l'une des conditions suivantes est remplie:

  • Une charge de travail s'exécute sur un cluster Google Kubernetes Engine version 1.30 ou ultérieure, et le type de contrôleur de la charge de travail est l'un des suivants:

    • apps.k8s.io/{Deployment,StatefulSet,DaemonSet}
    • batch.k8s.io/CronJob

  • Lorsque vous utilisez OpenTelemetry sur Cloud Run.

  • Lorsque vous utilisez OpenTelemetry sur Google Kubernetes Engine et suivez les conseils sur l'ingestion Kubernetes OTLP.

Managed Service pour Prometheus utilise l'API App Hub pour déterminer si une application App Hub existe. Lorsqu'une application est détectée, les étiquettes spécifiques à l'application suivantes sont ajoutées à vos données de trace:

  • metric.labels.apphub_application_{container,id,location}
  • metric.labels.apphub_workload_{criticality_type,environment_type,id}

Étiquettes des règles d'alerte

Les étiquettes de service et de charge de travail ne sont pas automatiquement associées aux règles d'alerte. Toutefois, vous pouvez associer une règle d'alerte à une charge de travail ou à un service spécifiques en associant tous les libellés suivants avec les clés suivantes à la règle d'alerte:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Lorsqu'une règle d'alerte inclut les clés précédentes, les incidents associés à la règle s'affichent dans les tableaux de bord prêts à l'emploi.

Pour en savoir plus, consultez la section Associer une règle d'alerte à un service ou à une charge de travail.

La console Google Cloud réinitialise automatiquement le sélecteur de ressources d'un dossier compatible avec les applications sur le projet de gestion du dossier lorsqu'une page d'observabilité Google Cloud s'ouvre.

Cloud Logging accepte les dossiers en tant que ressources. Par exemple, vous pouvez créer des collecteurs de journaux et des buckets de journaux dans une ressource de dossier. De même, les dossiers contiennent des buckets de journaux _Default et _Required, et vous pouvez souhaiter afficher leur contenu. Pour accéder à la ressource de dossier, utilisez le sélecteur de ressources et sélectionnez manuellement le dossier compatible avec les applications.

Avant de commencer

Avant de pouvoir utiliser la surveillance des applications, assurez-vous de configurer votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications. Il s'agit du projet que vous utilisez pour afficher les données de télémétrie de votre application:

  • Pour obtenir les autorisations nécessaires pour afficher les données de journal et de métrique, et pour créer des stratégies d'alerte et personnaliser des tableaux de bord, demandez à votre administrateur de vous accorder les rôles IAM suivants:

    • Afficheur de journaux (roles/logging.viewer) sur votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications, ainsi que sur tous les autres projets dont la portée des journaux par défaut est indiquée. Ce rôle permet d'accéder à la plupart des entrées de journaux du bucket de journaux _Default. Pour en savoir plus, consultez la section Rôles de journalisation.
    • Accesseur de vues de journaux (roles/logging.viewAccessor) sur les vues de journaux listées dans le champ d'action de journaux par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications. Pour en savoir plus sur l'octroi d'accès à une vue de journal, consultez Contrôler l'accès à une vue de journal.
    • Éditeur Monitoring (roles/monitoring.editor) dans le projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications. Pour les administrateurs principaux qui n'ont pas besoin de créer ni de modifier des règles d'alerte ni des tableaux de bord, envisagez d'accorder le rôle Lecteur Monitoring (roles/monitoring.viewer).
    • Lecteur App Hub dans votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications. Pour en savoir plus, consultez la section Rôles et autorisations dans App Hub.

    Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

    Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

  • Assurez-vous d'avoir configuré la portée d'observabilité de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications. Pour en savoir plus, consultez la section Configurer la surveillance des applications.

    Le champ d'application de l'observabilité contrôle les données disponibles pour votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications. Les paramètres par défaut de ces champs d'application ne vous permettent peut-être pas d'afficher toutes les données de journalisation ou de métrique.

  • Mettez à jour les règles d'alerte qui surveillent les données de votre application pour inclure des libellés spécifiques à l'application. Pour en savoir plus, consultez la section Associer une règle d'alerte à un service ou à une charge de travail.

Afficher le résumé de toutes les applications

Le tableau de bord de premier niveau prêt à l'emploi fournit un résumé concis de l'état de vos applications enregistrées. Pour chaque application, cette page liste le nombre d'incidents ouverts et des informations sur l'emplacement, la gravité et l'environnement.

Pour ouvrir le tableau de bord OOTB de premier niveau, qui liste les informations récapitulatives de vos applications enregistrées dans App Hub, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Surveillance des applications:

    Accéder à Surveillance des applications

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la barre d'outils de la console Google Cloud, sélectionnez le projet hôte de votre hub d'applications ou le projet de gestion de votre dossier compatible avec les applications.

  3. Facultatif: Pour ouvrir une application dans App Hub, cliquez sur Plus, puis sélectionnez Gérer dans App Hub.

  4. Pour ouvrir le tableau de bord OOTB d'une application, sélectionnez-la. La section suivante explique comment explorer ou interpréter la télémétrie.

Explorer la télémétrie et les incidents des applications

Lorsque vous sélectionnez une application listée sur la page Surveillance des applications, le tableau de bord de niveau supérieur prêt à l'emploi de l'application s'ouvre. Ce tableau de bord vous aide à comprendre l'état de votre application en résumant le nombre d'incidents ouverts et en listant les valeurs de plusieurs signaux d'or. Par exemple, si cette page affiche des échecs généralisés, cela peut indiquer que la source de l'échec est l'infrastructure et non votre application.

Pour ouvrir le tableau de bord prêt à l'emploi d'une application, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Surveillance des applications:

    Accéder à Surveillance des applications

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la barre d'outils de la console Google Cloud, sélectionnez le projet hôte de votre hub d'applications ou le projet de gestion de votre dossier compatible avec les applications.

  3. Sur la page Surveillance des applications, sélectionnez le nom d'une application.

    Le tableau de bord prêt à l'emploi de l'application s'ouvre avec l'onglet Vue d'ensemble sélectionné. Cet onglet liste chaque service et chaque charge de travail, ainsi que le nombre d'incidents ouverts et les valeurs des signaux d'or:

    • Trafic: taux de requêtes entrantes sur la ressource au cours de la période sélectionnée.
    • Taux d'erreur du serveur: pourcentage moyen de requêtes entrantes qui génèrent ou sont mappées sur des codes d'erreur HTTP de la série 5xx au cours de la période sélectionnée.
    • Latence au 95e centile: 95e centile de latence d'une requête de service agrégée sur la période sélectionnée, en millisecondes.
    • Saturation: mesure le niveau d'occupation de votre service ou de votre charge de travail. Pour les services et les charges de travail qui s'appuient sur des ressources basées sur le calcul, comme les groupes d'instances gérés (MIG), Cloud Run et les déploiements Google Kubernetes Engine, ce champ indique l'utilisation du processeur.

    Dans l'onglet Aperçu, vous pouvez effectuer les opérations suivantes:

    • Réinitialisez la période. Lorsque vous ouvrez le tableau de bord, la période est définie sur l'heure la plus récente.
    • Afficher des informations sur l'application, comme l'opérateur, le développeur et les propriétaires d'établissements
    • Ouvrez l'application, un service ou une charge de travail dans l'App Hub.
    • Ouvrez le tableau de bord d'un service ou d'une charge de travail.

  4. Pour afficher la télémétrie de l'application et des informations sur les incidents ouverts, sélectionnez l'onglet Tableau de bord.

    L'onglet Dashboard (Tableau de bord) affiche des informations sur les journaux, les métriques et les incidents. Cet onglet contient également des filtres que vous pouvez utiliser pour limiter les données affichées. Pour savoir comment explorer cet onglet, consultez les sections suivantes de ce document:

Filtrer un tableau de bord

L'onglet Tableau de bord affiche les données des services et des charges de travail d'une application. Toutefois, vous pouvez filtrer ce tableau de bord pour un service spécifique ou un ensemble de services.

Par exemple, la barre d'outils de l'onglet Dashboard contient un filtre tel que apphub_service_id: *. Si vous souhaitez afficher les données de services spécifiques, cliquez sur  Menu, puis sélectionnez ces services dans la liste.

Explorer les données des journaux

Si vous consultez l'onglet Dashboard (Tableau de bord) d'un tableau de bord d'application, vos données de journal s'affichent dans la section Application Logs (Journaux de l'application). Sinon, vos données s'affichent dans la section Journaux.

Les sections Journaux d'application et Journaux d'un tableau de bord affichent les entrées de journal correspondant à un filtre et stockées par les ressources listées dans le champ d'application par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications. Pour les applications, le filtre ressemble à ceci:

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

Pour les services et les charges de travail, le filtre contient des clauses supplémentaires. Pour afficher le filtre appliqué à vos données de journal, cliquez sur Afficher la requête.

Si vous souhaitez écrire des requêtes, vous pouvez ouvrir un volet ou la page Explorateur de journaux. Les deux options vous permettent d'écrire et d'exécuter des requêtes, et de modifier la portée. Toutefois, le pop-up conserve votre contexte actuel et vous permet d'enregistrer les résultats de votre exploration dans un tableau de bord personnalisé:

  • Pour ouvrir un volet, cliquez sur  Explorer les données.

    Une fois votre exploration terminée, cliquez sur Annuler pour fermer le volet et supprimer vos modifications. Si vous souhaitez enregistrer vos modifications dans un tableau de bord personnalisé, cliquez sur Enregistrer dans le tableau de bord, puis remplissez la boîte de dialogue. Vous ne pouvez pas enregistrer les modifications apportées au tableau de bord que vous consultiez lorsque vous avez ouvert le panneau déroulant.

    Le pop-up n'affiche pas les filtres affichés par le bouton Afficher la requête. Ces filtres sont appliqués au niveau du tableau de bord et ne peuvent pas être supprimés.

  • Pour ouvrir la page Explorateur de journaux dans un nouvel onglet du navigateur, cliquez sur Afficher dans l'explorateur de journaux.

    La requête est préconfigurée pour afficher les entrées de journal qui correspondent à des libellés d'application spécifiques et qui se trouvent dans la période spécifiée par le tableau de bord. Lorsque vous fermez l'onglet du navigateur, vos modifications sont supprimées.

Pour en savoir plus sur l'exploration de vos journaux, consultez les documents suivants:

Explorer les données de métrique

Les graphiques et les tableaux de votre tableau de bord affichent des signaux d'or et d'autres données de métrique pertinentes pour les ressources utilisées par votre application, votre service ou votre charge de travail. Les données affichées peuvent être stockées dans n'importe quel projet listé par le champ d'application des métriques de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications.

Pour tout graphique ou tableau affichant des données de métrique, vous pouvez afficher des détails tels que le type de métrique et les options d'agrégation. Pour afficher ces informations, accédez à la barre d'outils d'un graphique ou d'un tableau, puis cliquez sur Informations.

Pour explorer un graphique ou un tableau plus en détail, vous pouvez ouvrir un volet ou la page Explorateur de métriques. Les deux options vous permettent d'essayer différents paramètres de graphique et d'enregistrer les résultats dans un tableau de bord personnalisé. Toutefois, le pop-up conserve votre contexte actuel:

  • Pour ouvrir un volet, cliquez sur  Explorer les données.

    Une fois votre exploration terminée, cliquez sur Annuler pour fermer le volet et supprimer vos modifications. Si vous souhaitez enregistrer vos modifications dans un tableau de bord personnalisé, cliquez sur Enregistrer dans le tableau de bord, puis remplissez la boîte de dialogue. Vous ne pouvez pas enregistrer les modifications apportées au tableau de bord que vous consultiez lorsque vous avez ouvert le panneau déroulant.

  • Pour afficher le graphique ou le tableau dans l'explorateur de métriques, accédez à la barre d'outils, cliquez sur Plus, puis sélectionnez Afficher dans l'explorateur de métriques.

    Vous disposez désormais d'un graphique temporaire que vous pouvez modifier et explorer. Par exemple, vous pouvez modifier les options d'agrégation ou le style d'affichage. Pour enregistrer votre graphique dans un tableau de bord personnalisé, cliquez sur Enregistrer dans un tableau de bord et remplissez la

Explorer les incidents

La section Alertes des tableaux de bord liste les incidents récents pour les règles d'alerte associées à un service ou à une charge de travail. Ces règles d'alerte doivent être stockées dans le projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.

Si aucune entrée ne s'affiche dans la section Alertes, cela signifie que vous n'avez aucune règle d'alerte associée à un service ou à une charge de travail. Pour créer cette association, ajoutez des libellés à la règle. Pour en savoir plus, consultez la section Associer une règle d'alerte à un service ou à une charge de travail.

Pour en savoir plus sur vos incidents et vos règles d'alerte, procédez comme suit:

  • Pour obtenir des informations sur la règle d'alerte à l'origine de l'incident, cliquez sur son nom. Le tableau de bord qui s'ouvre affiche des informations détaillées sur la règle d'alerte, y compris un graphique qui affiche les données surveillées et les libellés.

  • Pour afficher toutes les règles d'alerte associées à l'application, accédez à la barre d'outils, puis cliquez sur Explorer data (Explorer les données). Un volet s'ouvre et liste toutes les règles. Pour revenir au tableau de bord, cliquez sur Annuler.

Explorer la télémétrie et les incidents liés à un service ou à une charge de travail

Un tableau de bord prêt à l'emploi est fourni pour chaque service et chaque charge de travail. Ces tableaux de bord affichent des informations sur les journaux, les métriques et les incidents. Ils peuvent vous aider à comprendre l'état d'un service ou d'une charge de travail spécifique. Vous pouvez explorer les données de ces tableaux de bord prêts à l'emploi de la même manière que les données affichées dans l'onglet Dashboard (Tableau de bord) d'une application.

Pour ouvrir le tableau de bord prêt à l'emploi d'un service ou d'une charge de travail, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Surveillance des applications:

    Accéder à Surveillance des applications

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la barre d'outils de la console Google Cloud, sélectionnez le projet hôte de votre hub d'applications ou le projet de gestion de votre dossier compatible avec les applications.

  3. Sur la page Surveillance des applications, sélectionnez le nom d'une application, puis un service ou une charge de travail.

    Un tableau de bord affiche les informations de journal, de métrique et d'incident pour le service ou la charge de travail que vous avez sélectionnés. Pour savoir comment explorer ces données, consultez les sections suivantes de ce document:

Créer un tableau de bord personnalisé

Google Cloud Observability permet de créer des tableaux de bord personnalisés, qui vous permettent de contrôler entièrement le contenu du tableau de bord. Les tableaux de bord personnalisés sont listés sur la page Tableaux de bord de la console Google Cloud. Vous pouvez les copier, les modifier et les supprimer. Ils peuvent également être la destination où vous enregistrez un widget de tableau de bord que vous avez configuré. Par exemple, si vous explorez un graphique sur un tableau de bord d'application, vous pouvez l'enregistrer dans un tableau de bord personnalisé en accédant à la barre d'outils et en sélectionnant Enregistrer dans un tableau de bord.

Si vous prévoyez de créer un tableau de bord personnalisé pour une application, un service ou une charge de travail, les informations suivantes peuvent vous être utiles:

Associer une règle d'alerte à une application App Hub

Pour associer une règle d'alerte à un service ou à une charge de travail, ajoutez des libellés spécifiques à l'application à la règle d'alerte. Lorsque vous ajoutez ces libellés, ils sont listés dans la règle d'alerte et sont également inclus dans les incidents. Pour en savoir plus sur les libellés, consultez la section Annoter des incidents avec des libellés.

Pour associer une règle d'alerte à une charge de travail ou à un service à l'aide de la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.
  3. Recherchez la règle d'alerte, cliquez sur  Afficher plus, sélectionnez Modifier, puis accédez à la section Notifications et nom.
  4. Dans la section Étiquettes d'application, sélectionnez votre application, puis votre charge de travail ou votre service.
  5. Cliquez sur Enregistrer la règle.

Une fois ces étapes terminées, des libellés avec les clés suivantes sont associés à votre règle d'alerte. Ces libellés identifient votre application et votre service ou charge de travail:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Vous pouvez également ajouter des libellés utilisateur à une règle d'alerte à l'aide de Google Cloud CLI, de Terraform ou de l'API Cloud Monitoring. Toutefois, vous devez utiliser les clés d'étiquettes indiquées dans l'exemple précédent. Pour en savoir plus, consultez les ressources suivantes :

Résoudre les problèmes

Pour en savoir plus sur les données que vous consultez ou sur les raisons pour lesquelles un tableau de bord n'affiche pas de données, consultez la section Résoudre les problèmes de surveillance des applications.