Step-by-Step Guide
- Update the Package Index
Open a terminal and update the package index to ensure you have the latest information about available packages:
sudo apt update
- Download Prometheus
Go to the Prometheus download page and get the latest version URL for Linux. Download the Prometheus tarball usingwget
:
wget https://github.com/prometheus/prometheus/releases/download/v2.31.1/prometheus-2.31.1.linux-amd64.tar.gz
(Replace the URL with the latest version if necessary.)
- Extract the Tarball
Extract the downloaded tarball:
tar -xvf prometheus-*.tar.gz
- Move Prometheus Files
Move the extracted files to/usr/local/bin
and/etc/prometheus
directories:
sudo mv prometheus-*/prometheus /usr/local/bin/
sudo mv prometheus-*/promtool /usr/local/bin/
sudo mv prometheus-*/consoles /etc/prometheus/
sudo mv prometheus-*/console_libraries /etc/prometheus/
sudo mv prometheus-*/prometheus.yml /etc/prometheus/
- Create a Prometheus User
Create a new Prometheus user and set ownership of the Prometheus files:
sudo useradd --no-create-home --shell /bin/false prometheus
sudo chown prometheus:prometheus /usr/local/bin/prometheus
sudo chown prometheus:prometheus /usr/local/bin/promtool
sudo chown -R prometheus:prometheus /etc/prometheus/
- Create Prometheus Service File
Create a systemd service file for Prometheus:
sudo nano /etc/systemd/system/prometheus.service
Add the following content:
[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target
[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/usr/local/bin/prometheus \
--config.file=/etc/prometheus/prometheus.yml \
--storage.tsdb.path=/var/lib/prometheus/ \
--web.console.templates=/etc/prometheus/consoles \
--web.console.libraries=/etc/prometheus/console_libraries
[Install]
WantedBy=multi-user.target
Save and close the file.
- Create Prometheus Data Directory
Create a directory for Prometheus data and set the appropriate ownership:
sudo mkdir /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheus
- Start and Enable Prometheus
Reload systemd to recognize the new service file:
sudo systemctl daemon-reload
Start the Prometheus service:
sudo systemctl start prometheus
Enable Prometheus to start on boot:
sudo systemctl enable prometheus
- Verify Prometheus Installation
Check the Prometheus service status to ensure it is running:
sudo systemctl status prometheus
If Prometheus is running, you should see an active (running) status.
- Access the Prometheus Web Interface
Open your web browser and navigate tohttp://your_server_ip:9090
. You should see the Prometheus web interface. - Configure Prometheus (Optional)
Edit theprometheus.yml
configuration file to add new scrape targets or alter existing configurations:sudo nano /etc/prometheus/prometheus.yml
After making changes, restart Prometheus to apply them:sudo systemctl restart prometheus
- Install Prometheus Node Exporter (Optional)
To monitor your server’s hardware and OS metrics, install the Prometheus Node Exporter. Download the latest version from the Prometheus Node Exporter download page, extract the tarball, and move the binary to/usr/local/bin
. Create a systemd service file for it, start, and enable the service similar to the steps above.