# Aodh Configuration Options

## aodh: DEFAULT

record_history
  Type:

    boolean

  Default:

    `True`

  Record alarm change events.

event_alarm_cache_ttl
  Type:

    integer

  Default:

    `60`

  TTL of event alarm caches, in seconds. Set to 0 to disable caching.

prometheus_disable_rbac
  Type:

    boolean

  Default:

    `False`

  Disable RBAC for Prometheus evaluator.

  Warning

  This option is deprecated for removal since Flamingo. Its value may be silently ignored in the future.

  Reason:

    Prometheus RBAC is always disabled. It’s not possible to correctly use client-side rbac enforcement from within services. Using it can cause issues.

prometheus_project_label_name
  Type:

    string

  Default:

    `project`

  Name of label used to identify metric project IDs in Prometheus. This label name will be used to restrict queries to the appropriate project.

additional_ingestion_lag
  Type:

    integer

  Default:

    `0`

  Minimum Value:

    0

  Maximum Value:

    86400

  The number of seconds to extend the evaluation windows to compensate the reporting/ingestion lag.

member_creation_time
  Type:

    integer

  Default:

    `120`

  The time in seconds to wait for the load balancer member creation.

rest_notifier_certificate_file
  Type:

    string

  Default:

    `''`

  SSL Client certificate file for REST notifier.

rest_notifier_certificate_key
  Type:

    string

  Default:

    `''`

  SSL Client private key file for REST notifier.

rest_notifier_ca_bundle_certificate_path
  Type:

    string

  Default:

    `<None>`

  SSL CA_BUNDLE certificate for REST notifier

rest_notifier_ssl_verify
  Type:

    boolean

  Default:

    `True`

  Whether to verify the SSL Server certificate when calling alarm action.

rest_notifier_max_retries
  Type:

    integer

  Default:

    `0`

  Number of retries for REST notifier

notifier_topic
  Type:

    string

  Default:

    `alarming`

  The topic that aodh uses for alarm notifier messages.

enable_evaluation_results_metrics
  Type:

    boolean

  Default:

    `False`

  Whether metric collection should be enabled.

## aodh: api

paste_config
  Type:

    string

  Default:

    `api-paste.ini`

  Configuration file for WSGI definition of API.

auth_mode
  Type:

    string

  Default:

    `keystone`

  Valid Values:

    keystone, noauth

  Authentication mode to use.

gnocchi_external_project_owner
  Type:

    string

  Default:

    `service`

  Project name of resources creator in Gnocchi. (For example the Ceilometer project name

gnocchi_external_domain_name
  Type:

    string

  Default:

    `Default`

  Domain name of resources creator in Gnocchi. (For example, default or service_domain

user_alarm_quota
  Type:

    integer

  Default:

    `-1`

  Maximum number of alarms defined for a user.

project_alarm_quota
  Type:

    integer

  Default:

    `-1`

  Maximum number of alarms defined for a project.

alarm_max_actions
  Type:

    integer

  Default:

    `-1`

  Maximum count of actions for each state of an alarm, non-positive number means no limit.

## aodh: coordination

backend_url
  Type:

    string

  Default:

    `<None>`

  The backend URL to use for distributed coordination. If left empty, alarm evaluation won’t do workload partitioning and will only function correctly if a single instance of the service is running.

heartbeat_interval
  Type:

    floating point

  Default:

    `1.0`

  Number of seconds between heartbeats for distributed coordination.

retry_backoff
  Type:

    integer

  Default:

    `1`

  Retry backoff factor when retrying to connect with coordination backend

max_retry_interval
  Type:

    integer

  Default:

    `30`

  Maximum number of seconds between retry to join partitioning group

## aodh: database

alarm_history_time_to_live
  Type:

    integer

  Default:

    `-1`

  Number of seconds that alarm histories are kept in the database for (<= 0 means forever).

alarm_histories_delete_batch_size
  Type:

    integer

  Default:

    `0`

  Minimum Value:

    0

  Number of alarm histories to be deleted in one iteration from the database (0 means all).

## aodh: evaluator

workers
  Type:

    integer

  Default:

    `1`

  Minimum Value:

    1

  Number of workers for evaluator service.

evaluation_interval
  Type:

    integer

  Default:

    `60`

  Period of evaluation cycle, should be >= than configured pipeline interval for collection of underlying meters.

  Deprecated Variations
  Group | Name
  --- | ---
  DEFAULT | evaluation_interval

## aodh: listener

workers
  Type:

    integer

  Default:

    `1`

  Minimum Value:

    1

  Number of workers for listener service.

event_alarm_topic
  Type:

    string

  Default:

    `alarm.all`

  The topic that aodh uses for event alarm evaluation.

batch_size
  Type:

    integer

  Default:

    `1`

  Number of notification messages to wait before dispatching them.

batch_timeout
  Type:

    integer

  Default:

    `<None>`

  Number of seconds to wait before dispatching samples when batch_size is not reached (None means indefinitely).

## aodh: notifier

batch_size
  Type:

    integer

  Default:

    `1`

  Number of notification messages to wait before dispatching them.

batch_timeout
  Type:

    integer

  Default:

    `<None>`

  Number of seconds to wait before dispatching samples when batch_size is not reached (None means indefinitely).

workers
  Type:

    integer

  Default:

    `1`

  Minimum Value:

    1

  Number of workers for notifier service.

## aodh: service_credentials

region_name
  Type:

    string

  Default:

    `<None>`

  Region name to use for OpenStack service endpoints.

interface
  Type:

    string

  Default:

    `public`

  Valid Values:

    public, internal, admin, publicURL, internalURL, adminURL

  Type of endpoint in Identity service catalog to use for communication with OpenStack services.

## aodh: service_types

zaqar
  Type:

    string

  Default:

    `messaging`

  Message queue service type.

this page last updated: 2026-08-15 16:35:58

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug