Différences entre les versions de Grafana

Lorsque vous créez un espace de travail Grafana, vous devez choisir une version de Grafana à créer. Vous pouvez choisir entre les versions compatibles avec les versions 8, 9 et 10 de Grafana. Chacun d'entre eux a ajouté des fonctionnalités par rapport à la version précédente. Les rubriques suivantes décrivent les modifications apportées aux versions 9 et 10, y compris les modifications apportées à la version 10 susceptibles d'interrompre les fonctionnalités que vous utilisez dans la version 9.

Note

Vous pouvez lire la documentation spécifique à la version sur l'utilisation de votre espace de travail Grafana dans les rubriquesTravailler dans la version 8 de Grafana, etTravailler dans la version 9 de Grafana. Travailler dans la version 10 de Grafana

Pour des notes détaillées par version et plus d'informations sur Grafana Labs, voir Nouveautés de Grafana dans la documentation de Grafana Labs.

Grafana version 10

Les fonctionnalités suivantes ont été ajoutées dans la version 10 de Grafana.

• Corrélations : les corrélations définissent la manière dont les données d'une source de données sont utilisées pour interroger les données d'une autre source de données et permettent à la visualisation Explore d'exécuter facilement des requêtes liées aux données affichées. Pour en savoir plus, consultez Corrélations dans Grafana version 10.

• Sous-dossiers : lorsque vous organisez vos tableaux de bord, vous pouvez désormais utiliser des sous-dossiers pour créer une hiérarchie imbriquée. Pour en savoir plus, consultez Création de dossiers de tableau de bord.

• Alertes — Les alertes Grafana permettent désormais de désactiver les alertes. De plus, les alertes Grafana n'envoient plus de notifications 3 fois.

• Aperçu de la mise à niveau des alertes — Avant de passer des alertes classiques du tableau de bord aux alertes Grafana, vous pouvez voir à quoi ressembleront vos alertes et même apporter les modifications qui seront appliquées lors de la migration. Pour en savoir plus, consultez Migration des alertes classiques du tableau de bord vers les alertes Grafana. Grafana Labs a annoncé que les versions 11 et ultérieures de Grafana ne prendront plus en charge les alertes de tableau de bord classiques.

• Offres d'assistance : les offres d'assistance constituent un moyen simple de collecter des informations sur votre espace de travail Grafana afin de les partager avec le support produit. Vous pouvez créer rapidement un bundle de support contenant des données sur les migrations, les plugins, les paramètres, etc. Pour en savoir plus, consultez Recueillez des informations pour obtenir de l'aide.

• Nouvelles visualisations — Trois nouvelles visualisations sont disponibles. Les panneaux XY Chart, Datagrid et Trend sont tous disponibles pour les espaces de travail compatibles avec la version 10. Les espaces de travail de la version 9 peuvent également utiliser des diagrammes XY.

• PagerDuty— Les plugins Enterprise incluent désormais un plugin pour PagerDuty.

• Refonte des transformations — L'onglet Transformations offre une expérience utilisateur et une conception visuelle améliorées. Les transformations sont classées par catégories, et chaque type de transformation est illustré pour vous aider à choisir la bonne.

• Encyclopédie métrique Prometheus — La liste déroulante des métriques Prometheus dans le générateur de requêtes Prometheus a été remplacée par une encyclopédie métrique paginée et consultable.

• Interface utilisateur de la clé API abandonnée — Les comptes de service sont le moyen recommandé pour authentifier les appels vers le protocole HTTP de APIs Grafana. Dans le cadre des travaux de Grafana Labs visant à supprimer les clés d'API, vous ne pouvez plus créer de clés d'API via l'interface utilisateur de l'espace de travail. Vous ne pouvez créer des clés d'API que par le biais du AWS APIs.

  Pour plus d'informations sur l'arrêt des clés d'API par Grafana Labs, APIKeysvoir : Suppression des clés d'API dans la liste des problèmes de GitHub Grafana.

Changements marquants

La version 10.4 de Grafana inclut des modifications par rapport aux versions 9.5 à 10.4 de Grafana. Les versions 10.0 et 10.3 de Grafana comportaient des modifications susceptibles d'interrompre les fonctionnalités dans certains cas. Lors de la mise à jour vers une nouvelle version, il est recommandé de tester dans un environnement hors production avant de mettre à jour vos espaces de travail de production.

Les modifications suivantes peuvent affecter la mise à jour de Grafana vers la version 10 de Grafana pour certains utilisateurs.

• Angular abandonné — Les plugins qui utilisent Angular ne seront plus pris en charge dans les futures versions de Grafana. Dans la version 10, les panneaux utilisant l'angle afficheront une bannière indiquant qu'ils utilisent une fonctionnalité abandonnée, pour indiquer qu'ils ne fonctionneront pas dans les versions futures.

• Alias CloudWatch supprimé — Les modèles d'alias dans l'éditeur de CloudWatch requêtes ont été remplacés par Label (étiquettes dynamiques).

  Ouvrez n'importe quel tableau de bord qui utilise le champ Alias, puis enregistrez-le. Alias est automatiquement migré vers Label.

• Les anciens plugins doivent être mis à niveau — Les plugins pour Athena et la source de données Amazon Redshift doivent être mis à jour dans les espaces de travail Grafana v10. Le plug-in de source de données Athena doit être de version 2.9.3 ou ultérieure ; le plug-in de source de données Amazon Redshift doit être de version 1.8.3 ou ultérieure.

  Pour plus d'informations sur l'installation ou la mise à niveau des plug-ins, consultezTrouvez des plugins avec le catalogue de plugins.

• BigQuery Le plug-in DoIT n'est plus pris en charge — Le plug-in de source de BigQuery données DoIT n'est plus pris en charge. Utilisez plutôt le plugin de source de BigQuery données officiel de Grafana Labs.

• Changements de transformation — La version 10 de Grafana a apporté quelques corrections de bogues aux noms de champs et aux clés. Pour plus de détails, consultez les modifications majeures apportées à la transformation dans la documentation de Grafana Labs.

• Autorisations relatives aux sources de données APIs : les points de terminaison permettant d'accéder aux autorisations des sources de données ont changé. Pour plus de détails, consultez la section Modifications des autorisations relatives aux sources de données dans la documentation de Grafana Labs.

Pour plus de détails sur les modifications majeures et celles qui concernent les développeurs de plugins, consultez les rubriques suivantes dans la documentation de Grafana Labs :

• Changements majeurs dans Grafana v10.0

• Changements majeurs dans Grafana v10.3

Grafana version 9

Les fonctionnalités suivantes ont été ajoutées dans Grafana v9.

• Alerte : les règles d'alerte gérées par Grafana prennent désormais en charge les noms de groupes.

• Explorer : créez un tableau de bord depuis la vue Explore.

• Requêtes Prometheus : un nouveau générateur de requêtes pour les requêtes Prometheus (utilisant ProMQL) facilite l'écriture de requêtes.

• Requêtes Loki : un nouveau générateur de requêtes pour les requêtes Loki (utilisant LogQL) facilite l'écriture de requêtes.

• Jetons API/Comptes de service : les comptes de service simplifient l'accès aux machines dans Grafana, vous aidant à gérer les jetons d'API.

• Gestion des plugins : vous pouvez activer la gestion des plugins pour installer, supprimer ou mettre à jour les plugins communautaires dans votre espace de travail. Cela vous donne accès à davantage de sources de données et de visualisations, et vous permet de contrôler la version de chaque plugin que vous utilisez.

• Suivi des métriques : configurez une source de données de suivi pour ajouter des liens vers des métriques avec des requêtes et des balises.

• Panneau Canvas : nouvelle visualisation de panneau avec des éléments statiques et dynamiques pour créer des panneaux personnalisés pilotés par les données avec des images et du texte superposé.

• Interface réorganisée : interface utilisateur mise à jour avec une navigation simplifiée dans la console Grafana.

• CloudWatch: La source de CloudWatch données Amazon peut désormais surveiller les métriques Comptes AWS de manière transversale Régions AWS.

• Journaux : L'interface pour les détails des journaux a été améliorée.

• Généralités : corrections de bugs et améliorations mineures dans l'ensemble.

Changements marquants

La version 9.4 de Grafana inclut une série de nouvelles fonctionnalités et améliorations, s'appuyant sur les versions précédentes. Cette version a apporté quelques modifications susceptibles de perturber les fonctionnalités dans certains cas. Lors de la mise à jour vers une nouvelle version, nous vous recommandons de tester dans un environnement hors production avant de mettre à jour vos espaces de travail de production.

Les modifications suivantes peuvent affecter la mise à jour de Grafana vers la version 9.4 de Grafana pour certains utilisateurs. Pour une liste détaillée de ces modifications, consultez le journal des modifications de Grafana 9.4 sur. GitHub

• API abandonnée — L'/api/tsdb/queryAPI a été supprimée.

  Action requise : Utiliser à la /api/ds/query place. Consultez la section Interroger une source de données dans la documentation publique de Grafana et le numéro #49916 sur. GitHub

• Modifications des points de terminaison d'API — Plusieurs points de terminaison d'API d'alerte nécessitent désormais un UID de source de données au lieu d'un identifiant numérique.

  Points de terminaison concernés :api/v1/rule/test,api/prometheus/, api/ruler/ api/alertmanager/

  Action requise : mettez à jour les appels d'API pour utiliser l'UID de la source de données comme paramètre de chemin. Voir les numéros #48070, #48052, #48046 et #47978 ci-dessous GitHub.

• Requêtes Azure Monitor supprimées : les requêtes Application Insights et Insight Analytics ne sont plus prises en charge.

  Obsolète dans Grafana 8.0, supprimée dans la version 9.0. Les requêtes obsolètes ne seront pas exécutées.

  Action requise : consultez la source de données Azure Monitor dans la documentation publique de Grafana pour obtenir des conseils de migration.

• Mode d'accès au navigateur supprimé — Le mode d'accès au navigateur n'est plus disponible pour les sources de données InfluxDB et Prometheus.

  Action requise : passez en mode d'accès au serveur dans la configuration de votre source de données. InfluxDB : obsolète dans la version 8.0.0, supprimée dans la version 9.2.0. Voir le numéro #53529 sur GitHub. Prometheus : obsolète dans la version 7.4.0, supprimé dans la version 9.2.0. Voir le numéro #50162 sur GitHub.

• Accès restreint aux paramètres du tableau de bord : vous ne pouvez plus ouvrir les paramètres du tableau de bord lorsque vous modifiez des panneaux.

  Les paramètres du tableau de bord sont verrouillés lorsque le mode d'édition du panneau est actif. Fermez le mode d'édition du panneau avant d'accéder aux paramètres du tableau de bord. Voir le numéro #54746 sur GitHub.

• Chiffrement des mots de passe des sources de données : les mots de passe non chiffrés ne sont plus pris en charge.

  Action requise : utilisez secureJsonData.password etsecureJsonData.basicAuthPassword. Abandonné précédemment dans la version 8.1.0. Voir le numéro #49987 sur GitHub.

• Comportement de la source de données par défaut : la sélection de la source de données par défaut n'affecte plus les panneaux existants.

  La source de données par défaut s'applique uniquement aux nouveaux panneaux. La modification de la valeur par défaut ne mettra pas à jour les tableaux de bord existants. Les panneaux précédemment enregistrés conservent leur configuration de source de données. Voir le numéro #45132 sur GitHub.

• Modification de la propriété d'intervalle Elasticsearch — Spécification de l'intervalle de requête mise à jour pour Elasticsearch 7.x.

  Transformé interval de fixed_interval propriété. Assure la cohérence avec Elasticsearch 8.x. La plupart des requêtes n'afficheront pas de modifications visibles. Voir le numéro #50297 sur GitHub.

• Mode document brut d'Elasticsearch abandonné : modifications du mode d'affichage dans la source de données Elasticsearch.

  Action requise : utilisez plutôt le mode Données brutes. Voir le numéro #62236 sur GitHub.

• Support des versions d'Elasticsearch : les anciennes versions d'Elasticsearch ne sont plus prises en charge.

  Action requise : mettez à niveau Elasticsearch vers la version 7.10.0 ou ultérieure. Les versions inférieures à 7.10.0 sont passées. end-of-life Voir le numéro #48715 sur GitHub.

• Le format d'URL Explore n'est plus disponible — Compact Explore URLs sera supprimé dans une future version.

  Action requise : mettez à jour les liens codés en dur pour utiliser le format d'URL standard. Compact URLs :&left=["now-1h","now"...]. Norme URLs :&left={"datasource":"test"...}. Voir le numéro #50873 sur GitHub.

• GitHub OAuth affichage des modifications : affichage GitHub du nom et de l'identifiant mis à jour.

  GitHub le nom apparaît sous la forme du nom de Grafana. GitHub login apparaît sous la forme de login Grafana. Améliore la clarté de l'identification des utilisateurs. Voir le numéro #45438 sur GitHub.

• Mise à jour de l'implémentation des panneaux Heatmap — Les panneaux Heatmap utilisent une nouvelle implémentation à partir de la version 9.1.0.

  Performances de rendu nettement améliorées. Les seaux sont placés sur des bordures raisonnables (1 m, 5 m, 30 s). Les cellules rondes ne sont plus prises en charge.

  Action requise : testez vos panneaux Heatmap après la mise à niveau. Désactivez la nouvelle implémentation en définissant l'indicateur de useLegacyHeatmapPanel fonctionnalité sur true si nécessaire. Ajouter ?__feature.useLegacyHeatmapPanel=true au tableau de bord URLs pour les tests. Voir le numéro #50229 sur GitHub.

• Migration du backend InfluxDB — Le comportement d'analyse des données d'InfluxDB a changé.

  La fonction de migration du backend InfluxDB toggle (influxdbBackendMigration) est réintroduite en raison de problèmes de traitement du backend. Par défaut, les données InfluxDB sont analysées dans le frontend. Si vous êtes passé à la version 9.4.4 et que vous avez ajouté des transformations sur les données InfluxDB, le rendu de ces panneaux ne sera pas possible.

  Action requise : Supprimez les panneaux concernés et recréez-les, ou modifiez le time champ comme Time dans panel.json oudashboard.json. Voir le numéro #64842 sur GitHub.

• Format des messages de journal mis à jour — La structure des messages de journal a été modifiée.

  lvlc'est maintenantlevel. eroret dbug sont maintenant error etdebug. Précision d'horodatage accrue. Possibilité de se désinscrire en activant les oldlog fonctionnalités (temporaire). Voir le numéro #47584 sur GitHub.

• Optimisation du format de données Loki — Loki enregistre les données en utilisant un format de trame de données plus efficace.

  Dataframe unique avec colonne d'étiquettes au lieu de dataframes séparées. Les panneaux Explore et Logs fonctionnent sans modification. D'autres panneaux ou transformations peuvent nécessiter un ajustement.

  Action requise : remplacez les libellés par la transformation des champs par la transformation des champs d'extraction. Voir le numéro #47153 sur GitHub.

• Gestion des valeurs NaN — NaN Représentation cohérente entre les sources de données Prometheus et Loki.

  NaNles valeurs restent telles qu'NaNelles ne sont pas converties ennull. Le changement doit être généralement invisible pour les utilisateurs. Affecte à la fois le tableau de bord et les chemins d'alerte. Voir les numéros #49475 et #45389 sur GitHub.

• Liens de réinitialisation de mot de passe invalidés — Les liens de réinitialisation de mot de passe existants ne fonctionneront pas après la mise à niveau.

  Les liens pour réinitialiser le mot de passe envoyés avant la mise à niveau ne sont pas valides. Les utilisateurs doivent demander de nouveaux liens de réinitialisation de mot de passe. Les liens expirent au bout de 2 heures. Voir le numéro #42334 sur GitHub.

• Préfixe d'étiquette réservée : les étiquettes commençant par grafana_ sont réservées.

  Les étiquettes configurées manuellement commençant par grafana_ peuvent être remplacées. Libellés réservés actuels : grafana_folder (Titre du dossier contenant l'alerte). Voir le numéro #50262 sur GitHub.

• Améliorations apportées à la transformation : la transformation Rename by regex prend désormais en charge les modèles mondiaux.

  Les modèles globaux utilisent le format/<stringToReplace>/g. Certaines transformations peuvent se comporter différemment. Enveloppez les chaînes correspondantes dans des barres obliques pour le comportement précédent : (.*) becomes. /(.*)/ Voir le numéro #48179 sur GitHub.