Veeam backup replication
Plugin to pull data from Veeam Backup replication
- Introduction
- Compatibility matrix
- Pre requisites
- Generate token (deprecated)
- Parameters
- Manual execution
- Configuration in PandoraFMS
- Modules generated by the plugin
Introduction
Ver. 04-02-2022
With this plug-in we will be able to see data from our Veeam Backup environment such as the last backup performed, jobs, etc.
Type: Server or agent plug-in
Compatibility matrix
Systems where tested |
CentOS 7, Fedora |
Systems where it should work |
Cualquier sistema linux |
Pre requisites
Required:
Connectivity to your Veeam Backup environment
Generate token (deprecated)
Updated 20 January 2025
In the latest version of the plugin, the token is generated by the plugin by passing the username and password, so this section is deprecated.
https://<hostname>:<port>/swagger/ui/index.html
* Default port: 9419
On the Veeam Backup & Replication REST API 1.0 page, expand the Login section and click POST api/oauth2/token.
In the expanded method window, click Test.
In the grant_type drop-down list, select password.
In the username and password fields, specify the credentials of a user created in Veeam Backup & Replication.
Click on Execute.
Wait for the response from the server. A successfully completed operation returns the response code 200. In the body of the response, Veeam Backup & Replication returns an access token, its expiration time and an update token.
* Remember that the duration of the access token is only 15 minutes.
Parameters
Parameter | Description |
-u, --user | User |
-p, --password | Password |
-i,--ip | ip of your veeam server |
-x, --prefix | Prefix for the agents |
-a, --api_version | Version for the API |
-g,--group | Pandora FMS target group (optional) |
--data_dir | Pandora FMS data directory. By default it is /var/spool/pandora/data_in/ (optional) |
--transfer_mode | XML transfer mode of the agents. Local or tentacle. By default tentacle. |
--tentacle_ip | IP address of tentacle to which the XML will be sent. By default 127.0.0.1 |
--tentacle_port | Tentacle port to which XML will be sent. Default :41121 |
--interval | Agent interval. Default 300 seconds. |
Manual execution
We can run the plugin manually to display an xml with the data on the screen.
./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>]
Configuration in PandoraFMS
The best way to manage server plugins in Pandora is from "/usr/share/pandora_server/util/plugin" so we will send it to that path.
Then we will move to the folder where we have put it ("/usr/share/pandora_server/util/plugin" is the recommended one").
As a server plugin
We will go to servers > plugins:
Click on add:
Click on add:
We enter as command the path to the plugin, and as parameters the ones we have entered executing the plugin, the "_field_" fields are macros defined below.
We put for each macro the description that you prefer . Remember that in this plugin the three mandatory parameters are user, password and IP, the others are optional.
Once this is done, if we execute the plugin from the terminal, the agent with the modules will have been created.
Modules generated by the plugin
The plugin will create 3 agents with several modules, the number of modules depends on your veeam environment as it will create one for each job created for example.
Veeam_Backup_Replication-Services_and_configuration
Veeam_Backup_Replication-Sessions_servers_and_repositories
Veeam_Backup_Replication-Proxyes_and_jobs