{"id":4619,"date":"2019-11-13T21:26:06","date_gmt":"2019-11-13T18:26:06","guid":{"rendered":"https:\/\/kifarunix.com\/?p=4619"},"modified":"2024-03-12T23:17:12","modified_gmt":"2024-03-12T20:17:12","slug":"install-and-configure-prometheus-on-centos-8","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-and-configure-prometheus-on-centos-8\/","title":{"rendered":"Install and Configure Prometheus on CentOS 8"},"content":{"rendered":"\n

Welcome to our guide on how to install and configure Prometheus on CentOS 8. Prometheus<\/a> is an  open-source time series collection and processing monitoring system with a dimensional data model, flexible query language, efficient time series database and modern alerting approach.<\/p>\n\n\n\n

Installing Prometheus on CentOS 8<\/h2>\n\n\n\n

Want to Install Prometheus on Ubuntu 18\/Debian 9. Check the links below;<\/p>\n\n\n\n

Install Prometheus on Ubuntu 18.04<\/a><\/p>\n\n\n\n

Install and Configure Prometheus on Debian 9<\/a><\/p>\n\n\n\n

Create Prometheus System User and Group<\/h3>\n\n\n\n

Run the command below to create prometheus<\/code> system user and group.<\/p>\n\n\n\n

useradd -M -r -s \/bin\/false prometheus<\/code><\/pre>\n\n\n\n
To verify this, you can try to print prometheus user and group information using the id<\/code> command;<\/p>\n\n\n\n
getent passwd prometheus\nprometheus:x:986:985::\/home\/prometheus:\/bin\/false<\/code><\/pre>\n\n\n\n
Create Prometheus Configuration Directories<\/h3>\n\n\n\n
Since we are installing Prometheus from source, you need to create the respective configuration directories.<\/p>\n\n\n\n
mkdir \/etc\/prometheus\nmkdir \/var\/lib\/prometheus<\/code><\/pre>\n\n\n\n
Download Prometheus Tarball<\/h3>\n\n\n\n
In order to install the latest version of Prometheus, navigate to the Download\u2019s Page<\/a> and grab Prometheus binary for your platform. You can simply run the command below to download version 2.14.0 (latest version as of this writing) for Linux systems.<\/p>\n\n\n\n
wget https:\/\/github.com\/prometheus\/prometheus\/releases\/download\/v2.14.0\/prometheus-2.14.0.linux-amd64.tar.gz -P \/tmp<\/code><\/pre>\n\n\n\n
Extract Prometheus Tarball<\/h3>\n\n\n\n
Once the download is done, extract the archive.<\/p>\n\n\n\n
cd \/tmp<\/code><\/pre>\n\n\n\n
tar -xzf prometheus-2.14.0.linux-amd64.tar.gz<\/code><\/pre>\n\n\n\n
ls prometheus-2.14.0.linux-amd64<\/code><\/pre>\n\n\n\n
console_libraries  consoles  LICENSE  NOTICE  prometheus  prometheus.yml  promtool  tsdb<\/code><\/pre>\n\n\n\n
Copy the two Prometheus binary files, prometheus<\/code>and promtool<\/code>, under the extracted Prometheus archive directory to the \/usr\/local\/bin<\/code> directory.<\/p>\n\n\n\n
cp prometheus-2.14.0.linux-amd64\/{prometheus,promtool} \/usr\/local\/bin\/<\/code><\/pre>\n\n\n\n
Copy the consoles\/<\/code> and console_libraries\/<\/code> directories to \/etc\/prometheus<\/code> directory created above.<\/p>\n\n\n\n
cp -r prometheus-2.14.0.linux-amd64\/{consoles,console_libraries} \/etc\/prometheus\/<\/code><\/pre>\n\n\n\n
Configure Prometheus on CentOS 8<\/h3>\n\n\n\n
The sample Prometheus configuration file, prometheus.yml<\/code>, is located under the extracted archive directory.<\/p>\n\n\n\n
Since we are doing a basic setup, we will copy the configuration file and modify it as follows such that it can scrape the local system only (Prometheus server).<\/p>\n\n\n\n
cp prometheus-2.14.0.linux-amd64\/prometheus.yml \/etc\/prometheus\/<\/code><\/pre>\n\n\n\n
Next, open the configuration file for modification and adjust it such that it looks like;<\/p>\n\n\n\n
vim \/etc\/prometheus\/prometheus.yml<\/code><\/pre>\n\n\n\n
# my global config\nglobal:\n  scrape_interval:     15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.\n  evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.\n  # scrape_timeout is set to the global default (10s).\n\n# A scrape configuration containing exactly one endpoint to scrape:\n# Here it's Prometheus itself.\nscrape_configs:\n  # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.\n  - job_name: 'prometheus'\n\n    # metrics_path defaults to '\/metrics'\n    # scheme defaults to 'http'.\n\n    static_configs:\n    - targets: ['localhost:9090']<\/code><\/pre>\n\n\n\n
Allow Prometheus through firewall.<\/p>\n\n\n\n
firewall-cmd --add-port=9090\/tcp --permanent<\/code><\/pre>\n\n\n\n
Reload firewalld<\/p>\n\n\n\n
firewall-cmd --reload<\/code><\/pre>\n\n\n\n
Set Proper Ownership on Configuration Files and Directories<\/h3>\n\n\n\n
Run the command below to set the ownership (owner and group) of Prometheus configuration files and directories to prometheus.<\/p>\n\n\n\n
chown -R prometheus:prometheus \/etc\/prometheus<\/code><\/pre>\n\n\n\n
chown -R prometheus:prometheus \/var\/lib\/prometheus<\/code><\/pre>\n\n\n\n
chown prometheus.prometheus \/usr\/local\/bin\/{prometheus,promtool}<\/code><\/pre>\n\n\n\n
Starting Prometheus<\/h3>\n\n\n\n
To start Prometheus with our basic configuration file,run:<\/p>\n\n\n\n
prometheus --config.file=\/etc\/prometheus\/prometheus.yml<\/code><\/pre>\n\n\n\n
...\nlevel=info ts=2019-11-13T17:33:55.867Z caller=main.go:743 msg=\"Loading configuration file\" filename=\/etc\/prometheus\/prometheus.yml\nlevel=info ts=2019-11-13T17:33:56.353Z caller=main.go:771 msg=\"Completed loading of configuration file\" filename=\/etc\/prometheus\/prometheus.yml\nlevel=info ts=2019-11-13T17:33:56.353Z caller=main.go:626 msg=\"Server is ready to receive web requests.\"<\/strong><\/code><\/pre>\n\n\n\n
You should able to access the Prometheus status page at http:\/\/localhost:9090<\/code> if you are accessing the server locally or http:\/\/<server-IP>:9090<\/code> if you are accessing remotely.<\/p>\n\n\n\n
\"Install<\/figure>\n\n\n\n
Create Prometheus Systemd Service file<\/h3>\n\n\n\n
To be able to run Prometheus as a service, you need to create a systemd service file, \/etc\/systemd\/system\/prometheus.service<\/code>, configured as follows.<\/p>\n\n\n\n
Note that this assumes Prometheus server is listening on default port 9090.<\/p>\n\n\n\n
vim \/etc\/systemd\/system\/prometheus.service<\/code><\/pre>\n\n\n\n
[Unit]\nDescription=Prometheus Time Series Collection and Processing Server\nWants=network-online.target\nAfter=network-online.target\n\n[Service]\nUser=prometheus\nGroup=prometheus\nType=simple\nExecStart=\/usr\/local\/bin\/prometheus \\\n    --config.file \/etc\/prometheus\/prometheus.yml \\\n    --storage.tsdb.path \/var\/lib\/prometheus\/ \\\n    --web.console.templates=\/etc\/prometheus\/consoles \\\n    --web.console.libraries=\/etc\/prometheus\/console_libraries\n\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\n
Reload systemd daemon configuration.<\/p>\n\n\n\n
systemctl daemon-reload<\/code><\/pre>\n\n\n\n
Start and Enable Prometheus service to run at boot time.<\/p>\n\n\n\n
systemctl enable --now prometheus<\/code><\/pre>\n\n\n\n
Check the status<\/p>\n\n\n\n
systemctl status prometheus<\/code><\/pre>\n\n\n\n
\u25cf prometheus.service - Prometheus Time Series Collection and Processing Server\n   Loaded: loaded (\/etc\/systemd\/system\/prometheus.service; enabled; vendor preset: disabled)\n   Active: active (running) since Wed 2019-11-13 20:47:02 EAT; 24s ago\n Main PID: 2931 (prometheus)\n    Tasks: 7 (limit: 5072)\n   Memory: 23.2M\n   CGroup: \/system.slice\/prometheus.service\n           \u2514\u25002931 \/usr\/local\/bin\/prometheus --config.file \/etc\/prometheus\/prometheus.yml --storage.tsdb.path \/var\/lib\/prometheus\/ --web.console.libraries=\/etc\/prometheus\/console_libraries<\/code><\/pre>\n\n\n\n
Check that prometheus is listening on TCP port 9090.<\/p>\n\n\n\n
lsof -i :9090<\/code><\/pre>\n\n\n\n
COMMAND    PID       USER   FD   TYPE DEVICE SIZE\/OFF NODE NAME\nprometheu 2931 prometheus    3u  IPv6  39243      0t0  TCP localhost:websm->localhost:45648 (ESTABLISHED)\nprometheu 2931 prometheus    7u  IPv6  39251      0t0  TCP localhost:47936->localhost:websm (ESTABLISHED)\nprometheu 2931 prometheus    8u  IPv6  39239      0t0  TCP *:websm (LISTEN)\nprometheu 2931 prometheus    9u  IPv6  39252      0t0  TCP localhost:websm->localhost:47936 (ESTABLISHED)\nprometheu 2931 prometheus   10u  IPv4  39242      0t0  TCP localhost:45648->localhost:websm (ESTABLISHED)<\/code><\/pre>\n\n\n\n
Great, Prometheus is now running as a service.<\/p>\n\n\n\n
You can now check the status of the connected targets. Click Status<\/strong> dropdown and then Targets.<\/strong> At the moment, we only have Prometheus scraping the localhost on which it is running.<\/p>\n\n\n\n
\n
\"\"<\/a><\/figure>\n<\/figure>\n\n\n\n
You can also check local system metrics for example to check memory statistics for example “go_memstats_frees_total<\/strong>“.<\/p>\n\n\n\n
\n
\"\"<\/a><\/figure>\n<\/figure>\n\n\n\n
For graphical overview, click Graph.<\/p>\n\n\n\n
\n
\"\"<\/a><\/figure>\n<\/figure>\n\n\n\n
Feel free to explore more about Prometheus here<\/a>.<\/p>\n\n\n\n
In our next guides, we will be covering how to monitor other targets using Prometheus. Enjoy.<\/p>\n\n\n\n
Related Tutorials<\/h3>\n\n\n\n
Integrate Prometheus with Grafana for Monitoring<\/a><\/p>\n\n\n\n
Monitor Linux System Metrics with Prometheus Node Exporter<\/a><\/p>\n\n\n\n
Install Monitorix on Debian 10<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Welcome to our guide on how to install and configure Prometheus on CentOS 8. Prometheus is an  open-source time series collection and processing monitoring system with<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[121,72,294],"tags":[1142,1194,295],"class_list":["post-4619","post","type-post","status-publish","format-standard","hentry","category-howtos","category-monitoring","category-prometheus","tag-centos-8","tag-install-prometheus-centos-8","tag-prometheus","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4619"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=4619"}],"version-history":[{"count":4,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4619\/revisions"}],"predecessor-version":[{"id":21262,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/4619\/revisions\/21262"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=4619"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=4619"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=4619"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}