Documentation Index
Fetch the complete documentation index at: https://www.activepieces.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
📋 What You Need Before Starting
Make sure these are ready:- BetterStack Setup: For managing incidents and on-call alerts.
- BetterStack Logs: For checking logs and errors.
- BetterStack Monitors: For e2e test results and uptime monitoring.
- BetterStack Errors: For thrown errors.
🚨 Stay Calm and Take Action
-
Tell Your Users:
- Let your users know there’s an issue. Post on Community and Discord.
- Example message: “We’re looking into a problem with our services. Thanks for your patience!”
-
Find Out What’s Wrong:
- Gather details. What’s not working? When did it start?
-
Update the Status Page:
- Use BetterStack and create an incident to update the status page. Set it to ”Investigating” or ”Partial Outage”.
🔍 Check for Infrastructure Problems
- Look at DigitalOcean:
- Check if the CPU, memory, or disk usage is too high.
- If it is:
- Increase the machine size temporarily to fix the issue.
- Keep looking for the root cause.
📜 Check Logs and Errors
-
Use BetterStack Logs:
- Go to https://telemetry.betterstack.com.
- Search for recent errors in the logs.
-
Check BetterStack errors:
- Go to https://errors.betterstack.com.
- Look for grouped errors (errors that happen a lot).
- Try to reproduce the error and fix it if possible.
🛠️ Debugging with Playwright / BetterStack Monitors
-
Check BetterStack Monitor Logs:
- Go to https://uptime.betterstack.com and review recent monitor failures.
- If the issue is a timeout, it might mean there’s a bigger performance problem.
-
Check Playwright E2E Results:
- Review the latest Playwright test run in CI for failed checks.
- If it’s an E2E test failure due to UI changes, it’s likely not urgent.
- Fix the test file packages/tests-e2e/scenarios/betterstack/webhook-should-return-response.flat.spec.js and the issue will go away once pushed to main and Sync Playwright test to BetterStack ci runs.
🎭 Debugging Incidents via Playwright Artifacts
- Go to the BetterStack Incidents list.
- Choose the relevant incident.
- Scroll down and open the Artifacts tab.
- You’ll find screenshots of the failed Playwright tests and logs that help pinpoint what went wrong.
🚨 When Should You Ask for Help?
Ask for help right away if:- Flows are failing.
- The whole platform is down.
- There’s a lot of data loss or corruption.
- You’re not sure what is causing the issue.
- You’ve spent more than 5 minutes and still don’t know what’s wrong.
- Use BetterStack to create a critical alert.
- Go to the Slack incident channel and escalate the issue to the engineering team.
💡 Helpful Tips
-
Stay Organized:
- Keep a list of steps to follow during downtime.
- Write down everything you do so you can refer to it later.
-
Communicate Clearly:
- Keep your team and users updated.
- Use simple language in your updates.
-
Take Care of Yourself:
- If you feel stressed, take a short break. Grab a coffee ☕, take a deep breath, and tackle the problem step by step.