Table of Contents
8 Plugin MSSQL
Visão geral
O arquivo de configuração do Zabbix agent 2 é usado para configurar plugins. Esses 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, em seguida, 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 iniciados com "#" são suportados apenas no início da linha.
Opções
| Parâmetro | Descrição |
|---|---|
| -V --version | Exibe a versão do plugin e informações de licença. |
| -h --help | Exibe informações de ajuda (forma abreviada). |
| -t, --test <item key> | Executa o plugin para teste (configuração do plugin ignorada). |
Parâmetros
| Parâmetro | Obrigatório | Intervalo | Padrão | Descrição |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | não | /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 contendo 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 parado junto com o Zabbix agent 2. | |
| Plugins.MSSQL.CustomQueriesEnabled | não | 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 | não | O caminho padrão do arquivo para o certificado de chave pública da autoridade certificadora (CA) que emitiu o certificado do servidor MSSQL. O certificado deve estar no formato PEM. | ||
| Plugins.MSSQL.Default.Database | não | O nome do banco de dados padrão para conectar. | ||
| Plugins.MSSQL.Default.Encrypt | não | Especifica o tipo de criptografia de conexão padrão. Os valores possíveis são: true - o envio de dados entre o plugin e o servidor é criptografado; false - o envio de dados entre o plugin e o servidor não é criptografado além do pacote de login; strict - o envio de dados entre o plugin e o servidor é criptografado E2E usando TDS8; disable - o envio de dados entre o plugin e o servidor não é criptografado. |
||
| Plugins.MSSQL.Default.HostNameInCertificate | não | O nome comum (CN) do certificado do servidor MSSQL por padrão. | ||
| Plugins.MSSQL.Default.Password | não | A senha a ser enviada para um servidor MSSQL protegido por padrão. | ||
| Plugins.MSSQL.Default.TLSMinVersion | não | 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 | não | Se o plugin deve confiar no certificado do servidor sem validá-lo por padrão. Valores possíveis: true, false. |
||
| Plugins.MSSQL.Default.Uri | não | sqlserver://localhost:1433 | O URI padrão para conectar. O único esquema suportado é sqlserver://. Um esquema pode ser omitido. Credenciais embutidas serão ignoradas. |
|
| Plugins.MSSQL.Default.User | não | O nome de usuário padrão a ser enviado para um servidor MSSQL protegido. | ||
| Plugins.MSSQL.KeepAlive | não | 60-900 | 300 | O tempo máximo de espera (em segundos) antes que conexões de plugin não utilizadas sejam fechadas. |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | não | O caminho do arquivo para o certificado de chave pública da autoridade certificadora (CA) que emitiu o certificado do servidor MSSQL para a sessão nomeada. O certificado deve estar no formato PEM. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | não | O nome do banco de dados para conectar para a sessão nomeada. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | não | Especifica o tipo de criptografia de conexão para a sessão nomeada. Os valores possíveis são: true - o envio de dados entre o plugin e o servidor é criptografado; false - o envio de dados entre o plugin e o servidor não é criptografado além do pacote de login; strict - o envio de dados entre o plugin e o servidor é criptografado E2E usando TDS8; disable - o envio de dados entre o plugin e o servidor não é criptografado. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | não | O nome comum (CN) do certificado do servidor MSSQL para a sessão nomeada. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | não | A senha a ser enviada para um servidor MSSQL protegido para a sessão nomeada. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | não | 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> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | não | Se o plugin deve confiar no certificado do servidor sem validá-lo para a sessão nomeada. Valores possíveis: true, false.<SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | não | sqlserver://localhost:1433 | O URI para conectar, para a sessão nomeada. O único esquema suportado é sqlserver://. Um esquema pode ser omitido. Credenciais embutidas serão ignoradas.<SessionName> - define o nome de uma sessão para uso nas chaves de item. |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | não | O nome de usuário a ser enviado para um servidor MSSQL protegido para a sessão nomeada. <SessionName> - define o nome de uma sessão para uso nas chaves de item. |
||
| Plugins.MSSQL.System.Path | não | 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 | não | 1-30 | timeout global | A duração, em segundos, para aguardar uma resposta do servidor ao conectar pela primeira vez e em operações subsequentes na sessão. |
Veja também:
- Descrição dos parâmetros gerais de configuração do Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instruções para configurar plugins