> ## Documentation Index
> Fetch the complete documentation index at: https://docs.5x.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring & Alerts

> Set up proactive alerts for your data ingestion pipelines to stay informed about sync status, failures, and data usage

**Focus:** Configure alerts to get notified about sync failures, successful completions, and data usage thresholds across your ingestion connectors.

Stay on top of your data pipeline health with comprehensive alerting that notifies you through Slack channels or email when important events occur in your ingestion workflows.

## Alert setup overview

5X provides flexible alert configuration to keep you informed about your data pipeline status. You can set up alerts in two ways:

<CardGroup cols={2}>
  <Card title="From connector listing" icon="bell">
    **Quick connector alerts**

    Set up alerts directly from the ingestion dashboard for specific connectors
  </Card>

  <Card title="From settings panel" icon="gear">
    **Centralized management**

    Configure and manage all alerts from a single location in Settings
  </Card>
</CardGroup>

## Setting up alerts

### **Method 1: From connector listing page**

The quickest way to set up alerts for a specific connector is directly from the ingestion dashboard:

<img src="https://mintcdn.com/5x/F78wdgJnT4aJ3lPl/images/ingestion/connector-alerts.png?fit=max&auto=format&n=F78wdgJnT4aJ3lPl&q=85&s=73445973ec9601a1da409e16a2ac6637" alt="Ingestion Dashboard with Alert Configuration" style={{borderRadius: '12px', boxShadow: '0 4px 12px rgba(0, 0, 0, 0.1)'}} width="1341" height="925" data-path="images/ingestion/connector-alerts.png" />

<Steps>
  <Step title="Navigate to ingestion dashboard">
    Go to **Ingestion** in the main navigation to view your connectors
  </Step>

  <Step title="Click the alert icon">
    Next to each connector, click the <Icon icon="bell" /> **icon** to open the alert configuration dialog
  </Step>

  <Step title="Configure alert settings">
    Set up your alert preferences including:

    * Alert name
    * Connector selection (pre-selected)
    * Alert types (Sync Failed, Sync Successful, Row usage limit)
    * Delivery channels (Slack and/or Email)
  </Step>

  <Step title="Save your alert">
    Click **Set alert** to activate the alert for that specific connector
  </Step>
</Steps>

### **Method 2: From settings panel**

For comprehensive alert management across all connectors:

<img src="https://mintcdn.com/5x/F78wdgJnT4aJ3lPl/images/ingestion/alerts-settings.png?fit=max&auto=format&n=F78wdgJnT4aJ3lPl&q=85&s=b977ed3aac4761811e30a91db763db19" alt="Alerts Settings Panel" style={{borderRadius: '12px', boxShadow: '0 4px 12px rgba(0, 0, 0, 0.1)'}} width="1165" height="510" data-path="images/ingestion/alerts-settings.png" />

<Steps>
  <Step title="Access settings">
    Navigate to **Settings** from the main navigation, then click **Alerts**
  </Step>

  <Step title="Create new alert">
    Click the **New Alert** button to open the alert configuration dialog
  </Step>

  <Step title="Configure alert details">
    Set up your alert with the following options:

    * **Alert name** - Descriptive name for your alert
    * **Type** - Select "Ingestion" for data pipeline alerts
    * **Connectors** - Choose which connectors to monitor
    * **Channel** - Select Slack channels for notifications
    * **Email** - Add email addresses for notifications
    * **Alert types** - Choose specific alert conditions
  </Step>

  <Step title="Save and activate">
    Click **Set alert** to create and activate your new alert
  </Step>
</Steps>

### **Editing existing alerts**

To modify an existing alert from the Settings panel:

<Steps>
  <Step title="Find your alert">
    In **Settings → Alerts**, locate the alert you want to modify
  </Step>

  <Step title="Click to edit">
    Click on the alert name or row to open the edit dialog
  </Step>

  <Step title="Update settings">
    Modify any alert settings including connectors, channels, or alert types
  </Step>

  <Step title="Save changes">
    Click **Update alert** to save your changes
  </Step>
</Steps>

## Alert types

Configure different alert types based on your monitoring needs:

<Tabs>
  <Tab title="Sync Failed">
    **Get notified when syncs fail**

    Receive immediate notifications when data synchronization fails for your connectors.

    **When this alert triggers:**

    * Sync encounters an error and cannot complete
    * Connection to data source fails
    * Authentication or permission issues occur
    * Data transformation errors during processing

    **Best practices:**

    * Set up for all critical connectors
    * Route to appropriate team channels
    * Include escalation for repeated failures
  </Tab>

  <Tab title="Sync Successful">
    **Confirmation of successful syncs**

    Stay informed when data synchronization completes successfully.

    **When this alert triggers:**

    * Sync completes without errors
    * All data successfully loaded to warehouse
    * Schema changes detected and handled
    * Scheduled sync runs on time

    **Best practices:**

    * Use for critical business data
    * Consider digest format for frequent syncs
    * Useful for compliance and audit trails
    * Monitor sync completion times
  </Tab>

  <Tab title="Row usage limit">
    **Monitor data volume thresholds**

    Get alerts when data processing approaches or exceeds usage limits.

    **When this alert triggers:**

    * Combined row count across connectors exceeds threshold
    * Individual connector processes excessive data
    * Unexpected data volume spikes detected
    * Approaching monthly or daily limits

    **Configuration options:**

    * Set threshold in millions of rows (e.g., 20 million)
    * Daily reset monitoring
    * Percentage-based warnings (e.g., 80% of limit)
    * Connector-specific limits

    **Best practices:**

    * Set threshold below actual limits
    * Monitor for data anomalies
    * Plan for business growth
    * Review limits regularly
  </Tab>
</Tabs>

## Alert configuration best practices

### **Alert organization**

Structure your alerts for maximum effectiveness:

<CardGroup cols={2}>
  <Card title="Connector-specific alerts" icon="link">
    **Focused monitoring**

    Set up dedicated alerts for critical connectors with specific requirements
  </Card>

  <Card title="Team-based routing" icon="users">
    **Proper escalation**

    Route alerts to appropriate teams based on connector ownership
  </Card>

  <Card title="Severity levels" icon="alert-triangle">
    **Prioritization**

    Use different channels for different alert severities
  </Card>

  <Card title="Noise reduction" icon="volume-off">
    **Alert fatigue**

    Avoid overwhelming teams with too many notifications
  </Card>
</CardGroup>

### **Alert naming conventions**

Use consistent naming for better organization:

**Naming structure:**

* **Environment prefix** - `[PROD]`, `[STAGING]`, `[DEV]`
* **Connector name** - Clear identifier for the data source
* **Alert type** - `Sync Failed`, `Usage Limit`, etc.
* **Team identifier** - Responsible team or department

**Examples:**

* `[PROD] Salesforce - Sync Failed - Sales Team`
* `[PROD] PostgreSQL - Usage Limit - Data Engineering`
* `[STAGING] BigQuery - Sync Successful - QA Team`

***
