8.4. metadata_agent.ini
本节包含 /etc/neutron/metadata_agent.ini 文件的选项。
8.4.1. DEFAULT
下表概述了 /etc/neutron/metadata_agent.ini 文件中的 [DEFAULT] 组下可用的选项。
.
| 配置选项 = 默认值 | 类型 | Description |
|---|---|---|
|
| 字符串值 | ssl 的证书颁发机构公钥(CA 证书)文件 |
|
| 布尔值 | 如果设置为 true，则日志级别将设置为 DEBUG，而不是默认的 INFO 级别。 |
|
| 列表值 | 以 logger=LEVEL 的形式列出软件包日志级别列表。如果设置了 log_config_append，则忽略此选项。 |
|
| 布尔值 | 启用或禁用弃用的致命状态。 |
| `instance_format = [instance: %(uuid)s] ` | 字符串值 | 通过日志消息传递的实例格式。 |
| `instance_uuid_format = [instance: %(uuid)s] ` | 字符串值 | 通过日志消息传递的实例 UUID 的格式。 |
|
| 字符串值 | 日志记录配置文件的名称。此文件附加到任何现有日志记录配置文件中。有关日志记录配置文件的详情，请查看 Python 日志记录模块文档。请注意，当使用日志记录配置文件时，所有日志记录配置都会在配置文件中设置，其他日志记录配置选项将被忽略（如 log-date-format）。 |
|
| 字符串值 | 在日志记录中定义 %%(asctime) s 的格式字符串。默认：%(default) s。如果设置了 log_config_append，则忽略此选项。 |
|
| 字符串值 | （可选）用于相对 log_file 路径的基础目录。如果设置了 log_config_append，则忽略此选项。 |
|
| 字符串值 | （可选）要将日志输出发送到的日志文件名称。如果没有设置默认值，日志记录将进入由 use_stderr 定义的 stderr。如果设置了 log_config_append，则忽略此选项。 |
|
| 整数值 | 轮转日志文件前的时间长度。除非将 log_rotation_type 设置为 "interval"，否则此选项将被忽略。 |
|
| 字符串值 | 轮转间隔类型。在调度下一个轮转时，将使用上次文件更改的时间（或服务启动的时间）。 |
|
| 字符串值 | 日志轮转类型。 |
|
| 字符串值 | 使用上下文格式化用于日志消息的字符串。oslo_log.formatters.ContextFormatter 使用 |
|
| 字符串值 | 当消息的日志记录级别为 DEBUG 时，要附加到日志消息的其他数据。oslo_log.formatters.ContextFormatter 使用 |
|
| 字符串值 | 上下文未定义时用于日志消息的字符串。oslo_log.formatters.ContextFormatter 使用 |
|
| 字符串值 | 用以下格式为每一行加前缀 异常输出。oslo_log.formatters.ContextFormatter 使用 |
|
| 字符串值 | 定义 logging_context_format_string 中使用的 %(user_identity) s 的格式字符串。oslo_log.formatters.ContextFormatter 使用 |
|
| 整数值 | 轮转日志文件的最大数量。 |
|
| 整数值 | 日志文件最大大小（以 MB 为单位）。如果 "log_rotation_type" 没有设置为 "size"，则忽略这个选项。 |
|
| 整数值 | 配置元数据服务器套接字的积压请求数 |
| `metadata_proxy_group = ` | 字符串值 | 在初始化后运行元数据代理的组(gid 或名称) （如果为空：代理有效组）。 |
| `metadata_proxy_shared_secret = ` | 字符串值 | 在代理元数据请求时，Neutron 使用共享 secret 为 Instance-ID 标头签名，以防止欺骗。您可以为 secret 选择任何字符串，但它必须与 Nova 元数据服务器使用的配置中匹配。注意：Nova 使用相同的配置密钥，但在 [neutron] 部分中。 |
|
| 字符串值 | 元数据代理 UNIX 域套接字的位置。 |
|
| 字符串值 | 元数据代理 UNIX 域套接字模式，允许 4 个值：deduce - 从 metadata_proxy_user/group 值的分离模式；user - 将元数据代理套接字模式设置为 0o644，以便在 metadata_proxy_user 是代理有效用户或 root 用户时使用；group - 将元数据代理套接字模式设置为 0o664，以变在 metadata_proxy_group 是有效的代理组或用户时使用；all - 将原始代理套接字模式设置为 0o666，在所有其他情况下使用。 |
| `metadata_proxy_user = ` | 字符串值 | 用户(uid 或名称)在其初始化后运行元数据代理（如果为空：代理有效的用户）。 |
|
| 整数值 | 元数据服务器的单独 worker 进程数量（与 ML2/OVN 一起使用时默认为 2，与其他后端驱动程序的 CPU 数量有一半） |
| `nova_client_cert = ` | 字符串值 | nova 元数据 api 服务器的客户端证书。 |
| `nova_client_priv_key = ` | 字符串值 | 客户端证书的私钥。 |
|
| 主机地址值 | Nova 元数据服务器的 IP 地址或 DNS 名称。 |
|
| 布尔值 | 允许对 nova 元数据执行不安全的 SSL (https)请求 |
|
| 端口值 | Nova 元数据服务器使用的 TCP 端口。 |
|
| 字符串值 | 协议来访问 nova 元数据、http 或 https |
|
| 布尔值 | 启用或禁用错误事件的发布。 |
|
| 整数值 | 每个 rate_limit_interval 的最大日志信息数。 |
|
| 字符串值 | 速率限制使用的日志级别名称：CRITICAL、ERROR、INFO、WARNING、DEBUG 或空字符串。大于或等于 rate_limit_except_level 的日志不会被过滤。空字符串表示过滤所有级别。 |
|
| 整数值 | 日志速率限制的间隔、秒数。 |
|
| 整数值 | 从 RPC 调用等待响应的最大秒数。 |
|
| 字符串值 | syslog 工具接收日志行。如果设置了 log_config_append，则忽略此选项。 |
|
| 布尔值 | 为日志记录启用 journald。如果在 systemd 环境中运行，您可能需要启用日志支持。这样做将使用日志原生协议，该协议除日志消息之外还包含结构化元数据。如果设置了 log_config_append，此选项将被忽略。 |
|
| 布尔值 | 使用 JSON 格式进行日志记录。如果设置了 log_config_append，则忽略此选项。 |
|
| 布尔值 | 使用 syslog 进行日志记录。现有的 syslog 格式是 DEPRECATED，稍后将更改为遵循 RFC5424。如果设置了 log_config_append，则忽略此选项。 |
|
| 布尔值 | 日志输出到 Windows 事件日志. |
|
| 布尔值 | 将输出输出到标准错误。如果设置了 log_config_append，则忽略此选项。 |
|
| 布尔值 | 使用旨在监视文件系统的日志记录处理程序。移动或移除日志文件时，此处理程序将立即打开具有指定路径的新日志文件。只有在指定了 log_file 选项并使用 Linux 平台时，才有意义。如果设置了 log_config_append，则忽略此选项。 |
8.4.2. agent
下表概述了 /etc/ neutron/metadata_agent.ini 文件中的 组下可用的选项。
[agent ]
| 配置选项 = 默认值 | 类型 | Description |
|---|---|---|
|
| 布尔值 | 日志代理心跳 |
|
| 浮点值 | 节点报告状态之间的秒数 ; 应该小于 agent_down_time，如果节点为一半或小于 agent_down_time。 |
8.4.3. 缓存
下表概述了 /etc/neutron/metadata_agent.ini 文件中的 [cache] 组下可用的选项。
| 配置选项 = 默认值 | 类型 | Description |
|---|---|---|
|
| 字符串值 | 缓存后端模块。对于具有数百个线程服务器的基于 eventlet 的环境，建议使用带有池(oslo_cache.memcache_pool)的 Memcache。对于小于 100 个线程服务器的环境，建议使用 Memcached (dogpile.cache.memcached)或 Redis (dogpile.cache.redis)。具有单一服务器实例的测试环境可以使用 dogpile.cache.memory 后端。 |
|
| 多值 | 为 backend 模块提供的参数。指定每参数传递到 dogpile.cache 后端的一次这个选项。示例格式："<argname>:<value>"。 |
|
| 字符串值 | 为缓存区域构建配置字典的前缀。除非存在另一个具有相同配置名称的 dogpile.cache 区域，否则这不应更改。 |
|
| 浮点值 | 尝试在 HashClient 内部机制中重新添加节点前的时间（以秒为单位）。 |
|
| 布尔值 | 从缓存后端进行额外的调试（缓存键、get/set/delete/etc 调用）。只有在您需要使用键/值查看特定的 cache-backend get/set/delete 调用时才有用。通常，这应该设为 false。 |
|
| 布尔值 | 启用重试客户端机制来处理失败。这些机制可用于嵌套所有的 pymemcache 客户端。打包程序允许您定义有多少尝试进行，以及 attemots 之间等待的时间。 |
|
| 布尔值 | dogpile 的 pymemcache 后端的套接字 keepalive 的全局切换 |
|
| 布尔值 | 缓存的全局切换。 |
|
| 整数值 | dogpile.cache 区域中的任何缓存项的默认 TTL （以秒为单位）。这适用于任何未为其定义显式缓存过期时间的缓存方法。 |
|
| 整数值 | 在客户端标记为死前应尝试的次数，并在 HashClient 的内部机制中从池中删除。 |
|
| 浮点值 | 在 HashClient 内部机制中重试尝试之间应经过的时间（以秒为单位）。 |
|
| 整数值 | 在再次尝试前，memcached 服务器被视为 dead 的秒数。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。 |
|
| 整数值 | 操作将等待的秒数，以获取 memcache 客户端连接。 |
|
| 布尔值 | 如果 memcache 在重新连接时清除，则全局切换。（仅oslo_cache.memcache_pool 后端）。 |
|
| 整数值 | 每个 memcached 服务器的最大打开连接数。(oslo_cache.memcache_pool backend)。 |
|
| 整数值 | 到 memcached 的连接在池关闭前没有被使用的秒数。（仅oslo_cache.memcache_pool 后端）。 |
|
| 列表值 |
memcache 服务器格式为 "host:port"。(dogpile.cache.memcached 和 oslo_cache.memcache_pool 后端)。如果给定主机引用 IPv6 或给定域，则您应该为给定地址系列( |
|
| 浮点值 | 每次对服务器调用的超时时间（以秒为单位）。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。 |
|
| 列表值 | 用于导入的代理类会影响 dogpile.cache 后端功能的方式。有关 change-backend-behavior 的 dogpile.cache 文档。 |
|
| 整数值 | 在失败前尝试操作的次数。 |
|
| 浮点值 | 每次尝试之间休眠的秒数。 |
|
| 整数值 | 在丢弃连接前，保持 TCP 的最大 keepalive 探测 TCP 数量。应该是大于零的正整数。 |
|
| 整数值 | 在 TCP 开始发送 keepalive 探测前，连接需要保持闲置的时间（以秒为单位）。应该是大于零的正整数。 |
|
| 整数值 | 各个 keepalive 探测之间的时间（以秒为单位）。应该是大于零的正整数。 |
|
| 字符串值 | 为使用 TLS 上下文创建的套接字设置可用密码。它应该是 OpenSSL 密码列表格式的字符串。如果没有指定，则所有启用了 OpenSSL 的密码都可用。 |
|
| 字符串值 | 以 PEM 格式串联的 CA 证书文件的路径，以建立缓存服务器的真实性。如果 tls_enabled 是 False，这个选项将被忽略。 |
|
| 字符串值 | 到 PEM 格式的单个文件的路径，其中包含客户端证书以及建立证书真实性所需的任意数量的 CA 证书。只有在需要客户端身份验证时才需要此文件。如果 tls_enabled 是 False，这个选项将被忽略。 |
|
| 布尔值 | 与缓存服务器组合时，TLS 使用的全局切换。 |
|
| 字符串值 | 到包含客户端私钥的单个文件的路径。其他私钥将从 tls_certfile 中指定的文件获取。如果 tls_enabled 是 False，这个选项将被忽略。 |
