f5networks.f5_modules.bigip_gtm_monitor_http 模块 – 管理 F5 BIG-IP GTM HTTP 监控

注意

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

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

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

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

f5networks.f5_modules 1.0.0 中的新增功能

概要

• 管理 F5 BIG-IP GTM（现为 BIG-IP DNS）HTTP 监控。

参数

参数	注释
ignore_down_response 布尔值	指定监控程序允许每个间隔进行多次探测尝试。 当 true 时，指定监控程序忽略监控超时期间的关闭响应。一旦监控超时达到而系统未收到启动响应，系统就会将对象标记为关闭。 当 false 时，指定监控程序在收到关闭响应时立即将对象标记为关闭。 创建新的监控程序时，如果未提供此参数，则默认值为 false。 选项 false true
interval 整数	指定此模板的监控实例运行频率的间隔。 如果在创建新的监控程序时未提供此参数，则默认值为 30。 此值**必须**小于 timeout 值。
ip 字符串	IP/端口定义的 IP 地址部分。如果在创建新的监控程序时未提供此参数，则默认值为“*”。 如果此值为 IP 地址，则必须指定 port 编号。
name 字符串 / 必需	监控程序名称。
parent 字符串	此监控模板的父模板。设置此值后，将无法更改。默认情况下，此值为 Common 分区上的 http 父级。 默认值： "/Common/http"
partition 字符串	用于管理资源的设备分区。 默认值： "Common"
port 字符串	IP/端口定义的端口地址部分。如果在创建新的监控程序时未提供此参数，则默认值为“*”。如果指定 IP 地址，则必须使用 1 到 65535 之间的值。
probe_timeout 整数	指定系统超时对系统进行探测请求的秒数。 创建新的监控程序时，如果未提供此参数，则默认值为 5。
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" ← (默认)
user 字符串 / 必需	连接 BIG-IP 或 BIG-IQ 的用户名。此用户必须拥有设备上的管理员权限。 您可以通过设置环境变量 F5_USER 来省略此选项。
validate_certs 布尔值	如果为 no，则不会验证 SSL 证书。仅在使用自签名证书的个人控制站点上使用此选项。 您可以通过设置环境变量 F5_VALIDATE_CERTS 来省略此选项。 选项 false true ← (默认)
receive 字符串	监控调用接收字符串。
reverse 布尔值	指示系统在测试成功时将目标资源标记为关闭。例如，如果您的网站主页上的内容是动态的并且经常更改，您可能希望设置一个反向 ECV 服务检查，查找字符串“Error”。 匹配此字符串表示 Web 服务器已关闭。 要使用此选项，必须为 send 和 receive 指定值。 选项 false true
send 字符串	监控调用的发送字符串。 创建新的监控时，如果未提供此参数，则使用默认值 GET /\r\n。
state 字符串	当 present 时，确保监控存在。 当 absent 时，确保监控已移除。 选项 "present" ← (默认) "absent"
target_password 字符串	如果被监控的目标需要身份验证，则指定密码。
target_username 字符串	如果被监控的目标需要身份验证，则指定用户名。
timeout 整数	节点或服务必须在多少秒内响应监控请求。如果目标在设定的时间段内响应，则认为其处于活动状态。如果目标在设定的时间段内没有响应，则认为其处于关闭状态。您可以将其更改为任何数字，但是它应该是间隔秒数的 3 倍加 1 秒。 创建新的监控时，如果未提供此参数，则默认值为 120。
transparent 布尔值	指定监控是否以透明模式运行。 以透明模式运行的监控将流量通过关联的池成员或节点（通常是路由器或防火墙）定向到别名目标（即，它探测监控中指定的 ip-port 组合）。 如果监控无法成功到达别名目标，则将发送监控流量的池成员或节点标记为关闭。 创建新的监控时，如果未提供此参数，则默认值为 no false。 选项 false true
update_password 字符串	always 在指定 target_password 时始终更新密码。 on_create 仅为新创建的监控设置密码。 选项 "always" ← (默认) "on_create"

注释

注意

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

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

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

示例

- name: Create a GTM HTTP monitor
  bigip_gtm_monitor_http:
    name: my_monitor
    ip: 1.1.1.1
    port: 80
    send: my send string
    receive: my receive string
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Remove HTTP Monitor
  bigip_gtm_monitor_http:
    name: my_monitor
    state: absent
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Add HTTP monitor for all addresses, port 514
  bigip_gtm_monitor_http:
    name: my_monitor
    port: 514
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

返回值

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

键	描述
ignore_down_response 布尔值	是否忽略关闭响应。 返回：changed 示例： true
interval 整数	运行监控检查的新间隔。 返回：changed 示例： 2
ip 字符串	IP/端口定义的新 IP。 返回：changed 示例： "10.12.13.14"
parent 字符串	监控的新父模板。 返回：changed 示例： "http"
port 字符串	监控检查资源的新端口。 返回：changed 示例： "8080"
probe_timeout 整数	系统将超时监控探测的新超时时间。 返回：changed 示例： 10
receive 字符串	此监控的新接收字符串。 返回：changed 示例： "tcp string to receive"
reverse 布尔值	监控是否以反向模式运行的新值。 返回：changed 示例： false
send 字符串	此监控的新发送字符串。 返回：changed 示例： "tcp string to send"
timeout 整数	远程系统必须在多长时间内响应监控的新超时时间。 返回：changed 示例： 10
transparent 布尔值	监控是否以透明模式运行的新值。 返回：changed 示例： false

作者

• Tim Rupp (@caphrim007)

• Wojciech Wypior (@wojtek0806)

资源链接

• 问题追踪器
• 主页
• 代码库 (源码)