Skip to main content

Provide customized metrics on data stored in NetBox.

Project description

netbox-more-metrics

Create custom metrics and export information from NetBox into your timeseries database.

Compatibility

NetBox Version Plugin Version
3.4 <= 3.7 0.1.X, 0.2.X
4.0 0.3.X

Installing

For adding to a NetBox Docker setup see the general instructions for using netbox-docker with plugins.

Install

pip install netbox-more-metrics

or by adding to your local_requirements.txt or plugin_requirements.txt (netbox-docker):

netbox-more-metrics

Development Install

If you would like to install a version not yet published to pypi.

pip install git+https://github.com/TheDJVG/netbox-more-metrics

or by adding to your local_requirements.txt or plugin_requirements.txt (netbox-docker):

git+https://github.com/TheDJVG/netbox-more-metrics

NetBox Configuration

Enable the plugin in /opt/netbox/netbox/netbox/configuration.py, or if you use netbox-docker, your /configuration/plugins.py file :

PLUGINS = [
    'netbox_more_metrics'
]

Features

Custom metrics

For example, you could track the amount of active devices over time by rack and site Example metric

Any model can be exported, data is grouped by the labels.

Filter validation

Every filter is tested on save and also when the metric is initiated for exporting. Example invalid filter

Heavy lifting is done by the database

As much as possible is done in the database directly to take advantage of any Model specific optimizations.

null database values are converted to a string "null".

Functions

  • Metrics can be included in the global metric endpoint (/metrics).
  • Metrics and MetricCollections can be individually exported (as long as the Metric(Collection) is enabled)

Future ideas

  • Adding a way to export utilization (e.g. how many IPs of a prefix are used, or how much power is still available on a feed).

More ideas welcome!

Missing

  • Tests
  • Documentation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netbox_more_metrics-0.3.1.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

netbox_more_metrics-0.3.1-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

Details for the file netbox_more_metrics-0.3.1.tar.gz.

File metadata

  • Download URL: netbox_more_metrics-0.3.1.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.4 Linux/6.10.0-arch1-2

File hashes

Hashes for netbox_more_metrics-0.3.1.tar.gz
Algorithm Hash digest
SHA256 6c4dee28bd60812e421e59318e7f59de66a7f061a6b880f8e0a529206415f030
MD5 90726b92316c8d4f1c84bf36fb07b749
BLAKE2b-256 6c320a6bc7436fa32d8a569393abe2c95b386945b198c10b0a3b719d4de36403

See more details on using hashes here.

File details

Details for the file netbox_more_metrics-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for netbox_more_metrics-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 87e619ad0869bfc0d08630e105d5c7e843e0f4ba9593a90829f6113da188881f
MD5 04c4265bc206df92b3e5650a5b48bed7
BLAKE2b-256 c647754834ba01ddfaf3b4c6e5417e140e1b559043adee151587beacf168028c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page