Module d'extension Grafana
Cette rubrique fournit des instructions sur l'Installation, la configuration et l'utilisation de Oracle Cloud Infrastructure Data Source for Grafana.
Cette rubrique fournit des instructions pour l'installation, la configuration et l'utilisation de l'origine de données Oracle Cloud Infrastructure pour Grafana, également référencée comme module d'extension de Grafana.
Présentation du module d'extension Grafana
Grafana est un outil d'alerte et de visualisation open source que vous pouvez utiliser pour l'analyse et la surveillance des données de série temporelle (mesures). Même si les mesures d'Oracle Cloud Infrastructure Monitoring sont visibles dans les graphiques de mesure via la console, vous pouvez utiliser Oracle Cloud Infrastructure Data Source for Grafana ("module d'extension Grafana") afin d'afficher les mesures des ressources des différents fournisseurs sur un même tableau de bord Grafana.
Prérequis pour l'utilisation du module d'extension Grafana
- Un compte Oracle Cloud Infrastructure.
- Un utilisateur dans ce compte, dans un groupe d'accès doté d'une stratégie IAM qui octroie les privilèges d'accès nécessaires à l'utilisation des ressources dans le compartiment de compte. La stratégie doit vous donner accès aux espaces de noms des mesures qui émettent des mesures (comme Compute) ainsi qu'aux ressources associées (comme un ensemble d'instances de calcul). Si vous essayez d'effectuer une action et qu'un message vous indique que vous n'y êtes pas autorisé, vérifiez auprès de l'administre le type d'accès qui vous a été accordé et dans quel compartiment vous devez travailler. Administrateurs : pour les stratégies courantes qui donnent aux groupes accès aux mesures, reportez-vous à Accès aux mesures pour les groupes. Pour autoriser des ressources, telles que des instances, à effectuer des appels d'API, ajoutez-les à un groupe dynamique via ses règles de mise en correspondance, puis créez une stratégie autorisant ce groupe dynamique à accéder aux mesures. Pour autoriser l'accès aux différents compartiments, créez la stratégie dans la location. En raison du concept d'héritage de stratégie, les instances dans le groupe dynamique indiqué peuvent accéder aux mesures dans n'importe quel compartiment. Pour limiter la portée de l'accès à un compartiment particulier, spécifiez ce compartiment au lieu de la location. Reportez-vous à Accès aux mesures pour les ressources.
- Instances Compute : pour émettre des mesures, le modules d'extension de surveillance des instances Compute doit être activé sur l'instance et les modules d'application doivent être en cours d'exécution. L'instance doit également disposer d'une passerelle de service ou d'une adresse IP publique pour envoyer des indicateurs au service Monitoring. Pour plus d'informations, reportez-vous à Activation de la surveillance pour les instances Compute.
- Clés et ID d'Oracle Cloud Infrastructure (OCID). Pour obtenir de l'aide, reportez-vous à Clés et OCID requis.
Téléchargement et installation du module d'extension Grafana
Grafana doit être installé pour pouvoir installer le module d'extension Grafana. La version 3.0 ou ultérieure est requise.
L'authentification pour l'accès aux mesures dépend de l'emplacement d'exécution de Grafana. Si vous exécutez Grafana sur unordinateur local en dehors d´Oracle Cloud Infrastructure, vous devez appeler l´API Monitoring à l´aide de l´interface de ligne de commande. Si vous exécutez Grafana sur une instance de calcul Oracle Cloud Infrastructure que vous venez de créer, vous pouvez ajouter l'instance à un groupe dynamique en configurant une règle de mise en correspondance. Dans tous les scénarios, vous avez la possibilité d'appeler l'API à l'aide de l'interface de ligne de commande.
Pour savoir comment installer le module d'extension Grafana (source de données d'Oracle Cloud Infrastructure pour Grafana), reportez-vous à https://github.com/oracle/oci-grafana-plugin.
Configuration du module d'extension Grafana
Cette section explique comment ajouter le module d'extension Grafana et comment configurer un tableau de bord.
Lorsqu'il est installé localement, le module d'extension de Grafana accède aux mesures via les appels à l'API Monitoring.
-
Configurez la CLI de sorte à accéder aux API Oracle Cloud Infrastructure.
Vous devez accéder à l'API Monitoring pour l'authentification.
-
Accédez à la page d'accueil de Grafana à l'URL suivante.
-
Ajout du module d'extension Grafana (source de données d'Oracle Cloud Infrastructure pour Grafana).
En plus des étapes ci-dessous, reportez-vous aux instructions Grafana pour ajouter des sources de données, à l'adresse https://grafana.com/docs/grafana/latest/getting-started/getting-started/.
- Dans Grafana, sur le tableau de bord d'accueil, cliquez sur l'icône représentant un engrenage à gauche.
- Cliquez sur Ajouter une source données.
- Dans la zone de texte de filtre, saisissez : oracle-oci-datasource
- Dans la liste filtrée, sélectionnez oracle-oci-datasource.
-
Sur la page Paramètres, indiquez l'OCID de location, la région par défaut et l'environnement. Pour Environnement, choisissez Local.
- Configurez un tableau de bord de type Graphique.
-
(Facultatif) Pour vérifier l'accès aux mesures d'Oracle Cloud Infrastructure, mettez à jour la requête de tableau de bord ("Mesures") avec une région, un compartiment, un espace de noms ou un indicateur spécifique. Vous pouvez également ajouter d'autres dimensions.
Félicitations. Vous pouvez à présent afficher vos mesures d'Oracle Cloud Infrastructure dans Grafana.
local est pour les déploiements Grafana en dehors d'Oracle Cloud Infrastructure.
Instance OCI est pour les déploiements Grafana sur des ressources Oracle Cloud Infrastructure.
La source de données est Alors ajoutée, ce qui vous permet de configurer un tableau qui affiche des mesures issues d'Oracle Cloud Infrastructure.
Dépannage du module d'extension
Si les options de la requête de tableaux de bord ("Mesures") n'ont pas pu être renseignées ou si vous rencontrez d' autres problèmes d'accès à des mesures, il est possible que la stratégie IAM utilisée afin d'accéder aux mesures aient un format incorrect ou qu'elle n'inclue pas toutes les règles de mise à correspondance requises pour votre groupe dynamique (pour l'exécution de l'instance de calcul Grafana sur une instance de calcul Oracle Cloud Infrastructure que vous aurez créée).
Pour résoudre ce problème, effectuez la procédure suivante.
- Vérifiez que votre stratégie IAM respecte les prérequis.
- Si vous avez mis à jour votre stratégie IAM, redémarrez le serveur Grafana et actualisez la page d'écoute Grafana.