Zabbix Maintenance

5 min

Resumo

Crie janelas de manutenção do Zabbix.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
collect_data	boolean	Escolhas: - false - true (default)	Tipo de manutenção. Com ou sem coleta de dados.
desc	string	- "Created by Atmosphere" (default)	Breve descrição da janela de manutenção.
host_groups aliases: host_group	list / elements=string		Grupos de hosts para gerenciar a janela de manutenção. Opção necessária quando state = present e host_names não é usado.
host_names aliases: host_name	list / elements=string		Hosts para os quais gerenciar a janela de manutenção. Opção necessária quando state = present e host_groups não é usado.
start_date	string		Hora de inicio da manutenção. Exemplos: - 2022-03-10T16:00:00+03:00 - 2022-03-10 16:00:00 - 1579297506.846899 - 1579297506
end_date	string		Hora de término da manutenção. Exemplos: - 2022-03-10T16:00:00+03:00 - 2022-03-10 16:00:00 - 1579297506.846899 - 1579297506
minutes	integer	- 10 (default)	Duração da janela de manutenção em minutos.
name - required	string		Nome exclusivo da janela de manutenção.
state	string	Escolhas: - present (default) - absent	Crie ou remova uma janela de manutenção. A janela de manutenção a ser removida é identificada pelo nome.
timeout	integer	- 10 (default)	O tempo limite da solicitação da API (segundos).

Extende fragmentos da documentação do módulo zabbix.

Notas

Útil para configurar hosts no modo de manutenção antes de uma grande atualização, e remover a janela de manutenção após a atualização.
O módulo cria a janela de manutenção de now() a now() + minutos, então se o horário do servidor Zabbix e o horário do host não estiverem sincronizados, você obterá resultados estranhos.

Exemplos

# Exemplo: Criar uma janela de manutenção nomeada para o host www1 por 90 minutos
- zabbix_maintenance:
    name: Update of www1
    host_name: www1.example.com
    state: present
    minutes: 90
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD

# Exemplo: Criar uma janela de manutenção nomeada para o host www1 e os grupos de host Office e Dev
- zabbix_maintenance:
    name: Update of www1
    host_name: www1.example.com
    host_groups:
      - Office
      - Dev
    state: present
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD

# Exemplo: Criar uma janela de manutenção nomeada para hosts www1 e db1, sem coleta de dados.
- zabbix_maintenance:
    name: update
    host_names:
      - www1.example.com
      - db1.example.com
    state: present
    collect_data: False
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD

# Exemplo: Remover janela de manutenção por nome
- zabbix_maintenance:
    name: Test1
    state: absent
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD

# Exemplo: Criar uma janela de manutenção apenas com start_date (start_date + 10 minutos).
- zabbix_maintenance:
    name: Update of srv-zabbix
    host_name: srv-zabbix
    state: present
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD
    start_date: "2022-03-10T16:00:00+03:00"
  register: result

# Exemplo: Criar uma janela de manutenção com start_date e end_date.
- zabbix_maintenance:
    name: Update of srv-zabbix
    host_name: srv-zabbix
    state: present
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD
    start_date: "2022-03-10T16:00:00+03:00"
    end_date: "2022-03-10T20:00:00+03:00"
  register: result

# Exemplo: Criar uma janela de manutenção apenas com start_date e minutes.
- zabbix_maintenance:
    name: Update of srv-zabbix
    host_name: srv-zabbix
    state: present
    server_url: https://monitoring.example.com
    login_user: atmosphere
    login_password: pAsSwOrD
    start_date: "2022-03-10 16:00:00"
    minutes: 90
  register: result

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
changed	bool	Valor alterado	Indica se houve alteração no objeto.