Sim

Grafana

Interagissez avec les tableaux de bord, les alertes et les annotations Grafana

Grafana est une plateforme open-source de premier plan pour la surveillance, l'observabilité et la visualisation. Elle permet aux utilisateurs d'interroger, de visualiser, d'alerter et d'analyser des données provenant de diverses sources, ce qui en fait un outil essentiel pour la surveillance des infrastructures et des applications.

Avec Grafana, vous pouvez :

  • Visualiser des données : créer et personnaliser des tableaux de bord pour afficher des métriques, des journaux et des traces en temps réel
  • Surveiller la santé et le statut : vérifier la santé de votre instance Grafana et des sources de données connectées
  • Gérer les alertes et les annotations : configurer des règles d'alerte, gérer les notifications et annoter les tableaux de bord avec des événements importants
  • Organiser le contenu : organiser les tableaux de bord et les sources de données dans des dossiers pour une meilleure gestion des accès

Dans Sim, l'intégration Grafana permet à vos agents d'interagir directement avec votre instance Grafana via API, permettant des actions telles que :

  • Vérifier l'état de santé du serveur Grafana, de la base de données et des sources de données
  • Récupérer, lister et gérer les tableaux de bord, les règles d'alerte, les annotations, les sources de données et les dossiers
  • Automatiser la surveillance de votre infrastructure en intégrant les données et les alertes Grafana dans vos automatisations de flux de travail

Ces capacités permettent aux agents Sim de surveiller les systèmes, de répondre de manière proactive aux alertes et d'aider à assurer la fiabilité et la visibilité de vos services — le tout dans le cadre de vos flux de travail automatisés.

Instructions d'utilisation

Intégrez Grafana dans les flux de travail. Gérez les tableaux de bord, les alertes, les annotations, les sources de données, les dossiers et surveillez l'état de santé.

Outils

grafana_get_dashboard

Obtenir un tableau de bord par son UID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com\)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
dashboardUidstringOuiL'UID du tableau de bord à récupérer

Sortie

ParamètreTypeDescription
dashboardjsonL'objet JSON complet du tableau de bord
metajsonMétadonnées du tableau de bord (version, permissions, etc.)

grafana_list_dashboards

Rechercher et lister tous les tableaux de bord

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
querystringNonRequête de recherche pour filtrer les tableaux de bord par titre
tagstringNonFiltrer par tag (séparés par des virgules pour plusieurs tags)
folderIdsstringNonFiltrer par ID de dossier (séparés par des virgules)
starredbooleanNonRenvoyer uniquement les tableaux de bord favoris
limitnumberNonNombre maximum de tableaux de bord à renvoyer

Sortie

ParamètreTypeDescription
dashboardsarrayListe des résultats de recherche de tableaux de bord

grafana_create_dashboard

Créer un nouveau tableau de bord

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
titlestringOuiLe titre du nouveau tableau de bord
folderUidstringNonL'UID du dossier dans lequel créer le tableau de bord
tagsstringNonListe de tags séparés par des virgules
timezonestringNonFuseau horaire du tableau de bord (ex., browser, utc)
refreshstringNonIntervalle d'actualisation automatique (ex., 5s, 1m, 5m)
panelsstringNonTableau JSON des configurations de panneaux
overwritebooleanNonÉcraser le tableau de bord existant avec le même titre
messagestringNonMessage de commit pour la version du tableau de bord

Sortie

ParamètreTypeDescription
idnumberL'ID numérique du tableau de bord créé
uidstringL'UID du tableau de bord créé
urlstringLe chemin d'URL vers le tableau de bord
statusstringStatut de l'opération (success)
versionnumberLe numéro de version du tableau de bord
slugstringSlug convivial pour l'URL du tableau de bord

grafana_update_dashboard

Mettre à jour un tableau de bord existant. Récupère le tableau de bord actuel et fusionne vos modifications.

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiToken de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com\)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations
dashboardUidstringOuiL'UID du tableau de bord à mettre à jour
titlestringNonNouveau titre pour le tableau de bord
folderUidstringNonNouvel UID de dossier pour déplacer le tableau de bord
tagsstringNonListe de nouvelles étiquettes séparées par des virgules
timezonestringNonFuseau horaire du tableau de bord (ex. : browser, utc)
refreshstringNonIntervalle d'actualisation automatique (ex. : 5s, 1m, 5m)
panelsstringNonTableau JSON des configurations de panneaux
overwritebooleanNonÉcraser même en cas de conflit de version
messagestringNonMessage de commit pour cette version

Sortie

ParamètreTypeDescription
idnumberL'ID numérique du tableau de bord mis à jour
uidstringL'UID du tableau de bord mis à jour
urlstringLe chemin URL vers le tableau de bord
statusstringStatut de l'opération (success)
versionnumberLe nouveau numéro de version du tableau de bord
slugstringSlug convivial pour URL du tableau de bord

grafana_delete_dashboard

Supprimer un tableau de bord par son UID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiToken de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com\)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations
dashboardUidstringOuiL'UID du tableau de bord à supprimer

Sortie

ParamètreTypeDescription
titlestringLe titre du tableau de bord supprimé
messagestringMessage de confirmation
idnumberL'ID du tableau de bord supprimé

grafana_list_alert_rules

Lister toutes les règles d'alerte dans l'instance Grafana

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiToken de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com\)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations

Sortie

ParamètreTypeDescription
rulesarrayListe des règles d'alerte

grafana_get_alert_rule

Obtenir une règle d'alerte spécifique par son UID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
alertRuleUidstringOuiL'UID de la règle d'alerte à récupérer

Sortie

ParamètreTypeDescription
uidstringUID de la règle d'alerte
titlestringTitre de la règle d'alerte
conditionstringCondition d'alerte
datajsonDonnées de requête de la règle d'alerte
folderUIDstringUID du dossier parent
ruleGroupstringNom du groupe de règles
noDataStatestringÉtat lorsqu'aucune donnée n'est retournée
execErrStatestringÉtat en cas d'erreur d'exécution
annotationsjsonAnnotations d'alerte
labelsjsonÉtiquettes d'alerte

grafana_create_alert_rule

Créer une nouvelle règle d'alerte

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
titlestringOuiLe titre de la règle d'alerte
folderUidstringOuiL'UID du dossier dans lequel créer l'alerte
ruleGroupstringOuiLe nom du groupe de règles
conditionstringOuiLe refId de la requête ou de l'expression à utiliser comme condition d'alerte
datastringOuiTableau JSON d'objets de données de requête/expression
forDurationstringNonDurée d'attente avant déclenchement (ex., 5m, 1h)
noDataStatestringNonÉtat lorsqu'aucune donnée n'est retournée (NoData, Alerting, OK)
execErrStatestringNonÉtat en cas d'erreur d'exécution (Alerting, OK)
annotationsstringNonObjet JSON d'annotations
labelsstringNonObjet JSON d'étiquettes

Sortie

ParamètreTypeDescription
uidstringL'UID de la règle d'alerte créée
titlestringTitre de la règle d'alerte
folderUIDstringUID du dossier parent
ruleGroupstringNom du groupe de règles

grafana_update_alert_rule

Mettre à jour une règle d'alerte existante. Récupère la règle actuelle et fusionne vos modifications.

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
alertRuleUidstringOuiL'UID de la règle d'alerte à mettre à jour
titlestringNonNouveau titre pour la règle d'alerte
folderUidstringNonNouvel UID de dossier pour déplacer l'alerte
ruleGroupstringNonNouveau nom du groupe de règles
conditionstringNonNouvelle référence de condition
datastringNonNouveau tableau JSON d'objets de données de requête/expression
forDurationstringNonDurée d'attente avant déclenchement (ex. : 5m, 1h)
noDataStatestringNonÉtat en l'absence de données (NoData, Alerting, OK)
execErrStatestringNonÉtat en cas d'erreur d'exécution (Alerting, OK)
annotationsstringNonObjet JSON d'annotations
labelsstringNonObjet JSON d'étiquettes

Sortie

ParamètreTypeDescription
uidstringL'UID de la règle d'alerte mise à jour
titlestringTitre de la règle d'alerte
folderUIDstringUID du dossier parent
ruleGroupstringNom du groupe de règles

grafana_delete_alert_rule

Supprimer une règle d'alerte par son UID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (par ex., https://your-grafana.com)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations
alertRuleUidstringOuiL'UID de la règle d'alerte à supprimer

Sortie

ParamètreTypeDescription
messagestringMessage de confirmation

grafana_list_contact_points

Lister tous les points de contact de notification d'alerte

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (par ex., https://your-grafana.com)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations

Sortie

ParamètreTypeDescription
contactPointsarrayListe des points de contact

grafana_create_annotation

Créer une annotation sur un tableau de bord ou comme annotation globale

Entrée

ParamètreTypeObligatoireDescription
apiKeychaîneOuiJeton de compte de service Grafana
baseUrlchaîneOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdchaîneNonID d'organisation pour les instances Grafana multi-organisations
textchaîneOuiLe contenu textuel de l'annotation
tagschaîneNonListe de tags séparés par des virgules
dashboardUidchaîneNonUID du tableau de bord auquel ajouter l'annotation (facultatif pour les annotations globales)
panelIdnombreNonID du panneau auquel ajouter l'annotation
timenombreNonHeure de début en millisecondes d'époque (par défaut : maintenant)
timeEndnombreNonHeure de fin en millisecondes d'époque (pour les annotations de plage)

Sortie

ParamètreTypeDescription
idnombreL'ID de l'annotation créée
messagechaîneMessage de confirmation

grafana_list_annotations

Interroger les annotations par plage de temps, tableau de bord ou tags

Entrée

ParamètreTypeObligatoireDescription
apiKeychaîneOuiJeton de compte de service Grafana
baseUrlchaîneOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdchaîneNonID d'organisation pour les instances Grafana multi-organisations
fromnombreNonHeure de début en millisecondes d'époque
tonombreNonHeure de fin en millisecondes d'époque
dashboardUidchaîneNonFiltrer par UID de tableau de bord
panelIdnombreNonFiltrer par ID de panneau
tagschaîneNonListe de tags séparés par des virgules pour filtrer
typechaîneNonFiltrer par type (alerte ou annotation)
limitnombreNonNombre maximum d'annotations à retourner

Sortie

ParamètreTypeDescription
annotationsarrayListe des annotations

grafana_update_annotation

Mettre à jour une annotation existante

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
annotationIdnumberOuiL'ID de l'annotation à mettre à jour
textstringOuiNouveau contenu textuel pour l'annotation
tagsstringNonListe de nouvelles balises séparées par des virgules
timenumberNonNouvelle heure de début en millisecondes d'époque
timeEndnumberNonNouvelle heure de fin en millisecondes d'époque

Sortie

ParamètreTypeDescription
idnumberL'ID de l'annotation mise à jour
messagestringMessage de confirmation

grafana_delete_annotation

Supprimer une annotation par son ID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com)
organizationIdstringNonID de l'organisation pour les instances Grafana multi-organisations
annotationIdnumberOuiL'ID de l'annotation à supprimer

Sortie

ParamètreTypeDescription
messagestringMessage de confirmation

grafana_list_data_sources

Lister toutes les sources de données configurées dans Grafana

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations

Sortie

ParamètreTypeDescription
dataSourcesarrayListe des sources de données

grafana_get_data_source

Obtenir une source de données par son ID ou UID

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiJeton de compte de service Grafana
baseUrlstringOuiURL de l'instance Grafana (ex. : https://your-grafana.com)
organizationIdstringNonID d'organisation pour les instances Grafana multi-organisations
dataSourceIdstringOuiL'ID ou l'UID de la source de données à récupérer

Sortie

ParamètreTypeDescription
idnumberID de la source de données
uidstringUID de la source de données
namestringNom de la source de données
typestringType de source de données
urlstringURL de connexion de la source de données
databasestringNom de la base de données (si applicable)
isDefaultbooleanIndique si c'est la source de données par défaut
jsonDatajsonConfiguration supplémentaire de la source de données

grafana_list_folders

Lister tous les dossiers dans Grafana

Entrée

ParamètreTypeObligatoireDescription
apiKeychaîneOuiJeton de compte de service Grafana
baseUrlchaîneOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdchaîneNonID de l'organisation pour les instances Grafana multi-organisations
limitnombreNonNombre maximum de dossiers à retourner
pagenombreNonNuméro de page pour la pagination

Sortie

ParamètreTypeDescription
folderstableauListe des dossiers

grafana_create_folder

Créer un nouveau dossier dans Grafana

Entrée

ParamètreTypeObligatoireDescription
apiKeychaîneOuiJeton de compte de service Grafana
baseUrlchaîneOuiURL de l'instance Grafana (ex., https://your-grafana.com\)
organizationIdchaîneNonID de l'organisation pour les instances Grafana multi-organisations
titlechaîneOuiLe titre du nouveau dossier
uidchaîneNonUID optionnel pour le dossier (généré automatiquement si non fourni)

Sortie

ParamètreTypeDescription
idnombreL'ID numérique du dossier créé
uidchaîneL'UID du dossier créé
titlechaîneLe titre du dossier créé
urlchaîneLe chemin URL vers le dossier

Notes

  • Catégorie : tools
  • Type : grafana
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started