Change Password

Please enter the password.
Please enter the password. Between 8-64 characters. Not identical to your email address. Contain at least 3 of uppercase, lowercase, numbers, and special characters (such as @*&#).
Please enter the password.

Change Nickname

Current Nickname:



    This article introduces the minimum procedure of using Ultipa Monitor in conjuction with Ultipa Manager or Prometheus to monitor Ultipa Server status.


    • Ultipa Server V4.0 or higher installed and started
    • Ultipa Manager V4.1 or higher installed and started (if intends to monitor in Ultipa Manager)
    • Latest version of Prometheus installed and started (if intends to monitor in Prometheus or other platforms)

    File Preparation

    1. Files of Ultipa Monitor (ultipa_monitor) and its configuraiton (./config/monitor-config.yml) are contained in the direcotry of Ultipa Server by default. In case they are not found, please contact our support team.

    2. Modify the configuration file if necessary. Below is a sample of the file with definiation of each parameter:

    # the first part of content usually needs no modification
      # file name of server config
      name: server.config
      # file path of server config
      path: ./config/
      # file type of server config
      type: ini
      # file path to record server process id
      pidfile: ./
    # modify the second part of content based on the real situation
      # file path of monitor log
      logpath: "./mlog"
      # port of monitor
      port: 19988
    # modify the third part of content based on the real situation
      # the name of job to be called by Prometheus
      fqname: "ultipa_server_info"
      # whether allows Prometheus to call the job
      status: true

    3. In case the file of Ultipa Monitor is not executable (usually occurs after manually copying Ultipa Monitor to the server directory), run chmod +x <filename> to grant execution permission. Below is the sample command:

    chmod +x ultipa_monitor

    Start Ultipa Monitor

    1. Install libpcap in case the feature of capturing and filtering packets is not enabled:

    yum -y install libpcap-devel

    2. Run below command to start Ultipa Monitor when it is stopped, or restart Ultipa Monitor if its configuration file is modified:

    ./ultipa_monitor -d

    Configure Prometheus

    1. Add the job information of Ultipa Monitor to the YML configuration file of Prometheus (prometheus). It can be attached to those existing jobs:

      scrape_interval: 5s
      evaluation_interval: 60s
      - job_name: ultipa_server_info-1
          - targets: ['']
              instance: ultipa_server_infor-1
      - job_name: ultipa_server_info-2
          - targets: ['']
              instance: ultipa_server_infor-2
      - job_name: ultipa_server_info-3
          - targets: ['']
              instance: ultipa_server_infor-3
      # the 'fqname' defined in the config file of Ultipa Monitor
      - job_name: ultipa_server_info
          # the server ip and monitor port defined in the config file of Ultipa Monitor
          - targets: ['']
              instance: ultipa_server_info

    2. Restart Prometheus:

    docker restart prometheus

    3. Switch to the newly added job in Prometheus user interface to confirm the connection:

    If other platforms are wanted, such as Grafana, they have to get metrics from Prometheus.

    Configure Ultipa Manager

    1. Login any Ultipa Server (not necessarily the one to be monitored) via Ultipa Manager, click Ultipa Monitor under menu Plugin:

    2. Follow the steps instructed in the screenshot to add and test the monitor:

    3. Switch to the newly added monitor to see the metrics:

    Please complete the following information to download this book