f5networks.f5_modules.bigip_device_syslog 模块 – 管理 BIG-IP 上的系统级 syslog 设置

注意

此模块是 f5networks.f5_modules 集合 (版本 1.32.1) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install f5networks.f5_modules。

要在剧本中使用它，请指定：f5networks.f5_modules.bigip_device_syslog。

f5networks.f5_modules 1.0.0 中的新增功能

概要

  • 管理 BIG-IP 上的系统级 syslog 设置。

参数

参数

注释

auth_priv_from

字符串

指定要包含在系统日志中的关于用户身份验证的最低级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

auth_priv_to

字符串

指定要包含在系统日志中的关于用户身份验证的最高级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

console_log

布尔值

启用或禁用将紧急 syslog 消息记录到控制台。

选项

  • false

  • true

cron_from

字符串

指定要包含在系统日志中的关于基于时间的调度的最低级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

cron_to

字符串

指定要包含在系统日志中的关于基于时间的调度的最高级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

daemon_from

字符串

指定要包含在系统日志中的关于守护进程性能的最低级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

daemon_to

字符串

指定要包含在系统日志中的关于守护进程性能的最高级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

include

字符串

要包含在设备 syslog 配置中的 Syslog-NG 配置。

iso_date

布尔值

启用或禁用日志文件中的消息的 ISO 日期格式。

选项

  • false

  • true

kern_from

字符串

指定要包含在系统日志中的最低级别的内核消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

kern_to

字符串

指定要包含在系统日志中的最高级别的内核消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

local6_from

字符串

指定要包含在日志中的来自 local6 设施的最低错误级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

local6_to

字符串

指定要包含在日志中的来自 local6 设施的最高错误级别消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

mail_from

字符串

指定要包含在系统日志中的最低级别的邮件日志消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

mail_to

字符串

指定要包含在系统日志中的最高级别的邮件日志消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

messages_from

字符串

指定要包含在系统日志中的最低级别的系统消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

messages_to

字符串

指定要包含在系统日志中的最高级别的系统消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

provider

字典

f5networks.f5_modules 1.0.0 中新增

包含连接详细信息的字典对象。

auth_provider

字符串

配置 auth 提供程序以从远程设备获取身份验证令牌。

此选项在使用 BIG-IQ 设备时非常有用。

no_f5_teem

布尔值

如果为 yes，则不会将 TEEM 遥测数据发送到 F5。

您可以通过设置环境变量 F5_TELEMETRY_OFF 来省略此选项。

先前使用的变量 F5_TEEM 已弃用，因为其名称令人困惑。

选项

  • false ← (默认值)

  • true

password

别名：pass、pwd

字符串 / 必填

用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。

您可以通过设置环境变量 F5_PASSWORD 来省略此选项。

server

字符串 / 必填

BIG-IP 主机或 BIG-IQ 主机。

您可以通过设置环境变量 F5_SERVER 来省略此选项。

server_port

整数

BIG-IP 服务器端口。

您可以通过设置环境变量 F5_SERVER_PORT 来省略此选项。

默认值： 443

timeout

整数

指定与网络设备通信的超时时间（以秒为单位），用于连接或发送命令。如果在操作完成之前超时，模块将报错。

transport

字符串

配置连接到远程设备时使用的传输连接。

选项

  • "rest" ← (默认)

用户

字符串 / 必填

连接 BIG-IP 或 BIG-IQ 的用户名。此用户必须具有设备上的管理员权限。

可以通过设置环境变量 F5_USER 来省略此选项。

validate_certs

布尔值

如果为 no，则不验证 SSL 证书。仅在使用自签名证书的个人控制站点上使用此选项。

可以通过设置环境变量 F5_VALIDATE_CERTS 来省略此选项。

选项

  • false

  • true ← (默认)

user_log_from

字符串

指定要包含在系统日志中的最低级别用户帐户消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

user_log_to

字符串

指定要包含在系统日志中的最高级别用户帐户消息。

选项

  • "alert"

  • "crit"

  • "debug"

  • "emerg"

  • "err"

  • "info"

  • "notice"

  • "warning"

注释

注意

  • 有关使用 Ansible 管理 F5 网络设备的更多信息，请参见 https://ansible.org.cn/integrations/networks/f5。

  • 需要 BIG-IP 软件版本 >= 12。

  • F5 模块仅操作 F5 产品的运行配置。为了确保 BIG-IP 特定的配置持久保存到磁盘，请务必包含至少一项使用 f5networks.f5_modules.bigip_config 模块保存运行配置的任务。请参考模块文档了解保存运行配置的正确使用方法。

示例

- name: Create a syslog config
  bigip_device_syslog:
    name: foo
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

返回值

常见的返回值已在 此处 记录，以下是此模块独有的字段

键

描述

auth_priv_from

字符串

新的最低用户身份验证日志记录级别。

返回：changed

示例： "alert"

auth_priv_to

字符串

新的最高用户身份验证日志记录级别。

返回：changed

示例： "emerg"

console_log

布尔值

是否启用控制台日志记录。

返回：changed

示例： true

cron_from

字符串

新的最低基于时间的调度日志记录级别。

返回：changed

示例： "emerg"

cron_to

字符串

新的最高基于时间的调度日志记录级别。

返回：changed

示例： "alert"

daemon_from

字符串

新的最低守护进程性能日志记录级别。

返回：changed

示例： "alert"

daemon_to

字符串

新的最高守护进程性能日志记录级别。

返回：changed

示例： "alert"

include

字符串

要包含在 syslog 配置中的新的额外 syslog-ng 配置。

返回：changed

示例： "filter f_remote_syslog { not (facility(local6)) };"

iso_date

布尔值

是否启用日志中的 ISO 日期格式。

返回：changed

示例： false

kern_from

字符串

新的最低内核消息日志记录级别。

返回：changed

示例： "alert"

kern_to

字符串

新的最高内核消息日志记录级别。

返回：changed

示例： "alert"

local6_from

字符串

新的最低 local6 设施日志记录级别。

返回：changed

示例： "alert"

local6_to

字符串

新的最高 local6 设施日志记录级别。

返回：changed

示例： "alert"

mail_from

字符串

新的最低邮件日志记录级别。

返回：changed

示例： "alert"

mail_to

字符串

新的最高邮件日志记录级别。

返回：changed

示例： "alert"

messages_from

字符串

新的最低系统日志记录级别。

返回：changed

示例： "alert"

messages_to

字符串

新的最高系统日志记录级别。

返回：changed

示例： "alert"

user_log_from

字符串

新的最低用户帐户日志记录级别。

返回：changed

示例： "alert"

user_log_to

字符串

新的最高用户帐户日志记录级别。

返回：changed

示例： "alert"

作者

  • Tim Rupp (@caphrim007)