# PromQLAlarmProps

Properties for creating a PromQL Alarm.

Extends: PromQLAlarmProps
Used as props by: PromQLAlarm

- Source: [`aws-cloudwatch/lib/promql-alarm.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-cloudwatch/lib/promql-alarm.ts#L15)
- Type last changed: v2.254.0 · 13 May 2026

## Example

```ts
new cloudwatch.PromQLAlarm(this, 'HighLatencyAlarm', {
  alarmDescription: 'P99 latency exceeds 500ms for 5 minutes',
  query: 'histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5',
  evaluationInterval: Duration.seconds(60),
  pendingPeriod: Duration.seconds(300),
  recoveryPeriod: Duration.seconds(600),
});
```

## Properties

- `actionsEnabled`: boolean = true — Whether the actions for this alarm are enabled.

- `alarmDescription`: string — Description for the alarm.

  **Default:** No description

- `alarmName`: string — Name of the alarm.

  **Default:** Automatically generated name

- `evaluationInterval`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) (required) — The frequency at which the alarm is evaluated.

  Must be between 10 seconds and 3600 seconds.

- `pendingPeriod`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The duration that a contributor must continuously breach before the contributor transitions to ALARM state.

  **Default:** No pending period

- `query`: string (required) — The PromQL query that the alarm evaluates.

- `recoveryPeriod`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The duration that a contributor must continuously not be breaching before it transitions back to the OK state.

  **Default:** No recovery period