Tech

How to Connect Prometheus with Vodia PBX

Published on:

July 24, 2024

Integrating Prometheus with Vodia PBX enables effective monitoring of your phone system’s performance. Start by creating an API account on Vodia PBX to grant access to Prometheus, followed by the installation of Prometheus on DigitalOcean. Update the prometheus.yml file to include your PBX as a target by configuring the DNS, username, and password. Explore the Vodia API for available system stats, such as CPU usage and memory. Finally, create custom stat panels in Prometheus to visualize and track these key performance metrics in real time.

Prometheus is an open-source monitoring and alerting toolkit that is part of the Cloud Native Computing Foundation. By integrating it with Vodia PBX, you can effectively monitor and manage your phone system's performance. Here’s how to get started:

Step 1: Create an API Account on Vodia PBX

To allow Prometheus to access Vodia PBX data, you need to create an API account. Follow these steps:

  1. Log in to Vodia PBX as an Administrator:
    • Navigate to the system level where you can manage user accounts.
  2. Create a New User Account for API Access:
    • Go to the Administrator section.
    • Create a new account with the following details:
      • Account: Choose a user name.
      • API Access: Enable API access.
      • Type: Set the account type to Regular.
      • Password: Set a strong, secret password.
  3. Save the Configuration:
    • Save the user account configuration.
    • Keep the username and password handy, as you will need them for Prometheus to access Vodia PBX data.
API credentils

Installing Prometheus on Digital Ocean: https://marketplace.digitalocean.com/apps/prometheus

Once your server is set up, you can access the Prometheus user interface by going to http://your_server_ip:9090/

Setting up the .yml file

By default, Prometheus is set up to monitor itself and Node Exporter. To monitor more systems, you need to update the configuration file located at: /etc/prometheus/prometheus.yml

Download Prometheus.yml

3 things need to be changed in the Prometheus .yml file config file

  • targets: ['123.vodia.com'] Here is where you will set the target - in this case it will be your PBX DNS name
  • username: 'prometheus'
  • password: 'prometheus'

Note: Do not remove the ' ' and [ ] in the config file leave it as is and change the value

Once you have edited the config file, you can modify the prometheus.yml using nano or any edit you desire by copy-pasting the config or simply creating a new .yml file and renaming the old file.

Restart the service by sudo systemctl restart prometheus

How to use Vodia API

To learn more about Vodia API, please visit us here https://api.vodia.com/#f3d2b273-75f7-4876-be45-d34858664fed

Check the Prometheus and click on System Stats - this will show all of the available APIs for Prometheus, and you will see an Example Response. Click on "view more" and it should look like this:

I have bolded all of the stats you can use as an examples, there's no need to copy the whole thing

# pbxctrl 69.3.2.beta

# HELP system_cpu_srv_max Peak usage of the CPU
# TYPE system_cpu_srv_max gauge
system_cpu_srv_max 0 1719852690061

# HELP system_cpu_srv_avg Average Load
# TYPE system_cpu_srv_avg gauge
system_cpu_srv_avg 0 1719852690061

# HELP system_cpu_ctrl_max Peak usage of the CPU
# TYPE system_cpu_ctrl_max gauge
system_cpu_ctrl_max 25 1719852690061

# HELP system_cpu_ctrl_avg Peak usage of the CPU
# TYPE system_cpu_ctrl_avg gauge
system_cpu_ctrl_avg 2 1719852690061

# HELP system_memory_all Total
# TYPE system_memory_all gauge
system_memory_all 172928 1719852690061

Creating a stat panel on Prometheus

Click "add panel" and enter the Vodia API cmd - in this case system_cpu_srv_max, then press execute: you can create many panels to monitor the PBX.

stat
Api
w
api
tcp

Latest Articles

View All

How the Hospitality Industry Can Exceed Guest Expectations

As hotels prepare for the upcoming travel season, many are rethinking their communication systems to better meet modern guest expectations. Vodia CEO Dr. Christian Stredicke explains how VoIP, AI, and app-based control are key to delivering smarter, more personalized service. Guests now expect mobile-first experiences—whether for check-in, room controls, or contacting hotel staff. Vodia’s customizable communication solutions help hotels automate tasks, streamline operations, and boost guest comfort while reducing costs. With robust security and seamless integration into existing hotel management systems, Vodia enables hotels to move beyond outdated hardware and deliver the connected, high-quality experience today’s travelers demand.

April 23, 2025

Seatrade Cruise Global 2025: Communications Revolution Onboard - What Cruise Experts Need to Know

At Seatrade’s 40th anniversary, Vodia and Lufthansa Industry Solutions showcased the Vodia Maritime Communication Server and the new CruisR World App—purpose-built for next-generation cruise ships and cost-effective retrofits. Key themes at the event included AI-powered language translation, breakthrough satellite connectivity, UC platforms, and advanced emergency protocols. These innovations enable cruise lines to streamline operations, personalize guest experiences, and meet growing expectations for safety and connectivity. As the cruise industry evolves, Vodia’s solutions position communication teams to lead with smarter, more human-centric technology at sea.

April 23, 2025

Real-Time Media Streaming in Vodia PBX: AI, Call Transcription, and Security in V69.5.6 | Webinar Recording Now Available

Vodia is excited to share the recording of our April 8, 2025 webinar on "Real-Time Media Streaming in Vodia PBX: AI, Call Transcription, and Security in V69.5.6." In this session, we explore how AI, call transcription, and security have become core features in the latest version of our PBX. We dive into the practical benefits of AI, including how it improves business communication with real-time transcription, enhances security with advanced features, and streamlines workflows through integrations like OpenAI and Microsoft Teams. Watch the recording to learn how these innovations can transform your business communications and boost efficiency.

April 16, 2025