Latest releases

------	GLPI 11	GLPI 10
Download	1.1.0	1.0.0
Branch	main	support/glpi10
Status	Latest	Supported

English version

Grafana integration with GLPI

This plugin is a modified version of the GLPI metabase plugin that allows you to embed Grafana dashboards directly into GLPI.

Requirements

• GLPI 11.x (for GLPI 10.x support, see the support/glpi10 branch)
• PHP 8.1+
• A Grafana instance accessible from the GLPI server

Installation

1. Download the latest release zip from the Releases page.
2. Extract the grafana folder into <glpi_root>/plugins/.
3. In GLPI: Setup > Plugins, find Grafana and click Install, then Enable.

Features

• Embed Grafana dashboards directly inside GLPI
• Granular permissions: assign dashboard access per user, group, profile, or entity
• Forward GLPI session data to Grafana as URL variables (user, entity, profile, groups, language)
• Set a default dashboard tab per profile or user
• Dashboard tree view with folder support

Plugin configuration

GLPI configuration

On the plugin's configuration page, you will need to provide the following information:

1. Grafana URL: The URL of the Grafana server you want to connect to.
2. & 3. Grafana Credentials: The username and password of a Grafana user. The plugin will use this account to connect to the API, retrieve the list of dashboards, and authenticate users to view them inside GLPI. You can control which dashboards are available by limiting this user's access within Grafana.
4. JWKS URL: This URL is required later when you configure authentication in Grafana.
5. Use Light Theme: Check this box to make the plugin use Grafana's light theme instead of the default dark theme.

Grafana server configuration

You'll need to modify the following parameters in your grafana.ini file.

Most parameters are self-explanatory, but here are a few key points:

• Note that the allow_embedding option is not in the same configuration block as the other options.

5. Login URL: Use the JWKS URL provided by the Grafana plugin in the previous section (point 4).
6. "sub" Parameter: This must match the username you entered in the plugin configuration (point 2).

Session variables

The plugin can forward GLPI session data to Grafana dashboards as URL variables (var-*). This allows Grafana to filter or personalize dashboards based on the logged-in user's context.

On the configuration page, enable the variables you want to forward:

Available variables:

Variable	Description
var-glpi_user_id	User ID
var-glpi_username	Username (login)
var-glpi_firstname	First name
var-glpi_lastname	Last name
var-glpi_entity_id	Active entity ID
var-glpi_entity_name	Active entity name
var-glpi_entity_ids	All active entity IDs (comma-separated)
var-glpi_profile_id	Active profile ID
var-glpi_profile_name	Active profile name
var-glpi_groups	Groups (comma-separated IDs)
var-glpi_language	Language

To use them in Grafana, create dashboard variables with the same names (without the var- prefix).

Permissions configuration

Once everything is configured, click the Permissions button on the plugin configuration page to open the permissions management page.

From there you can assign dashboard access individually to users, groups, profiles, or entities. Each entry lets you select which specific dashboards are visible.

---

Español

Este plugin es una versión modificada del plugin de Metabase para GLPI que permite incrustar paneles de Grafana directamente en GLPI.

Requisitos

• GLPI 11.x (para soporte de GLPI 10.x, ver la rama support/glpi10)
• PHP 8.1+
• Una instancia de Grafana accesible desde el servidor de GLPI

Instalación

1. Descargar el zip de la última versión desde la página de Releases.
2. Extraer la carpeta grafana dentro de <raiz_glpi>/plugins/.
3. En GLPI: Configuración > Complementos, buscar Grafana y hacer clic en Instalar, luego en Activar.

Funcionalidades

• Incrustar paneles de Grafana directamente dentro de GLPI
• Permisos granulares: asignar acceso a paneles por usuario, grupo, perfil o entidad
• Enviar datos de sesión de GLPI a Grafana como variables de URL (usuario, entidad, perfil, grupos, idioma)
• Establecer un panel por defecto por perfil o usuario
• Vista de árbol de paneles con soporte de carpetas

Configuración del plugin

Configuración en GLPI

En la página de configuración del plugin dentro de GLPI, necesitarás proporcionar la siguiente información:

1. URL de Grafana: La URL del servidor de Grafana al que deseas conectarte.
2. & 3. Credenciales de Grafana: El nombre de usuario y la contraseña de un usuario de Grafana. El plugin utilizará esta cuenta para conectarse a la API, obtener la lista de paneles y autenticar a los usuarios para que puedan verlos dentro de GLPI. Se puede controlar qué paneles aparecen limitando los permisos de este usuario directamente en Grafana.
4. URL del JWKS: Esta URL será necesaria más adelante cuando configures la autenticación en Grafana.
5. Usar Tema Claro: Marcar esta casilla para que el plugin utilice el tema claro de Grafana en lugar del tema oscuro por defecto.

Configuración del servidor Grafana

A continuación, se deben modificar los siguientes parámetros en tu archivo grafana.ini.

La mayoría de los parámetros son autoexplicativos, algunas notas:

• Tener en cuenta que la opción allow_embedding no se encuentra en el mismo bloque de configuración que las demás.

5. url_login: Utiliza la URL proporcionada por el plugin en la sección anterior (punto 4).
6. parámetro sub: Debe coincidir con el nombre de usuario que ingresaste en la configuración del plugin (punto 2).

Variables de sesión

El plugin puede enviar datos de la sesión de GLPI a los paneles de Grafana como variables de URL (var-*). Esto permite que Grafana filtre o personalice los paneles según el contexto del usuario conectado.

En la página de configuración, activar las variables que se quieran enviar:

Variables disponibles:

Variable	Descripción
var-glpi_user_id	ID de usuario
var-glpi_username	Nombre de usuario (login)
var-glpi_firstname	Nombre
var-glpi_lastname	Apellido
var-glpi_entity_id	ID de entidad activa
var-glpi_entity_name	Nombre de entidad activa
var-glpi_entity_ids	Todos los IDs de entidades activas (separados por coma)
var-glpi_profile_id	ID de perfil activo
var-glpi_profile_name	Nombre de perfil activo
var-glpi_groups	Grupos (IDs separados por coma)
var-glpi_language	Idioma

Para usarlas en Grafana, crear variables de dashboard con los mismos nombres (sin el prefijo var-).

Configuración de permisos

Una vez configurado todo, hacer clic en el botón Permisos de la página de configuración del plugin para abrir la página de gestión de permisos.

Desde ahí se puede asignar acceso a paneles individualmente a usuarios, grupos, perfiles o entidades. Cada entrada permite seleccionar qué paneles específicos son visibles.