How to Install Sensu Go Monitoring Tool on AlmaLinux 9

Estimated reading: 3 minutes 102 views

Introduction

Maintaining visibility across virtual private servers and complex cloud infrastructure requires a highly scalable observability platform. Sensu Go is a flexible, modern monitoring pipeline designed to track distributed systems, containers, and cloud applications. Whether you are managing fleets of AlmaLinux, Debian, or Ubuntu nodes, Sensu Go helps you easily monitor system health and automate incident response. Below is a comprehensive, step-by-step guide to deploying the Sensu Go Backend and the sensuctl command-line tool on an AlmaLinux 9 server.

Prerequisites

A server running AlmaLinux 9, fully updated.
Root or sudo user privileges.
An active internet connection to download the required packages.

Step 1: Add the Sensu Repository

Sensu provides an automated script to configure the package repositories for RHEL-based systems. Run the following command to add the Sensu stable repository to your system:

curl -s https://packagecloud.io/install/repositories/sensu/stable/script.rpm.sh | sudo bash

Step 2: Install the Sensu Backend

The Sensu Backend serves as the control plane of your monitoring system. It processes events, manages configurations, and hosts the Web UI. Install it using the dnf package manager:

sudo dnf install sensu-go-backend -y

Step 3: Configure and Start the Sensu Backend

Before starting the service, you need to set up the base configuration file. Download the default template provided by Sensu:

sudo curl -L https://docs.sensu.io/sensu-go/latest/files/backend.yml -o /etc/sensu/backend.yml

Once the configuration file is in place, enable and start the Sensu Backend service so it runs automatically on system boot:

sudo systemctl enable --now sensu-backend

Verify the service status to ensure it is running smoothly:

sudo systemctl status sensu-backend

Step 4: Initialize the Administrator Account

To access the Web UI and API, you must initialize an admin account. Define your desired username and password using environment variables, then run the initialization command:

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=admin
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=YourSecurePasswordHere
sensu-backend init

(Note: Replace YourSecurePasswordHere with a strong password).

Step 5: Install and Configure Sensu CLI (sensuctl)

The sensuctl command-line tool is essential for managing your Sensu resources, such as creating health checks, handling agents, and routing alerts.

sudo dnf install sensu-go-cli -y

Configure sensuctl to authenticate with your newly installed Backend:

sensuctl configure -n \
--username admin \
--password YourSecurePasswordHere \
--namespace default \
--url http://127.0.0.1:8080

Step 6: Configure the Firewall

To allow access to the Web UI from your browser and enable external Agents to communicate with the Backend, you must open the required network ports (3000 for the Web UI, 8080 for the API, and 8081 for Agent WebSockets).

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --add-port=8081/tcp --permanent
sudo firewall-cmd --reload

Expanding Your Monitoring Reach

Your Sensu Go control plane is now fully operational and ready to process telemetry data. You can open a web browser and navigate to http://<Your_Server_IP>:3000 (logging in with the admin credentials created in Step 4) to explore the graphical dashboard.

From this robust foundation, the next phase is deploying Sensu Agents across your network, configuring custom alert handlers, and integrating with external notification platforms to build a proactive, automated IT operations workflow.