13.3.2 PVSR plugin

The plugin contains: PVSR datasource, alert and equipment specific table panels, furthermore some general dashboards. The plugin communicates with the PVSR server via REST API.

Installation and enabling:

Copy the plugin folder to the user plugins directory (for example /var/lib/grafana/plugins). Since the PVSR plugin is not digitally signed by Grafana, the plugin’s name has to be present in the allow_loading_unsigned_plugins Grafana configuration parameter, for example:

[root@grafana-dev grafana]# /usr/bin/grep -i plugin /etc/grafana/grafana.ini

# Directory where grafana will automatically scan and look for plugins

plugins = /var/lib/grafana/plugins

[plugins]

allow_loading_unsigned_plugins = netvisor-pvsr-datasource

Restart the Grafana server. Search for the plugin in the “Configuration -> Plugins” menu item on the web interface and enable it under the “Config” tab. It is successful, if a green check mark and an “Enable” sign appear. You can disable and update the plugin here.

Requirements: Grafana 8

13.3.2.1 PVSR data source

The PVSR data source is created in a way that the Grafana server communicates directly with the PVSR server. The different configuration options:

·       Name: any of your choice

·       Default: if marked, then this is the default data source

·       Type: PVSR Datasource

·       PVSR URL: address of the PVSR server as seen from the Grafana server (http or https)

·       PVSR user login name / PVSR user password: username and password for connecting to the PVSR server

·       Use object cache: it offers a better performance by caching PVSR objects in the client’s browser

Data source usage:

There are different query modes in the data source, all of them have unique filter parameters.

·       Chart
You can query a measurement with it. Return values in the time interval set on the dashboard.
Filters:

·       Panel type:

§  TimeSeries: measured values in “number-date” format

§  TimeSeries (PVSR colors): the same as the previous one, but with additional color information from PVSR

§  Last values (…): only the last measured values, optionally with date information and either in a vertical or a horizontal representation. Use for panels, which are capable of displaying single data points.

·       Equipment Name: the equipment’s name in the PVSR. It can be a variable too.

·       Measurement: the equipment’s measurements and charts

·       Values: measured parameter. You can show all measured parameter by choosing “All Measurements”

·       Label Name: which PVSR parameters are present in the result entry’s label

·       Equipment Statuses

It display equipments along with the number of alarms grouped by the alarm severity

Filters:

·       Equipment Filter: filtering by the equipment’s name. The “%” sign can be use as joker character.

·       Threshold Type Filter: filtering by the threshold’s type name. The “%” sign can be use as joker character.

·       Report Table

Shows predefined PVSR report data

·       Report View: drop-down list of available PVSR report view tables

·       Max Items: the maximum number of entries in the table

·       Site Name: filtering by the name of the site

·       Equipment Name: filtering by the name of the equipment

·       Alert Table

Returns with actual or recently closed alerts as a table. It has at least seven column: Priority, Level, Name, Begin, Acknowledge by, Id, IsEvent. Priority, Id and IsEvent columns are hidden in the PVSR plugin’s alert specific table. The table might contain threshold user defined attributes as well

Filters:

·       Alert level: filter by the level

·       Alert Window: display only the current alarms or the recently closed alarms as well

·       Max Item: the maximum number of alarms

·       Equipment Name: name of a specific equipment. It can be a variable too.

·       Begin Time Filter: if selected then only those alarms are shown which begin in the timespan selected on the Grafana dashboard

·       UDAs: should the table contain user defined threshold attributes

·       Threshold Type Filter: filtering by the threshold’s type name. The “%” sign can be use as joker character.

·       Threshold name: filter for a specific threshold. The “%” sign can be use as joker character.

·       Equipment Table

Returns PVSR’s equipments as a table. There are 3 default columns: Name, Site, CollectorType. There are also more collector type specific parameters, if it is filtered by the “Collector Type” filter parameter.

Filter:

·       Collector parameter: filter by the collector’s type.

·       Max Items: number of the maximum displayed equipments. Default: 100

·       Site Filter: filter for equipments under a specific PVSR site. If the value is “all” or empty, then there is no filtering. The “%” sign can be use as joker character.

·       Equipment Filter: filter for a specific equipment. If the value is “all” or empty, then there is no filtering. The “%” sign can be use as joker character. It can be a variable too.

·       Server Status

It shows the PVSR server module statuses. Only PVSR administrators can use this mode

Filter:

·       Non Clearable Server Event Ageout: after how many time should a server event be considered closed if it does not have a close pair