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

# Set Up Alerts on Logs

> Learn how to set up alerts and be automatically notified when things go wrong

{/*<!-- markdownlint-enable MD044 -->*/}

## Overview

Galileo enables you to get alerted whenever unexpected things happen. For example:

* Your cost is higher than expected
* Your model is hallucinating more than you want
* Users are entering foul language into your app

To successfully set up an alert, you will need to have [logged your first trace](/getting-started/quickstart).

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-default-system-metrics.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=0279f8a6a5f979c3a76f2ffb713a159c" alt="System metrics in alerts" width="758" height="286" data-path="images/console-ui/alerts-default-system-metrics.png" />

These system metrics are available for alerts by default: Status Code, Cost, Latency.

[Add metrics](/concepts/metrics/overview) to enable more alerts.

## Example alerts

Each alert configuration includes:

* a metric e.g. Cost, Correctness, Context Adherence
* an aggregation function: Average, Minimum, Maximum, Count, Sum
* a threshold e.g. \< 0.5
* a time window e.g. 1 hour

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-configuration-input.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=480325f9d38f48bbd5c9a26f7bf6b925" alt="Example alert-configuration" width="604" height="255" data-path="images/console-ui/alerts-configuration-input.png" />

A few example alerts:

* Exceeding costs: If you want to get alerted with an uptick in cost (above \$100/day), select `Cost` Sum > 100 in the last day
* Hallucinations: If you want to get alerted when there's an extreme hallucination, select `Correctness` or `Context Adherence` Count = 1 for values = 0 in the last 15 minutes.
* Hallucination average: If you want to get alerted when hallucinations are probable (e.g. more than 50% below perfect threshold), select `Correctness` or `Context Adherence` Average \< 0.5 in the last 1 hour.

More example alerts are shown below:

<img src="https://mintcdn.com/v2galileo/Jt96XpE2E5-1xdjF/images/console-ui/alerts-configuration-example.png?fit=max&auto=format&n=Jt96XpE2E5-1xdjF&q=85&s=f602790fc12e4c20d9c75ea5df16160d" alt="Example alerts" width="1524" height="1064" data-path="images/console-ui/alerts-configuration-example.png" />

## Email notifications

To set up email alerts, add your recipients’ email addresses.

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-email-notifications-active.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=514a6635b704c75d179f6148f18b9313" alt="Setting up email notifications for alerts" width="858" height="304" data-path="images/console-ui/alerts-email-notifications-active.png" />

When emails have been added, the top right corner of the section will show "Active".

From the email notification (example below), you can click on the "Open Log Stream" button to find the problematic traces.

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-email-notifications-example.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=102427e56f60cefba8d6164a77d5ca0a" alt="Example email notifications for alerts" width="850" height="486" data-path="images/console-ui/alerts-email-notifications-example.png" />

## Slack notifications

To set up Slack alerts, you'll need to configure your workspace to receive Slack messages via webhook URLs.

Follow <a href="https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/" target="_blank">Slack's instructions to generate a webhook URL</a>.

A few pointers:

1. [Create a Slack app](https://api.slack.com/apps/new). If you don't have an existing manifest file, choose the "From scratch" option to create the app.

2. Pick an App Name like "Galileo Alerts" that will help identify the Slack app that the notifications will come from.

3. Go to the "Incoming Webhooks" page of your Slack app (under "Features"), and enable the toggle to "Activate Incoming Webhooks".

4. Click "Add New Webhook" and choose the Slack channel you'd like Galileo's Alerts to go to. (You can also test the webhook by direct messaging your user account.)

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-slack-notifications-inactive.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=e42a92cfedee6e2989a6d4f10dea0f3b" alt="Empty Slack notification for alerts" width="780" height="420" data-path="images/console-ui/alerts-slack-notifications-inactive.png" />

1. Copy the generated webhook URL from Slack, and paste it into Galileo's Slack Notification section.

2. In the "Notes" section, add the name of the channel that's getting notified.

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-slack-notifications-test.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=b257e5c65a37dd64da9a260f0fde86f8" alt="Test Slack notification for alerts" width="633" height="263" data-path="images/console-ui/alerts-slack-notifications-test.png" />

1. Try sending a test message to webhook to verify the connection.

<img src="https://mintcdn.com/v2galileo/uAcj5skeTWcBkXI6/images/console-ui/alerts-slack-notifications-active.png?fit=max&auto=format&n=uAcj5skeTWcBkXI6&q=85&s=b5568ac95b539af487cfd940f3b67e2c" alt="Active Slack notification for alerts" width="529" height="240" data-path="images/console-ui/alerts-slack-notifications-active.png" />

When a Slack notification have been added, the top right corner of the section will show "Active".
