Hermes
problemen oplossen

Troubleshooting voor het Hermes agent-framework: start, installatie, Docker, API’s, workflows, auth, webhooks en databases — logs eerst, herinstallatie later.

✓ Logs before reinstallation

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

FAQ

FAQ —
problems

Incident-flow en wanneer je Ploko inschakelt.

Contact →
Meestal configuratie, credentials, netwerk of een stuck workflow — niet “het model”. Start met logs en de secties op deze pagina; terug naar Hub voor context.
Check service status, poorten, .env en recente wijzigingen. Zie Install en sectie “Hermes start niet”. Geen wipe vóór log-export.
Noteer statuscode en endpoint; valideer token/scopes en rate limits. API Integrations · safety.
docker compose ps, logs en health checks; vermijd twee runtimes op één host. docker · installatie.
Runtime-log, connector-log en workflow-traces met timestamps en correlation-id. Eerst logs, dan config — zie sectie logs en monitoring.
Ja — incident-analyse, integratie-debug en productie-hardening. Specialist or contact.