Python API

This directory contains the Python 3.x API for querying ntopng using the Python language.

This API is based on ntopng's REST API and it allows users to perform operations such as:

• Read host statistics
• Get the active flows list
• Query network interface stats and time series
• Search historical data including alerts and flows

Prerequisites

The API is using Pandas and NumPy for working with time series data, plotly and fpdf for generating reports in PDF format. The examples are using additional modules, including redmail for sending reports by email.

In order to install prerequisites please do

• pip3 install -r requirements.txt

API Information

For each ntopng REST API call there is a corresponding Python method for the defined Python classes:

• host
• interface
• historical

The ntopng class is used to store information such as ntopng IP address and credentials used to connect it.

The test application can be used as example of the Python API

Installation

For you convenience, ntop periodically builds pip packages. You can install the latest available package as:

• pip3 install ntopng

Developing the Python API

We encourage our users to extend this API. For your convenience we are sharing a Makefile that you can use as skeleton for installing the package locally or creating test packages.

The Makefile can be also used to update the upstream library. The build and twine modules are required.

• pip install build twine
• make upload

Documentation

For detailed documentation on each API class please visit:

• Python API Docs

For further information please visit the API documentation available at:

ntopng Python API ntopng REST API v2