Skip to main content

Troubleshooting

Triage Aptos incidents by interface. If REST is unhealthy, check process status, storage, and p2p sync. If GraphQL is stale, compare indexer checkpoint lag against fullnode ledger version. If Transaction Stream processors loop, inspect cursor commits and idempotency conflicts.

SymptomFirst check
REST timeoutGateway logs, node process, port 8080 bind
Ledger not advancingPeer count, p2p 6180, disk saturation
GraphQL staleProcessor cursor vs REST ledger version
Duplicate rowsUnique key on transaction version/event index