Veeam backup and replication plugin
Plugin para sacar datos de Veeam Backup replication
- Introducción
- Matriz de compatibilidad
- Pre requisitos
- Generar token (Deprecado)
- Parámetros
- Ejecución manual
- Configuración en PandoraFMS
- Módulos generados por el plugin
Introducción
Ver. 04-02-2022
Con este plug-in podremos ver datos de nuestro entorno Veeam Backup como el ultimo backup realizado, los trabajos,etc.
Matriz de compatibilidad
| Sistemas donde se ha probado |
CentOS 7, Fedora |
| Sistemas donde debería funcionar |
Cualquier sistema linux o en windows ejecutandose en un agente software. |
Pre requisitos
Se requiere:
- Conectividad hacia tu entorno de Veeam Backup
Generar token (Deprecado)
Actualizado 20 enero 2025
En la ultima versión del plugin, el token lo genera este pasandole usuario y contraseña, por lo que este apartado esta deprecado.
https://<hostname>:<port>/swagger/ui/index.html* Port por defecto: 9419
En la página Veeam Backup & Replication REST API 1.0, expanda la sección Login y haga clic en POST api/oauth2/token.
En la ventana del método expandido, haz clic en Probar.
En la lista desplegable grant_type, seleccione password.
En los campos nombre de usuario y contraseña, especifique las credenciales de un usuario creado en Veeam Backup & Replication.
Haga clic en Ejecutar.
Espere la respuesta del servidor. Una operación completada con éxito devuelve el código de respuesta 200. En el cuerpo de la respuesta, Veeam Backup & Replication devuelve un token de acceso, su tiempo de caducidad y un token de actualización.
* Recuerda que la duración del token de acesso es de solo 15 minutos.
Parámetros
| Parámetro | Descripción |
| -u, --user | Usuario de Veeam |
| -p, --password | Password de Veeam |
| -i,--ip | IP de tu servidor Veeam con puerto. Ejemplo : 192.168.1.73:9401 |
| J-p,--prefix | Prefijo para los agentes |
| -g,--group | Grupo de destino de Pandora FMS (opcional) |
| -a, --api_version | Version de la API. Por defecto : "
1.0-rev2"
|
| --data_dir | Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/ (opcional) |
| --transfer_mode | Modo de transferencia de los XML de los agentes. Local o tentacle. Por defecto tentacle. |
| --tentacle_ip | Dirección IP de tentacle a la que se enviaran los XML. Por defecto 127.0.0.1 |
| --tentacle_port | Puerto de tentacle al que se enviarán los XML. Por defecto :41121 |
| --interval | Intervalo del agente. Por defecto 300 segundos. |
Ejecución manual
Podemos ejecutar el plugin manualmente para mostrar un xml con los datos por pantalla.
./pandora_veeam -i <ip with port> -u <user> -p <password>
[--prefix <prefix>] [--api_version <api_version>] [--group <group>]
[--data_dir <data_dir>] [--interval <interval>]
[--transfer_mode <transfer_mode>] [--tentacle_ip <tentacle_ip>] [--tentacle_port <tentacle_port>]Si al ejecutarlo, ves el error : Error getting token, es probable que no se tenga acceso al entorno. Puedes probar con el siguiente curl para verificar que es problema de interactividad.
curl -k -X POST "https://<user_ip>/api/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "x-api-version: <api_version>" \
-d "grant_type=password&username=<user>&password=<password>"Configuración en PandoraFMS
La mejor forma de manejar plugins de servidor en Pandora es desde "/usr/share/pandora_server/util/plugin" asi que lo enviaremos esa ruta.
Después nos moveremos a la carpeta en la que lo hemos metido ( "/usr/share/pandora_server/util/plugin" es la recomendada").
Como plugin de servidor
Iremos a servidores > plugins:
Pinchamos en añadir:
Le ponemos en nombre y la descripción que se prefiera:
Metemos como comando la ruta al plugin, y como parámetros los que hemos metido ejecutando el plugin, los campos "_field_" son macros definidas más abajo.
Ponemos por cada macro la descripción que se prefiera. Recuerda que en este plugin los tres parámetros de uso obligatorio son el user, password e IP, los demás son opcionales.
Una vez hecho esto, solo queda llamarlo por lo que iremos a la vista de algún agente y crearemos un módulo de complementos:
Una vez hecho esto, damos a crear.
Si el modulo se muestra con 1, quiere decir que se esta ejecutando correctamente
Le daremos un nombre y en el apartado "plugin" pondremos el que acabamos de configurar.
Como plugin de agente
Lo llamaremos en la última línea del conf del agente con el comando module_plugin , seguido de la ruta del plugin y de los parámetros utilizados.
module_plugin <path pandora_veaambackup.py> -i <ip> -t <token>Esto también se puede hacer desde la consola si esta la configuración remota habilitada.
Módulos generados por el plugin
El plugin creara 3 agentes con varios módulos, el número de módulos depende de tu entorno de veeam ya que creara uno por cada trabajo creado por ejemplo.
Veeam_Backup_Replication-Services_and_configuration
Veeam_Backup_Replication-Sessions_servers_and_repositories
Veeam_Backup_Replication-Proxyes_and_jobs
