使用td-agent-bit无法将日志输出至MySQL的问题排查

以下是针对该问题的具体排查步骤：

1. 获取td-agent-bit的详细错误日志 #

systemd的提示仅说明启动失败，未给出具体原因，必须查看td-agent-bit的专属日志定位问题：

• 实时跟踪服务日志：

  journalctl -u td-agent-bit.service -f
  

• 查看本地日志文件（路径可能因系统发行版略有差异）：

  cat /var/log/td-agent-bit/td-agent-bit.log
  

详细日志会直接暴露连接失败、插件缺失、配置语法错误等核心问题。

2. 验证MySQL连接有效性 #

先手动测试root用户能否正常连接目标数据库：

mysql -uroot -pd3qfeftgwff -h localhost logs_db

如果连接失败，可能的原因包括：

• 密码不匹配：确认配置文件中的Password值与MySQL root实际密码完全一致
• 本地连接方式冲突：MySQL的root用户可能默认仅允许socket连接而非TCP，此时需在td-agent-bit配置中添加Socket参数（路径根据你的MySQL部署调整）：

  [OUTPUT]
      Name        mysql
      Match       *
      Host        localhost
      Port        3306
      Socket      /var/run/mysqld/mysqld.sock
      Database    logs_db
      Table       logs_tb
      Column      text
      User        root
      Password    d3qfeftgwff
  

3. 确认MySQL输出插件已安装 #

部分版本的td-agent-bit默认未编译MySQL输出插件，执行以下命令检查可用插件列表：

td-agent-bit -e

如果输出中没有mysql，说明插件缺失，需重新安装带MySQL插件的td-agent-bit版本，或从源码编译时启用该插件。

4. 修正日志字段映射配置 #

你的logs_tb表仅包含text列，但td-agent-bit采集的日志默认包含timestamp、message等多个字段，需明确指定将哪个日志字段写入text列：
在OUTPUT配置块中添加Template参数，将日志的message字段映射到表的text列：

[OUTPUT]
    Name        mysql
    Match       *
    Host        localhost
    Port        3306
    Database    logs_db
    Table       logs_tb
    Column      text
    User        root
    Password    d3qfeftgwff
    Template    {"text": "$message"}

5. 再次确认数据库表的权限与结构 #

登录MySQL命令行，执行以下命令验证：

USE logs_db;
SHOW TABLES LIKE 'logs_tb';
DESCRIBE logs_tb;

确保logs_tb存在、text列类型为varchar(255)，同时root用户拥有对logs_db的INSERT权限。

内容的提问来源于stack exchange，提问作者nix86