Alerts Overview

Introduction

The Alerts dashboard helps you monitor and configure automatic notifications that are sent when log data matches conditions you define. Use it to create, review, and manage alert rules that trigger webhooks or other integrations.

What are Alerts?

Alerts are user-defined rules that watch incoming log or event data and send a notification (usually via a webhook) when conditions are met. Each alert contains:

• a descriptive Alert Name to identify it
• one or more project scopes (Select Project) to limit where the rule applies
• a set of Filters that describe the trigger conditions
• a Webhook destination and optional template variables
• a Deduplication Period to avoid repeated notifications

Key Features

• Create Alerts: Use the Create New button to define a new alert in a guided stepper form
• Edit Alerts: Click on the Edit icon to update an existing alert
• Delete Alerts: Click on the Delete icon and confirm to remove an alert
• Filter Builder: Build complex conditions with field/operator/value rules
• Webhook Template Variables: Map alert data into webhook templates
• Pagination: Browse alerts across pages using the pagination control

Dashboard Layout

Main Components

• Title and brief description at the top of the page
• Create New primary button to open the alert creation modal
• Alerts list: card-style rows showing each alert's Alert Name and action icons
• Pagination control at the bottom-right of the list
• Edit and Delete action icons on each alert
• Modal dialog (Create Alert / Edit Alert) with a two-step form

Navigation

• Navigate to the Alerts dashboard via the main sidebar under Alerts (or via the project settings where available).
• Use the Create New button in the top-right to begin creating an alert.
• Use the pagination control to move between result pages.

Quick Start Guide

Step 1: Open the Alerts Dashboard

1. Navigate to Alerts in the application sidebar.
2. The alerts list will load. If none exist, you'll see a Create Your First Alert prompt.

Step 2: Create a New Alert

1. Click on the Create New button in the top-right.
2. Complete the modal form (see Managing Alerts for detailed steps).
3. Click Create on the final step to save.

Alert Types

The UI treats alerts as rule objects rather than fixed types, but you can express severity and intent via naming and webhook templates. Use the table below to map common use cases:

Alert Type	Description	Use Case
Critical	Immediate attention required — use high-priority webhooks	System outages, data pipeline failures
Warning	Potential issues that need monitoring	Performance degradation, rising error rates
Informational	General status updates	Deployments, routine reports

Note: The application does not enforce a fixed Severity field. Use naming conventions or webhook templates to communicate priority.

Common Use Cases

Monitor Failed Jobs

• Create an alert with Filters that match status = failed or level = error for a specific Select Project.
• Use a Critical webhook template to notify on-call engineers.

Watch High Latency

• Use a numeric field in Filters such as data.duration > 1000 to trigger when latency exceeds a threshold.
• Set a longer Deduplication Period to avoid repeated notifications.

Trigger on Specific Events

• Filter by context.eventType eq user_signup and point to an informational webhook for analytics pipelines.

Next Steps

See Manage Alert for step-by-step instructions on creating, viewing, editing, and deleting alerts.

Tip: Give alerts descriptive names and include the project name or severity in the Alert Name to make them easier to scan in the list.

Warning: Deleting an alert is permanent. Use the Delete action only when you are sure the rule is no longer needed.