Table of Contents
8 MSSQL 插件
概览
本节列出了 MSSQL Zabbix 代理 2 插件配置文件（mssql.conf）支持的参数。
MSSQL 插件是一个可加载插件，并且在 MSSQL 插件仓库 中可用并有完整描述。
此插件自 Zabbix 6.0.27 起被支持。 Windows 的预编译插件二进制文件自 Zabbix 6.0.28 起可用，并且与 6.0.27 版本兼容。
请注意：
- 默认值反映了进程默认值，而不是配置文件中的值；
- Zabbix 仅支持 UTF-8 编码的配置文件，不包含 BOM；
- 仅支持以 “#” 开头的注释在行的开始处。
参数
| 参数 | 必填 | 范围 | 默认值 | 描述 |
|---|---|---|---|---|
| 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。唯一支持的schema是sqlserver://。可以省略schema。嵌入式凭据将被忽略。 |
|
| 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。唯一支持的schema是sqlserver://。可以省略schema。嵌入式凭据将被忽略。<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)
- 插件配置指南