[comment]: # ({ffe98fbd-ffe98fbd})
# 1 Estendendo os agents do Zabbix

Este tutorial fornece instruções passo a passo sobre como estender a
funcionalidade do agent do Zabbix com o uso de um [parâmetro de usuário](/manual/config/items/userparameters).

[comment]: # ({/ffe98fbd-ffe98fbd})

[comment]: # ({8f2323c0-8f2323c0})
##### Passo 1

Escreva um script ou linha de comando para recuperar o parâmetro necessário.

Por exemplo, podemos escrever o seguinte comando para obter o número total de consultas executadas por um servidor MySQL:

    mysqladmin -uroot status | cut -f4 -d":" | cut -f1 -d"S"

Quando executado, o comando retorna o número total de consultas SQL.

[comment]: # ({/8f2323c0-8f2323c0})

[comment]: # ({6117d271-6117d271})
##### Passo 2

Adicione o comando ao zabbix\_agentd.conf:

    UserParameter=mysql.questions,mysqladmin -uroot status | cut -f4 -d":" | cut -f1 -d"S"

**mysql.questions** é um identificador único. Pode ser qualquer identificador de chave válido, por exemplo, *queries*.

Teste este parâmetro usando o agent do Zabbix com a opção "-t" (se estiver executando como root, no entanto, observe que o agent pode ter permissões diferentes quando iniciado como daemon):

    zabbix_agentd -t mysql.questions

[comment]: # ({/6117d271-6117d271})

[comment]: # ({67b38df5-67b38df5})
##### Passo 3

Recarregue os parâmetros do usuário a partir do arquivo de configuração executando:

    zabbix_agentd -R userparameter_reload

Você também pode reiniciar o agent em vez do comando de controle em tempo de execução.

Teste o parâmetro usando o utilitário [zabbix\_get](/manual/concepts/get).

[comment]: # ({/67b38df5-67b38df5})

[comment]: # ({4a46fd71-4a46fd71})
##### Passo 4

Adicione um novo item com a Chave=mysql.questions ao host monitorado. O tipo do item deve ser Zabbix Agent ou Zabbix Agent (active).

Esteja ciente de que o tipo de valores retornados deve ser definido corretamente no Zabbix server. Caso contrário, o Zabbix não os aceitará.

[comment]: # ({/4a46fd71-4a46fd71})