Grafana

Interactúa con paneles, alertas y anotaciones de Grafana

Configuración

Listar paneles

Operación
Listar paneles
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Consulta de búsqueda
Filtrar paneles por título
Filtrar por etiqueta
tag1, tag2 (separadas por comas)
Listar dashboards (grafana_list_dashboards)

Buscar y listar todos los dashboards

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
querystringNoConsulta de búsqueda para filtrar dashboards por título
tagstringNoFiltrar por etiqueta (separadas por comas si hay varias)
folderIdsstringNoFiltrar por ID de carpetas (separados por comas)
starredbooleanNoDevolver solo dashboards destacados
limitnumberNoNúmero máximo de dashboards que devolver
Salida
ParámetroTipoDescripción
dashboardsarrayLista de resultados de búsqueda de dashboards

Obtener dashboard

Operación
Obtener dashboard
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: instancias con varias organizaciones
UID del dashboard*
Introduce el UID del dashboard
Obtener dashboard (grafana_get_dashboard)

Obtener un dashboard por su UID

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
dashboardUidstringSíUID del dashboard que se va a recuperar
Salida
ParámetroTipoDescripción
dashboardjsonEl objeto JSON completo del dashboard
metajsonMetadatos del dashboard (versión, permisos, etc.)

Crear dashboard

Operación
Crear dashboard
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Título del dashboard*
Introduzca el título del dashboard
UID de carpeta
Opcional: carpeta donde crear el dashboard
Etiquetas
tag1, tag2 (separadas por comas)
Paneles (JSON)
Array JSON de configuraciones de paneles
Mensaje de commit
Mensaje de versión opcional
Crear dashboard (grafana_create_dashboard)

Crear un dashboard nuevo

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
titlestringSíEl título del nuevo dashboard
folderUidstringNoEl UID de la carpeta donde crear el dashboard
tagsstringNoLista de etiquetas separadas por comas
timezonestringNoZona horaria del dashboard (p. ej., browser, utc)
refreshstringNoIntervalo de actualización automática (p. ej., 5s, 1m, 5m)
panelsstringNoArray JSON de configuraciones de paneles
overwritebooleanNoSobrescribir el dashboard existente con el mismo título
messagestringNoMensaje de commit de la versión del dashboard
Salida
ParámetroTipoDescripción
idnumberEl ID numérico del dashboard creado
uidstringEl UID del dashboard creado
urlstringLa ruta URL del dashboard
statusstringEstado de la operación (success)
versionnumberEl número de versión del dashboard
slugstringSlug del dashboard compatible con URL

Actualizar dashboard

Operación
Actualizar dashboard
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID del dashboard*
Introduce el UID del dashboard
UID de la carpeta
Opcional: carpeta donde crear el dashboard
Etiquetas
tag1, tag2 (separadas por comas)
Paneles (JSON)
Array JSON de configuraciones de paneles
Mensaje de commit
Mensaje de versión opcional
Actualizar dashboard (grafana_update_dashboard)

Actualiza un dashboard existente. Obtiene el dashboard actual y fusiona tus cambios.

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
dashboardUidstringSíUID del dashboard que se va a actualizar
titlestringNoNuevo título del dashboard
folderUidstringNoNuevo UID de carpeta al que mover el dashboard
tagsstringNoLista de etiquetas nuevas separadas por comas
timezonestringNoZona horaria del dashboard (p. ej., browser, utc)
refreshstringNoIntervalo de actualización automática (p. ej., 5s, 1m, 5m)
panelsstringNoArray JSON de configuraciones de paneles
overwritebooleanNoSobrescribir aunque haya un conflicto de versión
messagestringNoMensaje de commit de esta versión
Salida
ParámetroTipoDescripción
idnumberID numérico del dashboard actualizado
uidstringUID del dashboard actualizado
urlstringRuta URL del dashboard
statusstringEstado de la operación (success)
versionnumberNuevo número de versión del dashboard
slugstringSlug del dashboard compatible con URL

Eliminar dashboard

Operación
Eliminar dashboard
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID del dashboard*
Introduce el UID del dashboard
Eliminar dashboard (grafana_delete_dashboard)

Elimina un dashboard por su UID

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
dashboardUidstringSíUID del dashboard que se va a eliminar
Salida
ParámetroTipoDescripción
titlestringTítulo del dashboard eliminado
messagestringMensaje de confirmación
idnumberID del dashboard eliminado

Listar reglas de alerta

Operación
Listar reglas de alerta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Listar reglas de alerta (grafana_list_alert_rules)

Lista todas las reglas de alerta de la instancia de Grafana

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
Salida
ParámetroTipoDescripción
rulesarrayLista de reglas de alerta

Obtener regla de alerta

Operación
Obtener regla de alerta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID de regla de alerta*
Introducir UID de la regla de alerta
Obtener regla de alerta (grafana_get_alert_rule)

Obtener una regla de alerta específica por su UID

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
alertRuleUidstringSíUID de la regla de alerta que se va a obtener
Salida
ParámetroTipoDescripción
uidstringUID de la regla de alerta
titlestringTítulo de la regla de alerta
conditionstringCondición de alerta
datajsonDatos de consulta de la regla de alerta
folderUIDstringUID de la carpeta principal
ruleGroupstringNombre del grupo de reglas
noDataStatestringEstado cuando no hay datos
execErrStatestringEstado ante un error de ejecución
annotationsjsonAnotaciones de alerta
labelsjsonEtiquetas de alerta

Crear regla de alerta

Operación
Crear regla de alerta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID de carpeta
Opcional: carpeta donde crear el panel
Título de alerta
Nombre de la regla de alerta
UID de carpeta
UID de la carpeta de la regla de alerta
Grupo de reglas
Nombre del grupo de reglas
Condición
refId de la condición (p. ej., A)
Datos de consulta (JSON)
Array JSON de objetos de datos de consulta/expresión
Duración
5m (p. ej., 5m, 1h)
Estado sin datos
Sin datos
Estado de error
Alertando
Crear regla de alerta (grafana_create_alert_rule)

Crear una nueva regla de alerta

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
titlestringSíEl título de la regla de alerta
folderUidstringSíEl UID de la carpeta en la que crear la alerta
ruleGroupstringSíEl nombre del grupo de reglas
conditionstringSíEl refId de la consulta o expresión que se usará como condición de la alerta
datastringSíArray JSON de objetos de datos de consulta/expresión
forDurationstringNoDuración de espera antes de disparar (p. ej., 5m, 1h)
noDataStatestringNoEstado cuando no se devuelven datos (NoData, Alerting, OK)
execErrStatestringNoEstado ante un error de ejecución (Alerting, OK)
annotationsstringNoObjeto JSON de anotaciones
labelsstringNoObjeto JSON de etiquetas
Salida
ParámetroTipoDescripción
uidstringEl UID de la regla de alerta creada
titlestringTítulo de la regla de alerta
folderUIDstringUID de la carpeta padre
ruleGroupstringNombre del grupo de reglas

Actualizar regla de alerta

Operación
Actualizar regla de alerta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID de la regla de alerta*
Introduzca el UID de la regla de alerta
Título de la alerta
Introduzca el nombre de la regla de alerta
UID de la carpeta
UID de la carpeta de la regla de alerta
Grupo de reglas
Introduzca el nombre del grupo de reglas
Condición
refId de la condición (p. ej., A)
Datos de consulta (JSON)
Matriz JSON de objetos de datos de consulta/expresión
Duración For
5m (p. ej., 5m, 1h)
Estado sin datos
Sin datos
Estado de error
En alerta
Actualizar regla de alerta (grafana_update_alert_rule)

Actualiza una regla de alerta existente. Obtiene la regla actual y fusiona tus cambios.

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
alertRuleUidstringSíEl UID de la regla de alerta que se va a actualizar
titlestringNoNuevo título de la regla de alerta
folderUidstringNoNuevo UID de carpeta al que mover la alerta
ruleGroupstringNoNuevo nombre del grupo de reglas
conditionstringNoNuevo refId de condición
datastringNoNueva matriz JSON de objetos de datos de consulta/expresión
forDurationstringNoDuración de espera antes de disparar (p. ej., 5m, 1h)
noDataStatestringNoEstado cuando no se devuelven datos (NoData, Alerting, OK)
execErrStatestringNoEstado ante error de ejecución (Alerting, OK)
annotationsstringNoObjeto JSON de anotaciones
labelsstringNoObjeto JSON de etiquetas
Salida
ParámetroTipoDescripción
uidstringEl UID de la regla de alerta actualizada
titlestringTítulo de la regla de alerta
folderUIDstringUID de la carpeta principal
ruleGroupstringNombre del grupo de reglas

Eliminar regla de alerta

Operación
Eliminar regla de alerta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
UID de la regla de alerta*
Introducir UID de la regla de alerta
Eliminar regla de alerta (grafana_delete_alert_rule)

Elimina una regla de alerta por su UID

Entrada
ParameterTypeRequiredDescription
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
alertRuleUidstringSíEl UID de la regla de alerta que se va a eliminar
Salida
ParameterTypeDescription
messagestringMensaje de confirmación

Listar puntos de contacto

Operación
Listar puntos de contacto
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Listar puntos de contacto (grafana_list_contact_points)

Listar todos los puntos de contacto de notificación de alertas

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
Salida
ParámetroTipoDescripción
contactPointsarrayLista de puntos de contacto

Crear anotación

Operación
Crear anotación
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Texto de la anotación*
Escriba el texto de la anotación...
Etiquetas
tag1, tag2 (separadas por comas)
UID del dashboard*
Introduzca el UID del dashboard
ID del panel
Opcional: asociar a un panel concreto
Tiempo (epoch ms)
Opcional: de forma predeterminada, ahora
Tiempo de fin (epoch ms)
Opcional: para anotaciones de intervalo
Crear anotación (grafana_create_annotation)

Crea una anotación en un dashboard o como anotación global

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
textstringSíEl contenido de texto de la anotación
tagsstringNoLista de etiquetas separadas por comas
dashboardUidstringSíUID del dashboard al que añadir la anotación
panelIdnumberNoID del panel al que añadir la anotación
timenumberNoHora de inicio en milisegundos epoch (el valor predeterminado es ahora)
timeEndnumberNoHora de fin en milisegundos epoch (para anotaciones de intervalo)
Salida
ParámetroTipoDescripción
idnumberEl ID de la anotación creada
messagestringMensaje de confirmación

Listar anotaciones

Operación
Listar anotaciones
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Etiquetas
tag1, tag2 (separadas por comas)
UID del dashboard*
Introduce el UID del dashboard
ID del panel
Opcional: asociar a un panel concreto
Hora de inicio (epoch ms)
Filtrar desde
Hora de fin (epoch ms)
Filtrar hasta
Listar anotaciones (grafana_list_annotations)

Consultar anotaciones por intervalo de tiempo, dashboard o etiquetas

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
fromnumberNoHora de inicio en milisegundos epoch
tonumberNoHora de fin en milisegundos epoch
dashboardUidstringSíUID del dashboard del que consultar anotaciones
panelIdnumberNoFiltrar por ID de panel
tagsstringNoLista de etiquetas separadas por comas para filtrar
typestringNoFiltrar por tipo (alerta o anotación)
limitnumberNoNúmero máximo de anotaciones a devolver
Salida
ParámetroTipoDescripción
annotationsarrayLista de anotaciones

Actualizar anotación

Operación
Actualizar anotación
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Texto de la anotación*
Introducir texto de la anotación...
Etiquetas
tag1, tag2 (separadas por comas)
Hora (epoch ms)
Opcional: ahora por defecto
Hora de fin (epoch ms)
Opcional: para anotaciones de intervalo
ID de anotación*
Introducir ID de anotación
Actualizar anotación (grafana_update_annotation)

Actualizar una anotación existente

Entrada
ParameterTypeRequiredDescription
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias Grafana con varias organizaciones
annotationIdnumberSíID de la anotación que se va a actualizar
textstringSíNuevo contenido de texto de la anotación
tagsstringNoLista de etiquetas nuevas separadas por comas
timenumberNoNueva hora de inicio en milisegundos epoch
timeEndnumberNoNueva hora de fin en milisegundos epoch
Salida
ParameterTypeDescription
idnumberID de la anotación actualizada
messagestringMensaje de confirmación

Eliminar anotación

Operación
Eliminar anotación
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
ID de anotación*
Escriba el ID de anotación
Eliminar anotación (grafana_delete_annotation)

Eliminar una anotación por su ID

Entrada
ParámetroTipoRequeridoDescripción
apiKeycadenaSíToken de cuenta de servicio de Grafana
baseUrlcadenaSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdcadenaNoID de organización para instancias de Grafana multi-org
annotationIdnúmeroSíEl ID de la anotación a eliminar
Salida
ParámetroTipoDescripción
messagecadenaMensaje de confirmación

Listar fuentes de datos

Operación
Listar fuentes de datos
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional - para instancias multi-org
Listar fuentes de datos (grafana_list_data_sources)

Lista todas las fuentes de datos configuradas en Grafana

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
Salida
ParámetroTipoDescripción
dataSourcesarrayLista de fuentes de datos

Obtener fuente de datos

Operación
Obtener fuente de datos
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
ID de fuente de datos*
Introduce el ID o UID de la fuente de datos
Obtener fuente de datos (grafana_get_data_source)

Obtiene una fuente de datos por su ID o UID

Entrada
ParámetroTipoObligatorioDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
dataSourceIdstringSíEl ID o UID de la fuente de datos que se desea obtener
Salida
ParámetroTipoDescripción
idnumberID de la fuente de datos
uidstringUID de la fuente de datos
namestringNombre de la fuente de datos
typestringTipo de fuente de datos
urlstringURL de conexión de la fuente de datos
databasestringNombre de la base de datos (si aplica)
isDefaultbooleanIndica si esta es la fuente de datos predeterminada
jsonDatajsonConfiguración adicional de la fuente de datos

Listar carpetas

Operación
Listar carpetas
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias multi-org
Listar carpetas (grafana_list_folders)

Listar todas las carpetas en Grafana

Entrada
ParámetroTipoRequeridoDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (p. ej., https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana con varias organizaciones
limitnumberNoNúmero máximo de carpetas a devolver
pagenumberNoNúmero de página para la paginación
Salida
ParámetroTipoDescripción
foldersarrayLista de carpetas

Crear carpeta

Operación
Crear carpeta
URL de Grafana*
https://your-grafana.com
Token de cuenta de servicio*
••••••••
ID de organización
Opcional: para instancias con varias organizaciones
Título de la carpeta*
Introduce el título de la carpeta
UID de carpeta
Opcional: se genera automáticamente si no se proporciona
Crear carpeta (grafana_create_folder)

Crear una nueva carpeta en Grafana

Entrada
ParámetroTipoRequeridoDescripción
apiKeystringSíToken de cuenta de servicio de Grafana
baseUrlstringSíURL de la instancia de Grafana (por ejemplo, https://your-grafana.com)
organizationIdstringNoID de organización para instancias de Grafana multi-org
titlestringSíEl título de la nueva carpeta
uidstringNoUID opcional para la carpeta (generado automáticamente si no se proporciona)
Salida
ParámetroTipoDescripción
idnumberEl ID numérico de la carpeta creada
uidstringEl UID de la carpeta creada
titlestringEl título de la carpeta creada
urlstringLa ruta URL de la carpeta
hasAclbooleanSi la carpeta tiene permisos ACL personalizados
canSavebooleanSi el usuario actual puede guardar la carpeta
canEditbooleanSi el usuario actual puede editar la carpeta
canAdminbooleanSi el usuario actual tiene derechos de administrador en la carpeta
canDeletebooleanSi el usuario actual puede eliminar la carpeta
createdBystringNombre de usuario de quien creó la carpeta
createdstringMarca de tiempo de creación de la carpeta
updatedBystringNombre de usuario de quien actualizó la carpeta por última vez
updatedstringMarca de tiempo de la última actualización de la carpeta
versionnumberNúmero de versión de la carpeta

Instrucciones de uso

Integra Grafana en los flujos de trabajo. Gestiona paneles, alertas, anotaciones, fuentes de datos y carpetas, y monitorea el estado de salud.

Notas

  • Categoría: tools
  • Tipo: grafana