VMware Log Insight
Disclaimer: Community-maintained open-source project, not affiliated with, endorsed by, or sponsored by VMware, Inc. or Broadcom Inc. "VMware", "vSphere", and "Aria" are trademarks of Broadcom. Source is publicly auditable under the MIT license.
Read-only log search and aggregation for VMware Aria Operations for Logs (formerly vRealize Log Insight) — the appliance that collects syslog from ESXi hosts, vCenter, and VMs. The centralized-log data source for the VMware skill family. Strictly non-destructive: it queries, it never writes.
Companion Skills
| Need | Skill | Tools |
|---|---|---|
| Raw centralized logs + spikes | vmware-log-insight (this) | 7 |
| vCenter events & alarms | vmware-monitor | 27 |
| Metrics, anomalies, capacity | vmware-aria | 28 |
| Incident correlation / root cause | vmware-debug — feed it log_search output |
2 |
| VM lifecycle / operations | vmware-aiops | 49 |
Install
uv tool install vmware-log-insight
mkdir -p ~/.vmware-log-insight
cp config.example.yaml ~/.vmware-log-insight/config.yaml # edit host/username/provider
echo 'VMWARE_LOG_INSIGHT_PROD_PASSWORD=...' > ~/.vmware-log-insight/.env
chmod 600 ~/.vmware-log-insight/.env
vmware-log-insight doctor
Offline / Air-Gapped Install (from source)
This project uses the modern PEP 517 build system (hatchling), so there is no
setup.py by design — that is expected, not a missing file. If you cloned the
source and hit ERROR: File "setup.py" or "setup.cfg" not found ... editable mode currently requires a setuptools-based build, your pip is older than 21.3 and
cannot do an editable (-e) install with a non-setuptools backend. Editable
mode is a developer convenience, not needed to run the tool — do one of:
# From the source tree — a normal (non-editable) install builds a wheel:
pip install . # NOT pip install -e .
# ...or upgrade pip first, and editable works too:
pip install --upgrade pip && pip install -e .
For a truly air-gapped host, build the wheels on a connected machine and copy them over — the target then needs no network:
# On a connected machine, collect this package + its dependencies as wheels:
pip wheel . -w dist # → dist/*.whl (or: uv build, for just this package)
# Copy dist/ to the air-gapped host, then install offline:
pip install --no-index --find-links dist vmware-log-insight
MCP Tools (7 — all read-only)
| Tool | What |
|---|---|
log_search |
Search events by time window + text + filters |
log_aggregate |
Count/aggregate over time bins, with z-score spike detection |
log_fields |
List extracted fields usable in filters |
log_version |
Appliance version/build |
alert_list / alert_get / alert_history |
Query defined alerts and their trigger history |
Workflows
- Find errors fast —
vmware-log-insight search -q error -l 1h. - Where did logs burst? —
vmware-log-insight aggregate -q error -l 6h --bin-ms 300000, readspikes[], thensearchthe spike window. - Root cause — pass
log_searchresults (plus vCenter events from vmware-monitor and metrics from vmware-aria) to vmware-debugincident_timeline.
Troubleshooting
401 on /sessions→ check username/password/providerand theVMWARE_LOG_INSIGHT_<TARGET>_PASSWORDenv var.503 everywhere→ appliance starting up;doctorreports it as a status, not a crash.- Empty results → widen
--last; default API port is 9543 (setportif different).
Security
Read-only by construction. Credentials in ~/.vmware-log-insight/.env (chmod 600);
plaintext passwords auto-obfuscated to grep-safe b64: (obfuscation, not
encryption — inject from a secret manager for real secrecy). TLS on by default.
See SECURITY.md.
License
MIT.
1 maintainer
Metadata
1 maintainer
Release files for vmware-log-insight 1.9.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| vmware_log_insight-1.9.1.tar.gz | 214.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vmware_log_insight-1.9.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 255.5 kB
Release files / vmware_log_insight-1.9.1.tar.gz
| Download URL | vmware_log_insight-1.9.1.tar.gz |
|---|---|
| Size | 214.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2baba2f333a9d62ead9db4f95887feeece54daaf5087516aba9ffcd526fc68ee
|
|
BLAKE2b-256 checksum How to use checksums |
d47965baa6390433579ddd10c634aa4100417d3f3a0676b08ed0eb82a5ccd58a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / vmware_log_insight-1.9.1-py3-none-any.whl
| Download URL | vmware_log_insight-1.9.1-py3-none-any.whl |
|---|---|
| Size | 40.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9f64aae3e1cdc5f37228cd945bc93d59df2d404d3ac6d387a4d725e9efef7696
|
|
BLAKE2b-256 checksum How to use checksums |
90ba30282e9bcaf066c163b873aa9068c76e973fbbc0a6f6d1bcf4a7fb6f9b20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Security for vmware-log-insight 1.9.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
