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 de 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 période d'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 de temps d'une heure à deux heures, la période d'alignement est indiquée comme 1 minute interval. Toutefois, si vous modifiez la période de temps d'une heure à une journée, la période d'alignement est indiquée comme 5 minute interval.

Ce comportement est normal.

Le nombre de points de données que les graphiques peuvent afficher est limité. Par conséquent, lorsque le nombre de points de données disponibles pour la période sélectionnée est supérieur à la limite d'affichage, la surveillance modifie automatiquement les paramètres d'alignement pour réduire le nombre de points de données à afficher.

Le graphique n'affiche pas toutes les séries temporelles

Vous configurez un graphique, mais il n'affiche pas toutes les séries temporelles.

Pour des raisons de performances, les graphiques sont configurés pour afficher au maximum 50 séries temporelles.

Lorsque vous configurez un graphique et que plus de 50 séries temporelles sont disponibles, le graphique limite le nombre de séries temporelles affichées et ajoute une icône avec un point rouge à la barre d'outils. L'info-bulle de l'icône affiche le message suivant:

To improve performance, we've limited the time series displayed in this chart.

Pour afficher toutes les séries temporelles, développez l'info-bulle et sélectionnez le bouton Afficher toutes les séries temporelles.

Le graphique n'affiche aucune donnée

Vous configurez un graphique, mais celui-ci affiche un message d'erreur au lieu de données:

  • Lorsque les données ne sont pas disponibles 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:

    • Augmentez la période du graphique. Certains types de métriques, comme ceux qui indiquent l'utilisation des quotas, ne fournissent qu'un seul échantillon par jour.

    • Modifier 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. Vous pouvez utiliser l'interface de menu pour les graphiques afin de rechercher le type de métrique.

    • 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 sur l'axe Y de gauche ou de droite. Les unités de tous les types de métriques mappés sur l'axe Y de gauche doivent être identiques. Dans le cas contraire, le message d'erreur précédent s'affiche. De même, les unités de tous les types de métriques mappés sur l'axe Y à droite 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, un titre est associé à chaque type de métrique affiché dans le graphique.

Par exemple, si vous souhaitez que le graphique n'affiche que les séries temporelles des 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 en MQL et PromQL

Vous créez des graphiques dans un tableau de bord personnalisé et les configurez avec le langage de requête de surveillance (MQL) ou PromQL. Vous créez ensuite des filtres de tableau de bord permanents. Lorsque vous consultez le tableau de bord, vous essayez de modifier la valeur par défaut du filtre, mais le menu des valeurs de libellé ne s'affiche pas ou n'est pas correct:

Les valeurs d'un filtre appliqué à l'ensemble 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 ou modifiez des tableaux de bord.

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

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

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

  • Utilisez une période plus courte. Par exemple, affichez les données de l'heure la plus récente au lieu du 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 pouvant être affichés dans les tableaux de bord est limité. Lorsque ces limites sont atteintes, les tableaux de bord n'affichent que les événements les plus récents.

Le tableau de bord créé avec Terraform est redimensionné

Vous avez créé un tableau de bord à l'aide de Terraform, puis modifié ce tableau de bord à l'aide de la console Google Cloud. Vous vous attendiez à ce que le tableau de bord reste inchangé, à l'exception de vos modifications. Le tableau de bord est redimensionné. Par exemple, votre tableau de bord comportait 12 colonnes et en contient désormais 48.

Ne modifiez pas les tableaux de bord créés à l'aide de Terraform avec la console Google Cloud. Lorsque le tableau de bord est modifié, sa taille est multipliée par quatre.

Le widget de règle d'alerte n'affiche aucune donnée

Un tableau de bord contient un graphique pour une règle d'alerte, mais il n'affiche aucune donnée.

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

  • Affichez la configuration du graphique 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 à une règle d'alerte ou supprimez-le du tableau de bord.

    Les graphiques des tableaux de bord qui affichent des données pour une règle d'alerte cessent de les afficher lorsque la règle d'alerte référencée est supprimée. La suppression d'une règle d'alerte ne supprime pas les graphiques 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.

    Les graphiques des tableaux de bord qui affichent des données pour une règle d'alerte cessent d'afficher des données si la règle d'alerte est modifiée pour contenir plusieurs conditions. Pour résoudre cette condition, associez le graphique à une règle d'alerte ne comportant qu'une seule condition ou supprimez-le du tableau de bord.

  • Augmentez la période. Le sélecteur de période doit être défini sur une valeur supérieure à celle de 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 afficher 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 des journaux afin de n'afficher que les journaux des projets Google Cloud pour lesquels vous êtes autorisé à afficher les entrées de journal.

Le panneau des journaux affiche le message "Autorisation refusée"

Le widget du panneau des journaux d'un tableau de bord affiche le message d'autorisation refusé suivant:

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

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

  1. Modifiez le widget du panneau des journaux.

  2. Effectuez l'une des opérations suivantes :

    • Définissez le menu Champ d'application sur Projet, puis utilisez le menu Projets pour sélectionner Projet actuel.

    • Supprimez du menu Vues de stockage les vues de journaux que vous n'êtes pas autorisé à afficher. Pour en savoir plus sur les rôles IAM requis pour accéder aux vues de journaux, consultez la section Accorder l'accès à une vue de journal.

      Lorsque le widget du panneau des journaux recherche des vues de journaux, vous devez disposer de l'autorisation de lire les entrées de journal dans toutes les vues de journaux listées. Sinon, un message d'erreur s'affiche.

  3. Cliquez sur Appliquer.

Le tableau n'affiche pas toutes les séries temporelles

Vous configurez un tableau, mais il n'affiche pas toutes les séries temporelles.

Pour des raisons de performances, les tableaux sont configurés pour afficher au maximum 300 lignes.

É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 de l'outil d'importation de tableau de bord et son dépannage, 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.