Zabbix Host

5 min

Resumo

Criar, atualizar e excluir hosts Zabbix.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
host_name - required	string		Nome do host no Zabbix. (host_name) é o identificador exclusivo usado e não pode ser atualizado usando este módulo.
visible_name	string		Nome visível do host no Zabbix.
description	string		Descrição do host no Zabbix.
host_groups	list / elements = string		Lista de grupos de hosts dos quais o host faz parte.
link_templates	list / elements = string		Lista de modelos vinculados ao host.
inventory_mode	string	Escolhas: - automatic - manual - disabled	Configure o modo de inventário.
inventory_zabbix	dictionary		Adicione fatos para um inventário zabbix (por exemplo, Tag). Reveja a documentação da interface para obter mais informações sobre as propriedades suportadas (https://www.zabbix.com/documentation/3.2/manual/api/reference/host/object#host_inventory)
status	string	Escolhas: - enabled (default) - disabled	Monitorando o status do host.
state	string	Escolhas: - present (default) - absent	Estado do host. Em (present), ele criará se o host não existir ou atualizará o host se os dados associados forem diferentes. Em (absent) irá remover um host se ele existir.
proxy	string		O nome do proxy Zabbix a ser usado.
interfaces (Possíveis valores)	list / elements = dictionary	- [] (default)	Lista de interfaces a serem criadas para o host. Para obter mais informações, analise a documentação da interface do host em (https://www.zabbix.com/documentation/4.0/manual/api/reference/hostinterface/object).
tls_connect	integer	- 1 (default)	Especifica qual criptografia usar para conexões de saída. Valores possíveis, 1 (sem criptografia), 2 (PSK), 4 (certificado). Funciona apenas com Zabbix >= 3.0.
tls_accept	integer	- 1 (default)	Especifica quais tipos de conexões são permitidas para conexões de entrada. O parâmetro tls_accept aceita valores de 1 a 7. Valores possíveis, 1 (sem criptografia), 2 (PSK), 4 (certificado). Os valores podem ser combinados. Funciona apenas com Zabbix >= 3.0.
tls_psk_identity	string		É um nome único pelo qual este PSK específico é referido pelos componentes do Zabbix. Não coloque informações confidenciais na string de identidade PSK, elas são transmitidas pela rede sem criptografia. Funciona apenas com Zabbix >= 3.0.
tls_psk	string		O valor PSK é uma string de dígitos hexadecimais difícil de adivinhar. A chave pré-compartilhada, pelo menos 32 dígitos hexadecimais. Obrigatório se (tls_connect) ou (tls_accept) tiver PSK ativado. Funciona apenas com Zabbix >= 3.0.
ca_cert aliases: tls_issuer	string		Emissor de certificado necessário. Funciona apenas com Zabbix >= 3.0.
tls_subject	string		Assunto do certificado necessário. Funciona apenas com Zabbix >= 3.0.
ipmi_authtype	integer		Algoritmo de autenticação IPMI. Reveja a documentação do objeto Host para obter mais informações sobre as propriedades suportadas https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object. Os valores possíveis são, C (0) (nenhum), C (1) (MD2), C (2) (MD5), C (4) (direto), C (5) (OEM), C (6) (RMCP +), com C (1) sendo o padrão da API .
ipmi_privilege	integer		Nível de privilégio IPMI. Reveja a documentação do objeto Host para obter mais informações sobre as propriedades suportadas https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object. Os valores possíveis são C (1) (retorno de chamada ), C (2) (usuário), C (3) (operador), C (4) (admin), C (5) (OEM), com C (2) sendo o padrão da API.
ipmi_username	string		Nome de usuário IPMI. Veja também a última nota na documentação (ipmi_authtype)
ipmi_password	string		Senha IPMI. Veja também a última nota na documentação (ipmi_authtype)
force	boolean	Escolhas: - false - true (default)	Substitua a configuração do host, mesmo se já estiver presente.

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

Subcampos da opção interfaces

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
type - required	string	Escolhas: - 'agent' - 'snmp' - 'ipmi' - 'jmx'	Tipo de interface a ser adicionado - Valores numéricos também são aceitos para o tipo de interface: - 1 = agent - 2 = snmp - 3 = ipmi - 4 = jmx
main	integer	Escolhas: - 0 (default) - 1	Se a interface é usada como padrão. Se várias interfaces com o mesmo tipo forem fornecidas, apenas uma pode ser o padrão. 0 (não padrão), 1 (padrão).
useip	integer	Escolhas: - 0 (default) - 1	Conecte-se à interface do host com o endereço IP em vez do nome DNS. 0 (não usa ip), 1 (usa ip).
ip	string	- ' ' (default)	Endereço IP usado pela interface do host. Obrigatório se eu (useip = 1).
dns	string	- ' ' (default)	Nome DNS da interface do host. Obrigatório se eu (useip = 0).
port	string		Porta usada pela interface do host. Se não for especificado, a porta padrão para cada tipo de interface é usada: - 10050 se (type = 'agent') - 161 se (type = 'snmp') - 623 se (type = 'ipmi') - 12345 se (type = ' jmx ')
bulk	integer	Escolhas: - 0 - 1 (default)	Se deve usar solicitações SNMP em massa. 0 (não use solicitações em massa), 1 (use solicitações em massa).

Exemplos

# Exemplo: Criar um novo host ou atualize as informações de um host existente
- zabbix_host:
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    description: My ExampleHost Description
    host_groups:
      - Example group1
      - Example group2
    link_templates:
      - Example template1
      - Example template2
    status: enabled
    state: present
    inventory_mode: manual
    inventory_zabbix:
      tag: "{{ your_tag }}"
      alias: "{{ your_alias }}"
      notes: "Special Informations: {{ your_informations | default('None') }}"
      location: "{{ your_location }}"
      site_rack: "{{ your_site_rack }}"
      os: "{{ your_os }}"
      hardware: "{{ your_hardware }}"
    ipmi_authtype: 2
    ipmi_privilege: 4
    ipmi_username: username
    ipmi_password: password
    interfaces:
      - type: 1
        main: 1
        useip: 1
        ip: 10.xx.xx.xx
        dns: ""
        port: 10050
      - type: 4
        main: 1
        useip: 1
        ip: 10.xx.xx.xx
        dns: ""
        port: 12345
    proxy: a.zabbix.proxy


# Exemplo: Atualizar as configurações de TLS de um host existente
- zabbix_host:
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    host_groups:
      - Example group1
    tls_psk_identity: test
    tls_connect: 2
    tls_psk: 123456789abcdef123456789abcdef12

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
changed	bool	Valor alterado	Indica se houve alteração no objeto.
result	string	Sucesso	Mensagem contendo os hosts que tiveram alteração.