https://github.com/sol1/icinga-clustergraph
A graph of your icinga cluster
https://github.com/sol1/icinga-clustergraph
Last synced: 4 months ago
JSON representation
A graph of your icinga cluster
- Host: GitHub
- URL: https://github.com/sol1/icinga-clustergraph
- Owner: sol1
- Created: 2023-10-03T06:27:44.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-10T01:54:39.000Z (about 1 year ago)
- Last Synced: 2025-06-10T02:38:20.230Z (about 1 year ago)
- Language: PHP
- Size: 117 KB
- Stars: 9
- Watchers: 6
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ClusterGraph Module for Icinga Web 2
This module provides visualization of Icinga 2 cluster zones and endpoints in a graphical format.
This is useful to highlight how the cluster goes together, and which endpoints report to which parents in a graphical way.
One of the next goals is to allow the graph to highlight where there are multiple parents of a zone and whether all the children are properly configured.
## Features
- API integration with Icinga 2.
- Graphical representation of Icinga 2 cluster zones and endpoints.
- Configuration via Icinga Web 2 web interface.
## Prerequisites
- Icinga Web 2
- Icinga 2 with API user credentials
## Installation
1. Clone the `clustergraph` module to the `modules` directory of Icinga Web 2.
```
git clone https://github.com/sol1/icinga-clustergraph.git /usr/share/icingaweb2/modules/clustergraph
```
2. Enable the module via the Icinga Web 2 web interface or using the CLI:
```
icingacli module enable clustergraph
```
## Configuration
1. Navigate to `Configuration` -> `Modules` -> `clustergraph` -> `Config`.
2. Provide the necessary API details including API User, API Password, and API Endpoint.
3. Save changes.
## Usage
Once configured, navigate to the ClusterGraph section in Icinga Web 2 to view the graphical representation of Icinga 2
cluster zones and endpoints.
## Contributing
If you'd like to contribute to the development of this module, please submit pull requests or issues
to https://github.com/sol1/icinga-clustergraph.
## License
All code here is licensed under GPL V2