https://github.com/nbuchwitz/icingaweb2-module-map

An openstreetmap based map module for host and service state visualization with Icinga Web 2
https://github.com/nbuchwitz/icingaweb2-module-map

hacktoberfest icingaweb2 leaflet map module openstreetmap visualization

Last synced: 5 days ago
JSON representation

An openstreetmap based map module for host and service state visualization with Icinga Web 2

• Host: GitHub
• URL: https://github.com/nbuchwitz/icingaweb2-module-map
• Owner: nbuchwitz
• License: gpl-2.0
• Created: 2017-07-25T17:05:05.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-01-18T13:41:59.000Z (11 months ago)
• Last Synced: 2024-01-18T16:53:18.831Z (11 months ago)
• Topics: hacktoberfest, icingaweb2, leaflet, map, module, openstreetmap, visualization
• Language: PHP
• Homepage: https://icinga.com/docs/icinga2/latest/doc/13-addons/
• Size: 10.3 MB
• Stars: 80
• Watchers: 15
• Forks: 16
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Map module for Icinga Web 2

#### Table of Contents

1. [About](#about)

2. [License](#license)

3. [Documentation](#documentation)

4. [Support](#support)

5. [Requirements](#requirements)

6. [Thanks](#thanks)

7. [Contributing](#contributing)

## About

This module displays host objects as markers on [openstreetmap](https://www.openstreetmap.org) using [leaflet.js](http://leafletjs.com/). If you configure multiple hosts with the same coordinates, i.e. servers in a datacenter, a clustered view is rendered.

![Marker popup](doc/screenshot/map-module.png)

You could also integrate a map as dashlet into your dashboards:

![Marker popup](doc/screenshot/dashlets.png)

## License

Icinga Web 2 and this Icinga Web 2 module are licensed under the terms of the GNU General Public License Version 2, you will find a copy of this license in the LICENSE file included in the source package.

This module uses Leaflet and several plugins:

* [Leaflet](https://github.com/Leaflet/Leaflet) - BSD 2-clause "Simplified" License

* [Leaflet.markercluster](https://github.com/Leaflet/Leaflet.markercluster) - MIT license

* [Leaflet.Locate](https://github.com/domoritz/leaflet-locatecontrol) - MIT license

* [Leaflet.EasyButton](https://github.com/CliffCloud/Leaflet.EasyButton) - MIT license

* [Leaflet.Spin](https://github.com/makinacorpus/Leaflet.Spin) - MIT license

* [Leaflet.awesome-markers](https://github.com/sigma-geosistemas/Leaflet.awesome-markers) - MIT license

* [Spin.js](spin.js.org) - MIT license

## Documentation

* [Installation](doc/01-Installation.md)

* [Adding markers to your map](doc/02-Add-Items-to-map.md)

* [Exploring the map](doc/03-Exploring-the-map.md)

## Support

Join the [Icinga community channels](https://www.icinga.com/community/get-involved/) for questions.

## Requirements

* [Icinga Web 2](https://www.icinga.com/products/icinga-web-2/) (>= 2.4.1)

## Thanks

This module borrows a lot from https://github.com/Mikesch-mp/icingaweb2-module-globe.

## Contributing

There are many ways to contribute to the Icinga Web module for Maps --

whether it be sending patches, testing, reporting bugs, or reviewing and

updating the documentation. Every contribution is appreciated!

Please continue reading in the [contributing chapter](CONTRIBUTING.md).