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:loadablemodules

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pt:manual:config:items:loadablemodules [2015/11/18 12:24]
spaww
pt:manual:config:items:loadablemodules [2016/02/16 15:25] (current)
Line 113: Line 113:
 O cabeçalho mais importante para os módulos carregáveis é **include/​module.h**,​ que define as estruturas de dados. Outro cabeçalho útil é  **include/​sysinc.h**,​ que faz a inclusão dos cabeçalhos de sistema que serão necessários,​ que por sua vez auxilia o **include/​module.h** a funcionar adequadamente. O cabeçalho mais importante para os módulos carregáveis é **include/​module.h**,​ que define as estruturas de dados. Outro cabeçalho útil é  **include/​sysinc.h**,​ que faz a inclusão dos cabeçalhos de sistema que serão necessários,​ que por sua vez auxilia o **include/​module.h** a funcionar adequadamente.
  
-FIXME **This page is not fully translatedyetPlease help completing the translation.**\\ //(remove this paragraph once the translation is finished)//+Para que **include/​module.h** e **include/​sysinc.h** sejam incluídoso comando **./​configure** (sem parâmetros) deverá ser executado no diretório raiz dos fontes do ZabbixIsso irá criar o arquivo ​**include/config.h**, com as dependências do **include/sysinc.h**. ​(Se você tiver obtido o código fonte do Zabbix a partir do "​Subversion repository",​ o script **./configure** não existirá e o comando **./bootstrap.sh** deverá ser executado primeiro para gera-lo.)
  
-In order for include/​module.h and include/sysinc.h ​to be included, the **./configure** command (without arguments) should first be run in the root of Zabbix source tree. This will create **include/​config.h** filewhich include/​sysinc.h relies upon. (If you obtained Zabbix source code as a Subversion repository checkout, the ./​configure ​script ​does not exist yet and the **./​bootstrap.sh** command should first be run to generate it.)+Com esta informação em mente, tudo está pronto para criar o móduloO módulo deverá incluir **sysinc.h** ​**module.h**, e o script ​de criação se certificará que estes dois arquivos estão disponíveis no **path**. Veja o exemplo do módulo "​dummy"​ a seguir para maiores detalhes.
  
-With this information in mind, everything is ready for the module to be built. The module should include ​**sysinc.h** and **module.h**, and the build script should make sure that these two files are in the include path. See example "​dummy"​ module below for details.+Outro cabeçalho útil é o **include/log.h**, que define a função ​**zabbix_log()**, que poderá ser utilizada com o propósito de registro e debug.
  
-Another useful header is **include/​log.h**,​ which defines **zabbix_log()** function, which can be used for logging and debugging purposes. +=== - Parâmetros de configuração ​===
-=== - Configuration parameters ​===+
  
-Zabbix ​agentserver and proxy support two [[manual:​appendix:​config:​zabbix_server|parameters]] to deal with modules:+Zabbix ​AgentServer e Proxy suportam dois [[pt:manual:​appendix:​config:​zabbix_server|parâmetros]] para lidar com os módulos:
  
-  * LoadModulePath – full path to the location of loadable modules +  ​* **LoadModulePath** – caminho completo para a localização dos módulos carregáveis 
-  * LoadModule – module(s) to load at startup. The modules must be located in directory specified by LoadModulePath. ​It is allowed to include multiple LoadModule parameters.+  ​* **LoadModule** – módulo(s) para ser carregado durante ​inicialização. Os módulos deverão estar localizados no diretório definido em    **LoadModulePath**Também é permitida a inclusão de múltiplos módulos.
  
-For exampleto extend ​Zabbix ​agent we could add the following parameters:+Por exemplopara estender o Zabbix ​Agent nós podemos adicionar os parâmetros a seguir:
  
   LoadModulePath=/​usr/​local/​lib/​zabbix/​agent/​   LoadModulePath=/​usr/​local/​lib/​zabbix/​agent/​
Line 135: Line 134:
   LoadModule=dummy.so   LoadModule=dummy.so
  
-Upon agent startup it will load the mariadb.so, apache.so, kernel.so and dummy.so ​modules from the /​usr/​local/​lib/​zabbix/​agent ​directoryIt will fail if a module is missingin case of bad permissions or if a shared library is not a Zabbix ​module.+Quando o agente for inicializado ele irá carregar os módulos **mariadb.so, apache.so, kernel.so and dummy.so** a partir do diretório **/​usr/​local/​lib/​zabbix/​agent**Se um dos módulos estiver ausenteou não tiver com o permissionamento correto, ou não for um '​Módulo ​Zabbix' a carga do agente irá falhar.
  
-=== - Frontend configuration ​===+=== - Configuração na interface web ===
  
-Loadable modules are supported by Zabbix ​agentserver and proxyTherefore, item type in Zabbix frontend depends on where the module is loadedIf the module is loaded into the agentthen the item type should be "​Zabbix ​agent" ​or "​Zabbix ​agent (active)"​. ​If the module is loaded into server or proxythen the item type should be "Simple check".+Os módulos carregáveis são suportados pelo Zabbix ​AgentServer e ProxyPortantoo tipo do item depende de onde foi carregadoSe o módulo tiver sido carregado no agenteo tipo deverá ser "Agente ​Zabbix" ​ou "Agente ​Zabbix (ativo)"​. ​Se o módulo tiver sido carregado no Server ou Proxyo tipo do item deverá ser "Verificação simples".
  
-=== - Dummy module ​===+=== - Módulo ​Dummy ===
  
-Zabbix 2.2 includes a sample module written in languageThe module is located under src/​modules/​dummy:​+O código fonte do Zabbix 2.2 inclui um exemplo de módulo desenvolvido em C. O módulo está localizado em **src/​modules/​dummy**:
  
   [email protected]:​~trunk/​src/​modules/​dummy$ ls -l   [email protected]:​~trunk/​src/​modules/​dummy$ ls -l
Line 150: Line 149:
   -rw-rw-r-- 1 alex alex  245 Apr 24 17:54 README   -rw-rw-r-- 1 alex alex  245 Apr 24 17:54 README
  
-The module is well documented, it can be used as a template for your own modules.+O módulo é bem documentado e pode ser utilizado como um modelo para que você construa os seus próprios módulos.
  
-After ./​configure ​has been run in the root of Zabbix ​source tree as described abovejust run **make** ​in order to build **dummy.so**.+Após executar o **./configure** no diretório raiz dos fontes do Zabbix, ​conforme informado anteriormente,​ apenas execute o comando ​**make** ​para compilar o **dummy.so**.
  
 <code c> <code c>
Line 354: Line 353:
 </​code>​ </​code>​
  
-The module exports three new items:+Este módulo exporta três novos itens:
  
-  * ''​dummy.ping''​ - always returns ​'​1'​ +  * ''​dummy.ping''​ - sempre retorna ​'​1'​ 
-  * ''​dummy.echo[param1]''​ - returns the first parameter as it is, for example, ''​dummy.echo[ABC]'' ​will return ​ABC +  * ''​dummy.echo[param1]''​ - retorna o primeiro parâmetro que for informado, por exemplo, ''​dummy.echo[ABC]'' ​retornará: ​ABC 
-  * ''​dummy.random[param1,​ param2]''​ - returns a random number within the range of param1-param2, ​for example, ''​dummy.random[1,​1000000]''​+  * ''​dummy.random[param1,​ param2]''​ - retorna um número randômico dentro do range definido em param1-param2, ​por exemplo, ''​dummy.random[1,​1000000]''​
  
-=== - Limitations ​===+=== - Limitações ​===
  
-Support of loadable modules is implemented for the Unix platform onlyIt means that it does not work for Windows ​agents.+O suporte para módulos carregáveis foi implementado apenas na plataforma UNIXIsso significa que não irão funcionar em Agentes para Windows.
  
-In some cases a module may need to read module-related configuration parameters from //​zabbix_agentd.conf//​. ​It is not supported currently. If you need your module to use some configuration parameters you should probably implement parsing of module-specific configuration file.+Em alguns casos o módulo pode precisar ler parâmetros de configuração do //​zabbix_agentd.conf//​. ​Isso ainda não é fornecido pela API, se você precisar obter tais parâmetros você deverá implementar ​análise do arquivo de configurações.