agentmetrics-hermes
AgentMetrics observability plugin for Hermes agents. Auto-discovered via the hermes_agent.plugins entry-point — no code changes needed.
Install
pip install agentmetrics-hermes
Configuration
Create ~/.config/hermes/agentmetrics.yaml:
api_key: am_your_key
server_url: http://localhost:4000
agent_id: my-hermes-agent
environment: production
Or set environment variables (take precedence over the file):
| Variable | Description |
|---|---|
AGENTMETRICS_API_KEY |
API key |
AGENTMETRICS_SERVER_URL |
Server URL |
AGENTMETRICS_AGENT_ID |
Agent identifier |
AGENTMETRICS_ENVIRONMENT |
Deployment environment |
What gets tracked
| Metric | Description |
|---|---|
input_tokens / output_tokens |
Aggregated LLM token usage |
cache_read_tokens / cache_write_tokens |
Prompt cache statistics |
estimated_cost_usd |
Computed from model pricing |
duration_ms |
Session wall-clock time |
tool_calls / tool_errors |
Per-step tool tracking |
llm_calls |
Number of model API requests |
secrets_blocked_count |
Credentials redacted before transmission |
error |
Exception message on failure (secrets scrubbed) |
Durability
Events are written to a local WAL before transmission. If the server is unreachable the plugin retries automatically via an internal circuit breaker. Events that exhaust all retries go to a dead-letter queue and are surfaced as audit_dlq_alert events.
Security
All event payloads are scanned for API keys, JWTs, and passwords before transmission. Set redaction_mode: debug in the config to disable scrubbing during local development (expires automatically after a configurable TTL).
License
Metadata
Release files for agentmetrics-hermes 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentmetrics_hermes-0.2.2.tar.gz | 30.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentmetrics_hermes-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.7 kB
Release files / agentmetrics_hermes-0.2.2.tar.gz
| Download URL | agentmetrics_hermes-0.2.2.tar.gz |
|---|---|
| Size | 30.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7c1f284ebea03bb3f8d20ed9a1fcad08f008f729801dbab2c92696e95033821
|
|
BLAKE2b-256 checksum How to use checksums |
a08a66bdcad4c1c2b78bceb43bb8641bad566864e4995686bda7dd01124a62bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / agentmetrics_hermes-0.2.2-py3-none-any.whl
| Download URL | agentmetrics_hermes-0.2.2-py3-none-any.whl |
|---|---|
| Size | 26.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4374018ff7d048e5568fdb994ce0949dbbbe3d387b63498a4630a6796521cc22
|
|
BLAKE2b-256 checksum How to use checksums |
5d0ff29bd2b50f059caec3595e91a7769ba2debab3f3c8999091b1b839245d4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|