12 KiB
Configuration Options
Ceilometer specific
The following table lists the ceilometer specific options in the global configuration file. Please note that ceilometer uses openstack-common extensively, which requires that the other parameters are set appropriately. For information we are listing the configuration elements that we use after the ceilometer specific elements.
If you use sql alchemy, its specific paramaters will need to be set.
| Parameter | Default | Note |
|---|---|---|
| nova_control_exchange | nova | Exchange name for Nova notifications |
| glance_control_exchange | glance_notifications | Exchange name for Glance notifications |
| cinder_control_exchange | cinder | Exchange name for Cinder notifications |
| quantum_control_exchange | quantum | Exchange name for Quantum notifications |
| metering_secret | change this or be hacked | Secret value for signing metering messages |
| metering_topic | metering | the topic ceilometer uses for metering messages |
| counter_source | openstack | The source name of emited counters |
| control_exchange | ceilometer | AMQP exchange to connect to if using RabbitMQ or Qpid |
| periodic_interval | 600 | seconds between running periodic tasks |
| os-username | ceilometer | Username to use for openstack service access |
os-password os-tenant-id |
admin |
Password to use for openstack service access Tenant ID to use for openstack service access |
| os-tenant-name | admin | Tenant name to use for openstack service access |
| os-auth-url | http://localhost:5000/v2.0 | Auth URL to use for openstack service access |
| database_connection | mongodb://localhost:27017/ceilometer | Database connection string |
metering_api_port disabled_central_pollsters disabled_compute_pollsters disabled_notification_listeners |
8777 |
The port for the ceilometer API server List of central pollsters to skip loading List of compute pollsters to skip loading List of notification listeners to skip loading |
| reseller_prefix | AUTH_ | Prefix used by swift for reseller token |
SQL Alchemy
| Parameter | Default | Note |
|---|---|---|
| sql_connection_debug | 0 | Verbosity of SQL debugging information. 0=None, 100=Everything |
| sql_connection_trace | False | Add python stack traces to SQL as comment strings |
| sql_idle_timeout | 3600 | timeout before idle sql connections are reaped |
sql_max_retries |
10 |
maximum db connection retries during startup. (setting -1 implies an infinite retry count) |
| sql_retry_interval | 10 | interval between retries of opening a sql connection |
| mysql_engine | InnoDB | MySQL engine to use |
| sqlite_synchronous | True | If passed, use synchronous mode for sqlite |
General options
The following is the list of openstack-common options that we use:
| Parameter | Default | Note |
|---|---|---|
| default_notification_level | INFO | Default notification level for outgoing notifications |
| default_publisher_id | $host | Default publisher_id for outgoing notifications |
| bind_host | 0.0.0.0 | IP address to listen on |
| bind_port | 9292 | Port numver to listen on |
| port | 5672 | Rabbit MQ port to liste on |
| fake_rabbit | False | If passed, use a fake RabbitMQ provider |
| publish_errors | False | publish error events |
| use_stderr | True | Log output to standard error |
logfile_mode logdir logfile |
0644 |
Default file mode used when creating log files Log output to a per-service log file in named directory Log output to a named file |
| default_log_levels | ['amqplib=WARN',sqlalchemy=WARN,...] | Default log level per components |
| notification_topics | ['notifications', ] | AMQP topic used for openstack notifications |
| enabled_apis | ['ec2', 'osapi_compute'] | List of APIs to enable by default |
| verbose | False | Print more verbose output |
| debug | False | Print debugging output |
| state_path | currentdir | Top-level directory for maintaining nova state |
| sqlite_db | nova.sqlite | file name for sqlite |
| sql_connection | sqlite:///$state_path/$sqlite_db | connection string for sql database |
| matchmaker_ringfile | /etc/nova/matchmaker_ring.json | Matchmaker ring file (JSON) |
| rpc_zmq_bind_address | '*' | ZeroMQ bind address |
rpc_zmq_matchmaker |
ceilometer.openstack.common.rpc. matchmaker.MatchMakerLocalhost |
MatchMaker drivers |
| rpc_zmq_port | 9501 | ZeroMQ receiver listening port |
| rpc_zmq_port_pub | 9502 | ZeroMQ fanout publisher port |
| rpc_zmq_contexts | 1 | Number of ZeroMQ contexts |
| rpc_zmq_ipc_dir | /var/run/openstack | Directory for holding IPC sockets |
| rabbit_port | 5672 | The RabbitMQ broker port where a single node is used |
| rabbit_host | localhost | The RabbitMQ broker address where a single node is used |
| rabbit_hosts | ['$rabbit_host:$rabbit_port'] | The list of rabbit hosts to listen to |
| rabbit_userid | guest | the RabbitMQ userid |
| rabbit_password | guest | the RabbitMQ password |
| rabbit_virtual_host | / | the RabbitMQ virtual host |
| rabbit_retry_interval | 1 | how frequently to retry connecting with RabbitMQ |
| rabbit_retry_backoff | 2 | how long to backoff for between retries when connecting |
rabbit_max_retries |
0 |
maximum retries with trying to connect to RabbitMQ (the default of 0 implies an infinite retry count) |
| rabbit_durable_queues | False | use durable queues in RabbitMQ |
| rabbit_use_ssl | False | connect over SSL for RabbitMQ |
| rabbit_durable_queues | False | use durable queues in RabbitMQ |
rabbit_ha_queues kombu_ssl_version kombu_ssl_keyfile kombu_ssl_certfile kombu_ssl_ca_certs |
False |
use H/A queues in RabbitMQ (x-ha-policy: all). SSL version to use (valid only if SSL enabled) SSL key file (valid only if SSL enabled) SSL cert file (valid only if SSL enabled) SSL certification authority file |
| qpid_hostname | localhost | Qpid broker hostname |
qpid_port qpid_username qpid_password qpid_sasl_mechanisms |
5672 |
Qpid broker port Username for qpid connection Password for qpid connection Space separated list of SASL mechanisms to use for auth |
| qpid_reconnect_timeout | 0 | Reconnection timeout in seconds |
| qpid_reconnect_limit | 0 | Max reconnections before giving up |
| qpid_reconnect_interval_min | 0 | Minimum seconds between reconnection attempts |
| qpid_reconnect_interval_max | 0 | Maximum seconds between reconnection attempts |
| qpid_reconnect_interval | 0 | Equivalent to setting max and min to the same value |
| qpid_heartbeat | 60 | Seconds between connection keepalive heartbeats |
| qpid_protocol | tcp | Transport to use, either 'tcp' or 'ssl' |
| qpid_reconnect | True | Automatically reconnect |
| qpid_tcp_nodelay | True | Disable Nagle algorithm |
| rpc_backend | kombu | The messaging module to use, defaults to kombu. |
| rpc_thread_pool_size | 64 | Size of RPC thread pool |
| rpc_conn_pool_size | 30 | Size of RPC connection pool |
| rpc_response_timeout | 60 | Seconds to wait for a response from call or multicall |
rpc_cast_timeout |
30 |
Seconds to wait before a cast expires (TTL). Only supported by impl_zmq. |