夜莺-Nightingale-开源云原生监控分析系统部署 Prometheus 作为时序库使用（配置多数据源）_夜莺对接prometheus exporter数据源

夜莺-Nightingale-开源云原生监控分析系统部署 Prometheus 作为时序库使用（配置多数据源）

• • 一、前言
  • 二、Prometheus安装步骤
  • • 1. 下载并安装Prometheus
    • 2. 关键配置：启用Remote Write接收器
    • 3. 创建Systemd服务
    • 4. 启动并验证服务
  • 三、验证Remote Write功能
  • 四、修改夜莺配置文件对接时序库
  • • 1. 再增加一个Prometheus 时序库。
    • 2. 重启夜莺监控(N9E)服务：
    • 3. 夜莺数据源管理新增数据源
  • 五、常见问题解决
  • • 1. 夜莺转发数据时报404错误
    • 2. 权限问题
    • 3. 端口冲突
  • 六、总结
  • 参考链接

一、前言

Prometheus是一款开源的监控系统和时序数据库，广泛应用于云原生监控领域。在实际使用中，我们经常需要将其他监控系统（如夜莺监控）的数据写入Prometheus，这就需要启用Prometheus的remote write接收功能。本文将详细介绍如何正确部署Prometheus并配置remote write接收器。

二、Prometheus安装步骤

1. 下载并安装Prometheus

首先选择适合的Prometheus版本并下载：

mkdir -p /usr/local/prometheuswget https://github.com/prometheus/prometheus/releases/download/2.54.0/prometheus-2.54.0.linux-amd64.tar.gztar zxvf /root/prometheus-2.54.0.linux-amd64.tar.gz -C /usr/local/prometheus

2. 关键配置：启用Remote Write接收器

Prometheus默认不开启remote write接收功能，需要通过启动参数显式启用。根据版本不同，参数写法有所差异：

• 老版本：--enable-feature=remote-write-receiver
• 新版本：--web.enable-remote-write-receiver

不确定该用哪个参数时，可以通过以下命令查看：

./prometheus --help | grep receiver

[root@zyl-server prometheus-2.54.0.linux-amd64]# ./prometheus --help | grep receiver --[no-]web.enable-remote-write-receiver  --web.remote-write-receiver.accepted-protobuf-messages=prometheus.WriteRequest... ...   remote-write-receiver (DEPRECATED),  native-histograms, otlp-write-receiver,[root@zyl-server prometheus-2.54.0.linux-amd64]# [root@zyl-server prometheus-2.54.0.linux-amd64]# [root@zyl-server prometheus-2.54.0.linux-amd64]# 

3. 创建Systemd服务

创建服务配置文件/etc/systemd/system/prometheus.service：

cat <<EOF >/etc/systemd/system/prometheus.service[Unit]Description=\"prometheus\"Documentation=https://prometheus.io/After=network.target[Service]Type=simpleExecStart=/usr/local/prometheus/prometheus-2.54.0.linux-amd64/prometheus --config.file=/usr/local/prometheus/prometheus-2.54.0.linux-amd64/prometheus.yml --storage.tsdb.path=/usr/local/prometheus/data --web.enable-lifecycle --web.enable-remote-write-receiverRestart=on-failureSuccessExitStatus=0LimitNOFILE=65536StandardOutput=syslogStandardError=syslogSyslogIdentifier=prometheus[Install]WantedBy=multi-user.targetEOF

4. 启动并验证服务

systemctl daemon-reloadsystemctl enable prometheussystemctl restart prometheussystemctl status prometheus

三、验证Remote Write功能

Prometheus启动后，可以通过以下方式验证remote write接口是否正常工作：

1. 检查Prometheus日志，确认没有错误信息
2. 访问Prometheus的/api/v1/write接口：

   curl -X POST http://localhost:9090/api/v1/write

   如果返回404，说明remote write接收器没有正确启用；如果返回\"empty write request\"等消息，说明接口已正常启用

四、修改夜莺配置文件对接时序库

夜莺作为 pushgateway，需要告诉夜莺时序库的地址在哪里。夜莺的配置文件是 etc/config.toml，修改 [[Pushgw.Writers]] 部分即可，核心是 Url 部分，夜莺接收到指标数据之后，会通过 Prometheus remote write 协议写入 Url 指向的时序库（任何支持 Prometheus remote write 的存储都可以用）：

1. 再增加一个Prometheus 时序库。

[[Pushgw.Writers]]# Url = \"http://127.0.0.1:8480/insert/0/prometheus/api/v1/write\"Url = \"http://127.0.0.1:9090/api/v1/write\"# Basic auth usernameBasicAuthUser = \"\"# Basic auth passwordBasicAuthPass = \"\"# timeout settings, unit: msHeaders = [\"X-From\", \"n9e\"]Timeout = 10000DialTimeout = 3000TLSHandshakeTimeout = 30000ExpectContinueTimeout = 1000IdleConnTimeout = 90000# time duration, unit: msKeepAlive = 30000MaxConnsPerHost = 0MaxIdleConns = 100MaxIdleConnsPerHost = 100

2. 重启夜莺监控(N9E)服务：

systemctl restart n9esystemctl status n9e

3. 夜莺数据源管理新增数据源

五、常见问题解决

1. 夜莺转发数据时报404错误

这通常是因为Prometheus没有启用remote write接收器。请检查：

• 确保启动参数正确（--web.enable-remote-write-receiver或--enable-feature=remote-write-receiver）
• 确认Prometheus版本与参数匹配

2. 权限问题

确保Prometheus对数据目录有读写权限：

chown -R prometheus:prometheus /opt/prometheus/data

3. 端口冲突

如果9090端口被占用，可以通过--web.listen-address参数修改监听地址：

--web.listen-address=:9091

六、总结

正确配置Prometheus的remote write接收器对于构建监控数据流水线至关重要。通过本文介绍的步骤，您可以轻松部署一个支持remote write的Prometheus实例，为后续与其他监控系统（如夜莺）的集成打下基础。

参考链接

• Prometheus官方文档
• Remote Write协议说明