Troubleshooting

Hit a snag with OpenETL? This section helps you tackle common problems, debug like a pro, and find support when needed.

Common Issues

• Module Not Found:
  • Fix: Run npm install in your project root to grab dependencies.
• Pipeline Fails Silently:
  • Check: Ensure credentials in your vault are correct (e.g., client_id, refresh_token).
• Rate Limit Errors:
  • Solution: Adjust rate_limiting in your pipeline config—see Rate Limiting and Pagination.

Debugging Tips

• Enable Logging:

orchestrator.runPipeline({
  id: 'my-pipeline',
  source: { /* ... */ },
  logging: event => console.log(event),
});

• Check Adapter Connections: Test connect() manually to spot auth issues.
• Break It Down: Run smaller pipeline chunks to isolate failures.

Getting Help

• Docs: Dig into Architecture Overview for context.
• Community: Ask on Support—Discord, forums, or email.
• Issues: Search or file a bug on Github with logs and steps.

Still stuck? We’ve got your back—reach out!