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
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.
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6c4dee28bd60812e421e59318e7f59de66a7f061a6b880f8e0a529206415f030 |
|
MD5 | 90726b92316c8d4f1c84bf36fb07b749 |
|
BLAKE2b-256 | 6c320a6bc7436fa32d8a569393abe2c95b386945b198c10b0a3b719d4de36403 |
File details
Details for the file netbox_more_metrics-0.3.1-py3-none-any.whl
.
File metadata
- Download URL: netbox_more_metrics-0.3.1-py3-none-any.whl
- Upload date:
- Size: 18.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.12.4 Linux/6.10.0-arch1-2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 87e619ad0869bfc0d08630e105d5c7e843e0f4ba9593a90829f6113da188881f |
|
MD5 | 04c4265bc206df92b3e5650a5b48bed7 |
|
BLAKE2b-256 | c647754834ba01ddfaf3b4c6e5417e140e1b559043adee151587beacf168028c |