Ermete
problemen oplossen

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

✓ Registri prima della reinstallazione

Inizio

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 Integrazioni API.

flussi di lavoro

Workflow errors

Timeouts, stuck queues of mislukte tool-stappen. Isoleer één workflow, replay in staging en check approval-wachtrijen. Basis: flussi di lavoro.

Autenticazione

Authenticatieproblemen

Verlopen tokens, verkeerde OAuth-scopes of gedeelde service-accounts. Roteer secrets en herzie policies op Sicurezza.

webhook

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.

Dati

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.

Osservabilità

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.

Supporto

Wanneer Ploko inschakelen?

Schakel Ploko in bij productie-incidenten, integratie-cutovers of als interne debug langer dan een werkdag duurt. Hermes specialist · contatto.

FAQ

FAQ —
Problemi

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 Centro voor context.
Check service status, poorten, .env en recente wijzigingen. Zie Installare en sectie “Hermes start niet”. Geen wipe vóór log-export.
Noteer statuscode en endpoint; valideer token/scopes en rate limits. Integrazioni API · Sicurezza.
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. Specialista di contatto.