本文介绍如何利用 Ultipa Monitor 接口工具，通过 Ultipa Manager、Prometheus 监测 Ultipa Server 的运行状态。

准备工作

• 安装并启动 Ultipa Server V4.0 或更高版本
• 安装并启动 Ultipa Manager V4.1 或更高版本（如需通过 Ultipa Manager 进行监控）
• 安装并启动 Prometheus 的最新版本（如需通过 Prometheus 进行监控）

文件准备

1. Ultipa Monitor (ultipa_monitor) 及其配置文件 (./config/monitor-config.yml) 默认存放在 Ultipa Server 的目录下，如果安装好 Ultipa Server 后未发现这些文件，请联系 Ultipa 支持团队。

2. 根据需要修改配置文件内容。以下为文件示例：

# 服务器配置文件的信息，此部分通常不需要改动
configfile:
  # 文件名称
  name: server.config
  # 文件路径
  path: ./config/
  # 文件类型
  type: ini
  # 记录服务进程 ID 的文件路径
  pidfile: ./ultipa-server_d.pid

# Ultipa Monitor 配置文件的信息
monitor:
  # 监控日志文件的路径
  logpath: "./mlog"
  # 监控端口
  port: 19988

# Prometheus 相关配置
prometheus:
  # 监控任务的名称（被 Prometheus 调用时使用）
  fqname: "ultipa_server_info"
  # 是否允许 Prometheus 调用监控任务
  status: true

3. 如果 Ultipa Monitor 不可执行（通常发生于手动复制 Ultipa Monitor 到 server 目录时），可通过执行命令 chmod +x <文件名> 赋予相应权限。以下为命令示例：

chmod +x ultipa_monitor

启动 Ultipa Monitor

1. 对于尚未安装数据包捕获接口的系统，运行以下命令安装 libpcap：

yum -y install libpcap-devel

2. 以下命令可以启动一个已经停止的 Ultipa Monitor，或在其配置文件发生改变后重启 Ultipa Monitor：

./ultipa_monitor -d

配置 Prometheus

1. 将 Ultipa Monitor 的监控任务添加至 Prometheus (prometheus) 的配置文件中：

global:
  scrape_interval: 5s
  evaluation_interval: 60s
scrape_configs:
  - job_name: ultipa_server_info-1
    static_configs:
      - targets: ['192.168.2.195:19989']
        labels:
          instance: ultipa_server_infor-1
  - job_name: ultipa_server_info-2
    static_configs:
      - targets: ['192.168.2.47:19989']
        labels:
          instance: ultipa_server_infor-2
  - job_name: ultipa_server_info-3
    static_configs:
      - targets: ['192.168.2.51:19989']
        labels:
          instance: ultipa_server_infor-3
  # 监控任务名称，即 Ultipa Monitor 配置文件中的 'fqname' 
  - job_name: ultipa_server_info
    static_configs:
      # 服务器 IP 以及监控端口
      - targets: ['192.168.1.87:19988']
        labels:
          instance: ultipa_server_info

2. 重启 Prometheus：

docker restart prometheus

3. 在 Prometheus 用户界面切换至新添加的监控任务：

如需使用其他可视化监控平台，例如 Grafana，可以通过 Prometheus 调用接口。

配置 Ultipa Manager

1. 通过 Ultipa Manager 登录任何一个 Ultipa Server（可以不是待监控的 server），进入左侧 'Plugin/插件' 模块下的 Ultipa Monitor：

2. 按照下图所示的步骤，添加并测试监控任务：

3. 将左侧的监控任务列表切换至新添加的监控任务，并查看指标：