Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(alerts): rewriting the alert condition page, deleting extra docs #17869

Merged
merged 9 commits into from
Jul 12, 2024
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ tags:
- Alert conditions
metaDescription: 'Use the title template when you create an alert condition so you can easily identify related incidents.'
redirects:
- /docs/alerts/new-relic-alerts/defining-conditions/alert-condition-descriptions
- /docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/alert-descriptions
- /docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/alert-custom-violation-descriptions
- /docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/advanced-techniques/alert-custom-violation-descriptions/
freshnessValidatedDate: never
---

Expand Down

Large diffs are not rendered by default.

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -26,96 +26,20 @@ import queriesnrqlSignalLossUi from 'images/queries-nrql_screenshot-full_signal-

import queriesnrqlFineTuneSignals from 'images/queries-nrql_screenshot-full_fine-tune-signals.webp'

You can use [NRQL queries](/docs/insights/new-relic-insights/using-new-relic-query-language/using-nrql) to create alert conditions. Once you've defined your signal, you can further define your warning and critical threshold levels. This determines when an alerts incident is created. For more information on key concepts relating to NRQL alert conditions and streaming alerts, see [Streaming alerts: key terms and concepts](/docs/alerts-applied-intelligence/new-relic-alerts/get-started/streaming-alerts-key-terms-concepts).
We recommend creating an alert using a NRQL alert condition. This doc will guide you through formatting and configuring your NRQL alert conditions to maximize efficiency and reduce noise. If you've just started with New Relic, or you haven't created an alert condition yet, we recommend starting with [Alert conditions](/docs/alerts/create-alert/create-alert-condition/alert-conditions/).

## Create a NRQL alert condition from a policy [#alert-condition-from-policy]
You can create an alert condition from:

Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Conditions & Policies**</DNT> to create a NRQL alert condition from a policy. Then, click <DNT>**+ New alert condition**</DNT>.
* [A chart](/docs/tutorial-create-alerts/create-an-alert/)
* [A policy page](https://one.newrelic.com/nr1-core/condition-builder/policy-entity)
* [The <DNT>**Alert coverage gaps**</DNT> page](https://one.newrelic.com/alerts-ai/detection-gaps/)

<img
width="80%;"
title="Create a NRQL alert condition from a policy"
alt="An image of the UI demonstrating how to create a NRQL alert condition from a policy."
src={queriesPolicyNewAlertCondition}
/>

<figcaption>
Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Conditions & Policies > + New alert condition**</DNT>.
</figcaption>


Follow these steps.

<CollapserGroup>
<Collapser
id="step1"
title="Step 1. Define your signal"
>
1. Choose the <DNT>**Build a query**</DNT> option. This option enables you to identify a signal and add a NRQL query. See [How to use NRQL: the mechanics of querying](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-how-nrql-works/) if you need help for adding a query.

2. Click <DNT>**Next**</DNT>.

</Collapser>
<Collapser
id="step2"
title="Step 2. Adjust to signal behavior"
>

Tune this condition to adjust for frequency, choppiness, or gaps in your signal. Here, you can configure the [data aggregation](/docs/alerts-applied-intelligence/new-relic-alerts/get-started/choose-your-aggregation-method/), the [gap-filling strategy](#data-gaps), and the [evaluation delay](#evaluation-delay).

Click <DNT>**Next**</DNT> when you finish your configuration.

</Collapser>
<Collapser
id="step3"
title="Step 3. Define your thresholds"
>

You can define [thresholds](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/advanced-techniques/set-thresholds-alert-condition/) to determine what will open an incident. Once defined, click <DNT>**Next**</DNT>.

</Collapser>
<Collapser
id="step4"
title="Step 4. Add details"
>

Add the details of the alert condition. Add a name to the alert condition to find and use it easily. Then, connect it to a policy. You can select an existing one or create a new policy.

If you select <DNT>**New policy**</DNT>:

* Add a [meaningful name](/docs/alerts-applied-intelligence/new-relic-alerts/alert-policies/create-edit-or-find-alert-policy/#best-practices-policies) for the policy with a maximum of 64 characters.

* Select the way you want to [group your incidents](/docs/alerts-applied-intelligence/new-relic-alerts/alert-policies/specify-when-alerts-create-incidents/).

* Configure the [additional settings](/docs/alerts-applied-intelligence/new-relic-alerts/get-started/your-first-nrql-condition/#additional-settings) if you need to.

* Click <DNT>**Save & set up notifications**</DNT>.


If you've selected <DNT>**Existing policy**</DNT>, click <DNT>**Save condition**</DNT> once you've chosen a policy.

</Collapser>
</CollapserGroup>


## Create a condition from a chart [#create-chart]

Most of our charts, with the exception of a few older ones, allow you to create a condition from them.

To create a NRQL alert condition from a chart:

1. Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & Services**</DNT> and select an app.
2. In the left pane, select <DNT>**Metrics explorer**</DNT> and add your configuration.
3. In the chart's right corner, click the <Icon name="fe-more-horizontal"/> icon and select <DNT>**Create alert condition**</DNT>.

<img
title="Create alert condition from the metrics explorer"
alt="Create alert condition from the metrics explorer"
src={queriesMetricExplorerAnimation}
/>
You can also use one of our alert builders:

4. Follow the steps explained in the [Create a NRQL alert condition from a policy](#alert-condition-from-policy) but be aware that step 1 is a bit different because, now, the query is built with the data you've previously configured.
* Use <DNT>**Write your own query**</DNT> to build alerts from scratch.
* <DNT>Use **Guided mode**</DNT>to choose from recommended options and have your NRQL query built for you.

No matter where you begin creating an alert condition, whether through a chart or by writing your own query, NRQL is the building block upon which you can define your signal and set your thresholds.

## NRQL alert syntax [#syntax]

Expand Down
Loading
Loading