Hermes
problemen oplossen
Troubleshooting voor het Hermes agent-framework: start, installatie, Docker, API’s, workflows, auth, webhooks en databases — logs eerst, herinstallatie later.
Start
Hermes start niet
Controleer of de runtime/service actief is, of poorten niet bezet zijn en of configuratie en secrets compleet zijn. Vergelijk met een werkende installatie-baseline — herinstalleer niet vóór je logs hebt bekeken.
Setup
Installatieproblemen
Veelvoorkomend: ontbrekende dependencies, verkeerde paden, incomplete .env of versie-mismatch. Doorloop vereisten op de installatiepagina en fix één variabele per keer.
docker
Docker problemen
Unhealthy containers, volume-permissies, verkeerde compose-versie of dubbele processen op de host. Zie Docker & deployment (documentatie) en vergelijk health checks met lokale install.
API
API fouten
401/403: credentials of scopes. 429: rate limits. 5xx: upstream of payload. Log request-id en correlation-id; details bij API Integrations.
workflows
Workflow errors
Timeouts, stuck queues of mislukte tool-stappen. Isoleer één workflow, replay in staging en check approval-wachtrijen. Basis: workflows.
Auth
Authenticatieproblemen
Verlopen tokens, verkeerde OAuth-scopes of gedeelde service-accounts. Roteer secrets en herzie policies op safety.
webhooks
Webhook problemen
Signature mismatch, dubbele delivery of payloads die de workflow niet verwacht. Log raw body hash (niet secrets) en test met vaste test-event.
Data
Database/connectieproblemen
Connection pool uitgeput, firewall, verkeerde connection string of SSL-modus. Test connectie buiten de agent om; geen destructieve queries op prod tijdens debug.
observability
Logs en monitoring
Verzamel runtime-logs, connector-errors en workflow-traces vóór config-wijzigingen. Meet error rate en latency over tijd — niet alleen één failed run.
Support
Wanneer Ploko inschakelen?
Schakel Ploko in bij productie-incidenten, integratie-cutovers of als interne debug langer dan een werkdag duurt. Hermes specialist · contact.
Hermes cluster
Gerelateerde onderwerpen
Hub Install docker workflows safety API Integrations Specialist