community.general.oneandone_monitoring_policy 模块 – 配置 1&1 监控策略

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，有关详细信息，请参见 要求。

要在剧本中使用它，请指定： community.general.oneandone_monitoring_policy。

概要

• 创建、删除、更新监控策略（以及添加/删除端口、进程和服务器）。此模块依赖于 1and1 >= 1.0。

要求

执行此模块的主机需要以下要求。

• 1and1

参数

参数	注释
add_ports 列表 / 元素=字典	要添加到监控策略的端口。 默认值： []
add_processes 列表 / 元素=字典	要添加到监控策略的进程。 默认值： []
add_servers 列表 / 元素=字符串	要添加到监控策略的服务器。 默认值： []
agent 字符串	设置为 true 以使用代理。
api_url 字符串	自定义 API URL。覆盖 ONEANDONE_API_URL 环境变量。
auth_token 字符串	1&1 提供的用于身份验证的 API 令牌。
description 字符串	监控策略描述。maxLength=256
email 字符串	用户的电子邮件。maxLength=128
monitoring_policy 字符串	与 update 状态一起使用的监控策略标识符（id 或名称）。
name 字符串	与 present 状态一起使用的监控策略名称。与 absent 状态一起使用时用作标识符（id 或名称）。maxLength=128
ports 列表 / 元素=字典	将要监控的端口数组。 默认值： []
alert_if 字符串 / 必需	警报情况。 选项 "RESPONDING" "NOT_RESPONDING"
email_notification 字符串 / 必需	设置为 true 以发送电子邮件通知。
port 字符串 / 必需	端口号。minimum=1, maximum=65535
protocol 字符串 / 必需	互联网协议。 选项 "TCP" "UDP"
processes 列表 / 元素=字典	将要监控的进程数组。 默认值： []
alert_if 字符串 / 必需	警报情况。 选项 "RUNNING" "NOT_RUNNING"
process 字符串 / 必需	进程名称。maxLength=50
remove_ports 列表 / 元素=字符串	要从监控策略中删除的端口。 默认值： []
remove_processes 列表 / 元素=字符串	要从监控策略中删除的进程。 默认值： []
remove_servers 列表 / 元素=字符串	要从监控策略中删除的服务器。 默认值： []
state 字符串	定义监控策略的状态以创建、删除、更新。 选项 "present" ← (默认) "absent" "update"
thresholds 列表 / 元素=字典	监控策略阈值。每个子选项都有 warning 和 critical，两者都具有 alert 和 value 子选项。Warning 用于设置警告警报的限制，critical 用于设置严重警报。alert 启用警报，value 用于在超过值时发出建议。 默认值： []
cpu 字符串 / 必需	CPU 的使用限制。
disk 字符串 / 必需	硬盘的使用限制。
internal_ping 字符串 / 必需	内部 ping 的响应限制。
ram 字符串 / 必需	RAM 的使用限制。
transfer 字符串 / 必需	传输的消耗限制。
update_ports 列表 / 元素=字典	要在监控策略上更新的端口。 默认值： []
update_processes 列表 / 元素=字典	要在监控策略上更新的进程。 默认值： []
wait 布尔值	等待实例处于 'running' 状态后才返回 选项 false true ← (默认)
wait_interval 整数	定义使用 _wait_for 方法时要等待的秒数 默认值： 5
wait_timeout 整数	等待放弃之前的时长（秒） 默认值： 600

属性

属性	支持	描述
check_mode	支持：完全支持	可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在 diff 模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Create a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    name: ansible monitoring policy
    description: Testing creation of a monitoring policy with ansible
    email: [email protected]
    agent: true
    thresholds:
     -
       cpu:
         warning:
           value: 80
           alert: false
         critical:
           value: 92
           alert: false
     -
       ram:
         warning:
           value: 80
           alert: false
         critical:
           value: 90
           alert: false
     -
       disk:
         warning:
           value: 80
           alert: false
         critical:
           value: 90
           alert: false
     -
       internal_ping:
         warning:
           value: 50
           alert: false
         critical:
           value: 100
           alert: false
     -
       transfer:
         warning:
           value: 1000
           alert: false
         critical:
           value: 2000
           alert: false
    ports:
     -
       protocol: TCP
       port: 22
       alert_if: RESPONDING
       email_notification: false
    processes:
     -
       process: test
       alert_if: NOT_RUNNING
       email_notification: false
    wait: true

- name: Destroy a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    state: absent
    name: ansible monitoring policy

- name: Update a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy
    name: ansible monitoring policy updated
    description: Testing creation of a monitoring policy with ansible updated
    email: [email protected]
    thresholds:
     -
       cpu:
         warning:
           value: 70
           alert: false
         critical:
           value: 90
           alert: false
     -
       ram:
         warning:
           value: 70
           alert: false
         critical:
           value: 80
           alert: false
     -
       disk:
         warning:
           value: 70
           alert: false
         critical:
           value: 80
           alert: false
     -
       internal_ping:
         warning:
           value: 60
           alert: false
         critical:
           value: 90
           alert: false
     -
       transfer:
         warning:
           value: 900
           alert: false
         critical:
           value: 1900
           alert: false
    wait: true
    state: update

- name: Add a port to a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    add_ports:
     -
       protocol: TCP
       port: 33
       alert_if: RESPONDING
       email_notification: false
    wait: true
    state: update

- name: Update existing ports of a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    update_ports:
     -
       id: existing_port_id
       protocol: TCP
       port: 34
       alert_if: RESPONDING
       email_notification: false
     -
       id: existing_port_id
       protocol: TCP
       port: 23
       alert_if: RESPONDING
       email_notification: false
    wait: true
    state: update

- name: Remove a port from a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    remove_ports:
     - port_id
    state: update

- name: Add a process to a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    add_processes:
     -
       process: test_2
       alert_if: NOT_RUNNING
       email_notification: false
    wait: true
    state: update

- name: Update existing processes of a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    update_processes:
     -
       id: process_id
       process: test_1
       alert_if: NOT_RUNNING
       email_notification: false
     -
       id: process_id
       process: test_3
       alert_if: NOT_RUNNING
       email_notification: false
    wait: true
    state: update

- name: Remove a process from a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    remove_processes:
     - process_id
    wait: true
    state: update

- name: Add server to a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    add_servers:
     - server id or name
    wait: true
    state: update

- name: Remove server from a monitoring policy
  community.general.oneandone_monitoring_policy:
    auth_token: oneandone_private_api_key
    monitoring_policy: ansible monitoring policy updated
    remove_servers:
     - server01
    wait: true
    state: update

返回值

常见的返回值在此处有说明 此处，以下是此模块独有的字段

键	描述
monitoring_policy 字典	有关已处理的监控策略的信息 返回值： 始终 示例： {"id": "92B74394A397ECC3359825C1656D67A6", "name": "Default Policy"}

作者

• Amel Ajdinovic (@aajdinov)

• Ethan Devenport (@edevenport)

资源链接

• 问题追踪器
• 代码仓库
• 寻求帮助
• 提交错误报告
• 功能请求
• 通讯