Zabbix Mediatype

4 min

Resumo

Criar, atualizar e excluir tipos de mídia Zabbix.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
name - required	string		Nome do tipo de mídia.
state	string	Escolhas: - present (default) - absent	Estado desejado do tipo de mídia. Se (present), ele criará um tipo de mídia se ele não existir ou atualizará o tipo de mídia se os dados associados forem diferentes. Se (absent), ele removerá o tipo de mídia se ele existir.
type - required	string	Escolhas: - email - script - sms - jabber - ez_texting	Tipo do mediatype.
status	string	Escolhas: - enabled (default) - disabled	Se o tipo de mídia está habilitado ou não.
max_sessions	integer	- 1 (default)	O número máximo de alertas que podem ser processados em paralelo. O valor possível é 1 quando (type = sms) e 0-100 caso contrário.
max_attempts	integer	- 3 (default)	O número máximo de tentativas de enviar um alerta. O intervalo possível é 0-10.
attempt_interval	integer	- 10 (default)	O intervalo entre as novas tentativas. O intervalo possível é 0-60.
script_name	string		O nome do script executado. Obrigatório quando (type = script).
script_params	list / elements = string		Lista de parâmetros de script. Obrigatório quando (type = script).
gsm_modem	string		Nome do dispositivo serial do modem gsm. Obrigatório quando (type = sms).
username	string		Nome de usuário ou identificador do Jabber. Obrigatório quando (type = jabber) ou (type = ez_texting). Obrigatório quando (type = email) e (smtp_authentication = true).
password	string		Senha de autenticação. Obrigatório quando (type = jabber) ou (type = ez_texting). Obrigatório quando (type = email) e (smtp_authentication = true).
smtp_server	string	- 'localhost' (default)	Host do servidor SMTP. Obrigatório quando (type = email).
smtp_server_port	integer	- 25 (default)	Porta do servidor SMTP. Obrigatório quando (type = email).
smtp_helo	string	- 'localhost' (default)	SMTP HELO. Obrigatório quando (type = email).
smtp_email	string		Endereço de e-mail a partir do qual as notificações serão enviadas. Obrigatório quando (type = email).
smtp_authentication	boolean	Escolhas: - false (default) - true	Se a autenticação SMTP com nome de usuário e senha deve ser habilitada ou não. Se definido como (verdadeiro), (nome de usuário) e (senha) devem ser especificados.
smtp_security	string	Escolhas: - None - STARTTLS - SSL/TLS	Nível de segurança de conexão SMTP a ser usado.
smtp_verify_host	boolean	Escolhas: - false (default) - true	SSL verifica o host para SMTP. Pode ser especificado quando (smtp_security = STARTTLS) ou (smtp_security = SSL / TLS).
smtp_verify_peer	boolean	Escolhas: - false (default) - true	SSL verifica par para SMTP. Pode ser especificado quando (smtp_security = STARTTLS) ou (smtp_security = SSL / TLS).
message_text_limit	string	Escolhas: - USA - Canada	O limite do texto da mensagem. Obrigatório quando (type = ez_texting). 160 caracteres para os EUA e 136 caracteres para o Canadá.

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

Exemplos

# Exemplo: Criar um tipo de mídia de e-mail com autenticação SMTP
- zabbix_mediatype:
    name: "Ops email"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'email'
    smtp_server: 'example.com'
    smtp_server_port: 2000
    smtp_email: '[email protected]'
    smtp_authentication: true
    username: 'smtp_user'
    password: 'smtp_pass'

# Exemplo: Criar um tipo de mídia de script
- zabbix_mediatype:
    name: "my script"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'script'
    script_name: 'my_script.py'
    script_params:
      - 'arg1'
      - 'arg2'

# Exemplo: Criar um tipo de mídia jabber
- zabbix_mediatype:
    name: "My jabber"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'jabber'
    username: 'jabber_id'
    password: 'jabber_pass'

# Exemplo: Criar um tipo de mídia SMS
- zabbix_mediatype:
    name: "My SMS Mediatype"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'sms'
    gsm_modem: '/dev/ttyS0'

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
changed	bool	Valor alterado	Indica se houve alteração no objeto.
result	string	Sucesso	Mensagem contendo mediatypes que tiveram alteração.
diff	dict	Sucesso	Diferenças entre o mediatype inicial e pós alteração.