Getting Started with supaguard

This supaguard tutorial will show you how to set up your first AI-powered synthetic monitor in less than 2 minutes.

1. Create a Check

Once you have signed up for supaguard, you will see the Checks Dashboard.

1. Click the "New Check" button in the top right corner.
2. Select "AI Generate" (Recommended for first-time users).
3. Enter the URL you want to monitor (e.g., https://your-saas.com).
4. (Optional) Provide a hint to the AI, such as:

   "Login with user demo@example.com and password password123, then verify the dashboard loads."

2. Review the AI-Generated Script

supaguard's AI Agent will launch a browser, visit your URL, and attempt to perform the user flow you described.

• Watch in Real-time: You can see a live video preview of the agent navigating your site.
• Verify the Script: The agent will generate a Playwright script automatically. It will look like this:

import { test, expect } from '@playwright/test';

test('login flow', async ({ page }) => {
  await page.goto('https://your-saas.com/login');
  await page.fill('input[name="email"]', 'demo@example.com');
  await page.fill('input[name="password"]', 'password123');
  await page.click('button[type="submit"]');
  await expect(page.locator('.dashboard-header')).toBeVisible();
});

If the script looks correct, click "Save & Enable".

[!TIP] Keep your secrets safe. When testing login flows, don't hardcode passwords. Use process.env.MY_PASSWORD in your script and define the value in your Organization Settings > Variables.

3. Configure Regions and Frequency

By default, supaguard runs your check:

• Frequency: Every 10 minutes
• Locations: Random rotation
• Retry Strategy: Smart Retry enabled (re-run from a different region on failure)

You can customize this in the Settings tab of your new check.

What's Next?

Now that you have a basic check running:

• Configure Alerts: specific channels for Slack or PagerDuty.
• Explore Smart Retries: Learn how we stop false alarms.

Best Practices for AI Monitors

• Provide Clear Intent: The more specific your instructions (e.g., "Verify the pricing table displays '$99'"), the more reliable the generated script will be.
• Use Test Credentials: Always use dedicated test accounts for flows requiring authentication, not real user data.
• Start Small: Begin by monitoring 1-3 critical user journeys (e.g., Login, Checkout) before expanding to edge cases.