树莓派4运行Prometheus独立应用失败，错误码2求助

在8GB内存的RPI4上部署独立Prometheus应用，启动服务时失败，systemd日志显示退出状态码为2。

环境与配置 #

使用的prometheus.service文件内容：

[Unit]
Description=Prometheus Server
Documentation=https://prometheus.io/docs/introduction/overview/
After=network-online.target

[Service]
User=pi
Restart=on-failure

ExecStart=/home/pi/prometheus/prometheus \
    --config.file=/home/pi/prometheus/prometheus.yml \
    --storage.tsdb.path=/home/pi/prometheus/data

[Install]
WantedBy=multi-user.target

错误日志 #

● prometheus.service - Prometheus Server
     Loaded: loaded (/etc/systemd/system/prometheus.service; enabled; vendor preset: enabled)
     Active: failed (Result: exit-code) since Thu 2022-11-24 18:42:51 GMT; 2s ago
       Docs: https://prometheus.io/docs/introduction/overview/
    Process: 485265 ExecStart=/home/pi/prometheus/prometheus --config.file=/home/pi/prometheus/prometheus.yml --storage.tsdb.path=/home/pi/prometheus/data (code=exited, status=2)
   Main PID: 485265 (code=exited, status=2)
        CPU: 160ms

Nov 24 18:42:51 master2 systemd[1]: prometheus.service: Scheduled restart job, restart counter is at 5.
Nov 24 18:42:51 master2 systemd[1]: Stopped Prometheus Server.
Nov 24 18:42:51 master2 systemd[1]: prometheus.service: Start request repeated too quickly.
Nov 24 18:42:51 master2 systemd[1]: prometheus.service: Failed with result 'exit-code'.
Nov 24 18:42:51 master2 systemd[1]: Failed to start Prometheus Server.

疑问 #

此场景下退出状态码2代表什么含义？是权限问题还是其他原因？

Prometheus退出状态码2通常表示启动时遇到无法恢复的配置或依赖错误，并非单一指向权限问题，常见原因及排查步骤如下：

常见原因 #

1. 配置文件错误：prometheus.yml存在语法错误（比如缩进错误、字段缺失），或者配置中引用的资源路径无效
2. 路径问题：指定的配置文件、数据存储目录不存在，或者路径书写错误
3. 权限不足：运行用户pi对Prometheus二进制文件、配置文件无读取权限，或对数据目录无写入权限
4. 二进制架构不匹配：下载的Prometheus二进制文件与RPI4的ARM架构不兼容（比如误下载了x86_64版本）

排查步骤 #

1. 手动执行启动命令查看详细错误：
   直接在终端运行服务中的启动命令，Prometheus会输出具体的失败原因：

   /home/pi/prometheus/prometheus --config.file=/home/pi/prometheus/prometheus.yml --storage.tsdb.path=/home/pi/prometheus/data
   

2. 检查配置文件语法：
   使用Prometheus自带的promtool工具验证配置文件（若已安装）：

   promtool check config /home/pi/prometheus/prometheus.yml
   

3. 验证路径与权限：
   • 确认数据目录存在，若不存在则创建：

     mkdir -p /home/pi/prometheus/data
     

   • 检查目录与文件的权限归属，确保pi用户拥有对应权限：

     chown -R pi:pi /home/pi/prometheus/
     

4. 确认二进制架构兼容性：
   检查Prometheus二进制文件的架构信息，确保适配RPI4的ARM64/ARMHF架构：

   file /home/pi/prometheus/prometheus
   

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