Atom feed of this document
  
Juno -  Juno -  Juno -  Juno -  Juno -  Juno -  Juno -  Juno - 

 Chapter 11. Telemetry

The Telemetry service collects measurements within OpenStack. Its various agents and services are configured in the /etc/ceilometer/ceilometer.conf file.

To install Telemetry, see the OpenStack Installation Guide for your distribution (docs.openstack.org).

The following tables provide a comprehensive list of the Telemetry configuration options.

Table 11.1. Description of alarm configuration options
Configuration option = Default value Description
[alarm]
evaluation_interval = 60 (IntOpt) Period of evaluation cycle, should be >= than configured pipeline interval for collection of underlying metrics.
notifier_rpc_topic = alarm_notifier (StrOpt) The topic that ceilometer uses for alarm notifier messages.
partition_rpc_topic = alarm_partition_coordination (StrOpt) The topic that ceilometer uses for alarm partition coordination messages. DEPRECATED: RPC-based partitionedalarm evaluation service will be removed in Kilo in favour of the default alarm evaluation service using tooz for partitioning.
project_alarm_quota = None (IntOpt) Maximum number of alarms defined for a project.
record_history = True (BoolOpt) Record alarm change events.
rest_notifier_certificate_file = (StrOpt) SSL Client certificate for REST notifier.
rest_notifier_certificate_key = (StrOpt) SSL Client private key for REST notifier.
rest_notifier_max_retries = 0 (IntOpt) Number of retries for REST notifier
rest_notifier_ssl_verify = True (BoolOpt) Whether to verify the SSL Server certificate when calling alarm action.
user_alarm_quota = None (IntOpt) Maximum number of alarms defined for a user.

Table 11.2. Description of AMQP configuration options
Configuration option = Default value Description
[DEFAULT]
amqp_auto_delete = False (BoolOpt) Auto-delete queues in amqp.
amqp_durable_queues = False (BoolOpt) Use durable queues in amqp.
control_exchange = openstack (StrOpt) The default exchange under which topics are scoped. May be overridden by an exchange name specified in the transport_url option.
notification_driver = [] (MultiStrOpt) Driver or drivers to handle sending notifications.
notification_topics = notifications (ListOpt) AMQP topic used for OpenStack notifications.
transport_url = None (StrOpt) A URL representing the messaging driver to use and its full configuration. If not set, we fall back to the rpc_backend option and driver specific configuration.

Table 11.3. Description of API configuration options
Configuration option = Default value Description
[DEFAULT]
api_paste_config = api_paste.ini (StrOpt) Configuration file for WSGI definition of API.
pipeline_cfg_file = pipeline.yaml (StrOpt) Configuration file for pipeline definition.
policy_default_rule = default (StrOpt) Default rule. Enforced when a requested rule is not found.
policy_file = policy.json (StrOpt) The JSON file that defines policies.
reserved_metadata_length = 256 (IntOpt) Limit on length of reserved metadata values.
reserved_metadata_namespace = metering. (ListOpt) List of metadata prefixes reserved for metering use.
[api]
enable_reverse_dns_lookup = False (BoolOpt) Set it to False if your environment does not need or have dns server, otherwise it will delay the response from api.
host = 0.0.0.0 (StrOpt) The listen IP for the ceilometer API server.
pecan_debug = False (BoolOpt) Toggle Pecan Debug Middleware. Defaults to global debug value.
port = 8777 (IntOpt) The port for the ceilometer API server.

Table 11.4. Description of authorization configuration options
Configuration option = Default value Description
[service_credentials]
insecure = False (BoolOpt) Disables X.509 certificate validation when an SSL connection to Identity Service is established.
os_auth_url = http://localhost:5000/v2.0 (StrOpt) Auth URL to use for OpenStack service access.
os_cacert = None (StrOpt) Certificate chain for SSL validation.
os_endpoint_type = publicURL (StrOpt) Type of endpoint in Identity service catalog to use for communication with OpenStack services.
os_password = admin (StrOpt) Password to use for OpenStack service access.
os_region_name = None (StrOpt) Region name to use for OpenStack service endpoints.
os_tenant_id = (StrOpt) Tenant ID to use for OpenStack service access.
os_tenant_name = admin (StrOpt) Tenant name to use for OpenStack service access.
os_username = ceilometer (StrOpt) User name to use for OpenStack service access.

Table 11.5. Description of authorization token configuration options
Configuration option = Default value Description
[keystone_authtoken]
admin_password = None (StrOpt) Keystone account password
admin_tenant_name = admin (StrOpt) Keystone service account tenant name to validate user tokens
admin_token = None (StrOpt) This option is deprecated and may be removed in a future release. Single shared secret with the Keystone configuration used for bootstrapping a Keystone installation, or otherwise bypassing the normal authentication process. This option should not be used, use `admin_user` and `admin_password` instead.
admin_user = None (StrOpt) Keystone account username
auth_admin_prefix = (StrOpt) Prefix to prepend at the beginning of the path. Deprecated, use identity_uri.
auth_host = 127.0.0.1 (StrOpt) Host providing the admin Identity API endpoint. Deprecated, use identity_uri.
auth_port = 35357 (IntOpt) Port of the admin Identity API endpoint. Deprecated, use identity_uri.
auth_protocol = https (StrOpt) Protocol of the admin Identity API endpoint (http or https). Deprecated, use identity_uri.
auth_uri = None (StrOpt) Complete public Identity API endpoint
auth_version = None (StrOpt) API version of the admin Identity API endpoint
cache = None (StrOpt) Env key for the swift cache
cafile = None (StrOpt) A PEM encoded Certificate Authority to use when verifying HTTPs connections. Defaults to system CAs.
certfile = None (StrOpt) Required if Keystone server requires client certificate
check_revocations_for_cached = False (BoolOpt) If true, the revocation list will be checked for cached tokens. This requires that PKI tokens are configured on the Keystone server.
delay_auth_decision = False (BoolOpt) Do not handle authorization requests within the middleware, but delegate the authorization decision to downstream WSGI components
enforce_token_bind = permissive (StrOpt) Used to control the use and type of token binding. Can be set to: "disabled" to not check token binding. "permissive" (default) to validate binding information if the bind type is of a form known to the server and ignore it if not. "strict" like "permissive" but if the bind type is unknown the token will be rejected. "required" any form of token binding is needed to be allowed. Finally the name of a binding method that must be present in tokens.
hash_algorithms = md5 (ListOpt) Hash algorithms to use for hashing PKI tokens. This may be a single algorithm or multiple. The algorithms are those supported by Python standard hashlib.new(). The hashes will be tried in the order given, so put the preferred one first for performance. The result of the first hash will be stored in the cache. This will typically be set to multiple values only while migrating from a less secure algorithm to a more secure one. Once all the old tokens are expired this option should be set to a single value for better performance.
http_connect_timeout = None (BoolOpt) Request timeout value for communicating with Identity API server.
http_request_max_retries = 3 (IntOpt) How many times are we trying to reconnect when communicating with Identity API Server.
identity_uri = None (StrOpt) Complete admin Identity API endpoint. This should specify the unversioned root endpoint e.g. https://localhost:35357/
include_service_catalog = True (BoolOpt) (optional) indicate whether to set the X-Service-Catalog header. If False, middleware will not ask for service catalog on token validation and will not set the X-Service-Catalog header.
insecure = False (BoolOpt) Verify HTTPS connections.
keyfile = None (StrOpt) Required if Keystone server requires client certificate
memcache_secret_key = None (StrOpt) (optional, mandatory if memcache_security_strategy is defined) this string is used for key derivation.
memcache_security_strategy = None (StrOpt) (optional) if defined, indicate whether token data should be authenticated or authenticated and encrypted. Acceptable values are MAC or ENCRYPT. If MAC, token data is authenticated (with HMAC) in the cache. If ENCRYPT, token data is encrypted and authenticated in the cache. If the value is not one of these options or empty, auth_token will raise an exception on initialization.
revocation_cache_time = 10 (IntOpt) Determines the frequency at which the list of revoked tokens is retrieved from the Identity service (in seconds). A high number of revocation events combined with a low cache duration may significantly reduce performance.
signing_dir = None (StrOpt) Directory used to cache files related to PKI tokens
token_cache_time = 300 (IntOpt) In order to prevent excessive effort spent validating tokens, the middleware caches previously-seen tokens for a configurable duration (in seconds). Set to -1 to disable caching completely.

Table 11.6. Description of collector configuration options
Configuration option = Default value Description
[DEFAULT]
collector_workers = 1 (IntOpt) Number of workers for collector service. A single collector is enabled by default.
[collector]
requeue_sample_on_dispatcher_error = False (BoolOpt) Requeue the sample on the collector sample queue when the collector fails to dispatch it. This is only valid if the sample come from the notifier publisher
udp_address = 0.0.0.0 (StrOpt) Address to which the UDP socket is bound. Set to an empty string to disable.
udp_port = 4952 (IntOpt) Port to which the UDP socket is bound.
[dispatcher_file]
backup_count = 0 (IntOpt) The max number of the files to keep.
file_path = None (StrOpt) Name and the location of the file to record meters.
max_bytes = 0 (IntOpt) The max size of the file.

Table 11.7. Description of common configuration options
Configuration option = Default value Description
[DEFAULT]
host = localhost (StrOpt) Name of this node, which must be valid in an AMQP key. Can be an opaque identifier. For ZeroMQ only, must be a valid host name, FQDN, or IP address.
lock_path = None (StrOpt) Directory to use for lock files.
memcached_servers = None (ListOpt) Memcached servers or None for in process cache.
notification_workers = 1 (IntOpt) Number of workers for notification service. A single notification agent is enabled by default.
rootwrap_config = /etc/ceilometer/rootwrap.conf (StrOpt) Path to the rootwrap configuration file touse for running commands as root
[central]
partitioning_group_prefix = None (StrOpt) Work-load partitioning group prefix. Use only if you want to run multiple central agents with different config files. For each sub-group of the central agent pool with the same partitioning_group_prefix a disjoint subset of pollsters should be loaded.
[compute]
workload_partitioning = False (BoolOpt) Enable work-load partitioning, allowing multiple compute agents to be run simultaneously.
[coordination]
backend_url = None (StrOpt) The backend URL to use for distributed coordination. If left empty, per-deployment central agent and per-host compute agent won't do workload partitioning and will only function correctly if a single instance of that service is running.
heartbeat = 1.0 (FloatOpt) Number of seconds between heartbeats for distributed coordination (float)
[keystone_authtoken]
memcached_servers = None (ListOpt) Optionally specify a list of memcached server(s) to use for caching. If left undefined, tokens will instead be cached in-process.

Table 11.8. Description of database configuration options
Configuration option = Default value Description
[DEFAULT]
database_connection = None (StrOpt) DEPRECATED - Database connection string.
[database]
alarm_connection = None (StrOpt) The connection string used to connect to the alarm database. (if unset, connection is used)
backend = sqlalchemy (StrOpt) The back end to use for the database.
connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the database.
connection_debug = 0 (IntOpt) Verbosity of SQL debugging information: 0=None, 100=Everything.
connection_trace = False (BoolOpt) Add Python stack traces to SQL as comment strings.
db_inc_retry_interval = True (BoolOpt) If True, increases the interval between database connection retries up to db_max_retry_interval.
db_max_retries = 20 (IntOpt) Maximum database connection retries before error is raised. Set to -1 to specify an infinite retry count.
db_max_retry_interval = 10 (IntOpt) If db_inc_retry_interval is set, the maximum seconds between database connection retries.
db_retry_interval = 1 (IntOpt) Seconds between database connection retries.
idle_timeout = 3600 (IntOpt) Timeout before idle SQL connections are reaped.
max_overflow = None (IntOpt) If set, use this value for max_overflow with SQLAlchemy.
max_pool_size = None (IntOpt) Maximum number of SQL connections to keep open in a pool.
max_retries = 10 (IntOpt) Maximum db connection retries during startup. Set to -1 to specify an infinite retry count.
metering_connection = None (StrOpt) The connection string used to connect to the meteting database. (if unset, connection is used)
min_pool_size = 1 (IntOpt) Minimum number of SQL connections to keep open in a pool.
mysql_sql_mode = TRADITIONAL (StrOpt) The SQL mode to be used for MySQL sessions. This option, including the default, overrides any server-set SQL mode. To use whatever SQL mode is set by the server configuration, set this to no value. Example: mysql_sql_mode=
pool_timeout = None (IntOpt) If set, use this value for pool_timeout with SQLAlchemy.
retry_interval = 10 (IntOpt) Interval between retries of opening a SQL connection.
slave_connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the slave database.
sqlite_db = oslo.sqlite (StrOpt) The file name to use with SQLite.
sqlite_synchronous = True (BoolOpt) If True, SQLite uses synchronous mode.
time_to_live = -1 (IntOpt) Number of seconds that samples are kept in the database for (<= 0 means forever).
use_db_reconnect = False (BoolOpt) Enable the experimental use of database reconnect on connection lost.
use_tpool = False (BoolOpt) Enable the experimental use of thread pooling for all DB API calls

Table 11.9. Description of logging configuration options
Configuration option = Default value Description
[DEFAULT]
backdoor_port = None (StrOpt) Enable eventlet backdoor. Acceptable values are 0, <port>, and <start>:<end>, where 0 results in listening on a random tcp port number; <port> results in listening on the specified port number (and not enabling backdoor if that port is in use); and <start>:<end> results in listening on the smallest unused port number within the specified range of port numbers. The chosen port is displayed in the service's log file.
disable_process_locking = False (BoolOpt) Enables or disables inter-process locks.
nova_http_log_debug = False (BoolOpt) Allow novaclient's debug log output.

Table 11.10. Description of events configuration options
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)
[notification]
ack_on_event_error = True (BoolOpt) Acknowledge message when event persistence fails.
store_events = False (BoolOpt) Save event details.

Table 11.11. Description of exchange configuration options
Configuration option = Default value Description
[DEFAULT]
cinder_control_exchange = cinder (StrOpt) Exchange name for Cinder notifications.
glance_control_exchange = glance (StrOpt) Exchange name for Glance notifications.
heat_control_exchange = heat (StrOpt) Exchange name for Heat notifications
http_control_exchanges = ['nova', 'glance', 'neutron', 'cinder'] (MultiStrOpt) Exchanges name to listen for notifications.
ironic_exchange = ironic (StrOpt) Exchange name for Ironic notifications.
keystone_control_exchange = keystone (StrOpt) Exchange name for Keystone notifications.
neutron_control_exchange = neutron (StrOpt) Exchange name for Neutron notifications.
nova_control_exchange = nova (StrOpt) Exchange name for Nova notifications.
sahara_control_exchange = sahara (StrOpt) Exchange name for Data Processing notifications
sample_source = openstack (StrOpt) Source for samples emitted on this instance.
trove_control_exchange = trove (StrOpt) Exchange name for DBaaS notifications

Table 11.12. Description of glance configuration options
Configuration option = Default value Description
[DEFAULT]
glance_page_size = 0 (IntOpt) Number of items to request in each paginated Glance API request (parameter used by glancecelient). If this is less than or equal to 0, page size is not specified (default value in glanceclient is used).

Table 11.13. Description of inspector configuration options
Configuration option = Default value Description
[DEFAULT]
hypervisor_inspector = libvirt (StrOpt) Inspector to use for inspecting the hypervisor layer.
libvirt_type = kvm (StrOpt) Libvirt domain type (valid options are: kvm, lxc, qemu, uml, xen).
libvirt_uri = (StrOpt) Override the default libvirt URI (which is dependent on libvirt_type).

Table 11.14. Description of IPMI configuration options
Configuration option = Default value Description
[ipmi]
node_manager_init_retry = 3 (IntOpt) Number of retries upon Intel Node Manager initialization failure

Table 11.15. Description of logging configuration options
Configuration option = Default value Description
[DEFAULT]
debug = False (BoolOpt) Print debugging output (set logging level to DEBUG instead of default WARNING level).
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 (ListOpt) List of logger=LEVEL pairs.
fatal_deprecations = False (BoolOpt) Enables or disables fatal status of deprecations.
fatal_exception_format_errors = False (BoolOpt) Make exception message format errors fatal
instance_format = "[instance: %(uuid)s] " (StrOpt) The format for an instance that is passed with the log message.
instance_name_template = instance-%08x (StrOpt) Template string to be used to generate instance names
instance_usage_audit_period = month (StrOpt) Time period to generate instance usages for. Time period must be hour, day, month or year
instance_uuid_format = "[instance: %(uuid)s] " (StrOpt) The format for an instance UUID that is passed with the log message.
log_config_append = None (StrOpt) The name of a logging configuration file. This file is appended to any existing logging configuration files. For details about logging configuration files, see the Python logging module documentation.
log_date_format = %Y-%m-%d %H:%M:%S (StrOpt) Format string for %%(asctime)s in log records. Default: %(default)s .
log_dir = None (StrOpt) (Optional) The base directory used for relative --log-file paths.
log_file = None (StrOpt) (Optional) Name of log file to output to. If no default is set, logging will go to stdout.
log_format = None (StrOpt) DEPRECATED. A logging.Formatter log message format string which may use any of the available logging.LogRecord attributes. This option is deprecated. Please use logging_context_format_string and logging_default_format_string instead.
logging_context_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(request_id)s %(user_identity)s] %(instance)s%(message)s (StrOpt) Format string to use for log messages with context.
logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d (StrOpt) Data to append to log format when level is DEBUG.
logging_default_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [-] %(instance)s%(message)s (StrOpt) Format string to use for log messages without context.
logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d TRACE %(name)s %(instance)s (StrOpt) Prefix each line of exception output with this format.
publish_errors = False (BoolOpt) Enables or disables publication of error events.
syslog_log_facility = LOG_USER (StrOpt) Syslog facility to receive log lines.
use_stderr = True (BoolOpt) Log output to standard error.
use_syslog = False (BoolOpt) Use syslog for logging. Existing syslog format is DEPRECATED during I, and will change in J to honor RFC5424.
use_syslog_rfc_format = False (BoolOpt) (Optional) Enables or disables syslog rfc5424 format for logging. If enabled, prefixes the MSG part of the syslog message with APP-NAME (RFC5424). The format without the APP-NAME is deprecated in I, and will be removed in J.
verbose = False (BoolOpt) Print more verbose output (set logging level to INFO instead of default WARNING level).

Table 11.16. Description of nova configuration options
Configuration option = Default value Description
[DEFAULT]
enable_new_services = True (BoolOpt) Services to be added to the available pool on create
monkey_patch = False (BoolOpt) Whether to log monkey patching
monkey_patch_modules = nova.api.ec2.cloud:nova.notifications.notify_decorator, nova.compute.api:nova.notifications.notify_decorator (ListOpt) List of modules/decorators to monkey patch
network_api_class = nova.network.api.API (StrOpt) The full class name of the network API class to use
password_length = 12 (IntOpt) Length of generated instance admin passwords
snapshot_name_template = snapshot-%s (StrOpt) Template string to be used to generate snapshot names

Table 11.17. Description of nova cells configuration options
Configuration option = Default value Description
[cells]
bandwidth_update_interval = 600 (IntOpt) Seconds between bandwidth updates for cells.
call_timeout = 60 (IntOpt) Seconds to wait for response from a call to a cell.
capabilities = hypervisor=xenserver;kvm, os=linux;windows (ListOpt) Key/Multi-value list with the capabilities of the cell
cell_type = compute (StrOpt) Type of cell: api or compute
enable = False (BoolOpt) Enable cell functionality
manager = nova.cells.manager.CellsManager (StrOpt) Manager for cells
mute_child_interval = 300 (IntOpt) Number of seconds after which a lack of capability and capacity updates signals the child cell is to be treated as a mute.
name = nova (StrOpt) Name of this cell
reserve_percent = 10.0 (FloatOpt) Percentage of cell capacity to hold in reserve. Affects both memory and disk utilization
topic = cells (StrOpt) The topic cells nodes listen on
[upgrade_levels]
cells = None (StrOpt) Set a version cap for messages sent to local cells services

Table 11.18. Description of Qpid configuration options
Configuration option = Default value Description
[DEFAULT]
qpid_heartbeat = 60 (IntOpt) Seconds between connection keepalive heartbeats.
qpid_hostname = localhost (StrOpt) Qpid broker hostname.
qpid_hosts = $qpid_hostname:$qpid_port (ListOpt) Qpid HA cluster host:port pairs.
qpid_password = (StrOpt) Password for Qpid connection.
qpid_port = 5672 (IntOpt) Qpid broker port.
qpid_protocol = tcp (StrOpt) Transport to use, either 'tcp' or 'ssl'.
qpid_receiver_capacity = 1 (IntOpt) The number of prefetched messages held by receiver.
qpid_sasl_mechanisms = (StrOpt) Space separated list of SASL mechanisms to use for auth.
qpid_tcp_nodelay = True (BoolOpt) Whether to disable the Nagle algorithm.
qpid_topology_version = 1 (IntOpt) The qpid topology version to use. Version 1 is what was originally used by impl_qpid. Version 2 includes some backwards-incompatible changes that allow broker federation to work. Users should update to version 2 when they are able to take everything down, as it requires a clean break.
qpid_username = (StrOpt) Username for Qpid connection.

Table 11.19. Description of RabbitMQ configuration options
Configuration option = Default value Description
[DEFAULT]
kombu_reconnect_delay = 1.0 (FloatOpt) How long to wait before reconnecting in response to an AMQP consumer cancel notification.
kombu_ssl_ca_certs = (StrOpt) SSL certification authority file (valid only if SSL enabled).
kombu_ssl_certfile = (StrOpt) SSL cert file (valid only if SSL enabled).
kombu_ssl_keyfile = (StrOpt) SSL key file (valid only if SSL enabled).
kombu_ssl_version = (StrOpt) SSL version to use (valid only if SSL enabled). valid values are TLSv1, SSLv23 and SSLv3. SSLv2 may be available on some distributions.
rabbit_ha_queues = False (BoolOpt) Use HA queues in RabbitMQ (x-ha-policy: all). If you change this option, you must wipe the RabbitMQ database.
rabbit_host = localhost (StrOpt) The RabbitMQ broker address where a single node is used.
rabbit_hosts = $rabbit_host:$rabbit_port (ListOpt) RabbitMQ HA cluster host:port pairs.
rabbit_login_method = AMQPLAIN (StrOpt) the RabbitMQ login method
rabbit_max_retries = 0 (IntOpt) Maximum number of RabbitMQ connection retries. Default is 0 (infinite retry count).
rabbit_password = guest (StrOpt) The RabbitMQ password.
rabbit_port = 5672 (IntOpt) The RabbitMQ broker port where a single node is used.
rabbit_retry_backoff = 2 (IntOpt) How long to backoff for between retries when connecting to RabbitMQ.
rabbit_retry_interval = 1 (IntOpt) How frequently to retry connecting with RabbitMQ.
rabbit_use_ssl = False (BoolOpt) Connect over SSL for RabbitMQ.
rabbit_userid = guest (StrOpt) The RabbitMQ userid.
rabbit_virtual_host = / (StrOpt) The RabbitMQ virtual host.

Table 11.20. Description of Redis configuration options
Configuration option = Default value Description
[matchmaker_redis]
host = 127.0.0.1 (StrOpt) Host to locate redis.
password = None (StrOpt) Password for Redis server (optional).
port = 6379 (IntOpt) Use this port to connect to redis host.
[matchmaker_ring]
ringfile = /etc/oslo/matchmaker_ring.json (StrOpt) Matchmaker ring file (JSON).

Table 11.21. Description of rootwrap configuration options
Configuration option = Default value Description
[DEFAULT]
filters_path = /etc/ceilometer/rootwrap.d,/usr/share/ceilometer/rootwrap List of directories to load filter definitions from (separated by ','). These directories MUST all be only writeable by root !
exec_dirs = /sbin,/usr/sbin,/bin,/usr/bin List of directories to search executables in, in case filters do not explicitely specify a full path (separated by ',') If not specified, defaults to system PATH environment variable. These directories MUST all be only writeable by root !
use_syslog = False Enable logging to syslog Default value is False
syslog_log_facility = syslog Which syslog facility to use. Valid values include auth, authpriv, syslog, user0, user1... Default value is 'syslog'
syslog_log_level = ERROR Which messages to log. INFO means log all usage ERROR means only log unsuccessful attempts

Table 11.22. Description of RPC configuration options
Configuration option = Default value Description
[DEFAULT]
dispatcher = ['database'] (MultiStrOpt) Dispatcher to process data.
matchmaker_heartbeat_freq = 300 (IntOpt) Heartbeat frequency.
matchmaker_heartbeat_ttl = 600 (IntOpt) Heartbeat time-to-live.
rpc_backend = rabbit (StrOpt) The messaging driver to use, defaults to rabbit. Other drivers include qpid and zmq.
rpc_cast_timeout = 30 (IntOpt) Seconds to wait before a cast expires (TTL). Only supported by impl_zmq.
rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
rpc_response_timeout = 60 (IntOpt) Seconds to wait for a response from a call.
rpc_thread_pool_size = 64 (IntOpt) Size of RPC greenthread pool.
[notification]
messaging_urls = [] (MultiStrOpt) Messaging URLs to listen for notifications. Example: transport://user:pass@host1:port[,hostN:portN]/virtual_host (DEFAULT/transport_url is used if empty)
[publisher]
metering_secret = change this or be hacked (StrOpt) Secret value for signing metering messages.
[publisher_notifier]
metering_driver = messagingv2 (StrOpt) The driver that ceilometer uses for metering notifications.
metering_topic = metering (StrOpt) The topic that ceilometer uses for metering notifications.
[publisher_rpc]
metering_topic = metering (StrOpt) The topic that ceilometer uses for metering messages.

Table 11.23. Description of service types configuration options
Configuration option = Default value Description
[service_types]
glance = image (StrOpt) Glance service type.
kwapi = energy (StrOpt) Kwapi service type.
neutron = network (StrOpt) Neutron service type.
nova = compute (StrOpt) Nova service type.
swift = object-store (StrOpt) Swift service type.

Table 11.24. Description of swift configuration options
Configuration option = Default value Description
[DEFAULT]
reseller_prefix = AUTH_ (StrOpt) Swift reseller prefix. Must be on par with reseller_prefix in proxy-server.conf.

Table 11.25. Description of testing configuration options
Configuration option = Default value Description
[DEFAULT]
fake_rabbit = False (BoolOpt) If passed, use a fake RabbitMQ provider.

Table 11.26. Description of TripleO configuration options
Configuration option = Default value Description
[hardware]
readonly_user_name = ro_snmp_user (StrOpt) SNMPd user name of all nodes running in the cloud.
readonly_user_password = password (StrOpt) SNMPd password of all the nodes running in the cloud
url_scheme = snmp:// (StrOpt) URL scheme to use for hardware nodes

Table 11.27. Description of VMware configuration options
Configuration option = Default value Description
[vmware]
api_retry_count = 10 (IntOpt) Number of times a VMware Vsphere API must be retried
host_ip = (StrOpt) IP address of the VMware Vsphere host
host_password = (StrOpt) Password of VMware Vsphere
host_username = (StrOpt) Username of VMware Vsphere
task_poll_interval = 0.5 (FloatOpt) Sleep time in seconds for polling an ongoing async task
wsdl_location = None (StrOpt) Optional vim service WSDL location e.g http://<server>/vimService.wsdl. Optional over-ride to default location for bug work-arounds

Table 11.28. Description of XenAPI configuration options
Configuration option = Default value Description
[xenapi]
connection_password = None (StrOpt) Password for connection to XenServer/Xen Cloud Platform
connection_url = None (StrOpt) URL for connection to XenServer/Xen Cloud Platform
connection_username = root (StrOpt) Username for connection to XenServer/Xen Cloud Platform
login_timeout = 10 (IntOpt) Timeout in seconds for XenAPI login.

Table 11.29. Description of ZeroMQ configuration options
Configuration option = Default value Description
[DEFAULT]
rpc_zmq_bind_address = * (StrOpt) ZeroMQ bind address. Should be a wildcard (*), an ethernet interface, or IP. The "host" option should point or resolve to this address.
rpc_zmq_contexts = 1 (IntOpt) Number of ZeroMQ contexts, defaults to 1.
rpc_zmq_host = localhost (StrOpt) Name of this node. Must be a valid hostname, FQDN, or IP address. Must match "host" option, if running Nova.
rpc_zmq_ipc_dir = /var/run/openstack (StrOpt) Directory for holding IPC sockets.
rpc_zmq_matchmaker = oslo.messaging._drivers.matchmaker.MatchMakerLocalhost (StrOpt) MatchMaker driver.
rpc_zmq_port = 9501 (IntOpt) ZeroMQ receiver listening port.
rpc_zmq_topic_backlog = None (IntOpt) Maximum number of ingress messages to locally buffer per topic. Default is unlimited.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

loading table of contents...