Ermete
problemen oplossen
Troubleshooting voor het Hermes agent-framework: start, installatie, Docker, API’s, workflows, auth, webhooks en databases — logs eerst, herinstallatie later.
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.
Hermes cluster
Argomenti correlati
Centro Installare docker flussi di lavoro Sicurezza Integrazioni API Specialista