Kibana加入systemd启动时出现未知配置键错误求助

可能的原因及排查步骤 #

1. 检查systemd服务文件中的额外启动参数 #

手动安装的Kibana配置systemd时，服务文件可能错误添加了该配置参数。执行以下命令查看服务文件内容：

cat /etc/systemd/system/kibana.service

重点关注ExecStart行，是否包含--deprecation.skip_deprecated_settings参数，或者通过-c指定了非默认的配置文件。如果存在，直接删除该参数或修正配置文件路径。

2. 确认Kibana实际加载的配置文件 #

Kibana可能会加载多个配置文件（比如默认kibana.yml之外的本地配置、目录下的其他yml文件）。手动启动Kibana并查看详细日志，确认所有配置来源：

cd /opt/elk/kibana/bin
./kibana --verbose

日志中会输出所有加载的配置文件路径，逐一检查这些文件是否存在deprecation.skip_deprecated_settings配置项。

3. 排查环境变量中的配置注入 #

Kibana支持通过环境变量传递配置（格式为KIBANA_<配置键大写，下划线替换点>），比如KIBANA_DEPRECATION_SKIP_DEPRECATED_SETTINGS会被自动转译为deprecation.skip_deprecated_settings。执行以下命令检查相关环境变量：

printenv | grep KIBANA

如果存在对应环境变量，可在systemd服务文件中移除Environment配置项，或者在用户profile中删除该变量。

4. 验证Kibana版本兼容性 #

deprecation.skip_deprecated_settings是Kibana 8.x系列后期引入的配置项，如果你的Kibana版本为7.x或更早，该配置会被识别为未知键。执行以下命令查看Kibana版本：

/opt/elk/kibana/bin/kibana --version

若版本不兼容，要么升级Kibana到支持该配置的版本，要么移除所有包含该配置的来源。

总结 #

这个错误的核心是启动时加载了包含deprecation.skip_deprecated_settings的配置来源，而你的主配置文件中没有该键，重点排查systemd服务参数、额外配置文件、环境变量这几个方向即可。

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