{"id":20504074,"url":"https://github.com/icinga/icingaweb2-module-vsphere","last_synced_at":"2025-04-13T20:47:42.991Z","repository":{"id":91083285,"uuid":"95800314","full_name":"Icinga/icingaweb2-module-vsphere","owner":"Icinga","description":"VMware vSphere import source for the Icinga Director","archived":false,"fork":false,"pushed_at":"2021-10-19T13:57:05.000Z","size":428,"stargazers_count":33,"open_issues_count":15,"forks_count":8,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-13T20:47:38.245Z","etag":null,"topics":["icinga-director","import","vcenter","vmware","vsphere"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Icinga.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-06-29T17:04:03.000Z","updated_at":"2025-01-29T18:44:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"780738c2-db86-4938-8847-32a5188ee441","html_url":"https://github.com/Icinga/icingaweb2-module-vsphere","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficingaweb2-module-vsphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficingaweb2-module-vsphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficingaweb2-module-vsphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Ficingaweb2-module-vsphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Icinga","download_url":"https://codeload.github.com/Icinga/icingaweb2-module-vsphere/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248782278,"owners_count":21160716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["icinga-director","import","vcenter","vmware","vsphere"],"created_at":"2024-11-15T19:36:13.206Z","updated_at":"2025-04-13T20:47:42.985Z","avatar_url":"https://github.com/Icinga.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Icinga Web 2 module for vSphere\n===============================\n\nIn case you want to have an automated import of your Virtual Machines and/or\nPhysical Host from **VMware Sphere** (vCenter) into your Icinga monitoring\nsystem this module might be what you have been looking for.\n\nAt the time of this writing, the main purpose of this module is being a\nImport Source provider for the [Icinga Director](https://github.com/Icinga/icingaweb2-module-director):\n\n[![Import from VMware vSphere](doc/screenshot/00_preview/000_preview-vmware-vsphere-center-configuration-for-icinga-director.png)](doc/03-Import-Source.md)\n\n\nDocumentation\n-------------\n\n### Basics\n* [Installation](doc/01-Installation.md)\n* [Define an Import Source](doc/03-Import-Source.md)\n* [Working on the CLI](doc/04-CLI-Commands.md)\n* [Contributing](doc/81-Contributing.md)\n* [Changelog](doc/84-Changelog.md)\n\nCompatibility\n-------------\n\nThis module has no dependency on any SDK library. It had been written from\nscratch for vCenter 6.x and tested with different installations of vCenter 6.0.\nDirectly accessing ESXi 6.5 hosts also worked fine. We expect it to work fine\nalso with older versions, but had no access to such for tests so far. In case\nyou have, please let us know!\n\nPerformance\n-----------\n\nThis module should perform well. Here are some numbers showing resources spent\nwhen fetching 2600+ VMs. The initial login took 430ms, then 2.6 seconds have\nbeen needed to fetch all the data, and it took additional 350ms to process this\ndata. There is still room for optimizations, we for example implemented a Cookie\n(session) cache, but disabled it for now. For the current task (being an Import\nSource) this should easily be fast enough:\n\n    +---------------------------+----------+----------+------------+-------------+\n    | Description               | Off (ms) | Dur (ms) | Mem (diff) | Mem (total) |\n    +---------------------------+----------+----------+------------+-------------+\n    | Bootstrap ready           |    0.005 |    0.005 | 486.82 KiB |  486.82 KiB |\n    | Dispatching CLI command   |   11.752 |   11.747 | 526.72 KiB | 1013.54 KiB |\n    | Preparing the API         |   14.836 |    3.084 | 413.77 KiB | 1427.30 KiB |\n    | Logged in, ready to fetch |  444.801 |  429.965 |  -4.08 KiB |   11.80 MiB |\n    | Got 4696738 bytes         | 3055.117 | 2610.316 |   9.00 MiB |   20.81 MiB |\n    | Got 2633 VMs              | 3411.375 |  356.258 |  14.30 MiB |   35.11 MiB |\n    | Mapped properties         | 3411.393 |    0.018 |   896.00 B |   35.11 MiB |\n    | Logged out                | 3415.851 |    0.060 |  -4.27 KiB |   26.15 MiB |\n    +---------------------------+----------+----------+------------+-------------+\n\nPlease always make sure to fire your requests against your vCenter. Directly\nquerying your ESXi hosts will work, but you should then expect to be way slower.\n\nFuture Directions\n-----------------\n\nWe'd love to see this module grow. By giving it a little local DB schema and a\nlightweight daemon it could synchronize configuration, state and performance\ndata in a resource-efficient way. Monitoring checks could then directly use that\ndata and/or passively react to events. Additionally, this data would allow for\nsome nice new visualizations for the Icinga Web 2 GUI.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Ficingaweb2-module-vsphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficinga%2Ficingaweb2-module-vsphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Ficingaweb2-module-vsphere/lists"}