MySQL-jdbc采集器（app-discovery-mysql-jdbc）是一种通过JDBC连接MySQL数据库并采集客户端信息的高效工具，它主要通过查询MySQL的processlist表来获取客户端的host和port信息，从而帮助用户了解当前与MySQL服务器交互的所有客户端情况，以下是关于该采集器的详细配置说明及使用指南：
一、参数配置说明
| 参数 | 必选 | 配置说明 |
| output_path | 否 | 自定义采集结果（app-discovery-mysql-jdbc-xxx.csv文件）输出路径，不填则输出至默认路径：<采集器安装目录>/output/file目录下，C:\Edge\tools\plugins\collectors\app-discovery-collectors\python\mgc-app-discovery-collectors\app-discovery-mysql-jdbc\output\file\app-discovery-mysql-jdbc-xxx.csv |
| ssl | 否 | 如果遇到填写ca证书无法连接的情况，可以尝试填写pymysql支持的ssl参数信息登录，参数说明参见表2，格式为"参数名1,参数值1,参数名2,参数值2"。"ca,/data/ca.pem,key,/data/client-key.pem,cert,/data/client-cert.pem,check_hostname,True" |
| ca | 否 | 使用了SSL认证的verify_ca模式时，填写CA证书所在路径，Linux系统MySQL证书默认存放位置取决于MySQL的安装方式和版本，通常MySQL证书存放在以下位置：MySQL 5.6及以下版本：/etc/mysql/；MySQL 5.7及以上版本：/var/lib/mysql/，如果是云数据库，请参考各云厂商数据库的说明文档：华为云云数据库RDS、阿里云云数据库RDS |
| exclude_ip | 否 | 填写不需要采集的客户端IP地址，多个IP地址之间用逗号分隔，127.0.0.1,192.168.1.1 |
| password | 是 | 填写登录用户名对应的密码。 |
| user | 是 | 填写拥有process权限的登录用户名，查看mysql账号权限方法：在数据库执行如下命令，找到process权限，确定其是否为“Y”，SELECT * FROM mysql.user |
| port | 是 | 填写与MySQL服务器建立连接和进行通信的网络端口，3306 |
| endpoint | 是 | 填写MySQL服务器IP地址，192.168.1.100 |
二、SSL参数说明
| 参数 | 必选 | 说明 |
| disabled | 否 | 如果设置为True，则将禁用SSL，如果未指定证书，则此选项无效。 |
| ca | 是 | CA证书文件的路径。 |
| cert | 是 | 客户端证书文件的路径。 |
| key | 是 | 客户端私钥文件的路径。 |
| cipher | 否 | 要使用的加密算法。 |
| check_hostname | 否 | 如果设置为True，则在SSL连接时验证服务器的主机名，如果未指定证书，则此选项无效。 |
三、使用步骤
1、下载并安装MySQL Connector/J：确保你已经下载了适用于你MySQL版本的JDBC驱动，并将其添加到你的项目中或CLASSPATH中。
2、配置采集器参数：根据上述参数配置说明，编辑配置文件（如properties文件或直接在代码中设置），填写必要的连接信息和可选参数。
3、运行采集器：启动采集器程序，它将通过JDBC连接到指定的MySQL服务器，并查询processlist表以获取客户端信息。
4、查看结果：采集结果将保存在指定的output_path目录下，文件名为app-discovery-mysql-jdbc-xxx.csv，你可以使用任何文本编辑器或表格处理软件打开并查看结果。
四、常见问题及解答
Q1: 如何更改采集结果的输出路径？
A1: 你可以通过修改配置文件中的output_path参数来自定义采集结果的输出路径，如果不填写该参数，则结果将输出到默认路径下。
Q2: 如果遇到SSL连接问题应该怎么办？
A2: 确保你已经正确配置了所有必要的SSL参数，包括CA证书、客户端证书和私钥的路径，如果问题依旧存在，可以尝试禁用SSL连接（将disabled参数设置为True），但请注意这可能会降低连接的安全性。
五、小编有话说
MySQL-jdbc采集器是一款非常实用的工具，它能够帮助我们快速了解MySQL服务器上的所有客户端连接情况，通过合理配置和使用该采集器，我们可以更好地监控和管理MySQL服务器的性能和安全性，如果你在使用过程中遇到任何问题或需要更多帮助，请随时查阅官方文档或寻求社区支持。