Zabbix Documentation 3.2

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


pt:manual:config:items:userparameters

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
pt:manual:config:items:userparameters [2015/11/17 22:29]
spaww created
pt:manual:config:items:userparameters [2016/02/16 15:25] (current)
Line 11: Line 11:
   UserParameter=<​key>,<​command>​   UserParameter=<​key>,<​command>​
  
-FIXME **This page is not fully translatedyetPlease help completing the translation.**\\ //(remove this paragraph once the translation is finished)//+Como você deve ter percebidoum 'User Parameter'​ também contêm uma chaveEsta chave é o identificador único da nova funcionalidade e será necessária quando você for configurar o item. Você pode definir o nome que preferir. Uma vez que tenha terminado os ajustes no arquivo de configurações do Zabbix Agent, será necessário o reinicio do processo do agente para que as novas configurações estejam acessíveis.
  
-As you can seea user parameter also contains a key. The key will be necessary when configuring an item. Enter a key of your choice that will be easy to reference (it must be unique within a host). Restart the agent.+Logoquando configurar o [[item|item]], informe o nome de chave definido no 'User Parameter'​ para que o Zabbix saiba o que coletar.
  
-Then, when [[item|configuring an item]], enter the key to reference the command from the user parameter you want executed.+Os parâmetros de usuário são executados pelo Zabbix Agent. O limite de tamanho do dado retornado é de 512KB. **/bin/sh** será utilizado como interpretador de comando em ambientes UNIX. Os parâmetros de usuário respeitam o parâmetro de '​timeout'​ do agente; se o timeout for alcançado o processo iniciado pelo 'User Parameter'​ será terminado.
  
-User parameters are commands executed by Zabbix agent. Up to 512KB of data can be returned. **/bin/sh** is used as command line interpreter under UNIX operating systems. User parameters obey the agent check timeout; if timeout is reached the forked user parameter process is terminated.+Consulte também um [[pt:​manual:​config:​items:​userparameters:​extending_agent|tutorial passo-a-passo]] sobre como usar os parâmetros de usuário.
  
-See also a [[manual:​config:​items:​userparameters:​extending_agent|step-by-step tutorial]] on making use of user parameters.+== Exemplos de parâmetros de usuário simples ==
  
-== Examples of simple user parameters == +Um simples comendo:
- +
-A simple command:+
  
   UserParameter=ping,​echo 1   UserParameter=ping,​echo 1
  
-The agent will always return ​'​1' ​for an item with '​ping' ​key.+O agente sempre irá retornar o valor '​1'​para um item com a chave '​ping'​.
  
-A more complex example:+Um comando mais complexo:
  
   UserParameter=mysql.ping,​mysqladmin -uroot ping|grep -c alive   UserParameter=mysql.ping,​mysqladmin -uroot ping|grep -c alive
  
-The agent will return ​'​1', ​if MySQL server ​is alive, ​'​0' ​- otherwise.+O agente irá retornar ​'​1', ​se o MySQL server ​estiver em execução ou '​0' ​caso não esteja.
  
-=== Flexible user parameters ​===+=== Parâmetros de usuário flexíveis ​===
  
-Flexible user parameters accept parameters with the keyThis way a flexible user parameter can be the basis for creating several items.+Os parâmetros de usuário flexíveis aceitam parâmetros em suas chavesDesta forma um mesmo 'User Parameter'​ poderá ser chamado por vários itens no mesmo host, bastando para isso que os seus parâmetros sejam diferentes.
  
-Flexible user parameters have the following syntax:+Os parâmetros de usuário flexíveis tem a seguinte sintaxe:
  
   UserParameter=key[*],​command   UserParameter=key[*],​command
  
-^Parameter^Description+^Parâmetro^Descrição
-|**Key**|Unique ​item keyThe [*] defines that this key accepts parameters within the brackets.\\ Parameters are given when configuring the item.  | +|**Key**|Chave única do item. O "[*]" define que este parâmetro de usuário aceitará parâmetros entre colchetes.\\ Os parâmetros serão informados ao configurar os itens.  | 
-|**Command**|Command to be executed to evaluate value of the key.\\ Use positional references ​$1…$9 ​to refer to the respective parameter in the item key.\\ Zabbix ​parses the parameters enclosed in [ ] of the item key and substitutes ​$1,...,$9 in the command accordingly.\\ $0 will be substituted by the original command (prior to expansion of $0,​...,​$9) ​to be run.  |+|**Command**|Comando a ser executado quando a chave for necessária.\\ Utilize referências posicionais ​$1…$9 ​para utilizar os parâmetros da chave.\\ Zabbix ​analisa os parâmetros entre "[ ]" da chave do item e os substitui no formato do shell ($1,​...,​$9). ​ |
  
-<note tip>To use positional references unalteredspecify double dollar sign for example, awk '​{print $$2}'​. ​In this case ''​$$2'' ​will actually turn into ''​$2'' ​when executing the command.\\ \\ Note that positional references with the sign are interpreted by Zabbix ​agent regardless of whether they are enclosed between double ​("​) ​or single ​('​) ​quotes.</​note>​+<note tip>Para utilizar as referências posicionais de forma inalteradautilize o símbolo de dolar duplo por exemplo, awk '​{print $$2}'​. ​Neste caso o ''​$$2'' ​irá se transformar em ''​$2'' ​quando o comando for executado.\\ \\ Observe que as referências posicionais com o símbolo "$" serão interpretadas pelo Zabbix ​Agent, independentemente de estarem entre aspas duplo ("​) ​ou simples ​('​).</​note>​
  
-<note important>​Certain symbols are not allowed in user parameters by defaultSee [[manual:​appendix:​config:​zabbix_agentd|UnsafeUserParameters]] documentation for a full list.</​note>​+<note important>​Alguns símbolos não são permitidos nos parâmetros de usuário por padrãoVeja o manual de  ​[[pt:manual:​appendix:​config:​zabbix_agentd|parâmetros inseguros]] para uma lista completa.</​note>​
  
-== Example ​1 ==+== Exemplo ​1 ==
  
-Something very simple:+Algo muito simples:
  
   UserParameter=ping[*],​echo $1   UserParameter=ping[*],​echo $1
  
-We may define unlimited number of items for monitoring all having format ​ping[something].  +Podemos definir um número ilimitado de itens para monitorar com o formato 'ping[something]'.  
-  * ping[0] - will always return ​'​0'​ +  * ping[0] - sempre retornará ​'​0'​ 
-  * ping[aaa] - will always return ​'​aaa'​+  * ping[aaa] - sempre retornara ​'​aaa'​
  
-== Example ​2 ==+== Exemplo ​2 ==
  
-Let's add more sense!+Vamos fazer algo mais útil!
  
   UserParameter=mysql.ping[*],​mysqladmin -u$1 -p$2 ping | grep -c alive   UserParameter=mysql.ping[*],​mysqladmin -u$1 -p$2 ping | grep -c alive
  
-This parameter can be used for monitoring availability of MySQL databaseWe can pass user name and password:+Este parâmetro pode ser utilizado para verificar a disponibilidade de um BD MySQL. ​Nós podemos informar ainda um usuário e senha:
  
   mysql.ping[zabbix,​our_password]   mysql.ping[zabbix,​our_password]
  
-== Example ​3 ==+== Exemplo ​3 ==
  
-How many lines matching ​a regular ​expression in a file?+Quantas linhas correspondem ​determinada expressão ​regular ​em um arquivo?
  
   UserParameter=wc[*],​grep -c "​$2"​ $1   UserParameter=wc[*],​grep -c "​$2"​ $1
  
-This parameter can be used to calculate number of lines in file.+Este parâmetro pode ser utilizado para calcular ​quantidade de linhas em um arquivo.
  
   wc[/​etc/​passwd,​root]   wc[/​etc/​passwd,​root]
   wc[/​etc/​services,​zabbix]   wc[/​etc/​services,​zabbix]
  
-=== Command result ​===+=== Resultado do comando ​===
  
-The return value of the command is standard ​output ​together with standard error.+O valor de retorno do comando será o output ​padrão junto com as mensagens de erro.
  
-<note important>​A text (character, log or text type of informationitem will not become unsupported in case of standard error output.</​note>​+<note important>​Um item de texto (tipo de dado de caractere, log ou textoficará como 'não suportado'​ caso de retorno de erro no output ​padrão.</​note>​
  
-User parameters that return text (character, log, text type of information) can return whitespaceIn case of invalid result ​item will become unsupported.+Parâmetros de usuário que retornam textos poderão retornar caracteres em brancoNo caso de um resultado inválido o item passa a ser não suportado.