Configuring Integration
Before you set up the integration, make sure that the machine on which the Veeam Service Provider Console Web UI component is installed meets the Grafana requirements.
To collect data, Grafana requires Veeam Service Provider Console to store information about received API requests in the InfluxDB database. Note that only InfluxDB v2 or later is supported.
To view the predefined dashboards in Grafana, you must first download JSON files that contain dashboard configuration. To do that:
- Log in to Veeam Service Provider Console.
For details, see Accessing Veeam Service Provider Console.
- At the top right corner of the Veeam Service Provider Console window, click Configuration.
- In the configuration menu on the left, click Plugin Library.
- Click the Grafana Labs plugin tile. The integration instruction window will open.
- Under the step 5 of the instruction, click the links to download dashboard configuration files.
Configuring InfluxDB Integration
To configure integration with Grafana using InfluxDB database:
- Download InfluxDB on the official Download page.
- Install InfluxDB as described in the Install InfluxDB section of the InfluxDB documentation.
- Configure InfluxDB as described in the Get started with InfluxDB section of the InfluxDB documentation.
- Create an InfluxDB organization as described in the Create an organization section of the InfluxDB documentation.
- Create an organization bucket as described in the Create a bucket of the InfluxDB documentation.
- Create an API token as described in the Create a token section of the InfluxDB documentation.
Configuring Dashboard Containing REST API Metrics
To view Veeam Service Provider Console RESTful APIs Dashboard that visually represents real time statistics of REST API requests sent to a Veeam Service Provider Console server:
- On the machine on which the Veeam Service Provider Console Web UI component is installed, open the appsettings.json file located in the RestAPI folder of the Veeam Service Provider Console installation directory.
- In the file, change property values in the MetricsOptions section so that the result looks like the following:
"MetricsOptions": { "DefaultContextLabel": "VAC_REST", "Enabled": true, "ReportingEnabled": true, "Reporter": "InfluxDb2" "InfluxDb2Reporting": { "Url": "http://<IP address of the server on which InfluxDB is installed>:<TCP port for InfluxDB client-server communication>", "Enabled": true, "Organization": "<name of an organization that you configured at step 4>", "Bucket": "<name of a bucket that you configured at step 5>", "Token": "<API token that you created at step 6>" } }, |
- Save the changes.
- Do one of the following:
- In Task Manager, end the Veeam.AC.WebUI task.
- In Internet Information Services, recycle the Veeam Service Provider Console Web UI application pool.
- Download and install Grafana as described in the Install Grafana on Windows section of Grafana documentation.
- Access Grafana and add a data source as described in the Getting Started with Grafana and InfluxDB section of Grafana documentation.
- On the side menu, select Create > Import.
- In the Import window, click the Upload .json file button and select the grafana-v11-web-dashboard.json file.
- Click the Import button. The dashboard will automatically open.
Configuring Dashboard Containing Veeam Service Provider Console Server Metrics
To view dashboards that visually represent Veeam Service Provider Console server metrics:
- On the machine on which the Veeam Service Provider Console Server component is installed, open the configuration.overrides.json file located in the \Veeam\Veeam Availability Console\Configuration\Service folder.
- In the file, change property values in the GeneratedConfiguration section so that the result looks like the following:
"GeneratedConfiguration": { "Service_InfluxDb2_Url": "http://localhost:8086", "Service_InfluxDb2_Enabled": true, "Service_InfluxDb2_Organization": "veeam", "Service_InfluxDb2_Bucket": "vspc", "Service_InfluxDb2_Token": "admin" } |
where:
- Service_InfluxDb2_Organization is the name of the organization that you created at step 4 of the Configuring InfluxDB Integration section.
- Service_InfluxDb2_Bucket is the name of the organization bucket that you created at step 5 of the Configuring InfluxDB Integration section.
- Service_InfluxDb2_Token is the API key that you created at step 6 of the Configuring InfluxDB Integration section.
- Save the changes.
- Restart the VeeamManagementPortalSvc service.
- Download and install Grafana as described in the Install Grafana on Windows section of Grafana documentation.
- Access Grafana and add a data source as described in the Getting Started with Grafana and InfluxDB section of Grafana documentation.
- On the side menu, select Create > Import.
- In the Import window, click the Upload .json file button and select one of the JSON files that you downloaded from the Grafana plugin page in Veeam Service Provider Console.
- Click the Import button. The dashboard will automatically open.
- Repeat steps 7-9 for each downloaded JSON file.