Proxy
add_proxy_to_group
Add a proxy to a proxy group.
Requires a local address and port for active agent redirection if if the proxy does not have it set.
Examples
Add a proxy to a proxy group
Arguments
NAME_OR_ID
Name or ID of proxy to add.
Type: text
Required: ✅
PROXY_GROUP
Name or ID of proxy group to add proxy to.
Type: text
Required: ✅
LOCAL_ADDRESS
Address for active agents.
Type: text
Required: ✅
LOCAL_PORT
Address for active agents.
Type: text
Required: ✅
clear_host_proxy
Clear the proxy for one or more hosts.
Sets the hosts to be monitored by the Zabbix server instead of a proxy.
Arguments
HOSTNAME
Hostnames. Comma-separated Supports wildcards.
Type: text
Required: ✅
Options
--dryrun/--no-dryrun
Preview changes
Type: boolean (flag)
Default: False
load_balance_proxy_hosts
Spread hosts between multiple proxies.
Hosts are determined by the hosts monitored by the given proxies Hosts monitored by other proxies or not monitored at all are not affected.
Weighting for the load balancing is optional, and defaults to equal weights. Number of proxies must match number of weights if specified.
Examples
Load balance hosts evenly between two proxies
Place twice as many hosts on proxy1 as proxy2
Load balance hosts evenly between three proxies
Load balance hosts unevenly between three proxies
Arguments
<proxy1,proxy2,...>
Comma delimited list of proxies to share hosts between.
Type: text
Required: ✅
[weight1,weight2,...]
Weights for each proxy. Comma-separated. Defaults to equal weights.
Type: text
move_proxy_hosts
Move hosts from one proxy to another.
Examples
Move all hosts from one proxy to another
Move all hosts with names matching a regex pattern
Arguments
PROXY_SRC
Proxy to move hosts from.
Type: text
Required: ✅
PROXY_DST
Proxy to move hosts to.
Type: text
Required: ✅
Options
--filter
<HOST_FILTER>
Regex pattern of hosts to move.
Type: text
remove_proxy_from_group
Remove a proxy from a proxy group.
Arguments
NAME_OR_ID
Name or ID of proxy to remove.
Type: text
Required: ✅
show_proxies
Show all proxies.
Shows number of hosts for each proxy unless --hosts is passed in, in which case the hostnames of each host is displayed instead.
Arguments
NAME_OR_ID
Filter by proxy name or ID. Comma-separated. Supports wildcards.
Type: text
Options
--hosts
Show hostnames of each host.
Type: boolean (flag)
Default: False
show_proxy_group_hosts
Show all hosts in a proxy group.
Arguments
PROXYGROUP
Proxy group name or ID. Supports wildcards.
Type: text
Required: ✅
show_proxy_groups
Show all proxy groups and their proxies.
Optionally takes in a list of names or IDs to filter by.
Examples
Show all proxy groups
Show proxy groups with a specific proxy
Show proxy groups with either proxy1 or proxy2
Arguments
NAME_OR_ID
Filter by proxy name or ID. Comma-separated. Supports wildcards.
Type: text
Options
--proxy
<PROXIES>
Show only groups containing these proxies. Comma-separated.
Type: text
update_host_proxy
Assign hosts to a proxy.
Supports wildcards for both hosts and proxy names. If multiple proxies match the proxy name, the first match is used.
Arguments
HOSTNAME
Hostnames. Comma-separated Supports wildcards.
Type: text
Required: ✅
PROXY
Proxy name. Supports wildcards.
Type: text
Required: ✅
Options
--dryrun/--no-dryrun
Preview changes
Type: boolean (flag)
Default: False
update_hostgroup_proxy
Assign a proxy to all hosts in one or more host groups.
Arguments
HOSTGROUP
Host group(s). Comma-separated. Supports wildcards.
Type: text
Required: ✅
PROXY
Proxy to assign. Supports wildcards.
Type: text
Required: ✅
Options
--dryrun/--no-dryrun
Preview changes.
Type: boolean (flag)
Default: False
update_hostgroup_proxygroup
Assign a proxy group to all hosts in one or more host groups.
Arguments
HOSTGROUP
Host group(s). Comma-separated. Supports wildcards.
Type: text
Required: ✅
PROXYGROUP
Proxy group to assign. Supports wildcards.
Type: text
Required: ✅
Options
--dryrun/--no-dryrun
Preview changes.
Type: boolean (flag)
Default: False