OpenTelemetry Metric Alert Configuration

An OpenTelemetry metric (OTel) alert configuration generates alerts when ingested metric data meets specified conditions. You can create an OpenTelemetry metric alert configuration using either the Query Builder or a Raw query (PromQL expression). The Query Builder provides options to construct a query by selecting metrics, filters, aggregations, and grouping attributes, while a Raw Query enables you to enter a PromQL expression directly.

An OpenTelemetry metric alert configuration combines a name and alert group with either a visual query created using the Query Builder or a PromQL expression. LogicMonitor compares the query result with a configured threshold to determine whether to trigger an alert. The PromQL expression selects and aggregates time-series data, while LogicMonitor provides centralized monitoring and alerting for metrics received through supported metric ingestion pipelines.

Requirements for Adding Alert Configurations

To configure OpenTelemetry metric alerts, you need the following:

• To query OpenTelemetry metrics, you need OTel Metrics enabled in your LogicMonitor portal.
• To create and manage OpenTelemetry metric alert configurations, you need a LogicMonitor user with the “Manage” permission set.
• Ensure that the OpenTelemetry metric that you want to use is ingested in LogicMonitor and the metric is available for querying.

Adding Alert Configurations

1. In LogicMonitor, navigate to More > OTel Metrics.
2. Select Add Alert Rule from the dropdown menu on the Alert Configuration page.
3. In the Name field, enter a name for the alert configuration.
4. (Optional) In the Description field, enter a description for the alert configuration.

5. Under Select where to create this alert, do one of the following:
   • To use an existing alert group:
     1. Select Existing.
     2. Select the alert group from the Group dropdown menu.
   • To create a new alert group:
     1. Select Create new.
     2. In the Group name field, enter a name for the alert group.
     3. (Optional) In the Group description field, enter a description for the alert group.
6. In the Query section, select the time range from the Time range dropdown menu.
   • To build a query in the Query Builder section, do the following:
     1. Select Query Builder.
     2. To restrict the metric scope, under Filter by, add the filters.
     3. Select the aggregation from the aggregation dropdown menu.
        By default, the aggregation is set to Average.
     4. (Optional) Select the grouping attributes from the By dropdown menu.
     5. (Optional) Select Add function, and then configure the query function.
     6. In the Step field, enter the duration between query evaluation points.
     7. Review the query in the Generated query section.
     8. Select Run query.
        The Query preview pane displays the query results.
        
   • To use a raw query, do the following:
     1. Select Raw Query.
     2. Enter the PromQL expression in the Enter PromQL query field.
     3. In the Step field, enter the duration between query evaluation points.
     4. Select Run query.
        The query results display.
        
7. To configure an alert threshold, do the following:
   1. Select the comparison operator for the generated query from the Alert threshold section.
   2. Enter the threshold value to trigger the alert.
   3. Select the severity from the Trigger dropdown menu.
   4. Select Add.
      LogicMonitor creates the alert configuration and displays it in the selected alert group.
      

Adding an Alert Group

1. In LogicMonitor, navigate to More > OTel Metrics.
2. Select Add Alert Group from the dropdown menu on the Alert Configuration page.
3. In the Group name field, enter a name.

4. (Optional) In the Description field, enter a description for the alert group.
5. Select Add to create the alert group.
   LogicMonitor creates the alert group. The alert group becomes available when you create OpenTelemetry metric alert configurations.