Table of Contents
8 MSSQL 插件
概述
本节列出了 MSSQL Zabbix Agent 2 插件配置文件 (mssql.conf) 中支持的参数。
MSSQL 插件是一个可加载插件，详情请参见 MSSQL 插件仓库。
请注意：
- 默认值反映的是进程默认值，而不是随附配置文件中的值；
- Zabbix 只支持 UTF-8 编码且不带 BOM 的配置文件；
- 以“#”开头的注释仅在行首时才被支持。
参数
| 参数 | Mandatory | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | 否 | 空 | 指定包含用户定义的 .sql 文件的目录路径，这些文件包含插件可以执行的自定义查询。插件在启动时加载配置目录中的所有可用 .sql 文件。这意味着对自定义查询文件的任何更改直到插件重新启动才会反映出来。插件与Zabbix agent 2一起启动和停止。 | |
| Plugins.MSSQL.Default.CACertPath | 否 | 默认文件路径到颁发MSSQL服务器证书的证书颁发机构（CA）的公钥证书。证书必须是PEM格式。 | ||
| Plugins.MSSQL.Default.Database | 否 | 默认数据库名称以连接到。 | ||
| Plugins.MSSQL.Default.Encrypt | 否 | 指定默认的连接加密类型。可能的值是： true - 插件和服务器之间的数据传输是加密的； false - 插件和服务器之间的数据传输除了登录包之外是未加密的； strict - 插件和服务器之间的数据传输使用TDS8进行端到端加密； disable - 插件和服务器之间的数据传输是未加密的。 |
||
| Plugins.MSSQL.Default.HostNameInCertificate | 否 | MSSQL服务器证书的默认通用名称（CN）。 | ||
| Plugins.MSSQL.Default.Password | 否 | 默认密码发送到受保护的MSSQL服务器。 | ||
| Plugins.MSSQL.Default.TLSMinVersion | 否 | 默认使用的最低TLS版本。可能的值是：1.0，1.1，1.2，1.3。 |
||
| Plugins.MSSQL.Default.TrustServerCertificate | 否 | 默认情况下，插件是否应该在不验证的情况下信任服务器证书。可能的值：true，false。 |
||
| Plugins.MSSQL.Default.Uri | 否 | sqlserver://localhost:1433 | 默认URI以连接。唯一支持的模式是sqlserver://。可以省略模式。嵌入式凭证将被忽略。 |
|
| Plugins.MSSQL.Default.User | 否 | 发送到受保护的MSSQL服务器的默认用户名。 | ||
| Plugins.MSSQL.KeepAlive | 否 | 60-900 | 300 | 在未使用的插件连接被关闭前等待的最大时间（以秒为单位）。 |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | 否 | 为命名会话指定的MSSQL服务器证书颁发机构（CA）的公钥证书的文件路径。证书必须是PEM格式。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | 否 | 为命名会话连接的数据库名称。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | 否 | 为命名会话指定的连接加密类型。可能的值是： true - 插件和服务器之间的数据传输是加密的； false - 插件和服务器之间的数据传输除了登录包之外是未加密的； strict - 插件和服务器之间的数据传输使用TDS8进行端到端加密； disable - 插件和服务器之间的数据传输是未加密的。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | 否 | 为命名会话的MSSQL服务器证书的通用名称（CN）。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | 否 | 为命名会话发送到受保护的MSSQL服务器的密码。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | 否 | 为命名会话使用的最低TLS版本。可能的值是：1.0，1.1，1.2，1.3。<SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | 否 | 插件是否应该在不验证的情况下信任服务器证书，用于命名会话。可能的值：true，false。<SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | 否 | sqlserver://localhost:1433 | 为命名会话连接的URI。唯一支持的模式是sqlserver://。可以省略模式。嵌入式凭证将被忽略。<SessionName> - 定义用于监控项键中的会话名称。 |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | 否 | 为命名会话发送到受保护的MSSQL服务器的用户名。 <SessionName> - 定义用于监控项键中的会话名称。 |
||
| Plugins.MSSQL.System.Path | 否 | MSSQL插件可执行文件的路径。 MSSQL插件的全局设置。应用于所有连接。 示例用法： Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql |
||
| Plugins.MSSQL.Timeout | 否 | 1-30 | 全局超时 | 在首次连接和后续会话操作中等待服务器响应的持续时间（以秒为单位）。 |
另请参阅：
- Zabbix agent 2配置参数的通用描述： Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- 配置插件的说明