GLPI

Plugin con el que integrar el servicio de alertado de glpi en PandoraFMS.

Introducción

 

Este plugin tiene como finalidad poder manejar el sistema de tickets de GLPI en PandoraFMS, mediante alertas que crearan llamadas, para la creación de tickets y el seguimiento de estos.

El plugin realiza todas estas acciones mediante la API REST de glpi.

Matriz de compatibilidad

Sistemas donde se ha probado Rocky linux, Fedora 34
Sistemas donde funciona Cualquier sistema linux

Pre requisitos

Parámetros

Parámetros GLPI

-u,--user
Usuario de GLPI . Ejemplo : glpi . Obligatorio
-x,--password
Contraseña de GLPI, Ejemplo : glpi . Obligatorio
-i, --url
URL de GLPI (con el puerto), Ejemplo : http://localhost:8200. Obligatorio
-a, --app_token
Token de aplicación, Ejemplo : xZvyKomCYHSSva5oTXTNmMiy4SWzfi7O1FF. Obligatorio

Parámetros Tickets

-t,--ticket_name
Título o nombre para el ticket. Ejemplo: Incidencia módulo 8025. Obligatorio
-d,--ticket_description

Mensaje o descripción para el ticket. Ejemplo:

 "
2023-11-30 11:49:03
Free RAM
172.34.56.1
"
. Obligatorio

-p,--ticket_priority
Prioridad para el ticket. Ejemplo : 4. Obligatorio *
-c,--ticket_category
Categoría para el ticket. Ejemplo : Categoria1. Obligatorio
-g,--ticket_group
Grupo para el ticket. Ejemplo : Grupo1. Obligatorio
-j,--ticket_request_type
Tipo de request a añadir en el ticket ( campo 
requesttypes_id)
, por defecto: 8.
-k,--ticket_name_error
Titulo del ticket que se añadirá en los tickets que se creen al no haberse encontrado un computer.

Parámetros Pandora

-n,--alias_agent
Alias del agente. Ejemplo: RockyLinux8. Obligatorio
-m,--id_module
ID del módulo. Ejemplo: 8025. Obligatorio

Parámetros API Pandora

--api_url
Url de la API de Pandora. Ejemplo: http://172.42.42.101
Default: http://localhost
--api_user
Usuario de la API de Pandora. Ejemplo: admin. Default: admin
--api_pass
Contraseña del usuario de la API de Pandora. Ejemplo : pandora. Default : pandora
--api_user_pass
Contraseña del usuario de la API de Pandora. Ejemplo: 1234. Default: 1234

Parámetros extra

-l,--logfile
Ruta donde se añadirá el fichero de log. Ejemplo: /tmp/glpi_logfile.txt. Default : /tmp/glpi_logfile.txt
-r, --recovery
Para activar el modo recovery. Ejemplo : 1.  Obligatorio

* La prioridad se tiene que especificar numéricamente, abajo se muestra la tabla de cada valor y su correspondiente prioridad.

Valor Prioridad
1 Muy baja
2 Baja
3 Media
4 Alta
5 Muy alta
6 Primordial

Ayuda

-h El plugin tiene opción de ayuda en el que puedes ver todos sus parámetros y la descripción de estos.

SI quieres ver la ayuda del plugin, ejecuta este solo con este parámetro.

Ejecución manual

El formato de ejecución del plugin es el siguiente:

./pandora_glpi --user < user > --password < password > --url < url > --app_token < app token > \
--alias_agent < id_module > --id_module < id module > \
--ticket_name < ticket name > --ticket_message < ticket message > --ticket_priority < ticket priority > \
--ticket_category < ticket category > --ticket_group < ticket group > \
--log_file < log file > --recovery < 1 or 0 >

Ejemplo:

./pandora_glpi --user "glpi" --password "glpi" --url "http://localhost:8200" --app_token "xZvyKomCYHSSva5oTXTNmMiy4SWzfi7O1FFt" \
--alias_agent < "Rocky linux 8" > --id_module "8025" \
--ticket_name " Incidendia modulo 8025" \
--ticket_priority 4 \
--ticket_category "Categoria1" --ticket_group "grupo1" \
--log_file "/tmp/glpi_logfile.txt" --recovery 1 --ticket_message"
2023-11-30 11:49:03
Free RAM
172.34.56.1
" 

Configuración en PandoraFMS

Para configurar el plugin es necesario configurar un comando de alerta, usando los parámetros del plugin, para crear ejecuciones personalizadas.

 

Esto se puede hacer desde el menu de alertas en comandos :

image.png

 

Se deberá introducir un nombre, grupo, y el comando, usando como valores para los parámetros la macro _fieldx_, siendo x el número del parámetro (no distinguen ningún orden, simplemente cada macro tiene que tener un número diferente).

Una vez configurado, se puede configurar el valor de la macro debajo en los campos de descripción.

2.png