To set up Grafana, you’ll require the following:<\/p>\n
- \n
- A fully registered domain name. This tutorial uses your_domain throughout. You can purchase a domain name on Namecheap, get one for free on Freenom, or use the domain registrar of your choice.<\/li>\n
- The following DNS records set up for your server. You can follow the How To Add Domains article for details on how to add them if you are using Silicon Cloud.An A record with your_domain pointing to your server\u2019s public IP address.
\nAn A record with www.your_domain pointing to your server\u2019s public IP address.<\/li>\n - Nginx set up by following the How To Install Nginx on Ubuntu 20.04 tutorial, including a server block for your domain.<\/li>\n
- An Nginx server block with Let\u2019s Encrypt configured, which you can set up by following How To Secure Nginx with Let\u2019s Encrypt on Ubuntu 20.04.<\/li>\n<\/ul>\n
First, you need to install and set up Prometheus.<\/h2>\n
Prometheus is a toolkit for monitoring and alerts, which is open source. It is responsible for gathering and storing metrics as time-series data, with each metric being stored alongside its respective timestamp. Your task now is to install Prometheus and set it up to function as a service.<\/p>\n
Setting up Prometheus<\/h3>\n
To start the process, ensure you have Prometheus installed. Begin by logging into your server and proceed by updating the package lists in the provided manner.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> apt<\/span> update<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterward, you will proceed to generate the directories for Prometheus configuration and data. To establish a configuration directory named prometheus, execute the subsequent command:<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mkdir<\/span> -p<\/span> \/etc\/prometheus<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterward, establish the directories for data.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mkdir<\/span> -p<\/span> \/var\/lib\/prometheus<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nOnce you have successfully set up the directories, you can proceed to obtain the compressed installation file. Prometheus offers precompiled binary files in compressed formats. To acquire the Prometheus installation file, visit the designated download page.<\/p>\n
To acquire version 2.31.0, execute the subsequent command, substituting the required version number:<\/p>\n
<\/code><\/pre>\n- \n
- wget<\/span> https:\/\/github.com\/prometheus\/prometheus\/releases\/download\/v2.31.0<\/mark>\/prometheus-2.31.0.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfter downloading the file, you can extract it by using the tarball option.<\/p>\n
<\/code><\/pre>\n- \n
- tar<\/span> -xvf<\/span> prometheus-2.31.0.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nOnce the file has been extracted, go to the folder named Prometheus.<\/p>\n
<\/code><\/pre>\n- \n
- cd<\/span> prometheus-2.31.0.<\/mark>linux-amd64<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterwards, transfer the prometheus and promtool executable files to the \/usr\/local\/bin\/ folder.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mv<\/span> prometheus promtool \/usr\/local\/bin\/<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterwards, you will relocate all the files associated with Prometheus to a single destination: \/etc\/prometheus\/. To accomplish this, execute the given command to transfer the console files found in the consoles folder and the library files located in the console_libraries folder.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mv<\/span> consoles\/ console_libraries\/ \/etc\/prometheus\/<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nThe Prometheus GUI is accessed through the console and console library files. These files are stored together with the configuration files to ensure they are readily available when starting the service.<\/p>\n
Lastly, relocate the prometheus.yml template configuration file to the \/etc\/prometheus\/ folder.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mv<\/span> prometheus.yml \/etc\/prometheus\/prometheus.yml<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nThe Prometheus configuration file, prometheus.yml, is the designated file for customizing the port settings and determining the necessary files to enable when initiating the service.<\/p>\n
To inquire about the installed Prometheus version, execute the following command:<\/p>\n
<\/code><\/pre>\n- \n
- prometheus –version<\/span><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nYou will get output that looks like this:<\/p>\n
<\/code><\/pre>\nOutput<\/div>\n<\/code><\/pre>\nprometheus, version 2.31.0<\/mark> (branch: HEAD, revision: b41e0750abf5cc18d8233161560731de05199330) build user: root@0aa1b7fc430d build date: 20220714-15:13:18 go version: go1.18.4 platform: linux\/amd64<\/p>\n
<\/code><\/pre>\nAfter successfully installing Prometheus in the previous section and confirming its version, the next step will be to initiate it as a service.<\/p>\n
Using Prometheus in a service-oriented manner<\/h3>\n
Once Prometheus has been installed, you will proceed with setting it up to run as a service.<\/p>\n
To achieve this, first establish a Prometheus group and user before developing the system file. It is important to have a specific user with owner privileges for the relevant folders. Carry out the following command to establish a Prometheus group.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> groupadd<\/span> –system<\/span> prometheus<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterward, generate a prometheus user and allocate it to the previously established prometheus group.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> useradd<\/span> -s<\/span> \/sbin\/nologin –system<\/span> -g<\/span> prometheus<\/mark> prometheus<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nModify the ownership and permissions of the directory accordingly to ensure that the dedicated user possesses the accurate permissions.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> chown<\/span> -R<\/span> prometheus:prometheus \/etc\/prometheus\/ \/var\/lib\/prometheus\/<\/li>\n
- sudo<\/span> chmod<\/span> -R<\/span> 775<\/span> \/etc\/prometheus\/ \/var\/lib\/prometheus\/<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterwards, you will generate the service file for executing Prometheus as a service. Employing either nano or your preferred text editor, forge a prometheus.service file within the systemd service.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> nano<\/span> \/etc\/systemd\/system\/prometheus.service<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nInclude these lines of code:<\/p>\n
Insert the following code snippets:<\/p>\n
Incorporate the subsequent lines of code:<\/p>\n
Integrate the following code lines:<\/p>\n
One possible option for paraphrasing “\/etc\/systemd\/system\/prometheus.service” natively could be:
\n“A service file for Prometheus located in the systemd directory under \/etc.”<\/div>\n[Unit]\r\nDescription=Prometheus\r\nts=network-online.target\r\nAfter=network-online.target\r\n\r\n[Service]\r\nUser=prometheus\r\nGroup=prometheus\r\nRestart=always\r\nType=simple\r\nExecStart=\/usr\/local\/bin\/prometheus \\\r\n --config.file=\/etc\/prometheus\/prometheus.yml \\\r\n --storage.tsdb.path=\/var\/lib\/prometheus\/ \\\r\n --web.console.templates=\/etc\/prometheus\/consoles \\\r\n --web.console.libraries=\/etc\/prometheus\/console_libraries \\\r\n --web.listen-address=0.0.0.0:9090\r\n\r\n[Install]\r\ntedBy=multi-user.target\r\n<\/code><\/pre>\nBy utilizing this code, you can set up Prometheus to utilize the files mentioned in the ExecStart section in order to operate the service. The service file instructs systemd to execute Prometheus with the prometheus user, using the configuration file located at \/etc\/prometheus\/prometheus.yml and storing its data in the \/var\/lib\/prometheus directory. Additionally, Prometheus is configured to operate on port 9090. Please note that the detailed explanation of systemd service files is not covered in this tutorial, however, you can find more information at Understanding Systemd Units and Unit Files.<\/p>\n
Please save and close your file. If you are using nano, press CTRL+X, followed by Y.<\/p>\n
Begin running the Prometheus service.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> systemctl start prometheus<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAllow the Prometheus service to initiate automatically upon system initialization.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> systemctl enable<\/span> prometheus<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nTo determine the service status, you can utilize the given command.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> systemctl status prometheus<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nThe result will verify the service’s active status.<\/p>\n
\nGenerate a single option of the following paraphrase:<\/p>\n
Result<\/p>\n<\/div>\n
\u25cf prometheus.service - Prometheus\r\n Loaded: loaded (\/etc\/systemd\/system\/prometheus.service; enabled; vendor preset: enabled)\r\n Active: active (running)<\/mark> since Fri 2022-08-05 18:06:05 UTC; 13s ago\r\n Main PID: 7177 (prometheus)\r\n Tasks: 6 (limit: 527)\r\n Memory: 21.0M\r\n CGroup: \/system.slice\/prometheus.service\r\n \u2514\u25007177 \/usr\/local\/bin\/prometheus --config.file=\/etc\/prometheus\/prometheus.yml --storage.tsdb.path=\/var\/lib\/prometheus\/ --web.console.template>\r\n<\/code><\/pre>\nTo open Prometheus, open your web browser and go to your server’s IP address with port 9090 added at the end: http:\/\/your_server_ip:9090.<\/p>\n
\nNote<\/p>\n
Please ensure that port 9090 is allowed on your server in order to access the Prometheus web console. To verify your existing UFW ruleset, execute the following command:
\nsudo ufw status<\/div>\nIf port 9090 is currently not permitted, you can grant access by executing the following command:
\nsudo ufw allow 9090<\/p>\n<\/div>\nThe Prometheus web console is now available for your access.<\/p>\n
![\"Screencapture](\"https:\/\/cdn.silicloud.com\/blog-img\/blog\/img\/655c7e32c40ba52feef2082f\/65-0.png\" "\\"\\"")
<\/div>\nAfter completing this stage, Prometheus was successfully installed and set up as a service. Now, the next step involves associating your MongoDB database with Prometheus by utilizing the MongoDB exporter.<\/p>\n
Second step: Configuring the MongoDB Exporter.<\/h2>\n
To collect metrics, Prometheus utilizes scraping of targets. Now, you will need to install the MongoDB exporter and configure it as a Prometheus target to enable data collection from your MongoDB instance.<\/p>\n
The process of setting up the MongoDB Exporter software.<\/h3>\n
Create a folder for the MongoDB exporter in this section and go to it.<\/p>\n
<\/code><\/pre>\n- \n
- mkdir<\/span> mongodb-exporter<\/mark><\/li>\n
- cd<\/span> mongodb-exporter<\/mark><\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nTo obtain the MongoDB exporter, access it on Github. It is accessible as a binary file in an archive, which you will subsequently set up as a service. Use the specified command to download the binary file.<\/p>\n
<\/code><\/pre>\n- \n
- wget<\/span> https:\/\/github.com\/percona\/mongodb_exporter\/releases\/download\/v0.7.1<\/mark>\/mongodb_exporter-0.7.1.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nAfterwards, unzip the downloaded archive and place its contents into your existing directory.<\/p>\n
<\/code><\/pre>\n- \n
- tar<\/span> xvzf mongodb_exporter-0.7.1.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
<\/code><\/pre>\n<\/p>\n
<\/code><\/pre>\nIn the end, relocate the mongodb_exporter executable to usr\/local\/bin\/.<\/p>\n
<\/code><\/pre>\n- \n
- sudo<\/span> mv<\/span> mongodb_exporter \/usr\/local\/bin\/<\/li>\n<\/ol>\n
<\/code><\/pre>\n
- sudo<\/span> mv<\/span> mongodb_exporter \/usr\/local\/bin\/<\/li>\n<\/ol>\n
- tar<\/span> xvzf mongodb_exporter-0.7.1.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
- cd<\/span> mongodb-exporter<\/mark><\/li>\n<\/ol>\n
- mkdir<\/span> mongodb-exporter<\/mark><\/li>\n
- sudo<\/span> systemctl status prometheus<\/li>\n<\/ol>\n
- sudo<\/span> systemctl enable<\/span> prometheus<\/li>\n<\/ol>\n
- sudo<\/span> systemctl start prometheus<\/li>\n<\/ol>\n
- sudo<\/span> chmod<\/span> -R<\/span> 775<\/span> \/etc\/prometheus\/ \/var\/lib\/prometheus\/<\/li>\n<\/ol>\n
- sudo<\/span> chown<\/span> -R<\/span> prometheus:prometheus \/etc\/prometheus\/ \/var\/lib\/prometheus\/<\/li>\n
- sudo<\/span> useradd<\/span> -s<\/span> \/sbin\/nologin –system<\/span> -g<\/span> prometheus<\/mark> prometheus<\/mark><\/li>\n<\/ol>\n
- sudo<\/span> groupadd<\/span> –system<\/span> prometheus<\/mark><\/li>\n<\/ol>\n
- prometheus –version<\/span><\/li>\n<\/ol>\n
- sudo<\/span> mv<\/span> prometheus.yml \/etc\/prometheus\/prometheus.yml<\/li>\n<\/ol>\n
- sudo<\/span> mv<\/span> consoles\/ console_libraries\/ \/etc\/prometheus\/<\/li>\n<\/ol>\n
- sudo<\/span> mv<\/span> prometheus promtool \/usr\/local\/bin\/<\/li>\n<\/ol>\n
- cd<\/span> prometheus-2.31.0.<\/mark>linux-amd64<\/li>\n<\/ol>\n
- tar<\/span> -xvf<\/span> prometheus-2.31.0.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
- wget<\/span> https:\/\/github.com\/prometheus\/prometheus\/releases\/download\/v2.31.0<\/mark>\/prometheus-2.31.0.<\/mark>linux-amd64.tar.gz<\/li>\n<\/ol>\n
- sudo<\/span> mkdir<\/span> -p<\/span> \/var\/lib\/prometheus<\/mark><\/li>\n<\/ol>\n
- sudo<\/span> mkdir<\/span> -p<\/span> \/etc\/prometheus<\/mark><\/li>\n<\/ol>\n
- sudo<\/span> apt<\/span> update<\/li>\n<\/ol>\n