8 Plugin MSSQL

Visão geral

O arquivo de configuração do Zabbix agent 2 é usado para configurar plugins. Estes parâmetros de configuração do Zabbix agent 2 são suportados para operar o plugin MSSQL.

Recomenda-se especificá-los em seu próprio arquivo de configuração (por exemplo, mssql.conf) e então usar a diretiva Include para adicionar esse arquivo à configuração do Zabbix agent 2.

O plugin MSSQL é um plugin carregável e está disponível e totalmente descrito no repositório do plugin MSSQL.

Observe que:

  • Os valores padrão refletem os padrões do processo, não os valores nos arquivos de configuração fornecidos.
  • Os valores suportam variáveis de ambiente;
  • O Zabbix suporta arquivos de configuração apenas em codificação UTF-8 sem BOM.
  • Comentários que começam com "#" são suportados apenas no início da linha.

Opções

Parâmetro Descrição
-V --version Imprime a versão do plugin e informações de licença.
-h --help Imprime informações de ajuda (abreviação).
-t, --test <item key> Inicia o plugin para teste (configuração do plugin ignorada).

Parâmetros

Parameter Mandatory Range Default Description
Plugins.MSSQL.CustomQueriesDir no /usr/local/share/zabbix/custom-queries/mssql para sistemas Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL para sistemas Windows, onde * é o nome da unidade da variável de ambiente ProgramFiles		 Especifica o caminho do arquivo para um diretório que contém arquivos .sql definidos pelo usuário com consultas personalizadas que o plugin pode executar. O plugin carrega todos os arquivos .sql disponíveis no diretório configurado na inicialização. Isso significa que quaisquer alterações nos arquivos de consulta personalizada não serão refletidas até que o plugin seja reiniciado. O plugin é iniciado e interrompido junto com o Zabbix agent 2.
Plugins.MSSQL.CustomQueriesEnabled no false Se definido, habilita a execução da chave de item mssql.custom.query. Se desabilitado, nenhuma consulta será carregada do caminho do diretório de consultas personalizadas.
Plugins.MSSQL.Default.CACertPath no O caminho de arquivo padrão para o certificado de chave pública da autoridade certificadora (CA) que emitiu o certificado do server MSSQL. O certificado deve estar no formato PEM.
Plugins.MSSQL.Default.Database no O nome padrão do banco de dados ao qual se conectar.
Plugins.MSSQL.Default.Encrypt no Especifica o tipo padrão de criptografia da conexão. Os valores possíveis são:
true - o envio de dados entre o plugin e o server é criptografado;
false - o envio de dados entre o plugin e o server não é criptografado além do pacote de login;
strict - o envio de dados entre o plugin e o server é criptografado de ponta a ponta usando TDS8;
disable - o envio de dados entre o plugin e o server não é criptografado.
Plugins.MSSQL.Default.HostNameInCertificate no O nome comum (CN) do certificado do server MSSQL por padrão.
Plugins.MSSQL.Default.Password no A senha a ser enviada para um server MSSQL protegido por padrão.
Plugins.MSSQL.Default.TLSMinVersion no A versão mínima do TLS a ser usada por padrão. Os valores possíveis são: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no Se o plugin deve confiar no certificado do server sem validá-lo por padrão. Valores possíveis: true, false.
Plugins.MSSQL.Default.Uri no sqlserver://localhost:1433 A URI padrão para conexão. O único esquema suportado é sqlserver://. Um esquema pode ser omitido. Credenciais incorporadas serão ignoradas.
Plugins.MSSQL.Default.User no O nome de usuário padrão a ser enviado para um server MSSQL protegido.
Plugins.MSSQL.KeepAlive no 60-900 300 O tempo máximo de espera (em segundos) antes que conexões do plugin não utilizadas sejam fechadas.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no O caminho de arquivo para o certificado de chave pública da autoridade certificadora (CA) que emitiu o certificado do server MSSQL para a sessão nomeada. O certificado deve estar no formato PEM.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.Database no O nome do banco de dados ao qual se conectar para a sessão nomeada.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt no Especifica o tipo de criptografia da conexão para a sessão nomeada. Os valores possíveis são:
true - o envio de dados entre o plugin e o server é criptografado;
false - o envio de dados entre o plugin e o server não é criptografado além do pacote de login;
strict - o envio de dados entre o plugin e o server é criptografado de ponta a ponta usando TDS8;
disable - o envio de dados entre o plugin e o server não é criptografado.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no O nome comum (CN) do certificado do server MSSQL para a sessão nomeada.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.Password no A senha a ser enviada para um server MSSQL protegido para a sessão nomeada.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no A versão mínima do TLS a ser usada para a sessão nomeada. Os valores possíveis são: 1.0, 1.1, 1.2, 1.3.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Se o plugin deve confiar no certificado do server sem validá-lo para a sessão nomeada. Valores possíveis: true, false.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 A URI para conexão, para a sessão nomeada. O único esquema suportado é sqlserver://. Um esquema pode ser omitido. Credenciais incorporadas serão ignoradas.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.Sessions.<SessionName>.User no O nome de usuário a ser enviado para um server MSSQL protegido para a sessão nomeada.
<SessionName> - defina o nome de uma sessão para uso em chaves de item.
Plugins.MSSQL.System.Path no Caminho para o executável do plugin MSSQL.
Configuração global para o plugin MSSQL. Aplicada a todas as conexões.
Exemplo de uso: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout A duração, em segundos, para aguardar uma resposta de um server ao se conectar pela primeira vez e em operações subsequentes na sessão.

Veja também: