https://github.com/icinga/icingaweb2-module-vsphere
VMware vSphere import source for the Icinga Director
https://github.com/icinga/icingaweb2-module-vsphere
icinga-director import vcenter vmware vsphere
Last synced: 2 months ago
JSON representation
VMware vSphere import source for the Icinga Director
- Host: GitHub
- URL: https://github.com/icinga/icingaweb2-module-vsphere
- Owner: Icinga
- License: gpl-2.0
- Created: 2017-06-29T17:04:03.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-10-19T13:57:05.000Z (over 3 years ago)
- Last Synced: 2025-04-13T20:47:38.245Z (2 months ago)
- Topics: icinga-director, import, vcenter, vmware, vsphere
- Language: PHP
- Size: 418 KB
- Stars: 33
- Watchers: 13
- Forks: 8
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Icinga Web 2 module for vSphere
===============================
In case you want to have an automated import of your Virtual Machines and/or
Physical Host from **VMware Sphere** (vCenter) into your Icinga monitoring
system this module might be what you have been looking for.
At the time of this writing, the main purpose of this module is being a
Import Source provider for the [Icinga Director](https://github.com/Icinga/icingaweb2-module-director):
[](doc/03-Import-Source.md)
Documentation
-------------
### Basics
* [Installation](doc/01-Installation.md)
* [Define an Import Source](doc/03-Import-Source.md)
* [Working on the CLI](doc/04-CLI-Commands.md)
* [Contributing](doc/81-Contributing.md)
* [Changelog](doc/84-Changelog.md)
Compatibility
-------------
This module has no dependency on any SDK library. It had been written from
scratch for vCenter 6.x and tested with different installations of vCenter 6.0.
Directly accessing ESXi 6.5 hosts also worked fine. We expect it to work fine
also with older versions, but had no access to such for tests so far. In case
you have, please let us know!
Performance
-----------
This module should perform well. Here are some numbers showing resources spent
when fetching 2600+ VMs. The initial login took 430ms, then 2.6 seconds have
been needed to fetch all the data, and it took additional 350ms to process this
data. There is still room for optimizations, we for example implemented a Cookie
(session) cache, but disabled it for now. For the current task (being an Import
Source) this should easily be fast enough:
+---------------------------+----------+----------+------------+-------------+
| Description | Off (ms) | Dur (ms) | Mem (diff) | Mem (total) |
+---------------------------+----------+----------+------------+-------------+
| Bootstrap ready | 0.005 | 0.005 | 486.82 KiB | 486.82 KiB |
| Dispatching CLI command | 11.752 | 11.747 | 526.72 KiB | 1013.54 KiB |
| Preparing the API | 14.836 | 3.084 | 413.77 KiB | 1427.30 KiB |
| Logged in, ready to fetch | 444.801 | 429.965 | -4.08 KiB | 11.80 MiB |
| Got 4696738 bytes | 3055.117 | 2610.316 | 9.00 MiB | 20.81 MiB |
| Got 2633 VMs | 3411.375 | 356.258 | 14.30 MiB | 35.11 MiB |
| Mapped properties | 3411.393 | 0.018 | 896.00 B | 35.11 MiB |
| Logged out | 3415.851 | 0.060 | -4.27 KiB | 26.15 MiB |
+---------------------------+----------+----------+------------+-------------+
Please always make sure to fire your requests against your vCenter. Directly
querying your ESXi hosts will work, but you should then expect to be way slower.
Future Directions
-----------------
We'd love to see this module grow. By giving it a little local DB schema and a
lightweight daemon it could synchronize configuration, state and performance
data in a resource-efficient way. Monitoring checks could then directly use that
data and/or passively react to events. Additionally, this data would allow for
some nice new visualizations for the Icinga Web 2 GUI.