Documentation
Table of Contents
8 MSSQL 插件
概述
本节列出了 MSSQL Zabbix Agent 2 插件配置文件 (mssql.conf) 中支持的参数。
MSSQL 插件是一个可加载插件，详情请参见 MSSQL 插件仓库。
请注意：
- 默认值反映的是进程默认值，而不是随附配置文件中的值；
- 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。唯一支持的模式是 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)
- 配置插件的说明：插件