第 2 章 ceilometer


下面的章节包含有关 ceilometer 服务中的配置选项的信息。

2.1. ceilometer.conf

本节包含 /etc/ceilometer/ceilometer.conf 文件的选项。

2.1.1. DEFAULT

下表概述了 ceilometer.conf 文件中的 [DEFAULT] 组下可用的选项。

.

Expand
配置选项 = 默认值类型描述

backdoor_port = None

字符串值

启用 eventlet backdoor。可接受值为 0、<port> 和 <start>:<end>,其中 0 会导致侦听一个随机的 tcp 端口号;<port> 会导致侦听指定的端口号(如果该端口正在使用),并且 <start>:<end> 会导致在指定端口号范围内侦听最小未使用的端口号。所选端口显示在服务的日志文件中。

backdoor_socket = None

字符串值

启用 eventlet backdoor,使用提供的路径作为可接收连接的 unix 套接字。这个选项与 backdoor_port 相互排斥,其中只能提供一个。如果同时提供了这两个选项,则此选项存在会覆盖该选项的使用。在路径 {pid} 中,路径将被当前进程的 PID 替换。

batch_size = 50

整数值

要发送到通知代理的样本的批处理大小,设置为 0 以禁用。当使用 prometheus exporter 功能时,这应该大于每个指标的最大样本数。

cfg_file = polling.yaml

字符串值

用于轮询定义的配置文件。

conn_pool_min_size = 2

整数值

连接过期策略的池大小限制

conn_pool_ttl = 1200

整数值

池中闲置连接的生存时间

control_exchange = openstack

字符串值

主题范围的默认交换。可以被 transport_url 选项中指定的交换名称覆盖。

debug = False

布尔值

如果设置为 true,则日志级别将设为 DEBUG,而不是默认的 INFO 级别。

default_log_levels = ['amqp=WARN', 'amqplib=WARN', 'boto=WARN', 'qpid=WARN', 'sqlalchemy=WARN', 'suds=INFO', 'oslo.messaging=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', 'keystoneauth=WARN', 'oslo.cache=INFO', 'oslo_policy=INFO', 'dogpile.core.dogpile=INFO']

列出值

以 logger=LEVEL 的形式列出软件包日志级别列表。如果设置了 log_config_append,则忽略这个选项。

enable_notifications = True

布尔值

轮询服务是否应该在轮询周期后发送通知。

enable_prometheus_exporter = False

布尔值

允许此 ceilometer 轮询实例,直接以 Prometheus 格式公开检索到的指标。

event_pipeline_cfg_file = event_pipeline.yaml

字符串值

事件管道定义的配置文件。

executor_thread_pool_size = 64

整数值

当 executor 为 threading 或 eventle 时,executor 线程池的大小。

fatal_deprecations = False

布尔值

启用或禁用弃用的严重状态。

graceful_shutdown_timeout = 60

整数值

指定一个超时,之后安全关闭服务器将退出。零值表示无限等待。

heartbeat_socket_dir = None

字符串值

创建用于轮询心跳的套接字文件的路径。

host = <based on operating system>

主机地址值

此节点的名称,必须在 AMQP 键中有效。可以是不透明标识符。对于 ZeroMQ,必须是有效的主机名、FQDN 或 IP 地址。

http_timeout = 600

整数值

HTTP 请求的超时秒数。将它设置为 None 以禁用超时。

hypervisor_inspector = libvirt

字符串值

用于检查虚拟机监控程序层的检查器。已知的检查器是 libvirt、hyperv 和 vsphere。

`instance_format = [instance: %(uuid)s] `

字符串值

通过日志消息传递的实例格式。

`instance_uuid_format = [instance: %(uuid)s] `

字符串值

通过日志消息传递的实例 UUID 格式。

libvirt_type = kvm

字符串值

libvirt 域类型。

`libvirt_uri = `

字符串值

覆盖默认 libvirt URI (依赖于 libvirt_type)。

log-config-append = None

字符串值

日志配置文件的名称。此文件附加到任何现有日志记录配置文件中。有关日志记录配置文件的详情,请查看 Python 日志记录模块文档。请注意,当使用日志记录配置文件时,会在配置文件中设置所有日志记录配置,并忽略其他日志记录配置选项(例如 log-date-format)。

log-date-format = %Y-%m-%d %H:%M:%S

字符串值

在日志记录中定义 %%(asctime) s 的格式字符串。默认: %(default) s。如果设置了 log_config_append,则忽略这个选项。

log-dir = None

字符串值

(可选)用于相对 log_file 路径的基础目录。如果设置了 log_config_append,则忽略这个选项。

log-file = None

字符串值

(可选)要将日志输出发送到的日志文件名称。如果没有设置默认值,日志记录将进入由 use_stderr 定义的 stderr。如果设置了 log_config_append,则忽略这个选项。

log_options = True

布尔值

启动服务( DEBUG 级别)时,启用或禁用所有注册选项的日志记录值。

log_rotate_interval = 1

整数值

轮转日志文件前的时间长度。除非 log_rotation_type 设为 "interval",否则此选项会被忽略。

log_rotate_interval_type = days

字符串值

轮转间隔类型。调度下一个轮转时使用上次文件更改(或服务启动时的时间)。

log_rotation_type = none

字符串值

日志轮转类型。

logging_context_format_string = %(asctime) s.%(msecs) 03d %(process) d %(levelname) s %(name) s [%(global_request_id) s %(request_id) s %(user_identity) s] %(instance) s%(message) s

字符串值

用于带有上下文的日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用

logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d

字符串值

当消息的日志记录级别为 DEBUG 时,要附加到日志消息的额外数据。由 oslo_log.formatters.ContextFormatter 使用

logging_default_format_string = %(asctime) s.%(msecs) 03d %(process) d %(levelname) s %(name) s [-] %(instance) s%(message) s

字符串值

上下文未定义时用于日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用

logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s

字符串值

使用这种格式为每行例外输出加上前缀。由 oslo_log.formatters.ContextFormatter 使用

logging_user_identity_format = %(user) s %(project) s %(system_scope) s %(user_domain) s %(project_domain) s

字符串值

定义 logging_context_format_string 中使用的 %(user_identity) s 格式字符串。由 oslo_log.formatters.ContextFormatter 使用

max_logfile_count = 30

整数值

轮转日志文件的最大数量。

max_logfile_size_mb = 200

整数值

日志文件的最大大小(以 MB 为单位)。如果 "log_rotation_type" 没有设置为 "size",则忽略这个选项。

max_parallel_requests = 64

整数值

同时处理的服务的最大并行请求数。

partitioning_group_prefix = None

字符串值

工作加载分区组前缀。只有在您要使用不同的配置文件运行多个轮询代理时,才使用。对于具有相同 partitioning_group_prefix 的代理池的每个子组,应加载一个 disjoint 子集 pollsters。

pipeline_cfg_file = pipeline.yaml

字符串值

管道定义的配置文件。

pollsters_definitions_dirs = ['/etc/ceilometer/pollsters.d']

多值

包含用于创建 pollsters 的 YAML 文件的目录列表。

prometheus_listen_addresses = ['127.0.0.1:9101']

列出值

将公开导出的指标的 ipaddr:port 组合列表。

publish_errors = False

布尔值

启用或禁用错误事件的发布。

rate_limit_burst = 0

整数值

每个 rate_limit_interval 的最大日志信息数。

rate_limit_except_level = CRITICAL

字符串值

通过速率限制使用的日志级别名称:CRITICAL、ERROR、INFO、WARNING、DEBUG 或空字符串。不过滤级别大于或等于 rate_limit_except_level 的日志。空字符串表示过滤所有级别。

rate_limit_interval = 0

整数值

日志速率限制的时间间隔、秒数。

reseller_prefix = AUTH_

字符串值

Swift 经销商前缀.必须在 proxy-server.conf 中使用 vendor_prefix 进行 par。

reserved_metadata_keys = []

列出值

为 metering 保留的元数据键列表。这些密钥对于命名空间中包含的密钥是额外的。

reserved_metadata_length = 256

整数值

限制保留元数据值的长度。

reserved_metadata_namespace = ['metering.']

列出值

为 metering 保留的元数据前缀列表。

rootwrap_config = /etc/ceilometer/rootwrap.conf

字符串值

用于以 root 身份运行命令的 rootwrap 配置文件的路径

rpc_conn_pool_size = 30

整数值

RPC 连接池的大小。

rpc_ping_enabled = False

布尔值

添加端点以回答 ping 调用。端点名为 oslo_rpc_server_ping

rpc_response_timeout = 60

整数值

等待来自调用的响应的秒数。

sample_source = openstack

字符串值

此实例上发出的示例源。

syslog-log-facility = LOG_USER

字符串值

syslog 工具可接收日志行。如果设置了 log_config_append,则忽略这个选项。

tenant_name_discovery = False

布尔值

识别轮询示例中的项目和用户名。默认情况下,收集这些值是禁用的,因为根据项目数量、用户和从环境中轮询示例,它可能会超负 keystone 服务。在使用这个功能时,建议使用 ceilometer 配置缓存后端,以减少对 keystone 发出的调用数量。

transport_url = rabbit://

字符串值

用于连接到消息传递后端的网络地址和可选用户凭证,采用 URL 格式。预期的格式是:

driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query

示例:rabbit://rabbitmq:password@127.0.0.1:5672//

有关 URL 中字段的详情,请查看 oslo_messaging.TransportURL 文档 https://docs.openstack.org/oslo.messaging/latest/reference/transport.html

use-journal = False

布尔值

为日志记录启用 journald。如果在 systemd 环境中运行,您可能需要启用日志支持。这样做将使用日志原生协议,该协议包括日志消息外的结构化元数据。如果设置了 log_config_append,则忽略此选项。

use-json = False

布尔值

使用 JSON 格式进行日志记录。如果设置了 log_config_append,则忽略这个选项。

use-syslog = False

布尔值

使用 syslog 进行日志记录。现有 syslog 格式为 DEPRECATED,稍后将更改为遵循 RFC5424。如果设置了 log_config_append,则忽略这个选项。

use_eventlog = False

布尔值

日志输出到 Windows 事件日志。

use_stderr = False

布尔值

将日志输出到标准错误。如果设置了 log_config_append,则忽略这个选项。

watch-log-file = False

布尔值

使用旨在监视文件系统的日志记录处理程序。当移动或删除日志文件时,此处理程序将立即打开具有指定路径的新日志文件。只有在指定了 log_file 选项并使用 Linux 平台时才有意义。如果设置了 log_config_append,则忽略这个选项。

2.1.2. 缓存

下表概述了 ceilometer.conf 文件中的 [cache] 组下可用的选项。

Expand
表 2.1. 缓存
配置选项 = 默认值类型Description

backend = dogpile.cache.null

字符串值

缓存后端模块.对于基于事件线程服务器的或环境,建议使用带有池的 Memcache (oslo_cache.memcache_pool)。对于小于 100 个线程服务器的环境,建议使用 Memcached (dogpile.cache.memcached)或 Redis (dogpile.cache.redis)。带有单一服务器实例测试环境可以使用 dogpile.cache.memory 后端。

backend_argument = []

多值

提供给 backend 模块的参数。指定每个参数一次这个选项,以传递给 dogpile.cache 后端。示例格式:"<argname>:<value>"。

config_prefix = cache.oslo

字符串值

为缓存区域构建配置字典的前缀。除非存在具有相同配置名称的另一个 dogpile.cache 区域,否则不需要更改此设置。

dead_timeout = 60

浮点值

尝试将节点重新添加到 HashClient 内部机制中的池前的时间(以秒为单位)。

debug_cache_backend = False

布尔值

从缓存后端(缓存密钥、get/set/delete/etc 调用)进行额外的调试。只有在您需要使用键/值查看特定的 cache-backend get/set/delete 调用时,这才有用。通常,这应该设为 false。

enable_retry_client = False

布尔值

启用重试客户端机制来处理失败。这些机制可用于嵌套所有的 pymemcache 客户端。打包程序允许您定义在 attemots 之间等待多少次尝试和等待的时间。

enable_socket_keepalive = False

布尔值

dogpile 的 pymemcache backend 的 socket keepalive 的全局切换

enabled = False

布尔值

缓存的全局切换。

expiration_time = 600

整数值

dogpile.cache 区域中的任何缓存项目的默认 TTL (以秒为单位)。这适用于没有为其定义显式缓存过期时间的任何缓存方法。

hashclient_retry_attempts = 2

整数值

在客户端被标记为死状态并从 HashClient 内部机制中的池中移除客户端的次数。

hashclient_retry_delay = 1

浮点值

在 HashClient 内部机制中应在重试尝试之间传递的时间(以秒为单位)。

memcache_dead_retry = 300

整数值

在再次尝试前 memcached 服务器被视为死的秒数。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

`memcache_password = `

字符串值

启用 SASL 的 memcached 密码

memcache_pool_connection_get_timeout = 10

整数值

操作将等待进入 memcache 客户端连接的秒数。

memcache_pool_flush_on_reconnect = False

布尔值

如果 memcache 将在重新连接时清空,则全局切换。(仅限oslo_cache.memcache_pool 后端)。

memcache_pool_maxsize = 10

整数值

每个 memcached 服务器的最大打开连接数。(仅限oslo_cache.memcache_pool 后端)。

memcache_pool_unused_timeout = 60

整数值

在关闭之前,与 memcached 的连接在池中保持未使用的秒数。(仅限oslo_cache.memcache_pool 后端)。

memcache_sasl_enabled = False

布尔值

如果 SASL_enable 为 true,则启用 SASL (Simple Authentication and SecurityLayer),否则禁用。

memcache_servers = ['localhost:11211']

列出值

memcache 服务器的格式是 "host:port"。这由依赖 Memcached 的后端使用。如果 dogpile.cache.memcachedoslo_cache.memcache_pool 已使用,并且给定主机引用 IPv6 或给定域引用 IPv6,那么您应该为给定地址加上地址系列(inet6)添加前缀(inet6) (e.g inet6[::1]:11211,inet6:[fd12:3456:789a:1::1]:11211,inet6 [controller-0] 211:11211)使用。如果未指定地址系列,则这些后端将使用与 IPv4 对应的默认 inet 地址系列

memcache_socket_timeout = 1.0

浮点值

对每个对服务器调用的超时时间(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

`memcache_username = `

字符串值

启用 SASL 的 memcached 的用户名

proxies = []

列出值

用于导入的代理类将影响 dogpile.cache 后端功能的方式。参阅 dogpile.cache 文档中有关 changing-backend-behavior 的文档。

retry_attempts = 2

整数值

失败前尝试操作的次数。

retry_delay = 0

浮点值

每次尝试之间休眠的秒数。

socket_keepalive_count = 1

整数值

丢弃连接前应发送的最大 keepalive 探测 TCP 数。应该是一个大于零的正整数。

socket_keepalive_idle = 1

整数值

在 TCP 开始发送 keepalive 探测前,连接需要保持闲置的时间(以秒为单位)。应该是一个大于零的正整数。

socket_keepalive_interval = 1

整数值

单个 keepalive 探测之间的时间(以秒为单位)。应该是一个大于零的正整数。

tls_allowed_ciphers = None

字符串值

为使用 TLS 上下文创建的套接字设置可用密码。它应该是 OpenSSL 密码列表格式的字符串。如果没有指定,则所有启用的 OpenSSL 密码都将可用。

tls_cafile = None

字符串值

以 PEM 格式串联的 CA 证书文件的路径,以建立缓存服务器的真实性。如果 tls_enabled 是 False,则忽略这个选项。

tls_certfile = None

字符串值

PEM 格式的单个文件的路径,其中包含客户端证书以及建立证书真实性所需的任意数量的 CA 证书。仅当需要客户端身份验证时,才需要此文件。如果 tls_enabled 是 False,则忽略这个选项。

tls_enabled = False

布尔值

与缓存服务器捆绑时,用于 TLS 使用的全局切换。

tls_keyfile = None

字符串值

到包含客户端私钥的单个文件的路径。否则,私钥将从 tls_certfile 中指定的文件中获取。如果 tls_enabled 是 False,则忽略这个选项。

2.1.3. Compute

下表概述了 ceilometer.conf 文件中的 [compute] 组下可用的选项。

Expand
表 2.2. Compute
配置选项 = 默认值类型描述

instance_discovery_method = libvirt_metadata

字符串值

Ceilometer 提供了许多方法来发现计算节点上运行的实例:* naive: poll nova 以获取所有实例 * workload_partitioning: poll nova 以获取计算 * libvirt_metadata:从 libvirt 元数据获取实例,但没有实例元数据(推荐 Gnocchi 后端)

resource_cache_expiry = 3600

整数值

完全刷新实例资源缓存的到期,因为实例可能会迁移到另一主机,因此我们需要通过完全刷新本地缓存来清理本地缓存中的传统实例信息。最小应该是 resource_update_interval 的配置选项的值。此选项仅用于代理轮询 Nova API,因此仅当 instance_discovery_method 设置为 naive 时,它才会正常工作。

resource_update_interval = 0

整数值

新实例将根据此选项定期发现(以秒为单位)。默认情况下,代理会根据管道轮询间隔发现实例。如果选项大于 0,则会根据此选项的间隔更新要轮询的实例列表。与实例相关的测量将匹配管道中定义的间隔。此选项仅用于代理轮询 Nova API,因此仅当 instance_discovery_method 设置为 naive 时,它才会正常工作。

2.1.4. 协调

下表概述了 ceilometer.conf 文件中的 [coordination] 组下可用的选项。

Expand
表 2.3. 协调
配置选项 = 默认值类型描述

backend_url = None

字符串值

用于分布式协调的后端 URL。如果每个部署中心代理和每个主机计算代理留空,则不会进行工作负载分区,且仅在服务的单一实例正在运行时才正常工作。

2.1.5. event

下表概述了 ceilometer.conf 文件中的 [event] 组下可用的选项。

Expand
表 2.4. event
配置选项 = 默认值类型描述

definitions_cfg_file = event_definitions.yaml

字符串值

事件定义的配置文件。

drop_unmatched_notifications = False

布尔值

如果没有事件定义匹配,丢弃通知。(否则,我们仅使用默认特征进行转换。)

store_raw = []

多值

存储所选优先级级别的原始通知(info 和/或错误)。默认情况下不会捕获原始详情。

2.1.6. ipmi

下表概述了 ceilometer.conf 文件中的 [ipmi] 组下可用的选项。

Expand
表 2.5. ipmi
配置选项 = 默认值类型描述

node_manager_init_retry = 3

整数值

Intel Node Manager 初始化失败时重试次数

polling_retry = 3

整数值

在禁用此 pollster 前,IPMI/NM 轮询故障的容错功能。负表示重试。

2.1.7. 量表

下表概述了 ceilometer.conf 文件中的 [meter] 组下可用的选项。

Expand
表 2.6. 量表
配置选项 = 默认值类型描述

meter_definitions_dirs = ['/etc/ceilometer/meters.d', '/usr/lib/python3.9/site-packages/ceilometer/data/meters.d']

多值

列出目录以查找定义计量通知的文件。

2.1.8. monasca

下表概述了 ceilometer.conf 文件中的 [monasca] 组下可用的选项。

Expand
表 2.7. monasca
配置选项 = 默认值类型描述

archive_on_failure = False

布尔值

打开后,发布至 Monasca 时文件系统的存档指标会失败,或指标发布 maxes out retry attempt。

archive_path = mon_pub_failures.txt

字符串值

未能发布到 Monasca 的指标文件。这包括在第一次尝试时发布失败的指标以及缺少重试失败的指标。

batch_count = 1000

整数值

批处理中的最大样本数。

batch_max_retries = 3

整数值

发布失败时最多重试尝试次数上限到 Monasca API。

batch_mode = True

布尔值

指明是否在批处理中发布示例。

batch_polling_interval = 5

整数值

检查是否满足批处理条件的频率。

batch_timeout = 15

整数值

批处理中发布样本的最长时间(秒)。

client_max_retries = 3

整数值

连接到 Monasca API 的最大重试尝试次数。

client_retry_interval = 60

整数值

尝试重新连接到 Monasca API 的频率。

clientapi_version = 2_0

字符串值

发布时使用的 Monasca 客户端版本。

cloud_name = None

字符串值

云的名称

cluster = None

字符串值

集群名称

control_plane = None

字符串值

control plane 的名称

enable_api_pagination = False

布尔值

通过 monasca api 结果集启用分页。

monasca_mappings = /etc/ceilometer/monasca_field_definitions.yaml

字符串值

Monasca 静态和动态字段映射

retry_on_failure = False

布尔值

指明发布程序在失败时是否重试发布示例。只有几个错误情况会排队以重试。

2.1.9. 通知

下表概述了 ceilometer.conf 文件中的 [notification] 组下可用的选项。

Expand
表 2.8. 通知
配置选项 = 默认值类型描述

ack_on_event_error = True

布尔值

当事件持久性失败时确认消息。

batch_size = 1

整数值

发布前要等待的通知消息数。

batch_timeout = None

整数值

当未达到 batch_size 时分配示例前等待的秒数(无意)。

messaging_urls = []

多值

用于侦听通知的消息传递 URL。示例:rabbit://user:pass@host1:port1[,user:pass@hostN:portN]/virtual_host (如果为空,则使用DEFAULT/transport_url)。例如,当您为每个服务指定消息传递节点时,所有 nova 通知都会进入 rabbit-nova:5672,而所有 cinder 通知都转到 rabbit-cinder:5672。

notification_control_exchanges = ['nova', 'glance', 'neutron', 'cinder', 'heat', 'keystone', 'sahara', 'trove', 'zaqar', 'swift', 'ceilometer', 'magnum', 'dns', 'ironic', 'aodh']

多值

用于侦听通知的交换名称。

pipelines = ['meter', 'event']

多值

选择要启用哪个管道管理器生成数据

workers = 1

整数值

通知服务的 worker 数量,默认值为 1。

2.1.10. oslo_concurrency

下表概述了 ceilometer.conf 文件中的 [oslo_concurrency] 组下可用的选项。

Expand
表 2.9. oslo_concurrency
配置选项 = 默认值类型Description

disable_process_locking = False

布尔值

启用或禁用进程间的锁定。

lock_path = None

字符串值

用于锁定文件的目录。为安全起见,指定的目录应该只对运行需要锁定的进程的用户写入。默认为环境变量 OSLO_LOCK_PATH。如果使用外部锁定,则必须设置锁定路径。

2.1.11. oslo_messaging_amqp

下表概述了 ceilometer.conf 文件中的 [oslo_messaging_amqp] 组下可用的选项。

Expand
表 2.10. oslo_messaging_amqp
配置选项 = 默认值类型Description

addressing_mode = dynamic

字符串值

表示驱动程序使用的寻址模式。允许的值: legacy - 使用旧的不可路由寻址;routable - 使用可路由地址;dynamic - 如果消息总线不支持路由,使用 legacy,如果支持,使用 routable。

anycast_address = anycast

字符串值

在发送到一组消费者时,附加到地址前缀中。由消息总线使用来识别应以轮循方式传送的消息。

broadcast_prefix = broadcast

字符串值

广播到所有服务器时使用的地址前缀

connection_retry_backoff = 2

整数值

在每次失败故障转移尝试失败后,增加 connection_retry_interval。

connection_retry_interval = 1

整数值

在尝试重新连接前需要暂停的秒数。

connection_retry_interval_max = 30

整数值

connection_retry_interval + connection_retry_backoff 的最大限制

container_name = None

字符串值

AMQP 容器的名称。必须全局唯一。默认为生成的 UUID

default_notification_exchange = None

字符串值

通知地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_notification_exchange if set else control_exchange if set else notify

default_notify_timeout = 30

整数值

发送通知消息发送的截止时间。仅在调用者不提供超时到期时使用。

default_reply_retry = 0

整数值

因可恢复错误而重新发送失败的回复消息的最大尝试次数。

default_reply_timeout = 30

整数值

rpc 回复消息发送的截止时间。

default_rpc_exchange = None

字符串值

RPC 地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_rpc_exchange if set else control_exchange if set else rpc

default_send_timeout = 30

整数值

rpc cast 或调用消息发送的截止时间。仅在调用者不提供超时到期时使用。

default_sender_link_timeout = 600

整数值

调度闲置发送方链接的清除持续时间。在到期后分离链接。

group_request_prefix = unicast

字符串值

发送到组中任何服务器的地址前缀

idle_timeout = 0

整数值

不活跃连接的超时时间(以秒为单位)

link_retry_delay = 10

整数值

重新连接因为可恢复的错误而失败的 AMQP 1.0 链接之间暂停的时间。

multicast_address = multicast

字符串值

在发送 fanout 消息时附加到地址前缀中。由消息总线用来识别 fanout 消息。

notify_address_prefix = openstack.org/om/notify

字符串值

所有生成的通知地址的地址前缀

notify_server_credit = 100

整数值

传入通知消息的窗口大小

pre_settled = ['rpc-cast', 'rpc-reply']

多值

发送此类类型的消息。预先修改的消息将不会接收来自对等点的确认。注意:如果发送失败,则预先修改的消息可能会静默丢弃。允许的值: rpc-call - send RPC Calls pre-settled rpc-reply- send RPC Replies pre-settled rpc-cast - Send RPC Casts pre-settled notify - Send Notifications pre-settled

pseudo_vhost = True

布尔值

为那些不支持原生支持虚拟主机(如 qpidd)的消息总线启用虚拟主机支持。当设置为 true 时,虚拟主机名将添加到所有消息总线地址中,从而有效地为每个虚拟主机 创建专用子网。如果消息总线使用 AMQP 1.0 Open performative 作为虚拟主机名称中的 hostname 字段,则设置为 False。

reply_link_credit = 200

整数值

传入 RPC Reply 消息的窗口大小。

rpc_address_prefix = openstack.org/om/rpc

字符串值

所有生成的 RPC 地址的地址前缀

rpc_server_credit = 100

整数值

传入 RPC 请求消息的窗口大小

`sasl_config_dir = `

字符串值

包含 SASL 配置的目录路径

`sasl_config_name = `

字符串值

配置文件的名称(不带 .conf 后缀)

`sasl_default_realm = `

字符串值

如果用户名中没有域,则将使用 SASL 域

`sasl_mechanisms = `

字符串值

可接受的 SASL 机制的空格分隔列表

server_request_prefix = exclusive

字符串值

发送到特定服务器时使用的地址前缀

ssl = False

布尔值

尝试通过 SSL 连接。如果没有指定其他与 ssl 相关的参数,它将使用系统的 CA-bundle 来验证服务器证书。

`ssl_ca_file = `

字符串值

用于验证服务器证书的 CA 证书 PEM 文件

`ssl_cert_file = `

字符串值

自我识别用于客户端身份验证的证书 PEM 文件

`ssl_key_file = `

字符串值

用于为 ssl_cert_file 证书签名的私钥 PEM 文件(可选)

ssl_key_password = None

字符串值

用于解密 ssl_key_file 的密码(如果加密)

ssl_verify_vhost = False

布尔值

默认情况下,SSL 检查服务器证书中的名称是否与 transport_url 中的主机名匹配。在某些配置中,可能最好使用虚拟主机名,例如,如果服务器使用 Server Name Indication TLS 扩展(rfc6066)为每个虚拟主机提供证书。如果服务器的 SSL 证书使用虚拟主机名称而不是 DNS 名称,则将 ssl_verify_vhost 设置为 True。

trace = False

布尔值

debug:将 AMQP 帧转储到 stdout

unicast_address = unicast

字符串值

在发送到特定的 RPC/Notification 服务器时,附加到地址前缀中。由消息总线用来识别发送到单个目的地的消息。

2.1.12. oslo_messaging_kafka

下表概述了 ceilometer.conf 文件中的 [oslo_messaging_kafka] 组下可用的选项。

Expand
表 2.11. oslo_messaging_kafka
配置选项 = 默认值类型Description

compression_codec = none

字符串值

生成者生成的所有数据的压缩码c。如果没有设置,则不会使用压缩。请注意,这允许的值取决于 kafka 版本

conn_pool_min_size = 2

整数值

连接过期策略的池大小限制

conn_pool_ttl = 1200

整数值

池中闲置连接的生存时间

consumer_group = oslo_messaging_consumer

字符串值

Kafka 消费者的组 ID。一个组中的消费者将协调消息消耗

enable_auto_commit = False

布尔值

启用异步消费者提交

kafka_consumer_timeout = 1.0

浮点值

Kafka 用户的默认超时

kafka_max_fetch_bytes = 1048576

整数值

Kafka 使用者的最大获取字节数

max_poll_records = 500

整数值

轮询调用中返回的最大记录数

pool_size = 10

整数值

Kafka Consumers 的池大小

producer_batch_size = 16384

整数值

producer async 发送的批处理大小

producer_batch_timeout = 0.0

浮点值

KafkaProducer batching 的延迟上限(以秒为单位)

sasl_mechanism = PLAIN

字符串值

安全协议是 SASL 的机制

security_protocol = PLAINTEXT

字符串值

用于与代理通信的协议

`ssl_cafile = `

字符串值

用于验证服务器证书的 CA 证书 PEM 文件

`ssl_client_cert_file = `

字符串值

用于身份验证的客户端证书 PEM 文件。

`ssl_client_key_file = `

字符串值

用于身份验证的客户端密钥 PEM 文件。

`ssl_client_key_password = `

字符串值

用于身份验证的客户端密钥密码文件。

2.1.13. oslo_messaging_notifications

下表概述了 ceilometer.conf 文件中的 [oslo_messaging_notifications] 组下可用的选项。

Expand
表 2.12. oslo_messaging_notifications
配置选项 = 默认值类型Description

driver = []

多值

处理发送通知的驱动程序。可能的值有 messaging, messagingv2, routing, log, test, noop

retry = -1

整数值

因可恢复的错误而发送失败的通知消息的最大尝试次数。0 - no retry, -1 - indefinite

topics = ['notifications']

列出值

用于 OpenStack 通知的 AMQP 主题。

transport_url = None

字符串值

代表用于通知的消息传递驱动程序的 URL。如果没有设置,我们回退到用于 RPC 的同一配置。

2.1.14. oslo_messaging_rabbit

下表概述了 ceilometer.conf 文件中的 [oslo_messaging_rabbit] 组下可用的选项。

Expand
表 2.13. oslo_messaging_rabbit
配置选项 = 默认值类型Description

amqp_auto_delete = False

布尔值

AMQP 中的自动删除队列。

amqp_durable_queues = False

布尔值

在 AMQP 中使用持久队列。如果启用了 rabbit_quorum_queue,则队列将具有持久性,并且此值将被忽略。

direct_mandatory_flag = True

布尔值

(DEPRECATED)为直接发送启用/禁用 RabbitMQ 强制标记。直接发送用作回复,因此当客户端队列不存在时,会引发 MessageUndeliverable 异常。MessageUndeliverable 异常将用于对超时进行循环,以便发送者有机会恢复该标志,且无法停用此功能。

enable_cancel_on_failover = False

布尔值

启用 x-cancel-on-ha-failover 标志,rabbitmq 服务器将取消和通知消费者何时队列停机

heartbeat_in_pthread = False

布尔值

默认情况下,通过原生 python 线程运行健康检查心跳线程。如果此选项等于 False,则健康检查心跳将从父进程继承执行模型。例如,如果父进程使用 eventlet/greenlet 对 stdlib 进行补丁,则 heartbeat 将通过绿色线程运行。这个选项应只针对 wsgi 服务设置为 True。

heartbeat_rate = 2

整数值

heartbeat_timeout_threshold 中检查心跳的频率。

heartbeat_timeout_threshold = 60

整数值

如果 heartbeat 的 keep-alive 失败(0 禁用心跳)失败,则 Rabbit 代理被视为 down 的秒数。

kombu_compression = None

字符串值

EXPERIMENTAL:可能的值为 gzip, bz2。如果没有设置压缩,则不会使用。这个选项可能在以后的版本中不可用。

kombu_failover_strategy = round-robin

字符串值

确定在当前连接到的 RabbitMQ 节点不可用时如何选择下一个 RabbitMQ 节点。只有在配置中提供了多个 RabbitMQ 节点时,才会生效。

kombu_missing_consumer_retry_timeout = 60

整数值

在放弃向其回复发送之前,等待缺少客户端的时间。这个值不应超过 rpc_response_timeout。

kombu_reconnect_delay = 1.0

浮点值

在响应 AMQP 消费者取消通知前等待(以秒为单位)等待(以秒为单位)。

rabbit_ha_queues = False

布尔值

尝试在 RabbitMQ 中使用 HA 队列(x-ha-policy: all)。如果更改这个选项,您必须擦除 RabbitMQ 数据库。在 RabbitMQ 3.0 中,在声明队列时,x-ha-policy 参数不再控制队列镜像。如果您只想确保所有队列(除自动生成的名称除外)都已镜像到所有节点,请运行:"rabbitmqctl set_policy HA ^(?!amq\.) commands {"ha-mode": "all"} "

rabbit_interval_max = 30

整数值

RabbitMQ 连接重试的最大间隔。默认值为 30 秒。

rabbit_login_method = AMQPLAIN

字符串值

RabbitMQ 登录方法。

rabbit_qos_prefetch_count = 0

整数值

指定要预先抓取的消息数量。将 设为零可允许无限消息。

rabbit_quorum_delivery_limit = 0

整数值

每次消息被重新设计为消费者时,计数器都会递增。当重新传送计数超过交付限制后,消息将被丢弃或死信(如果配置了 DLX 交换)仅在启用 rabbit_quorum_queue 时使用,默认 0 代表没有设置限制。

rabbit_quorum_max_memory_bytes = 0

整数值

默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列使用的内存字节数。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。

rabbit_quorum_max_memory_length = 0

整数值

默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列中的消息数量。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。

rabbit_quorum_queue = False

布尔值

在 RabbitMQ 中使用仲裁队列(x-queue-type: quorum)。仲裁队列是基于 Raft 共识算法的 RabbitMQ 实施持久复制 FIFO 队列的现代队列类型。它从 RabbitMQ 3.8.0 开始提供。如果设置此选项将与 HA 队列(rabbit_ha_queues) aka 镜像队列冲突,换句话说,应该禁用 HA 队列,因此启用此选项时会忽略 amqp_durable_queues opion。

rabbit_retry_backoff = 2

整数值

连接到 RabbitMQ 时,在重试之间会多长时间进行 backoff。

rabbit_retry_interval = 1

整数值

使用 RabbitMQ 重试连接的频率。

rabbit_transient_queues_ttl = 1800

整数值

正整数,代表队列 TTL (x-expires)的持续时间(以秒为单位)。TTL 期间未使用的队列将自动删除。参数仅影响回复和 fanout 队列。

ssl = False

布尔值

通过 SSL 连接。

`ssl_ca_file = `

字符串值

SSL 证书颁发机构文件(仅在启用 SSL 时才评估)。

`ssl_cert_file = `

字符串值

SSL 证书文件(仅在启用 SSL 时才评估)。

ssl_enforce_fips_mode = False

布尔值

强制 OpenSSL FIPS 模式的全局切换。此功能需要 Python 支持。这在所有环境中的 Python 3.9 中都可用,并可能已向后移植到所选环境中的旧的 Python 版本。如果使用的 Python 可执行文件不支持 OpenSSL FIPS 模式,则会引发异常。

`ssl_key_file = `

字符串值

SSL 密钥文件(仅在启用 SSL 时才评估)。

`ssl_version = `

字符串值

要使用的 SSL 版本(仅在启用 SSL 时验证)。有效值为 TLSv1 和 SSLv23。在某些发行版中可能会提供 SSLv2、SSLv3、TLSv1_1 和 TLSv1_2。

2.1.15. oslo_reports

下表概述了 ceilometer.conf 文件中的 [oslo_reports] 组下可用的选项。

Expand
表 2.14. oslo_reports
配置选项 = 默认值类型Description

file_event_handler = None

字符串值

监视触发报告的更改的文件路径,而不是信号。设置此选项将禁用报告的信号触发器。如果应用程序作为 WSGI 应用程序运行,建议使用此应用程序而不是信号。

file_event_handler_interval = 1

整数值

设置 file_event_handler 时轮询之间等待的秒数

log_dir = None

字符串值

创建文件的日志目录的路径

2.1.16. 轮询

下表概述了 ceilometer.conf 文件中的 [polling] 组下可用的选项。

Expand
表 2.15. 轮询
配置选项 = 默认值类型描述

batch_size = 50

整数值

要发送到通知代理的样本的批处理大小,设置为 0 以禁用。当使用 prometheus exporter 功能时,这应该大于每个指标的最大样本数。

cfg_file = polling.yaml

字符串值

用于轮询定义的配置文件。

enable_notifications = True

布尔值

轮询服务是否应该在轮询周期后发送通知。

enable_prometheus_exporter = False

布尔值

允许此 ceilometer 轮询实例,直接以 Prometheus 格式公开检索到的指标。

heartbeat_socket_dir = None

字符串值

创建用于轮询心跳的套接字文件的路径。

partitioning_group_prefix = None

字符串值

工作加载分区组前缀。只有在您要使用不同的配置文件运行多个轮询代理时,才使用。对于具有相同 partitioning_group_prefix 的代理池的每个子组,应加载一个 disjoint 子集 pollsters。

pollsters_definitions_dirs = ['/etc/ceilometer/pollsters.d']

多值

包含用于创建 pollsters 的 YAML 文件的目录列表。

prometheus_listen_addresses = ['127.0.0.1:9101']

列出值

将公开导出的指标的 ipaddr:port 组合列表。

tenant_name_discovery = False

布尔值

识别轮询示例中的项目和用户名。默认情况下,收集这些值是禁用的,因为根据项目数量、用户和从环境中轮询示例,它可能会超负 keystone 服务。在使用这个功能时,建议使用 ceilometer 配置缓存后端,以减少对 keystone 发出的调用数量。

2.1.17. publisher

下表概述了 ceilometer.conf 文件中的 [publisher] 组下可用的选项。

Expand
表 2.16. publisher
配置选项 = 默认值类型描述

telemetry_secret = 为有效的签名进行更改

字符串值

签名消息的 secret 值。如果不需要签名,则设置值为空,以避免计算开销。

2.1.18. publisher_notifier

下表概述了 ceilometer.conf 文件中的 [publisher_notifier] 组下可用的选项。

Expand
表 2.17. publisher_notifier
配置选项 = 默认值类型描述

event_topic = event

字符串值

ceilometer 用于事件通知的主题。

metering_topic = metering

字符串值

ceilometer 用于计量通知的主题。

telemetry_driver = messagingv2

字符串值

ceilometer 用于计量通知的驱动程序。

2.1.19. rgw_admin_credentials

下表概述了 ceilometer.conf 文件中的 [rgw_admin_credentials] 组下可用的选项。

Expand
表 2.18. rgw_admin_credentials
配置选项 = 默认值类型描述

access_key = None

字符串值

Radosgw Admin 的访问密钥。

SECRET_KEY = None

字符串值

Radosgw Admin 的 secret 密钥。

2.1.20. rgw_client

下表概述了 ceilometer.conf 文件中的 [rgw_client] 组下可用的选项。

Expand
表 2.19. rgw_client
配置选项 = 默认值类型描述

implicit_tenants = False

布尔值

RGW 是否使用隐式租户。

2.1.21. service_credentials

下表概述了 ceilometer.conf 文件中的 [service_credentials] 组下可用的选项。

Expand
表 2.20. service_credentials
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

interface = public

字符串值

Identity service 目录中的端点类型,用于与 OpenStack 服务通信。

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

region-name = None

字符串值

用于 OpenStack 服务端点的区域名称。

system-scope = None

字符串值

系统操作范围

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

2.1.22. service_types

下表概述了 ceilometer.conf 文件中的 [service_types] 组下可用的选项。

Expand
表 2.21. service_types
配置选项 = 默认值类型描述

cinder = volumev3

字符串值

Cinder 服务类型。

Glance = image

字符串值

Glance 服务类型。

neutron = network

字符串值

Neutron 服务类型。

nova = compute

字符串值

Nova 服务类型。

radosgw = None

字符串值

radosgw 服务类型。

swift = object-store

字符串值

Swift 服务类型。

2.1.23. vmware

下表概述了 ceilometer.conf 文件中的 [vmware] 组下可用的选项。

Expand
表 2.22. vmware
配置选项 = 默认值类型Description

api_retry_count = 10

整数值

可以重试 VMware vSphere API 的次数。

ca_file = None

字符串值

用于验证 vCenter 服务器证书的 CA 捆绑包文件。

host_ip = 127.0.0.1

主机地址值

VMware vSphere 主机的 IP 地址。

`host_password = `

字符串值

VMware vSphere 的密码。

host_port = 443

端口值

VMware vSphere 主机的端口。

`host_username = `

字符串值

VMware vSphere 的用户名。

insecure = False

布尔值

如果为 true,则不会验证 vCenter 服务器证书。如果为 false,则使用默认 CA 信任存储进行验证。如果设置了 "ca_file",则忽略这个选项。

task_poll_interval = 0.5

浮点值

轮询持续 async 任务的时间(以秒为单位)。

wsdl_location = None

字符串值

可选的 vim 服务 WSDL 位置,如 http://<server>/vimService.wsdl。可选的 over-ride to default location for bug work-arounds。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat