韓誥傭痔

Table of Contents

8 Scripts

8 Scripts

Vis?o geral

Na se??o Administra??o ↙ Scripts scripts globais definidos pelo usu芍rio pode ser configurado e mantido.

Scripts globais, dependendo do escopo configurado e tamb谷m de permiss?es, est?o dispon赤veis para execu??o:

do host menu em v芍rios locais de frontend (Dashboard, Problems, Latest dados, Mapas, etc.)
do evento menu
pode ser executado como uma opera??o de a??o

Os scripts s?o executados no agente 韓誥傭痔, servidor 韓誥傭痔 (proxy) ou Apenas servidor 韓誥傭痔. Veja tamb谷m Comando execu??o.

Tanto no agente 韓誥傭痔 quanto nos scripts remotos do proxy 韓誥傭痔 s?o desabilitados por predefini??o. Eles podem ser habilitados por:

adicionando o par?metro AllowKey=system.run[*] no agente configura??o;
definindo o par?metro EnableRemoteCommands para '1' no proxy configura??o

Uma lista de scripts existentes com seus detalhes 谷 exibida.

Dados exibidos:

Coluna	Descri??o
Nome	Nome do script. Clicar no nome do script abre o script formul芍rio de configura??o.
Escopo	Escopo do script - opera??o de a??o, a??o manual do host ou a??o manual do evento. Essa configura??o determina onde o script est芍 dispon赤vel.
Usado em a??es	A??es onde o script 谷 usado s?o exibidas.
Tipo	O tipo de script 谷 exibido - comando Webhook, Script, SSH, Telnet ou IPMI.
Execute on	? exibido se o script ser芍 executado apenas no agente 韓誥傭痔, servidor 韓誥傭痔 (proxy) ou servidor 韓誥傭痔 apenas.
Comandos	Todos os comandos a serem executados dentro do script s?o exibidos.
Grupo de usu芍rios	O grupo de usu芍rios para o qual o script est芍 dispon赤vel 谷 exibido (ou Todos para todos os grupos de usu芍rios).
Grupo de hosts	O grupo de hosts para o qual o script est芍 dispon赤vel 谷 exibido (ou All para todos os grupos de hosts).
Acesso ao host	O n赤vel de permiss?o para o grupo de hosts 谷 exibido - Read ou Write. Somente usu芍rios com o n赤vel de permiss?o necess芍rio ter?o acesso 角 execu??o do script.

Para configurar um novo script, clique no bot?o Criar script na canto superior direito.

Op??es de edi??o em massa

Um bot?o abaixo da lista oferece uma op??o de edi??o em massa:

Excluir - exclui os scripts

Para usar esta op??o, marque as caixas de sele??o antes dos respectivos scripts e clique em Excluir.

Usando filtro

Voc那 pode usar o filtro para exibir apenas os scripts de seu interesse para um melhor desempenho de pesquisa, os dados s?o pesquisados com macros n?o resolvido.

O link Filter est芍 dispon赤vel acima da lista de scripts. Se voc那 clicar nele, fica dispon赤vel um filtro onde voc那 pode filtrar scripts por nome e escopo.

Configurando um script global

Atributos do script:

Par?metro		Descri??o
Nome		Nome exclusivo do script. Ex. `Limpar sistema de arquivos /tmp`
Escopo		Escopo do script - opera??o de a??o, a??o manual do host ou a??o manual do evento. Esta configura??o determina onde o script pode ser usado - em comandos remotos de opera??es de a??o, a partir do menu do host ou do menu do evento respectivamente. Definir o escopo para 'Opera??o de a??o' torna o script dispon赤vel para todos os usu芍rios com acesso a Configura??o ↙ A??es. Se um script for realmente usado em um a??o, seu escopo n?o pode ser alterado de 'opera??o de a??o'. Suporte a macro O escopo afeta o intervalo de macros dispon赤veis. Por exemplo, macros relacionadas ao usu芍rio ({USER.*}) s?o suportadas em scripts para permitir a transmiss?o de informa??es sobre o usu芍rio que iniciou o script. No entanto, eles n?o s?o compat赤veis se o escopo do script for uma opera??o de a??o, pois as opera??es de a??o s?o executadas automaticamente. Para descobrir quais macros s?o compat赤veis, fa?a uma pesquisa por 'Notifica??es e comandos baseados em acionador/Comandos baseados em acionador', 'Scripts de a??o de host manual' e 'Scripts de a??o de evento manual' na tabela macros com suporte. Observe que, se uma macro pode resolver um valor com espa?os (por exemplo, nome do host), n?o se esque?a de citar conforme necess芍rio.
Caminho do menu		O caminho do menu desejado para o script. Por exemplo, `Default` ou `Default/`, exibir芍 o script no respectivo diret車rio. Os menus podem ser aninhados, por exemplo. `Menu principal/Submenu1/Submenu2`. Ao acessar scripts atrav谷s do menu host/evento nas se??es de monitoramento, eles ser?o organizados de acordo com os diret車rios fornecidos. Este campo 谷 exibido apenas se 'A??o manual do host' ou 'A??o manual do evento' estiver selecionado como Escopo.
Type		Clique no respectivo bot?o para selecionar o tipo de script: Webhook, Script, SSH, Telnet ou IPMI comando.
	Tipo de script: Webhook
	Par?metros	Especifique as vari芍veis ??do webhook como pares atributo-valor. Veja tamb谷m: Webhook configura??o de m赤dia. Macros e macros de usu芍rio personalizados s?o suportados em valores de par?metro. O suporte a macro depende do escopo do script (consulte Escopo acima).
	Script	Insira o c車digo JavaScript no bloco que aparece ao clicar no campo de par?metro (ou no bot?o visualizar/editar pr車ximo a ele). O suporte a macro depende do escopo do script (consulte Escopo acima). Veja tamb谷m: configura??o de m赤dia Webhook, objetos Javascript adicionais.
	Timeout	Tempo limite de execu??o JavaScript (1-60s, padr?o 30s). Sufixos de tempo s?o suportados, por exemplo, 30s, 1m.
	Tipo de script: script
	Execute on	Clique no respectivo bot?o para executar o shell script em: Agente 韓誥傭痔 - o script ser芍 executado pelo agente 韓誥傭痔 (se o item system.run for permitido) no host servidor 韓誥傭痔 (proxy) - o script ser芍 executado pelo servidor 韓誥傭痔 ou proxy (se habilitado por EnableRemoteCommands) - dependendo se o host 谷 monitorado por servidor ou proxy 韓誥傭痔 server - o script ser芍 executado apenas pelo 韓誥傭痔 server
	Comandos	Digite o caminho completo para os comandos a serem executados dentro do script. O suporte a macro depende do escopo do script (veja Escopo acima). macros de usu芍rio personalizados s?o suportados.
	Tipo de script: SSH
	M谷todo de autentica??o	Selecione o m谷todo de autentica??o - senha ou chave p迆blica.
	Nome de usu芍rio	Digite o nome de usu芍rio.
	Senha	Digite a senha. Este campo estar芍 dispon赤vel se 'Senha' for selecionado como m谷todo de autentica??o.
	Arquivo de chave p迆blica	Digite o caminho para o arquivo de chave p迆blica. Este campo est芍 dispon赤vel se 'Chave p迆blica' for selecionado como m谷todo de autentica??o.
	Arquivo de chave privada	Digite o caminho para o arquivo de chave privada. Este campo est芍 dispon赤vel se 'Chave p迆blica' for selecionado como m谷todo de autentica??o.
	Passphrase	Insira a senha. Este campo est芍 dispon赤vel se 'Chave p迆blica' for selecionado como m谷todo de autentica??o.
	Porta	Digite a porta.
	Comandos	Insira os comandos. O suporte a macro depende do escopo do script (consulte Escopo acima). macros de usu芍rio personalizados s?o suportados.
	Tipo de script: Telnet
	Nome de usu芍rio	Digite o nome de usu芍rio.
	Senha	Digite a senha.
	Porta	Digite a porta
	Comandos	Insira os comandos. O suporte a macro depende do escopo do script (consulte Escopo acima). macros de usu芍rio personalizados s?o suportados.
	Tipo de script: IPMI
	Command	Insira o comando IPMI. O suporte a macro depende do escopo do script (consulte Escopo acima). macros de usu芍rio personalizados s?o suportados.
Descri??o		Digite uma descri??o para o script.
Grupo de hosts		Selecione o grupo de hosts para o qual o script estar芍 dispon赤vel (ou All para todos os grupos de hosts).
Grupo de usu芍rios		Selecione o grupo de usu芍rios para o qual o script estar芍 dispon赤vel (ou Todos para todos os grupos de usu芍rios). Este campo 谷 exibido apenas se 'A??o manual do host' ou ' A??o de evento manual' est芍 selecionada como Escopo.
Permiss?es de host necess芍rias		Selecione o n赤vel de permiss?o para o grupo de hosts - Read ou Write. Somente usu芍rios com o n赤vel de permiss?o necess芍rio ter?o acesso para executar o script. Este campo 谷 exibido apenas se 'A??o manual do host' ou 'A??o manual do evento' estiver selecionado como Escopo.
Ativar confirma??o		Marque a caixa de sele??o para exibir uma mensagem de confirma??o antes de executar o script. Esse recurso pode ser especialmente 迆til com opera??es potencialmente perigosas (como um script de reinicializa??o) ou que podem levar muito tempo. Esta op??o 谷 exibida apenas se 'A??o manual do host' ou 'A??o manual do evento' estiver selecionado como Escopo .
Texto de confirma??o		Insira um texto de confirma??o personalizado para o pop-up de confirma??o ativado com a caixa de sele??o acima (por exemplo, O sistema remoto ser芍 reinicializado. Tem certeza?). Para ver a apar那ncia do texto, clique em Confirma??o de teste ao lado do campo. As macros {HOST.} e {USER.} s?o compat赤veis. macros de usu芍rio personalizados s?o suportados. Observa??o: as macros n?o ser?o expandidas ao testar a mensagem de confirma??o. Este campo 谷 exibido apenas se 'A??o manual do host ' ou 'A??o de evento manual' est芍 selecionada como Escopo.

Execu??o e resultado do script

Os scripts executados pelo servidor 韓誥傭痔 s?o executados pela ordem descrita em Se??o Execu??o do comando incluindo a verifica??o do c車digo de sa赤da. O resultado do script ser芍 exibido em um janela pop-up que aparecer芍 ap車s a execu??o do script.

Nota: O valor de retorno do script 谷 a sa赤da padr?o junto com erro padr?o.

Veja um exemplo de script e a janela de resultados abaixo:

uname -v
       /tmp/non_existing_script.sh
       echo "Este script foi iniciado por {USER.USERNAME}"

O resultado do script n?o exibe o script em si.

Tempo limite do script

Agente 韓誥傭痔

Voc那 pode encontrar uma situa??o em que ocorre um tempo limite durante a execu??o de um roteiro.

Veja um exemplo de script rodando no agente 韓誥傭痔 e a janela de resultados abaixo:

dormir 5
       df -h

A mensagem de erro, neste caso, 谷 a seguinte:

Tempo limite durante a execu??o de um script de shell.

Para evitar tal situa??o, 谷 aconselh芍vel otimizar o script em si (em vez de ajustar o par?metro Timeout para um valor correspondente (no nosso caso, > '5') modificando o agente 韓誥傭痔 configura??o e servidor 韓誥傭痔 configura??o).

Caso ainda seja alterado o par?metro Timeout no agente 韓誥傭痔 configuration ap車s o erro mensagem aparece:

Falha ao obter valor do agente: ZBX_TCP_READ() expirou.

Significa que a modifica??o foi feita no agente 韓誥傭痔 configura??o e 谷 obrigat車rio para modificar a configura??o de tempo limite tamb谷m no servidor 韓誥傭痔 configura??o.

Servidor/proxy 韓誥傭痔

Veja um exemplo de script rodando no servidor 韓誥傭痔 e o resultado janela abaixo:

dormir 11
       df -h

Tamb谷m 谷 aconselh芍vel otimizar o pr車prio script (em vez de ajustar TrapperTimeout para um valor correspondente (no nosso caso, > '11') modificando o servidor 韓誥傭痔 configura??o).