Résoudre les problèmes liés aux graphiques

Cette page décrit certains des comportements que vous pouvez rencontrer lorsque vous utilisez les métriques collectées par vos projets Google Cloud.

Erreurs dans le graphique

Cette section décrit les erreurs que vous pouvez rencontrer lorsque vous configurez un graphique. Vous pouvez configurer des graphiques à l'aide de l'Explorateur de métriques ou en les ajoutant à un tableau de bord.

Écarts dans les données des graphiques

Les graphiques présentent parfois des écarts dans les données. Par exemple, la capture d'écran suivante illustre ce comportement pour la métrique loadbalancing.googleapis.com/https/total_latencies:

Exemple de graphique avec des valeurs manquantes

Des écarts peuvent se produire lorsque les données sont écrites très rarement. Cloud Monitoring collecte des métriques par échantillonnage et, avec des données très creuses, il est possible qu'aucune donnée ne soit disponible lorsqu'un échantillon est collecté. Par exemple, des écarts entre les métriques de l'équilibreur de charge peuvent se produire lorsque le nombre de requêtes est inférieur ou égal à 0,05 requête par seconde (RPS). Les écarts disparaissent lorsque le taux de requêtes augmente.

La durée de l'alignement change lorsque la période est modifiée

Vous ajoutez un graphique à un tableau de bord. Lorsque vous modifiez la période du graphique, la période d'alignement peut parfois changer. Par exemple, si vous modifiez la période d'une heure à deux heures, la période d'alignement est indiquée comme 1 minute interval. Toutefois, si vous modifiez la période d'une heure à un jour, la période d'alignement sera 5 minute interval.

Ce comportement est normal.

Les graphiques ne peuvent afficher qu'un nombre limité de points de données. Par conséquent, lorsque le nombre de points de données disponibles pour la période sélectionnée dépasse la limite d'affichage, Monitoring modifie automatiquement les paramètres d'alignement pour réduire le nombre de points de données à afficher.

Le graphique n'affiche aucune donnée

Vous configurez un graphique, mais celui-ci affiche un message d'erreur à la place des données:

  • Lorsqu'aucune donnée n'est disponible pour la période spécifiée pour votre graphique, le message suivant s'affiche:

    No data is available for the selected time frame.
    

    Pour résoudre le problème, procédez comme suit:

    • Étendez la période du graphique. Certains types de métriques, telles que celles qui indiquent l'utilisation des quotas, ne fournissent qu'un seul échantillon par jour.

    • Modifiez le type de métrique sélectionné pour votre graphique. Il est possible que le type de métrique spécifié par votre graphique soit inactif. Autrement dit, il n'y a pas de données pour ce type de métrique.

  • Lorsque le type de métrique ou de ressource spécifié par la requête n'est pas reconnu, le message suivant s'affiche:

    An error occurred requested data. One or more resources could not be found.
    

    Pour résoudre ce problème, procédez comme suit:

    • Vérifiez que le type de métrique et le type de ressource spécifiés dans la requête sont définis. Pour rechercher le type de métrique dans les graphiques, vous pouvez utiliser l'interface basée sur des menus.

    • Vérifiez l'orthographe du type de métrique et du type de ressource dans la requête.

Un graphique comportant plusieurs métriques affiche un message d'erreur

Vous configurez un graphique pour afficher plusieurs métriques. Le graphique affiche le message d'erreur suivant :

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

Les graphiques peuvent afficher plusieurs types de métriques. Vous pouvez mapper un type de métrique à l'axe Y de gauche ou à l'axe Y de droite. Les unités de tous les types de métriques mappés à l'axe Y de gauche doivent être identiques. Sinon, le message d'erreur précédent s'affiche. De même, les unités de tous les types de métriques mappées à l'axe Y droit doivent être identiques, sinon le message d'erreur précédent s'affiche.

Pour résoudre cette erreur, procédez comme suit :

  1. Si votre graphique contient des métriques comportant plus de deux types d'unités, supprimez-les jusqu'à ce qu'il ne reste que deux types d'unités.

  2. Attribuez toutes les métriques ayant un type d'unité à l'axe Y à gauche et toutes les métriques ayant l'autre type d'unité à l'axe Y à droite.

Un graphique comportant plusieurs métriques affiche des données inattendues

Un graphique est configuré pour afficher plusieurs métriques et des filtres ont été ajoutés pour n'afficher que des séries temporelles spécifiques. Cependant, le graphique montre des séries temporelles qui ne correspondent pas aux filtres.

Pour résoudre ce problème, veillez à appliquer des filtres à chaque métrique représentée dans le graphique.

Par exemple, la capture d'écran suivante montre le volet de configuration de l'explorateur de métriques pour un graphique qui affiche le nombre d'octets lus et écrits par des instances de machine virtuelle (VM) :

Exemple d'explorateur de métriques avec deux types de métriques

Dans la capture d'écran, il y a un en-tête pour chaque type de métrique affiché par le graphique.

Par exemple, si vous souhaitez que le graphique n'affiche des séries temporelles que pour les VM situées dans la zone us-central1-a, ajoutez le filtre zone = us-central1-a à chaque requête.

Impossible de sélectionner des valeurs de filtre pour les graphiques définis par MQL et PromQL

Vous créez des graphiques dans un tableau de bord personnalisé, puis vous les configurez avec le langage MQL (Monitoring Query Language) ou avec PromQL. Vous créerez ensuite des filtres de tableau de bord permanents. Lorsque vous affichez le tableau de bord, vous essayez de modifier la valeur par défaut du filtre, mais le menu des valeurs de libellés ne s'affiche pas ou celui des valeurs des libellés n'est pas correct:

Les valeurs d'un filtre au niveau du tableau de bord ne sont pas chargées.

Pour résoudre ce problème, saisissez la valeur du filtre, puis sélectionnez Appliquer. Par exemple, si la clé de filtre est zone, vous pouvez saisir us-central1-a.

Erreurs du tableau de bord

Cette section décrit les erreurs que vous pouvez rencontrer lorsque vous créez des tableaux de bord.

Le tableau de bord n'affiche pas tous les événements

Vous configurez un tableau de bord pour afficher les événements. Toutefois, seuls les événements récents sont affichés. Les événements plus anciens ne sont pas affichés.

Pour résoudre ce problème, effectuez l'une des opérations suivantes:

  • Choisissez une période plus courte. Par exemple, affichez les données pour l'heure la plus récente plutôt que pour le jour le plus récent, ou sélectionnez une période personnalisée.

  • Ajoutez des filtres.

Pour des raisons de performances, le nombre d'événements qu'ils peuvent afficher est limité dans les tableaux de bord. Une fois ces limites atteintes, les tableaux de bord n'affichent que les événements les plus récents.

Le graphique d'alerte n'affiche aucune donnée

Un tableau de bord contient un graphique d'alerte, mais le graphique d'alerte n'affiche aucune donnée.

Pour résoudre ce problème, procédez comme suit :

  • Affichez la configuration du graphique d'alerte et assurez-vous qu'une règle d'alerte est sélectionnée. Si aucune règle d'alerte n'est affichée, associez le graphique d'alerte à une règle d'alerte ou supprimez-le du tableau de bord.

    Si un graphique d'alerte est ajouté à un tableau de bord et que la règle d'alerte référencée est ensuite supprimée, le graphique d'alerte cesse d'afficher des données. La suppression d'une règle d'alerte ne supprime pas les graphiques d'alerte qui font référence à cette règle.

  • Affichez les détails de la règle d'alerte et vérifiez qu'elle ne contient qu'une seule condition.

    Si un graphique d'alerte est ajouté à un tableau de bord et que la règle d'alerte référencée est ensuite modifiée pour contenir plusieurs conditions, le graphique d'alerte cesse d'afficher des données. Pour résoudre cette condition, associez le graphique d'alerte à une règle d'alerte ne comportant qu'une seule condition ou supprimez le graphique d'alerte du tableau de bord.

  • Prolongez la période. Le sélecteur de période doit être défini sur une valeur plus longue que la période d'échantillonnage des données. Bien que la plupart des métriques soient échantillonnées toutes les 60 secondes, certaines métriques sont rarement échantillonnées. Par exemple, la métrique serviceruntime.googleapis.com/quota/limit est échantillonnée toutes les 86 400 secondes (une journée).

Le panneau des journaux signale une requête non valide

Le message d'erreur "Error: Invalid query" (Erreur : Requête non valide) s'affiche et le panneau des journaux n'affiche aucune entrée de journal.

Pour résoudre ce problème, réduisez le nombre des projets pour lesquels vous avez configuré l'affichage des journaux dans le panneau des journaux.

Pour en savoir plus sur cette condition d'échec, consultez la section La requête renvoie une erreur.

Le panneau des journaux signale qu'aucune entrée n'a été trouvée

Le message d'erreur "Aucune entrée correspondant au filtre actuel trouvée" s'affiche dans un panneau de journaux. Ce message peut s'afficher pour plusieurs raisons. Vérifiez les éléments suivants :

  • Pour chacun des projets pour lesquels vous souhaitez afficher les entrées de journal, assurez-vous que l'une des conditions suivantes est remplie :

    • Vous disposez du rôle Lecteur de journaux (roles/logging.viewer).
    • Pour les rôles personnalisés, vous disposez des autorisations suivantes :

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list
  • Assurez-vous que les clauses de l'éditeur de requête n'entrent pas en conflit avec les paramètres affichés dans le panneau des journaux.

    Par exemple, lorsque le champ Éditeur de requête contient severity=NOTICE, le panneau des journaux récupère tous les journaux dont le niveau de gravité est exactement NOTICE. Si le menu Gravité du panneau des journaux est défini sur "Warning" (Avertissement), le panneau des journaux affiche le message "Aucune entrée correspondant au filtre actuel trouvée". Le message s'affiche car aucune des entrées de journal récupérées ne possède un niveau de gravité au moins égal à "Warning".

    En revanche, lorsque le champ Éditeur de requête contient severity=WARNING et que le menu Gravité du panneau des journaux est défini sur "Notice" (Remarque), des entrées de journal peuvent s'afficher. Avec cette configuration, le panneau des journaux récupère les journaux dont le niveau de gravité est WARNING. Ensuite, cette liste de journaux est filtrée pour n'afficher que celles dont la gravité est au moins égale à "Notice", et tous les journaux récupérés ont au moins ce niveau de gravité.

Le panneau des journaux indique qu'il affiche des données partielles

Un indicateur d'avertissement et le message "Affichage de résultats partiels" s'affichent dans un panneau de journaux.

Lorsque vous n'êtes pas autorisé à afficher les journaux d'un projet Google Cloud pour lequel vous avez choisi d'afficher les journaux, cet indicateur s'affiche. Pour supprimer l'indicateur d'avertissement, effectuez l'une des opérations suivantes :

  • Contactez votre administrateur système et demandez-lui d'effectuer l'une des opérations suivantes pour chaque projet Google Cloud dont vous souhaitez consulter les journaux :

    • Attribuez le rôle de lecteur de journaux (roles/logging.viewer).
    • Pour les rôles personnalisés, attribuez les autorisations suivantes :

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list
  • Modifiez la configuration du panneau "Journaux" pour n'afficher que les journaux des projets Google Cloud pour lesquels vous êtes autorisé à afficher les entrées de journal.

Échec de l'appel d'API pour créer un tableau de bord avec un panneau de journaux

Plusieurs raisons peuvent expliquer pourquoi un message d'erreur s'affiche lorsque vous créez un tableau de bord avec un panneau de journaux :

  • Lorsque le panneau des journaux ne répond pas aux exigences de hauteur ou de largeur minimales, l'erreur suivante s'affiche :

    Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.
    

    Pour résoudre cette condition, dans la représentation JSON du tableau de bord, assurez-vous que les champs height et width du widget de panneau de journaux répondent aux exigences minimales.

  • Lorsque le champ logsPanel.filter dépasse 2 000 caractères, l'erreur suivante s'affiche:

    Unable to save dashboard: filter cannot be greater than 2000 characters.
    

    Pour résoudre cette condition, réduisez le filtre.

  • Lorsque le champ resourceNames est manquant, le message d'erreur suivant s'affiche :

    Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.
    

    Pour résoudre cette condition, ajoutez un champ resourceNames dans le JSON du tableau de bord.

  • Lorsque la syntaxe de resourceNames est incorrecte, l'erreur est semblable à l'exemple suivant :

    Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`."
    

    Pour résoudre cette condition, remplacez a-project par projects/a-project dans le JSON du tableau de bord.

  • Pour plus d'informations sur la façon de résoudre des erreurs de syntaxe dans le champ filter, consultez la section Dépannage : problèmes de syntaxe.

Pour obtenir un exemple de fichier JSON correctement formaté, consultez la section Tableau de bord avec un widget LogsPanel.

Importer des tableaux de bord Grafana

Pour en savoir plus sur l'utilisation et le dépannage de l'importateur de tableaux de bord, consultez la page Importer des tableaux de bord Grafana dans Cloud Monitoring.

Pour en savoir plus sur les problèmes de conversion du contenu du tableau de bord, consultez le fichier README de l'outil d'importation.