42-evey
evey-telemetry
Structured JSON logging of every tool call, delegation, and error with auto-rotating event log and self-inspection via telemetry_query.
Repository last updated Jul 18, 2026
Overview
Evey Telemetry is a plugin for the Hermes Agent ecosystem that provides structured JSON logging for all agent activities. It captures every tool call, delegation, and error in a consistent format, enabling detailed observability and debugging.
The plugin includes an auto-rotating event log that manages log file size and retention automatically, preventing disk exhaustion while preserving recent history. A built-in telemetry_query tool allows the agent to inspect its own event log at runtime, supporting self-diagnosis and adaptive behavior.
This plugin is ideal for developers and operators running autonomous agents who need reliable, queryable telemetry without external dependencies. It integrates seamlessly with Hermes Agent's plugin system and requires no additional infrastructure.
Highlights
- Structured JSON logging for all tool calls, delegations, and errors
- Auto-rotating event log prevents disk bloat
- Built-in telemetry_query tool for runtime self-inspection
- MIT licensed, open-source plugin for Hermes Agent
Features
Structured JSON Logging
Every tool call, delegation, and error is logged as structured JSON, making it easy to parse and analyze.
Auto-Rotating Event Log
The event log automatically rotates to manage file size, ensuring continuous logging without manual intervention.
Self-Inspection via telemetry_query
The agent can query its own telemetry log at runtime using the telemetry_query tool, enabling adaptive behavior and debugging.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
git clone https://github.com/42-evey/hermes-plugins.git
cp -r hermes-plugins/evey-* ~/.hermes/plugins/
cp hermes-plugins/evey_utils.py ~/.hermes/plugins/
# Restart hermes-agentHow it's built
The plugin is written in Python and integrates with Hermes Agent via the standard plugin interface. It hooks into the agent's execution pipeline to intercept tool calls, delegations, and errors, serializing them as JSON lines to a configurable log file.
The auto-rotation mechanism is based on file size thresholds, with configurable maximum size and backup count. The telemetry_query tool exposes a simple query interface that filters events by type, timestamp, or content, returning results as JSON.
No external dependencies are required beyond Python and the Hermes Agent runtime. The plugin is distributed under the MIT license.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The 42-evey/evey-telemetry repository is the authoritative source and the place to file issues or contribute.
Category: Observability & Telemetry · Licensed under MIT