# vmbro/vcf-operations-vcommunity architecture

> Architecture diagram of the GitHub repository vmbro/vcf-operations-vcommunity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vmbro/vcf-operations-vcommunity
- Repository: https://github.com/vmbro/vcf-operations-vcommunity

## Overview

This is a VCF Operations management pack that enriches monitored vCenter inventory with configuration, properties, metrics, and guest-OS data. Its principal workflow is adapter collection: the adapter prepares configuration and dispatches inventory collectors, which retrieve vCenter data, match it to VCF Operations resources, enrich those resources, and return them. Windows service and event collection use guest operations. The README also describes dashboards, reports, and super metrics, but their implementation paths are absent from the supplied tree; the graph focuses on the represented runtime. Edges reflect excerpts, SOURCE INDEX references, or README statements.

Main entry points: [`Management Pack/app/adapter.py`](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/adapter.py) (Adapter runtime), [`Management Pack/app/collectors/vm/collectVMData.py`](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vm/collectVMData.py) (VM collector), [`Management Pack/app/utils/vi_property_collector.py`](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/utils/vi_property_collector.py) (vSphere property retrieval), [`Management Pack/app/collectors/vcenter/collectvCenterData.py`](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vcenter/collectvCenterData.py) (vCenter collector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_adapter["Adapter orchestration"]
  node_adapter["Adapter runtime<br/>[adapter.py]"]
  node_constants["Adapter constants<br/>[main.py]"]
end

subgraph group_inventory["Inventory collection"]
  node_vcenter["vCenter collector"]
  node_clusters["Cluster collector"]
  node_hosts["Host collector<br/>[collectHostData.py]"]
  node_vms["VM collector<br/>[collectVMData.py]"]
  node_datastores["Datastore collector"]
  node_property_collector["vSphere property retrieval"]
end

subgraph group_enrichment["Resource enrichment"]
  node_cluster_enrichment["Cluster properties and metrics"]
  node_host_enrichment["Host properties"]
  node_vm_enrichment["VM properties"]
  node_datastore_enrichment["Datastore properties"]
  node_vcenter_enrichment["vCenter properties"]
end

subgraph group_guest["Guest monitoring"]
  node_windows_services["Windows services<br/>[vmService.py]"]
  node_windows_events["Windows event logs"]
end

node_operator(("Adapter operator"))
node_vcf_operations["VCF Operations"]
node_vcenter_api["vCenter API"]
node_guest_api["VMware Guest Operations"]

node_operator -->|"invokes"| node_adapter
node_adapter -->|"uses identifiers"| node_constants
node_adapter -->|"dispatches"| node_vcenter
node_adapter -->|"dispatches"| node_clusters
node_adapter -->|"dispatches"| node_hosts
node_adapter -->|"dispatches"| node_vms
node_adapter -->|"dispatches"| node_datastores
node_adapter -->|"reads configuration"| node_vcf_operations
node_vcenter -->|"queries resources"| node_vcf_operations
node_clusters -->|"queries resources"| node_vcf_operations
node_hosts -->|"queries resources"| node_vcf_operations
node_vms -->|"queries resources"| node_vcf_operations
node_datastores -->|"queries resources"| node_vcf_operations
node_vcenter -->|"reads settings"| node_vcenter_api
node_clusters -->|"retrieves properties"| node_property_collector
node_hosts -->|"retrieves properties"| node_property_collector
node_vms -->|"retrieves properties"| node_property_collector
node_datastores -->|"retrieves properties"| node_property_collector
node_property_collector -->|"queries objects"| node_vcenter_api
node_vcenter -->|"adds properties"| node_vcenter_enrichment
node_clusters -->|"adds properties and metrics"| node_cluster_enrichment
node_hosts -->|"adds properties"| node_host_enrichment
node_vms -->|"adds properties"| node_vm_enrichment
node_datastores -->|"adds properties"| node_datastore_enrichment
node_vms -->|"collects services"| node_windows_services
node_vms -->|"collects events"| node_windows_events
node_windows_services -->|"runs guest commands"| node_guest_api
node_windows_events -->|"runs guest commands"| node_guest_api

click node_adapter "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/adapter.py"
click node_constants "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/constants/main.py"
click node_vcenter "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vcenter/collectvCenterData.py"
click node_clusters "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/cluster/collectClusterData.py"
click node_hosts "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/host/collectHostData.py"
click node_vms "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vm/collectVMData.py"
click node_datastores "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/datastore/collectDatastoreData.py"
click node_property_collector "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/utils/vi_property_collector.py"
click node_cluster_enrichment "https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/cluster"
click node_host_enrichment "https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/host"
click node_vm_enrichment "https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/vm"
click node_datastore_enrichment "https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/datastore"
click node_vcenter_enrichment "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/properties/vcenter/collect_vcenter_properties.py"
click node_windows_services "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/properties/vm/vmService.py"
click node_windows_events "https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/events/vm/collect_windows_event_logs.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_adapter,node_constants toneBlue
class node_vcenter,node_clusters,node_hosts,node_vms,node_datastores,node_property_collector toneAmber
class node_cluster_enrichment,node_host_enrichment,node_vm_enrichment,node_datastore_enrichment,node_vcenter_enrichment,node_vcenter_api toneMint
class node_windows_services,node_windows_events toneRose
class node_operator,node_vcf_operations,node_guest_api toneIndigo
```

## Components

### Adapter orchestration

- [Adapter runtime](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/adapter.py): `Management Pack/app/adapter.py`
- [Adapter constants](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/constants/main.py): `Management Pack/app/constants/main.py`

### Inventory collection

- [vCenter collector](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vcenter/collectvCenterData.py): `Management Pack/app/collectors/vcenter/collectvCenterData.py`
- [Cluster collector](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/cluster/collectClusterData.py): `Management Pack/app/collectors/cluster/collectClusterData.py`
- [Host collector](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/host/collectHostData.py): `Management Pack/app/collectors/host/collectHostData.py`
- [VM collector](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/vm/collectVMData.py): `Management Pack/app/collectors/vm/collectVMData.py`
- [Datastore collector](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/collectors/datastore/collectDatastoreData.py): `Management Pack/app/collectors/datastore/collectDatastoreData.py`
- [vSphere property retrieval](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/utils/vi_property_collector.py): `Management Pack/app/utils/vi_property_collector.py`

### Resource enrichment

- [Cluster properties and metrics](https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/cluster): `Management Pack/app/properties/cluster`
- [Host properties](https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/host): `Management Pack/app/properties/host`
- [VM properties](https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/vm): `Management Pack/app/properties/vm`
- [Datastore properties](https://github.com/vmbro/vcf-operations-vcommunity/tree/main/Management%20Pack/app/properties/datastore): `Management Pack/app/properties/datastore`
- [vCenter properties](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/properties/vcenter/collect_vcenter_properties.py): `Management Pack/app/properties/vcenter/collect_vcenter_properties.py`

### Guest monitoring

- [Windows services](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/properties/vm/vmService.py): `Management Pack/app/properties/vm/vmService.py`
- [Windows event logs](https://github.com/vmbro/vcf-operations-vcommunity/blob/main/Management%20Pack/app/events/vm/collect_windows_event_logs.py): `Management Pack/app/events/vm/collect_windows_event_logs.py`

### Other components

- **Adapter operator**
- **VCF Operations**
- **vCenter API**
- **VMware Guest Operations**

## Connections

- Adapter operator → Adapter runtime: invokes (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → Adapter constants: uses identifiers (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → vCenter collector: dispatches (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → Cluster collector: dispatches (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → Host collector: dispatches (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → VM collector: dispatches (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → Datastore collector: dispatches (evidence: `Management Pack/app/adapter.py`)
- Adapter runtime → VCF Operations: reads configuration (evidence: `Management Pack/app/adapter.py`)
- vCenter collector → VCF Operations: queries resources (evidence: `Management Pack/app/collectors/vcenter/collectvCenterData.py`)
- Cluster collector → VCF Operations: queries resources (evidence: `Management Pack/app/collectors/cluster/collectClusterData.py`)
- Host collector → VCF Operations: queries resources (evidence: `Management Pack/app/collectors/host/collectHostData.py`)
- VM collector → VCF Operations: queries resources (evidence: `Management Pack/app/collectors/vm/collectVMData.py`)
- Datastore collector → VCF Operations: queries resources (evidence: `Management Pack/app/collectors/datastore/collectDatastoreData.py`)
- vCenter collector → vCenter API: reads settings (evidence: `Management Pack/app/collectors/vcenter/collectvCenterData.py`)
- Cluster collector → vSphere property retrieval: retrieves properties (evidence: `Management Pack/app/collectors/cluster/collectClusterData.py`)
- Host collector → vSphere property retrieval: retrieves properties (evidence: `Management Pack/app/collectors/host/collectHostData.py`)
- VM collector → vSphere property retrieval: retrieves properties (evidence: `Management Pack/app/collectors/vm/collectVMData.py`)
- Datastore collector → vSphere property retrieval: retrieves properties (evidence: `Management Pack/app/collectors/datastore/collectDatastoreData.py`)
- vSphere property retrieval → vCenter API: queries objects (evidence: `Management Pack/app/utils/vi_property_collector.py`)
- vCenter collector → vCenter properties: adds properties (evidence: `Management Pack/app/collectors/vcenter/collectvCenterData.py`)
- Cluster collector → Cluster properties and metrics: adds properties and metrics (evidence: `Management Pack/app/collectors/cluster/collectClusterData.py`)
- Host collector → Host properties: adds properties (evidence: `Management Pack/app/collectors/host/collectHostData.py`)
- VM collector → VM properties: adds properties (evidence: `Management Pack/app/collectors/vm/collectVMData.py`)
- Datastore collector → Datastore properties: adds properties (evidence: `Management Pack/app/collectors/datastore/collectDatastoreData.py`)
- VM collector → Windows services: collects services (evidence: `Management Pack/app/collectors/vm/collectVMData.py`)
- VM collector → Windows event logs: collects events (evidence: `Management Pack/app/collectors/vm/collectVMData.py`)
- Windows services → VMware Guest Operations: runs guest commands (evidence: `Management Pack/app/properties/vm/vmService.py`)
- Windows event logs → VMware Guest Operations: runs guest commands (evidence: `Management Pack/app/events/vm/collect_windows_event_logs.py`)
