Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

12.2. New, updated, and deprecated options in Liberty for Telemetry

Table 12.48. New options

Option = default value (Type) Help string
[DEFAULT] batch_polled_samples = True (BoolOpt) To reduce polling agent load, samples are sent to the notification agent in a batch. To gain higher throughput at the cost of load set this to False.
[DEFAULT] ceilometer_control_exchange = ceilometer (StrOpt) Exchange name for ceilometer notifications.
[DEFAULT] dns_control_exchange = central (StrOpt) Exchange name for DNS notifications.
[DEFAULT] executor_thread_pool_size = 64 (IntOpt) Size of executor thread pool.
[DEFAULT] magnum_control_exchange = magnum (StrOpt) Exchange name for Magnum notifications.
[DEFAULT] password = (StrOpt) Password for Redis server (optional).
[DEFAULT] pipeline_polling_interval = 20 (IntOpt) Polling interval for pipeline file configuration in seconds.
[DEFAULT] port = 6379 (IntOpt) Use this port to connect to redis host.
[DEFAULT] refresh_event_pipeline_cfg = False (BoolOpt) Refresh Event Pipeline configuration on-the-fly.
[DEFAULT] refresh_pipeline_cfg = False (BoolOpt) Refresh Pipeline configuration on-the-fly.
[DEFAULT] rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
[DEFAULT] rpc_poll_timeout = 1 (IntOpt) The default number of seconds that poll should wait. Poll raises timeout exception when timeout expired.
[DEFAULT] rpc_zmq_all_req_rep = True (BoolOpt) Use REQ/REP pattern for all methods CALL/CAST/FANOUT.
[DEFAULT] rpc_zmq_concurrency = eventlet (StrOpt) Type of concurrency used. Either "native" or "eventlet"
[DEFAULT] watch_log_file = False (BoolOpt) (Optional) Uses logging handler designed to watch file system. When log file is moved or removed this handler will open a new log file with specified path instantaneously. It makes sense only if log-file option is specified and Linux platform is used. This option is ignored if log_config_append is set.
[DEFAULT] zmq_use_broker = True (BoolOpt) Shows whether zmq-messaging uses broker or not.
[alarm] alarm_max_actions = -1 (IntOpt) Maximum count of actions for each state of an alarm, non-positive number means no limit.
[api] aodh_is_enabled = None (BoolOpt) Set True to redirect alarms URLs to aodh. Default autodetection by querying keystone.
[api] aodh_url = None (StrOpt) The endpoint of Aodh to redirect alarms URLs to Aodh API. Default autodetection by querying keystone.
[api] default_api_return_limit = 100 (IntOpt) Default maximum number of items returned by API request.
[api] gnocchi_is_enabled = None (BoolOpt) Set True to disable resource/meter/sample URLs. Default autodetection by querying keystone.
[api] workers = 1 (IntOpt) Number of workers for api, default value is 1.
[collector] enable_rpc = False (BoolOpt) Enable the RPC functionality of collector. This functionality is now deprecated in favour of notifier publisher and queues.
[collector] workers = 1 (IntOpt) Number of workers for collector service. default value is 1.
[cors] allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
[cors] allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
[cors] allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
[cors] allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
[cors] expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
[cors] max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.
[cors.subdomain] allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
[cors.subdomain] allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
[cors.subdomain] allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
[cors.subdomain] allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
[cors.subdomain] expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
[cors.subdomain] max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.
[database] alarm_history_time_to_live = -1 (IntOpt) Number of seconds that alarm histories are kept in the database for (<= 0 means forever).
[dispatcher_gnocchi] archive_policy = low (StrOpt) The archive policy to use when the dispatcher create a new metric.
[dispatcher_gnocchi] archive_policy_file = gnocchi_archive_policy_map.yaml (StrOpt) The Yaml file that defines per metric archive policies.
[dispatcher_gnocchi] filter_project = gnocchi (StrOpt) Gnocchi project used to filter out samples generated by Gnocchi service activity
[dispatcher_gnocchi] filter_service_activity = True (BoolOpt) Filter out samples generated by Gnocchi service activity
[dispatcher_gnocchi] resources_definition_file = gnocchi_resources.yaml (StrOpt) The Yaml file that defines mapping between samples and gnocchi resources/metrics
[dispatcher_gnocchi] url = http://localhost:8041 (StrOpt) URL to Gnocchi.
[hardware] meter_definitions_file = snmp.yaml (StrOpt) Configuration file for defining hardware snmp meters.
[keystone_authtoken] region_name = None (StrOpt) The region in which the identity server can be found.
[meter] meter_definitions_cfg_file = meters.yaml (StrOpt) Configuration file for defining meter notifications.
[notification] pipeline_processing_queues = 10 (IntOpt) Number of queues to parallelize workload across. This value should be larger than the number of active notification agents for optimal results.
[notification] workers = 1 (IntOpt) Number of workers for notification service, default value is 1.
[oslo_messaging_amqp] password = (StrOpt) Password for message broker authentication
[oslo_messaging_amqp] sasl_config_dir = (StrOpt) Path to directory that contains the SASL configuration
[oslo_messaging_amqp] sasl_config_name = (StrOpt) Name of configuration file (without .conf suffix)
[oslo_messaging_amqp] sasl_mechanisms = (StrOpt) Space separated list of acceptable SASL mechanisms
[oslo_messaging_amqp] username = (StrOpt) User name for message broker authentication
[oslo_messaging_qpid] send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behaviour since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other have finish to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with a new installations or for testing. Please note, that this option will be removed in the Mitaka release.
[oslo_messaging_rabbit] kombu_reconnect_timeout = 60 (IntOpt) How long to wait before considering a reconnect attempt to have failed. This value should not be longer than rpc_response_timeout.
[oslo_messaging_rabbit] send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behaviour since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other have finish to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with a new installations or for testing. Please note, that this option will be removed in the Mitaka release.
[oslo_middleware] secure_proxy_ssl_header = X-Forwarded-Proto (StrOpt) The HTTP Header that will be used to determine what the original request protocol scheme was, even if it was hidden by an SSL termination proxy.

Table 12.49. New default values

Option Previous default value New default value
[DEFAULT] default_log_levels amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN, urllib3.connectionpool=WARN, websocket=WARN, keystonemiddleware=WARN, routes.middleware=WARN, stevedore=WARN amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN, urllib3.connectionpool=WARN, websocket=WARN, requests.packages.urllib3.util.retry=WARN, urllib3.util.retry=WARN, keystonemiddleware=WARN, routes.middleware=WARN, stevedore=WARN, taskflow=WARN
[DEFAULT] logging_exception_prefix %(asctime)s.%(msecs)03d %(process)d TRACE %(name)s %(instance)s %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s
[DEFAULT] rpc_zmq_matchmaker local redis
[DEFAULT] use_syslog_rfc_format False True
[DEFAULT] verbose False True
[matchmaker_redis] password None
[notification] disable_non_metric_meters False True
[oslo_messaging_rabbit] heartbeat_timeout_threshold 0 60

Table 12.50. Deprecated options

Deprecated option New Option
[DEFAULT] api_workers [api] workers
[DEFAULT] notification_workers [notification] workers
[DEFAULT] database_connection None
[DEFAULT] collector_workers [collector] workers
[DEFAULT] rpc_thread_pool_size [DEFAULT] executor_thread_pool_size
[DEFAULT] log_format None
[DEFAULT] use_syslog None