..
    Warning: Do not edit this file. It is automatically generated from the
    software project's code and your changes will be overwritten.

    The tool to generate this file lives in openstack-doc-tools repository.

    Please make any changes needed in the code, then run the
    autogenerate-config-doc tool from the openstack-doc-tools repository, or
    ask for help on the documentation mailing list, IRC channel or meeting.

.. _ceilometer-events:

.. list-table:: Description of events configuration options
   :header-rows: 1
   :class: config-ref-table

   * - Configuration option = Default value
     - Description
   * - **[event]**
     -
   * - ``definitions_cfg_file`` = ``event_definitions.yaml``
     - (StrOpt) Configuration file for event definitions.
   * - ``drop_unmatched_notifications`` = ``False``
     - (BoolOpt) Drop notifications if no event definition matches. (Otherwise, we convert them with just the default traits)
   * - ``store_raw`` = ``[]``
     - (MultiStrOpt) Store the raw notification for select priority levels (info and/or error). By default, raw details are not captured.
   * - **[notification]**
     -
   * - ``ack_on_event_error`` = ``True``
     - (BoolOpt) Acknowledge message when event persistence fails.
   * - ``store_events`` = ``False``
     - (BoolOpt) Save event details.
   * - ``workers`` = ``1``
     - (IntOpt) Number of workers for notification service, default value is 1.
   * - ``workload_partitioning`` = ``False``
     - (BoolOpt) Enable workload partitioning, allowing multiple notification agents to be run simultaneously.