In this tutorial we will show you how to install Prometheus on CentOS 8. For those of you who didn’t know, Prometheus is an excellent open source monitoring system which allows us to collect metrics from our applications and stores them in a database, especially a time-series based DB. The biggest advantage of Prometheus is the query language it provides for data processing.
This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo’ to the commands to get root privileges. I will show you through the step by step installation Prometheus on a CentOS 8 server.
Install Prometheus on CentOS 8
Step 1. First, let’s start by ensuring your system is up-to-date.
1 2 | sudodnfcleanall sudodnfupdate |
Step 2. Add system user and group for Prometheus.
Run the command below to create prometheus system user and group:
1 | useradd-M-r-s/bin/falseprometheus |
Create a directory that will be used to store Prometheus data:
1 2 | mkdir/etc/prometheus mkdir/var/lib/prometheus |
We need to download the latest release of Prometheus archive and extract it to get binary files:
1 2 3 | wgethttps://github.com/prometheus/prometheus/releases/download/v2.14.0/prometheus-2.14.0.linux-amd64.tar.gz -P /tmp cd/tmp tar-xzfprometheus-2.14.0.linux-amd64.tar.gz |
Next, copy the two Prometheus files, prometheusand promtool, under the extracted Prometheus archive directory to the /usr/local/bin directory:
1 2 | cpprometheus-2.14.0.linux-amd64/{prometheus,promtool}/usr/local/bin/ cp-rprometheus-2.14.0.linux-amd64/{consoles,console_libraries}/etc/prometheus/ |
Configure Prometheus:
Configurations should be added to the “/etc/prometheus/prometheus.yml”, Open the configuration file for modification and adjust it such that it looks like:
1 | nano/etc/prometheus/prometheus.yml |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | # my global config global: scrape_interval: 15s# Set the scrape interval to every 15 seconds. Default is every 1 minute. evaluation_interval:15s# Evaluate rules every 15 seconds. The default is every 1 minute. # scrape_timeout is set to the global default (10s). # A scrape configuration containing exactly one endpoint to scrape: # Here it's Prometheus itself. scrape_configs: # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config. -job_name:'prometheus' # metrics_path defaults to '/metrics' # scheme defaults to 'http'. static_configs: -targets:['localhost:9090'] |
You need to create a systemd service file, /etc/systemd/system/prometheus.service, configured as follows:
1 | nano/etc/systemd/system/prometheus.service |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | [Unit] Description=PrometheusTimeSeriesCollectionandProcessingServer 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 |
Reload the systemd service:
1 2 3 | systemctldaemon-reload systemctlenable--nowprometheus systemctlstatusprometheus |
Allow Prometheus through firewall:
1 2 | sudofirewall-cmd--add-port=9090/tcp--permanent sudofirewall-cmd--reload |
Run the command below to set the ownership of Prometheus configuration files and directories to prometheus:
1 2 3 | chown-Rprometheus:prometheus/etc/prometheus chown-Rprometheus:prometheus/var/lib/prometheus chownprometheus.prometheus/usr/local/bin/{prometheus,promtool} |
Prometheus will be available on HTTP port 9090 by default. Open your favorite browser and navigate to http://your-domain.com:9090 or http://server-ip-address:9090 and complete the required the steps to finish the installation.
Congratulation’s! You have successfully installed Prometheus. Thanks for using this tutorial for installing Prometheus on CentOS 8 system. For additional help or useful information, we recommend you to check the official Prometheus website.
