PRTG Grafana Datasource Plugin

This repository contains a Grafana datasource plugin for PRTG, allowing users to visualize and analyze PRTG metrics within Grafana.

Introduction

This Grafana datasource plugin integrates with PRTG, enabling users to fetch and display data from PRTG sensors directly in Grafana dashboards. It provides a seamless way to monitor and analyze PRTG data using Grafana's powerful visualization tools.

Installation

First you need to download docker and go(golang) to your computer

Install Docker

Install Go

1. Clone the repository:

   git clone https://github.com/1DeliDolu/PRTG.git

2. Navigate to the plugin directory:

   cd PRTG/maxmarkusprogram-prtg-datasource

3. Install dependencies:

   npm install

4. Build the plugin:

   npm run build

5. Build backend plugin

   mage

6. Rename the dist directory to

   cp -r dist /var/lib/grafana/plugins/PRTG
   

7. Restart Grafana:

   with wsl

   sudo systemctl restart grafana-server
   

** or with Powershell**

net stop grafana

net start grafana

... or

After clone, copy Prtg Folder to C:\Program Files\GrafanaLabs\grafana\data\plugins

Restart Grafana:

sudo systemctl restart grafana-server

Configuration

1. Open Grafana and navigate to the Data Sources page.
2. Click on "Add data source" and select "PRTG".
3. Configure the PRTG datasource by providing the necessary connection details such as PRTG server URL, API key, and other relevant settings.
4. Save and test the datasource to ensure it is working correctly.

Usage

1. Create a new dashboard or open an existing one in Grafana.
2. Add a new panel and select the PRTG datasource.
3. Configure the query to fetch data from the desired PRTG sensors.
4. Customize the visualization settings to display the data as needed.

Troubleshooting

If you encounter any issues, please refer to the following troubleshooting steps:

• Ensure the PRTG server URL and API key are correctly configured.
• Check the Grafana server logs for any error messages.
• Verify that the plugin is correctly installed in Grafana's plugin directory.
• Restart Grafana and try again.

Additional Resources

• Grafana Plugin Development Documentation
• PRTG API Documentation

Feel free to contribute to this project by submitting issues or pull requests.

You can now save this content in the README.md file in your repository.

Config Editor

1. Open http://localhost:3000/ in browser or http://grafana.prtg:3000/connections/datasources

2. Press PRTG

3. Enter your prtg server

4. Enter your api-token and Press save & test

5.Press Build an Dashboard

6.Press Add visualizaton

7.Press PRTG

Query Metrics

Select Query Type

9.Select Group

10.Select Device

11.Select Sensor

12.Select Channel

13.Look at Panel

Options

14.Add Group name in panel

15.Add Device and Sensor

16.Add new query

17.Select Query, Group, Device, Sensor and Channel

18.An another example

19.Fill Opacity

20.Select Stat

Query Raw

1.Select Query Raw, Group, Device, Sensor, Property and Filter Property

2. Examples

Query Text

1.Query Text

Panel

Video

1. copy repository https://github.com/1DeliDolu/PRTG.git

``

2. open vs code and terminal with bash. Clone Repository

``

3. Open new terminal with wsl (i use debian) and land "maxmarkusprogram-prtg-datasource" cd maxmarkusprogram-prtg-datasource

``

4. npm install

``

5. npm run build

``

7. mage

``

7. mv dist/ Prtg

``

8. close vs code

``

9. copy

``

10. paste Prtg in C:\Program Files\GrafanaLabs\grafana\data\plugins

``

11. Stop and start Grafana with powershell

``

12. Sign in

    at firts time user admin pasword admin

``

13. Datasource panel

``

14.Create query

``

15. dashboard

``