Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/netreplica/graphite?source=awesome-netbox
Visualization for Network Topologies – NetBox, Containerlab, Netlab
https://github.com/netreplica/graphite?source=awesome-netbox
List: graphite?source=awesome-netbox
containerlab netbox networking nextui visualization
Last synced: about 1 month ago
JSON representation
Visualization for Network Topologies – NetBox, Containerlab, Netlab
- Host: GitHub
- URL: https://github.com/netreplica/graphite?source=awesome-netbox
- Owner: netreplica
- License: apache-2.0
- Created: 2022-02-09T06:11:26.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-23T05:52:26.000Z (7 months ago)
- Last Synced: 2024-05-23T06:01:34.258Z (7 months ago)
- Topics: containerlab, netbox, networking, nextui, visualization
- Language: JavaScript
- Homepage: https://netreplica.com
- Size: 2.75 MB
- Stars: 54
- Watchers: 2
- Forks: 3
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-netbox - netreplica/graphite - Standalone topology visualizer Netreplica `graphite`. (Utilities)
README
[](https://discord.gg/M2SkgSdKht)
---
# Netreplica Graphite
Visualization for Network Topologies
## Supported software
### NetBox
Support for [NetBox](https://netbox.dev/) DCIM system includes:
* Visualization of network topologies exported by [netreplica/nrx](https://github.com/netreplica/nrx) command-line tool
* Does not require installation of a plugin on a NexBox instance
* Filtering based on Device `role`, `site` and/or `tag` information to select devices for visualization
* User-customizable topology data definitions via Jinja2 [templates](https://github.com/netreplica/templates/tree/main/graphite)
To export a topology for visualization from NetBox run `nrx` with the following parameters. See more in `nrx` [documentation](https://github.com/netreplica/nrx/tree/main#topology-visualization-with-graphite).
```Shell
nrx.py --config netbox.conf --input netbox --output graphite --site SITE --tag TAG
```
Once the data is exported, run Graphite using of the methods [described here](docs/DOCKER.md) to see the topology via a browser.
### Containerlab
Support for [Containerlab](https://containerlab.dev/) network emulation software includes:
* Visualization of live topologies, including dynamic information about network nodes – for example, management IP addresses.
* WebSSH access to running Containerlab nodes from the topology visualization.
* Launching Graphite as part of Containerlab topology by including it as a node in the topology YAML file.
The easiest way to use Graphite with Containerlab is to add the following code to a topology YAML file under the `nodes:` section. For a full topology example see [examples/2host.yaml](examples/2host.yaml).
```Yaml
graphite:
kind: linux
image: netreplica/graphite
env:
HOST_CONNECTION: ${SSH_CONNECTION}
binds:
- __clabDir__/topology-data.json:/htdocs/default/default.json:ro
- __clabDir__/ansible-inventory.yml:/htdocs/lab/default/ansible-inventory.yml:ro
ports:
- 8080:80
exec:
- sh -c 'graphite_motd.sh 8080'
labels:
graph-hide: yes
```
Once added, deploy the topology with `sudo -E containerlab deploy -t `. Note `-E` parameter for `sudo` – it is needed to pass `SSH_CONNECTION` variable.
Look for `Graphite visualization 🎨 http://:8080/graphite` Containerlab output. If you are running Containerlab on a VM via an SSH session, the `` in the URL should be the one you are using to connect to the VM, so there is a good chance the link will just work. If not, you might need to replace `` with proper address to connect to Graphite.
## Detailed instructions on using Graphite with Containerlab
Follow [step-by-step reference](docs/CONTAINERLAB.md) to learn how to use Graphite with ContainerLab.
## Running Graphite as a standalone Docker container
To be able to visualize multiple Containerlab topologies, including those that are not currently running, you can launch Graphite as a standalone container. Follow [the guide](docs/DOCKER.md) to learn how.
## Copyright notice
Copyright 2022-2023 Netreplica Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.