ntop / ntopng-grafana-datasource

ntopng Grafana Datasource

Discontinuation Notice

ntop has redicected resources and focus to the integration of InfluxDB, which is natively supported in ntopng starting from version 3.8. For this reason, support and development for this plugin have been discontinued in favour of the InfluxDB Grafana datasource plugin https://grafana.com/docs/features/datasources/influxdb/.

To start using InfluxDB with ntopng please refer to the documentation: https://www.ntop.org/guides/ntopng/basic_concepts/timeseries.html#influxdb-driver

ntopng Datasource

The official ntopng Grafana datasource plugin lets you quickly navigate ntopng data from inside the beautiful Grafana dashboards.

Setting Up the Datasource

To set up the datasource visit Grafana Datasources page and select the green button Add a datasource. Select ntopng as the datasource Type in the page that opens.

The HTTP url must point to a running ntopng instance, to the endpoint /lua/modules/grafana. The Access method must be set to Direct. An example of a full HTTP url that assumes there is an ntopng instance running on localhost port 3001 is the following:

http://localhost:3001/lua/modules/grafana

Tick Basic Auth if your ntopng instance has authentication enabled and specify a username-password pair in fields User and Password. The pair must identify an ntopng user. Leave the Basic Auth checkbock unticked if ntopng has no authentication (--disable-login).

Finally, hit the button Save and Test to verify the datasource is working properly. A green message Success: Data souce is working appears to confirm the datasource is properly set up.

Supported metrics

Once the datasource is set up, ntopng metrics can be charted in any Grafana dashboard.

Supported metrics are:

• Interface metrics
• Host metrics

Metrics that identify an interface are prefixed with a interface_ that precedes the actual interface name. Similarly, metrics that identify an host are prefixed with a host_ followed by the actual host ip address.

Interface and host metrics have a suffix that contain the type of metric (i.e., traffic for traffic rates and traffic totals orT allprotocols for layer-7 application protocol rates). The type of metric is followed by the unit of measure (i.e., bps for bits per second, pps for packets per second, and bytes).

Interface Metrics

Supported interface metrics are:

• Traffic rates, in bits and packets per second
• Traffic totals, both in Bytes and packets
• Application protocol rates, in bits per second

Host Metrics

Supported host metrics are:

• Traffic rate in bits per second
• Traffic total in Bytes
• Application protocol rates in bits per second.

ntopng-grafana-datasource's Issues

FR - Legend entries

Could you add the possibility to change the strings of the legend entries?
As you can see here

is not important to know the name of the zc interface (zc:2@0) but could be useful change it with the string "IT Office".
I saw some examples on the web where it was possible to use the command "ALIAS BY" into the datasource.
Could you add this feature into the ntopng datasource?
Thanks...

Hide Interface name

Can I hide ntopng interface name on Grafana ([tcp://127.0.0.1:5556] ) ?

Thanks,

Unable to See Hosts/Top Talkers in Timeseries

Hope I'm missing something simple - within grafana there is no data points from my top talkers. Everything is fine within the ntopng dashboard but not showing as available in grafana panels. Essentially just my sniffer interface is available. I had an issue were the daily protocols were not working whether natively or in grafana and worked through some setting suggestions and toggle timeseries on/off (which fixed it). I don't even know where to look since obviously the datasource is working just not getting everything....any direction is appreciated.

ntopng Professional Edition v.3.2.180126

Use of templating variables in grafana with ntop datasource

Hi,

I've been triying to use variables to have templating dashboard to be able to visualize ntop graphs for different hosts, but i have notice that i can not use variables in the metrics when configuring the panel graph in grafana with ntop datasource.. so i would like to know if it is possible to use templating variables when using grafana with ntop datasource (create a different graph panel for each host will take me so much time).

Thanks.

ntop/ntopng#1508

FR - "other protocols" into the allprotocols_bps timeserie

As you can see into this image:

with the timeserie "interface_zc:2@0_allprotocols_bps" we can see only the first 10 protocols discovered by ntopng.
I have just 2 feature request:

1. Could you add the possibility to change the number of protocols shown into the graph? (In instance from 10 to 15 or from 10 to 5)
2. Into the graph now we see only the first 10 protocols but we haven't any information about to the other protocols detected by ntopng. It could be useful to add a new graph into this timeserie called "Other protocols" useful to understand what happen into the monitored network.

Could you add these features?

Thanks...

Unknown error

Unknown error, when click in "save and test"

Unable to connect/test local datasource

I've installed Grafana on the same server as ntop. The documentation gives an example of...

http://localhost:3001/lua/modules/grafana

...though the default ntopng instance runs on 3000. I'm not sure why it would reference 3001 at both ntop's and grafana's site. At any rate, my configuration is based on the above, but port 3000, and the rest configured as the documentation shows. Testing the configuration seemingly fails as all that's returned is a orange box with the text, if any, obscured. There is no reference to this in either the grafana or ntopng log. Grafana was restarted successfully after the plugin installation.

Further to the above, I have no issue pointing to a remote instance of ntopng.

Datasourc fails in installation.

1. The official ntopng Grafana datasource plugin lets you quickly navigate ntopng data from inside the beautiful Grafana dashboards. Cannot find on the grafana web site.

2. Installing the version in github in the directory /usr/share/grafana/public/app/plugins/datasource/ntopng

Allows the datasource to been visible, but when you enter the type, all the settings
fields disappear (HTTP settings, HTTP auth), and that remains are the name and type fields.

It is then impossible to proceed further.

FR - add new useful metrics/timeseries

I released this simple patch to add some useful metrics/timeseries to the datasource:

ntop_grafana_patch.txt

Could you add this new metrics/timeseries into your datasource?
I think that It could be useful also add other metrics/timeseries... ;-)

Thanks...

Angular is deprecated - please migrate to React

Hello 👋 from Grafana Labs

We have detected that your plugin might still be using AngularJS and recommend migrating it to React, so that it may continue to operate successfully in future versions of Grafana.

You can read more on why and how by visiting our documentation: https://grafana.com/docs/grafana/latest/developers/angular_deprecation/

You can reach out to us with any questions via slack: slack.grafana.com - channel #plugins or our plugin development community forum

Scripts not working with grafana 5.2

Hello,

I migrate to grafana 5.2 and the NtopNG plugin does not work any more and returns an error on all panels.

<title>ntop</title>

Script "/usr/share/ntopng/scripts/lua/modules/grafana/query.lua" returned an error:

/usr/share/ntopng/scripts/lua/modules/grafana/query.lua:22: attempt to index field 'payload' (a nil value)

". Parse error: "{}" http://errors.angularjs.org/1.6.6/$http/baddata?p0=HTTP/1.1 500 Internal server error Content-Type: text/html Connection: close <title>ntop</title>

Script "/usr/share/ntopng/scripts/lua/modules/grafana/query.lua" returned an error:

/usr/share/ntopng/scripts/lua/modules/grafana/query.lua:22: attempt to index field 'payload' (a nil value)

&p1={}

Regards

JP P

Error with connecting to datasource

I have a new install on Fedora 27 with Grafana already working without issue.

I compiled ntopng this morning and it seems to be working fine:

ntopng --version
v.3.3.180129 [Community build]

I'm using a connection like this and I hit save and test and it gives me a red error box without any text.

If I drop an extra / on the end, I can see the pages seems to be there without an issue:

I'm also running with logins disabled so I have no auth checked for that reason.