www.linode.com Open in urlscan Pro
2a02:26f0:1700:11::b856:678c  Public Scan

Form analysis
3 forms found in the DOM

GET https://www.linode.com

<form role="search" method="get" action="https://www.linode.com" class="c-search"><label for="s">Search</label>
  <input type="search" placeholder="Search Linode" name="s" id="s">
  <input type="submit" value="Search">
</form>

https://login.linode.com/signup

<form :action="signupURL(false)" data-turbo="false" action="https://login.linode.com/signup"><input type="hidden" name="promo" :value="promoCode()" value="docs032323">
  <button @click="$store.nav.analytics.handler.convertObject(document.body.dataset.objectid, 'DOCS: Promo Code')" type="submit" formtarget="_blank"
    class="bg-transparent hover:bg-gray-800 text-white text-md font-semibold py-2 px-4 border border-white hover:border-gray-800 rounded"> Sign Up</button>
</form>

POST https://delighted.com/t/KGQxrivu?referrer=%2Fdocs%2Fguides%2Fhow-to-install-prometheus-and-grafana-on-ubuntu%2F

<form data-turbo="false" x-data="{}" :action="'https://delighted.com/t/KGQxrivu?referrer=' + encodeURIComponent(window.location.pathname)" method="post" target="_blank" novalidate=""
  action="https://delighted.com/t/KGQxrivu?referrer=%2Fdocs%2Fguides%2Fhow-to-install-prometheus-and-grafana-on-ubuntu%2F">
  <div class="flex flex-col items-center">
    <h2 id="delighted">Your Feedback Is Important</h2>
    <p class="text-base text-titlecolor md:text-lg mb-6 mt-2 text-center">Let us know if this guide was helpful to you.</p><button type="submit" @click="$store.nav.analytics.handler.convertObject(document.body.dataset.objectid, 'DOCS: Feedback')"
      class="btn p-4 rounded-md border-2 border-gray-400 hover:border-brand hover:text-brand text-sm sm:text-lg" value="Feedback" name="feedback"> Provide Feedback</button>
  </div>
</form>

Text Content

We’re working on integrating Linode and Akamai. Learn more.
 * Search
 * Partners
 * Docs
 * Support
 * Sales
 * Careers
 * Log In


 * Why Choose Us
 * Products
 * Industries
 * Marketplace
 * Pricing
 * Community
 * Sign Up
 * Mobile

 * Why Choose Us
   * Why Choose Us
   * Global Infrastructure
   * Cloud Simplified
   * Predictable Pricing
   * Support Experience
   * Free Bundled Services
   * Customer Stories
   * Cloud for Business
   * Our Approach
   * What is Cloud Computing?
 * Products
   * Products Overview
   * Compute
     * Dedicated CPU
     * Shared CPU
     * High Memory
     * Premium CPU
     * GPU
     * Kubernetes
     * EdgeWorkers
   * Storage
     * Block Storage
     * Object Storage
     * Backups
   * Databases
     * Managed Databases
     * MySQL
     * PostgreSQL
   * Services
     * Managed
     * Professional Services
   * Networking
     * Cloud Firewall
     * DDoS Protection
     * DNS Manager
     * NodeBalancers
     * VLAN
   * Developer Tools
     * Cloud Manager
     * API
     * CLI
     * Terraform Provider
     * Ansible Collection
     * Images
     * Integrations
     * StackScripts
     * Monitoring
     * Users & Permissions
   * Delivery
     * Adaptive Media Delivery
     * Download Delivery
     * Ion
     * Global Traffic
   * Security
     * Guardicore
     * Kona Site Defender
     * App & API Protector
     * Bot Manager
     * Account Protector
     * EAA
 * Industries
   * Digital Agencies
   * Ecommerce
   * Education
   * Gaming
   * Managed Hosting
   * Managed Service Providers
   * Media
   * SaaS
 * Marketplace
   * Browse Marketplace
   * Submit Marketplace App
 * Pricing
   * Pricing List
   * Cloud Estimator
   * Cloud Pricing Calculator
 * Community
   * Community Overview
   * Q&A
   * Developer Portal
   * Affiliate Program
   * Beta Program
   * Customer Referral Program
   * Partner Program
   * Startup Programs
   * Blog
   * Content Resources
   * Events
   * Newsletter
   * Promotional Offers
   * Distributions
   * Kernels
 * Company
   * About Us
   * Press Center
   * Careers
   * Legal
   * Sales
   * System Status

 * Search
 * Docs
 * Blog
 * Resources
 * Pricing
 * Partners
 * Support
 * Sales

Search
 * Log In
 * Sign Up

FEATURED

Hero Forge
Secure, Accessible GPU Instances
Unleash Millions of Adventurers
Read Story
 * Why Choose Us
 * Global Infrastructure
 * Cloud Simplified
 * Predictable Pricing
 * Support Experience
 * Free Bundled Services

 * About Us
 * Customer Stories
 * Cloud for Business
 * Our Approach
 * What is Cloud Computing?

FEATURED

Free Bundled Services
Discover our no-cost security, networking,
maintenance, and monitoring solutions.
Learn More
View All Products

COMPUTE

 * Dedicated CPU
 * Shared CPU
 * High Memory
 * Premium CPU
 * GPU
 * Kubernetes
 * EdgeWorkers

STORAGE

 * Block Storage
 * Object Storage
 * Backups

DATABASES

 * Managed Databases
 * MySQL
 * PostgreSQL

NETWORKING

 * Cloud Firewall
 * DDoS Protection
 * DNS Manager
 * NodeBalancers
 * VLAN

DEVELOPER TOOLS

 * Cloud Manager
 * API
 * CLI
 * Terraform Provider
 * Ansible Collection
 * Images
 * Integrations
 * StackScripts
 * Monitoring
 * Users & Permissions

DELIVERY

 * Adaptive Media Delivery
 * Download Delivery
 * Ion
 * Global Traffic

SECURITY

 * Guardicore
 * Kona Site Defender
 * App & API Protector
 * Bot Manager
 * Account Protector
 * EAA

SERVICES

 * Managed
 * Professional Services

FEATURED

Portability in the Cloud
Best Practices for Building SaaS-Based Applications
Get Your Copy

INDUSTRIES

 * Digital Agencies
 * Ecommerce
 * Education
 * Gaming
 * Managed Hosting
 * Managed Service Providers
 * Media
 * SaaS

FEATURED

Cloud Pricing Calculator
Estimate your cloud costs. Price and configure cloud features to match your
needs.
Launch Calculator

PRICING

 * Pricing List
 * Cloud Estimator
 * Cloud Pricing Calculator

FREE EBOOK

Try IAC by Justin Mitchel
A step-by-step IAC guide for Terraform,
Ansible, Puppet, Chef, and Salt
Download

COMMUNITY

 * Overview
 * Q&A
 * Developer Portal
 * Affiliate Program
 * Beta Program
 * Customer Referral Program
 * Partner Program
 * Startup Programs

ENGAGE WITH US

 * Blog
 * Content Resources
 * Events
 * Newsletter
 * Press Center
 * Promotional Offers
 * Find a Partner

Explore docs

 1. Docs Home
 2. Guides
 3. Uptime & Analytics
 4. Server Monitoring
 5. 

 * Contents
   Contents
   
   
   
   
   


CONTENTS

 1. What is Prometheus?
 2. What is Grafana?
 3. Marketplace App
 4. Before You Begin
 5. How to Install and Configure Prometheus, Grafana, and Node Exporter
    1. How to Download and Install Prometheus
    2. How to Configure Prometheus as a Service
    3. How to Install and Configure Node Exporter on the Client
    4. How to Configure Prometheus to Monitor Client Nodes
    5. How to Install and Deploy the Grafana Server
    6. How to Integrate Grafana and Prometheus
    7. How to Import a Grafana Dashboard
 6. Conclusion
 7. More Information
 8. Your Feedback Is Important

Filtered by search term
   
   
 * 
   Products
   406
   
   
   
 * 
   Guides
   1695
   
   
   
      
      
    * 
      Akamai + Linode
      1
      
      
      
    * 
      Applications
      218
      
      
      
    * 
      Databases
      177
      
      
      
    * 
      Development
      287
      
      
      
    * 
      Email Server Guides
      67
      
      
      
    * 
      Game Servers
      25
      
      
      
    * 
      IPs, Networking & Domains
      70
      
      
      
    * 
      Kubernetes
      60
      
      
      
    * 
      Linode Platform
      17
      
      
      
    * 
      Quick Answers
      63
      
      
      
    * 
      Security, Upgrades & Backups
      153
      
      
      
    * 
      Tools & Reference
      119
      
      
      
    * 
      Uptime & Analytics
      55
      
      
      
         
         
       * 
         Analytics
         18
         
         
         
       * 
         Load Balancing
         2
         
         
         
       * 
         Logs
         1
         
         
         
       * 
         Server Monitoring
         33
         
         
         
            
            
          * 
            How to Install Nagios on CentOS 8
            
          * 
            Setting Up the Adagios Web Interface for Nagios
            
          * 
            How to Install and Configure Prometheus and Grafana on Ubuntu
            
          * 
            Configuring Nagios Alerts on Debian 10 and Ubuntu 20.04
            
          * 
            Install Nagios on Debian 10 and Ubuntu 20.04
            
          * 
            Linux System Monitoring Fundamentals
            
          * 
            Using Monitorix for System Monitoring
            
          * 
            Using Nethogs to Monitor Network Usage
            
          * 
            Using the System Activity Reporter (sar)
            
          * 
            Monitoring Your System with Graphite and a Grafana Dashboard
            
          * 
            Monitor Remote Hosts with Icinga
            
          * 
            Install Icinga 2 Monitoring on Debian 9
            
          * 
            How to Install and Configure Graylog2 on Debian 9
            
          * 
            Install Nagios 4 on Ubuntu and Debian 8
            
          * 
            Deploy Graphite with Grafana on Ubuntu 14.04
            
          * 
            Installing Monit for Server Monitoring
            
          * 
            Monitor System Logs with Logwatch
            
          * 
            Using top to Monitor Server Performance
            
          * 
            Install and Configure OSSEC on Debian 7
            
          * 
            Monitor Services with Nagios on Ubuntu 12.04
            
          * 
            Use Cacti to Monitor Resource Utilization on Ubuntu 12.04
            
          * 
            Deploy Munin to Monitor Servers on Ubuntu 12.04
            
          * 
            Monitoring Servers with Zabbix
            
          * 
            Monitoring Servers with Munin on Ubuntu 11.04 (Natty)
            
          * 
            Monitoring Servers with Munin on Debian 6 (Squeeze)
            
          * 
            Nagios Server Monitoring
            
          * 
            Monitor Services with Nagios on Gentoo Linux
            
          * 
            Monitor Services with Nagios on Ubuntu 10.10 (Maverick)
            
          * 
            Use vmstat to Monitor System Performance
            
          * 
            Monitor Services with Nagios on Ubuntu 10.04 (Lucid)
            
          * 
            Monitoring Servers with Munin on Ubuntu 10.04 (Lucid)
            
          * 
            Monitor Services with Nagios on Debian 5 (Lenny)
            
          * 
            Monitoring Resource Utilization with Cacti on Debian 5 (Lenny)
            
      
       * 
         Uptime Best Practices
         1
         
         
         
   
    * 
      Web Server Guides
      218
      
      
      
    * 
      Website Guides
      164
      
      
      

 * 
   API
   337
   
   
   
 * 
   Reference Architecture
   8
   
   
   
 * 
   Marketplace
   112
   
   
   
 * 
   Blog
   588
   
   
   
 * 
   Resources
   581
   
   
   
 * 
   Q&A
   12000
   
   
   


 1. Docs Home
 2. 

List Sections Tiles


SEARCH RESULTS

 results matching 

 results


NO RESULTS








Previous Next


FILTERS

Filters ( )

All


Add tags


All


Add authors


All

 1. Docs Home
 2. Guides
 3. Uptime & Analytics
 4. Server Monitoring
 5. 


HOW TO INSTALL AND CONFIGURE PROMETHEUS AND GRAFANA ON UBUNTU

Published Tuesday, June 13, 2023, by Jeff Novotny
 * Report an Issue
 * View File
 * Edit File

 * Share on Twitter
 * Share on Facebook
 * Share on Hacker News

> Traducciones al Español
> Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que
> usted esté viendo una traducción generada automáticamente. Estamos trabajando
> con traductores profesionales para verificar las traducciones de nuestro sitio
> web. Este proyecto es un trabajo en curso.

Create a Linode account to try this guide with a $100 credit.
This credit will be applied to any valid services used during your first
60 days.
Sign Up

Most administrators want to have a comprehensive overview of how their servers
are performing. Having visibility of server CPU, memory, and I/O statistics
helps them discover and isolate issues before they can cause problems.
Prometheus offers a robust node monitoring solution for collecting useful
statistics from client nodes. In conjunction with the Grafana visualization
solution, Prometheus allows users to visually monitor core server statistics.


WHAT IS PROMETHEUS?

Prometheus is an open-source system monitoring application that collects server
metrics at regular intervals. It can monitor its host server as well as external
clients. Prometheus enables external performance monitoring for all clients,
allowing for early detection of possible errors or unexpected behavior. Each
client must run a metrics collation tool known as an exporter to collect and
expose its internal statistics. For security reasons, Prometheus cannot monitor
an external node that is not collecting data in this manner.

The Prometheus server uses the HTTP protocol to poll the client servers for the
required data. It maintains a time-series database of the results, polling each
client at a predefined interval. Prometheus stores the discrete snapshots along
with the timestamps indicating when the statistics were retrieved. Prometheus
retains the metrics it collects, allowing it to build an overview of the
long-term performance of the client.

Although various statistic collectors can be used on the client nodes,
Prometheus recommends its own Node Exporter tool. Prometheus Node Exporter
collects a large number of hardware and kernel metrics, including CPU and memory
use. A full list of the available metrics collected can be found on the Node
Exporter GitHub page. Node Exporter is closely integrated with Prometheus and
shares the same data format. No conversion or pre-processing work is required to
use Node Exporter and Prometheus together. Node Exporter should be installed on
every client to monitor. Node Exporter uses port 9100, while Prometheus uses
port 9090. For more information on Prometheus, see the Prometheus Documentation.

Some additional features of Prometheus are as follows.

 * It is open source and independent of any company
 * Each Prometheus server is autonomous and does not require distributed storage
   or a central server
 * It is highly reliable and easy to install
 * Different clients can be polled at different intervals
 * It uses a flexible multi-dimensional data model with support for time-series
   data and key-value pairs
 * It supports the PromQL query language for retrieving and analyzing data
 * It includes the AlertManger component. AlertManager receives alerts from
   clients and pushes them out to different subscribers
 * Prometheus can feed its metrics into visualization tools such as Grafana
 * The optional Prometheus PushGateway supports the push-based metric collection
 * It is customizable and supports third-party libraries
 * It supports Docker containerization and Kubernetes
 * Prometheus has a large and active developer and user community


WHAT IS GRAFANA?

Grafana is a visualization application available in both open-source and
enterprise editions. Grafana does not collect any metrics from the clients and
it does not store any data. Instead, the Grafana user interface displays the
metrics collected by Prometheus or another data source in an intuitive and
visually-appealing format. Grafana presents the data using a dashboard. A
dashboard is a template to define the values to display and how to display them.
Most dashboards provide additional options, allowing users to exercise more
control over the presentation.

Grafana supports a wide range of dashboards, including the Prometheus Node
Exporter dashboard. Grafana features the approved dashboards in the Grafana
Dashboard Library. It also allows users to create their own panels and run their
own queries on a data source. Grafana can also connect to SQL or NoSQL
databases, and incident ticket applications such as Jira, and GitLab. Multiple
data sources can be integrated within the same dashboard.

Grafana supports alerts, annotations, dashboard variables, plugins, and
authentication. It also provides a range of analytics tools to further
deconstruct the data. The Grafana web interface can be accessed using port 3000
of the host server. For best results, run Prometheus and Grafana on the same
server. For more background information, see the Introduction to Grafana.


MARKETPLACE APP

Installing a complete Prometheus and Grafana-based system is a multi-step
process. To streamline deployments, you can use the Prometheus and Grafana
Marketplace App. For a more traditional and hands-on deployment, follow the
instructions below.


BEFORE YOU BEGIN

 1. If you have not already done so, create a Linode account and Compute
    Instance. See our Getting Started with Linode and Creating a Compute
    Instance guides.

 2. Follow our Setting Up and Securing a Compute Instance guide to update your
    system. You may also wish to set the timezone, configure your hostname,
    create a limited user account, and harden SSH access.

 3. Prometheus requires 4GB of memory and 20GB of disk space and works best with
    at least two CPU cores.

 4. In most cases, Prometheus and Grafana are used to monitor external servers.
    To duplicate the configuration in this guide, create and set up a second
    Linode Compute Instance to use as a client.

Note
The steps in this guide are written for non-root users. Commands that require
elevated privileges are prefixed with sudo. If you are not familiar with the
sudo command, see the Linux Users and Groups guide.


HOW TO INSTALL AND CONFIGURE PROMETHEUS, GRAFANA, AND NODE EXPORTER

In these instructions, the system hosting the Prometheus server is referred to
as the “monitoring server”. The system being monitored is a “client”. It is
possible to develop very complicated custom exporters and dashboards using
Prometheus and Grafana. However, this guide describes a more straightforward
solution for monitoring the most critical client details, including CPU, memory,
and I/O usage. It does not require any knowledge of PromQL or any low-level
details for either Prometheus or Grafana.

To configure the end-to-end solution, the following steps are required.

 1. Download and install Prometheus on the monitoring system.
 2. Configure Prometheus to run as a service.
 3. Install Node Exporter on all clients.
 4. Configure Prometheus to monitor the clients.
 5. Install and deploy the Grafana server.
 6. Integrate Grafana and Prometheus.
 7. Import a Dashboard for the Node Exporter Statistics.

This guide is designed for Ubuntu 22.04 LTS users but is generally applicable to
the most recent Ubuntu releases.

Note
Clients can run different releases of Ubuntu than the monitoring system and do
not have to use the Ubuntu distribution. However, Node Exporter is only
available for Linux.


HOW TO DOWNLOAD AND INSTALL PROMETHEUS

Prometheus can be downloaded as a precompiled binary from the GitHub repository.
The Prometheus Downloads repository lists the most recent release of Prometheus.
The Prometheus GitHub page also provides instructions on how to build Prometheus
from the source code or run it as a Docker container. To download Prometheus,
follow these steps.

 1.  Visit the Prometheus downloads and make a note of the most recent release.
     The most recent LTS release is clearly indicated on the site.

 2.  Use wget to download Prometheus to the monitoring server. The target link
     has the format
     https://github.com/prometheus/prometheus/releases/download/v[release]/prometheus-[release].linux-amd64.tar.gz.
     Replace the string [release] with the actual release to download. For
     example, the following command downloads release 2.37.6.
     
     wget https://github.com/prometheus/prometheus/releases/download/v2.37.6/prometheus-2.37.6.linux-amd64.tar.gz
     
     

 3.  Extract the archived Prometheus files.
     
     tar xvfz prometheus-*.tar.gz
     
     

 4.  (Optional) After the files have been extracted, delete the archive or move
     it to a different location for storage.
     
     rm prometheus-*.tar.gz
     
     

 5.  Create two new directories for Prometheus to use. The /etc/prometheus
     directory stores the Prometheus configuration files. The
     /var/lib/prometheus directory holds application data.
     
     sudo mkdir /etc/prometheus /var/lib/prometheus
     
     

 6.  Move into the main directory of the extracted prometheus folder. Substitute
     the name of the actual directory in place of prometheus-2.37.6.linux-amd64.
     
     cd prometheus-2.37.6.linux-amd64
     
     

 7.  Move the prometheus and promtool directories to the /usr/local/bin/
     directory. This makes Prometheus accessible to all users.
     
     sudo mv prometheus promtool /usr/local/bin/
     
     

 8.  Move the prometheus.yml YAML configuration file to the /etc/prometheus
     directory.
     
     sudo mv prometheus.yml /etc/prometheus/prometheus.yml
     
     

 9.  The consoles and console_libraries directories contain the resources
     necessary to create customized consoles. This feature is more advanced and
     is not covered in this guide. However, these files should also be moved to
     the etc/prometheus directory in case they are ever required.
     
     Note
     After these directories are moved over, only the LICENSE and NOTICE files
     remain in the original directory. Back up these documents to another
     location and delete the prometheus-releasenum.linux-amd64 directory.
     
     sudo mv consoles/ console_libraries/ /etc/prometheus/
     
     

 10. Verify that Prometheus is successfully installed using the below command:
     
     prometheus --version
     
     
     
     prometheus, version 2.37.6 (branch: HEAD, revision: 8ade24a23af6be0f35414d6e8ce09598446c29a2)
     build user:       root@5f96027a7c3e
     build date:       20230220-09:36:40
     go version:       go1.19.6
     platform:         linux/amd64


HOW TO CONFIGURE PROMETHEUS AS A SERVICE

Although Prometheus can be started and stopped from the command line, it is more
convenient to run it as a service using the systemctl utility. This allows it to
run in the background.

Before Prometheus can monitor any external systems, additional configuration
details must be added to the prometheus.yml file. However, Prometheus is already
configured to monitor itself, allowing for a quick sanity test. To configure
Prometheus, follow the steps below.

 1. Create a prometheus user. The following command creates a system user.
    
    sudo useradd -rs /bin/false prometheus
    
    

 2. Assign ownership of the two directories created in the previous section to
    the new prometheus user.
    
    sudo chown -R prometheus: /etc/prometheus /var/lib/prometheus
    
    

 3. To allow Prometheus to run as a service, create a prometheus.service file
    using the following command:
    
    sudo vi /etc/systemd/system/prometheus.service
    
    
    
    Enter the following content into the file:
    
    
    File: /etc/systemd/system/prometheus.service
    
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    
    
    [Unit]
    Description=Prometheus
    Wants=network-online.target
    After=network-online.target
    
    [Service]
    User=prometheus
    Group=prometheus
    Type=simple
    Restart=on-failure
    RestartSec=5s
    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 \
        --web.listen-address=0.0.0.0:9090 \
        --web.enable-lifecycle \
        --log.level=info
    
    [Install]
    WantedBy=multi-user.target
    
    * The Wants and After options must be set to network-online.target.
    * The User and Group fields must both be set to prometheus.
    * The ExecStart parameter explains where to find the prometheus executable
      and defines the default options.
    * The config.file option defines the location of the Prometheus
      configuration file as /etc/prometheus/prometheus.yml.
    * storage.tsdb.path tells Prometheus to store application data in the
      /var/lib/prometheus/ directory.
    * web.listen-address is set to 0.0.0.0:9090, allowing Prometheus to listen
      for connections on all network interfaces.
    * The web.enable-lifecycle option allows users to reload the configuration
      file without restarting Prometheus.

 4. Reload the systemctl daemon.
    
    sudo systemctl daemon-reload
    
    

 5. (Optional) Use systemctl enable to configure the prometheus service to
    automatically start when the system boots. If this command is not added,
    Prometheus must be launched manually.
    
    sudo systemctl enable prometheus
    
    

 6. Start the prometheus service and review the status command to ensure it is
    active.
    
    Note
    If the prometheus service fails to start properly, run the command
    journalctl -u prometheus -f --no-pager and review the output for errors.
    
    sudo systemctl start prometheus
    sudo systemctl status prometheus
    
    
    
    prometheus.service - Prometheus
    Loaded: loaded (/etc/systemd/system/prometheus.service; enabled; vendor preset: enabled)
    Active: active (running) since Mon 2023-04-10 13:06:50 UTC; 7s ago

 7. Access the Prometheus web interface and dashboard at
    http://local_ip_addr:9090. Replace local_ip_addr with the address of the
    monitoring server. Because Prometheus is using the default configuration
    file, it does not display much information yet.
    
    

 8. The default prometheus.yml file contains a directive to scrape the local
    host. Click Status and Targets to list all the targets. Prometheus should
    display the local Prometheus service as the only target.
    
    


HOW TO INSTALL AND CONFIGURE NODE EXPORTER ON THE CLIENT

Before a remote system can be monitored, it must have some type of client to
collect the statistics. Several third-party clients are available. However, for
ease of use, Prometheus recommends the Node Exporter client. After Node Exporter
is installed on a client, the client can be added to the list of servers to
scrape in prometheus.yml.

To install Node Exporter, follow these steps. Repeat these instructions for
every client.

Note
When Node Exporter is running, its collection of statistics is available on port
9100. This port is accessible on the internet and anyone running Prometheus
elsewhere can potentially collect them. If you are using a firewall, you must
open port 9100 using the command sudo ufw allow 9100.

 1.  Consult the Node Exporter section of the Prometheus downloads page and
     determine the latest release.

 2.  Use wget to download this release. The format for the file is
     https://github.com/prometheus/node_exporter/releases/download/v[release_num]/node_exporter-[release_num].linux-amd64.tar.gz.
     Replace [release_num] with the number corresponding to the actual release.
     For example, the following example demonstrates how to download Node
     Exporter release 1.5.0.
     
     wget https://github.com/prometheus/node_exporter/releases/download/v1.5.0/node_exporter-1.5.0.linux-amd64.tar.gz
     
     

 3.  Extract the application.
     
     tar xvfz node_exporter-*.tar.gz
     
     

 4.  Move the executable to usr/local/bin so it is accessible throughout the
     system.
     
     sudo mv node_exporter-1.5.0.linux-amd64/node_exporter /usr/local/bin
     
     

 5.  (Optional) Remove any remaining files.
     
     rm -r node_exporter-1.5.0.linux-amd64*
     
     

 6.  There are two ways of running Node Exporter. It can be launched from the
     terminal using the command node_exporter. Or, it can be activated as a
     system service. Running it from the terminal is less convenient. But this
     might not be a problem if the tool is only intended for occasional use. To
     run Node Exporter manually, use the following command. The terminal outputs
     details regarding the statistics collection process.
     
     node_exporter
     
     

 7.  It is more convenient to run Node Exporter as a service. To run Node
     Exporter this way, first, create a node_exporter user.
     
     sudo useradd -rs /bin/false node_exporter
     
     

 8.  Create a service file for systemctl to use. The file must be named
     node_exporter.service and should have the following format. Most of the
     fields are similar to those found in prometheus.service, as described in
     the previous section.
     
     sudo vi /etc/systemd/system/node_exporter.service
     
     
     
     File: /etc/systemd/system/node_exporter.service
     
      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     
     
     [Unit]
     Description=Node Exporter
     Wants=network-online.target
     After=network-online.target
     
     [Service]
     User=node_exporter
     Group=node_exporter
     Type=simple
     Restart=on-failure
     RestartSec=5s
     ExecStart=/usr/local/bin/node_exporter
     
     [Install]
     WantedBy=multi-user.target

 9.  (Optional) If you intend to monitor the client on an ongoing basis, use the
     systemctl enable command to automatically launch Node Exporter at boot
     time. This continually exposes the system metrics on port 9100. If Node
     Exporter is only intended for occasional use, do not use the command below.
     
     sudo systemctl enable node_exporter
     
     

 10. Reload the systemctl daemon, start Node Exporter, and verify its status.
     The service should be active.
     
     sudo systemctl daemon-reload
     sudo systemctl start node_exporter
     sudo systemctl status node_exporter
     
     
     
     node_exporter.service - Node Exporter
     Loaded: loaded (/etc/systemd/system/node_exporter.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-04-11 13:48:06 UTC; 4s ago

 11. Use a web browser to visit port 9100 on the client node, for example,
     http://local_ip_addr:9100. A page entitled Node Exporter is displayed along
     with a link reading Metrics. Click the Metrics link and confirm the
     statistics are being collected. For a detailed explanation of the various
     statistics, see the Node Exporter Documentation.
     
     


HOW TO CONFIGURE PROMETHEUS TO MONITOR CLIENT NODES

The client nodes are now ready for monitoring. To add clients to prometheus.yml,
follow the steps below:

 1. On the monitoring server running Prometheus, open prometheus.yml for
    editing.
    
    sudo vi /etc/prometheus/prometheus.yml
    
    

 2. Locate the section entitled scrape_configs, which contains a list of jobs.
    It currently lists a single job named prometheus. This job monitors the
    local Prometheus task on port 9090. Beneath the prometheus job, add a second
    job having the job_name of remote_collector. Include the following
    information.
    
    * A scrape_interval of 10s.
    * Inside static_configs in the targets attribute, add a bracketed list of
      the IP addresses to monitor. Separate each entry using a comma.
    * Append the port number :9100 to each IP address.
    * To enable monitoring of the local server, add an entry for localhost:9100
      to the list.
    
    The entry should resemble the following example. Replace remote_addr with
    the actual IP address of the client.
    
    
    File: /etc/prometheus/prometheus.yml
    
    1
    2
    3
    4
    5
    
    
    ...
    - job_name: "remote_collector"
      scrape_interval: 10s
      static_configs:
        - targets: ["remote_addr:9100"]

 3. To immediately refresh Prometheus, restart the prometheus service.
    
    sudo systemctl restart prometheus
    
    

 4. Using a web browser, revisit the Prometheus web portal at port 9090 on the
    monitoring server. Select Status and then Targets. A second link for the
    remote_collector job is displayed, leading to port 9100 on the client. Click
    the link to review the statistics.
    
    


HOW TO INSTALL AND DEPLOY THE GRAFANA SERVER

Prometheus is now collecting statistics from the clients listed in the
scrape_configs section of its configuration file. However, the information can
only be viewed as a raw data dump. The statistics are difficult to read and not
too useful.

Grafana provides an interface for viewing the statistics collected by
Prometheus. Install Grafana on the same server running Prometheus and add
Prometheus as a data source. Then install one or more panels for interpreting
the data. To install and configure Grafana, follow these steps.

 1. Install some required utilities using apt.
    
    sudo apt-get install -y apt-transport-https software-properties-common
    
    

 2. Import the Grafana GPG key.
    
    sudo wget -q -O /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key
    
    

 3. Add the Grafana “stable releases” repository.
    
    echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
    
    

 4. Update the packages in the repository, including the new Grafana package.
    
    sudo apt-get update
    
    

 5. Install the open-source version of Grafana.
    
    Note
    To install the Enterprise edition of Grafana, use the command sudo apt-get
    install grafana-enterprise instead.
    
    sudo apt-get install grafana
    
    

 6. Reload the systemctl daemon.
    
    sudo systemctl daemon-reload
    
    

 7. Enable and start the Grafana server. Using systemctl enable configures the
    server to launch Grafana when the system boots.
    
    sudo systemctl enable grafana-server.service
    sudo systemctl start grafana-server
    
    

 8. Verify the status of the Grafana server and ensure it is in the active
    state.
    
    sudo systemctl status grafana-server
    
    
    
    grafana-server.service - Grafana instance
    Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled; vendor preset: enabled)
    Active: active (running) since Tue 2023-04-11 17:31:53 UTC; 9s ago


HOW TO INTEGRATE GRAFANA AND PROMETHEUS

All system components are now installed, but Grafana and Prometheus are not set
up to interact. The remaining configuration tasks, including adding Prometheus
as the data source and importing a dashboard panel, can be accomplished using
the Grafana web interface.

To integrate Grafana and Prometheus, follow the steps below:

 1. Using a web browser, visit port 3000 of the monitoring server. For example,
    enter http://local_ip_addr:3000, replacing local_ip_addr with the actual IP
    address. Grafana displays the login page. Use the user name admin and the
    default password password. Change the password to a more secure value when
    prompted to do so.
    
    

 2. After a successful password change, Grafana displays the Grafana Dashboard.
    
    

 3. To add Prometheus as a data source, click the gear symbol, standing for
    Configuration, then select Data Sources.
    
    

 4. At the next display, click the Add data source button.
    
    

 5. Choose Prometheus as the data source.
    
    

 6. For a local Prometheus source, as described in this guide, set the URL to
    http://localhost:9090. Most of the other settings can remain at the default
    values. However, a non-default Timeout value can be added here.
    
    

 7. When satisfied with the settings, select the Save & test button at the
    bottom of the screen.
    
    

 8. If all settings are correct, Grafana confirms the Data source is working.
    
    


HOW TO IMPORT A GRAFANA DASHBOARD

A dashboard displays statistics for the client node using a more effective and
standardized layout. It is certainly possible to create a custom dashboard.
However, Prometheus has already created a dashboard to support the Node Exporter
statistics. The Node Exporter Full dashboard neatly graphs most of the values
collected from the client nodes. It is much less work to import this premade
dashboard than to create a custom one.

To import the Node Exporter dashboard, follow the steps below:

Note
To create a custom dashboard, click on the Dashboard button, which resembles
four squares. Then select + New Dashboard. Consult the Grafana guide to Building
a Dashboard for additional information.

 1. Visit the Grafana Dashboard Library. Enter Node exporter as the search term.
    
    

 2. Select the entry for Node Exporter Full.
    
    

 3. Make a note of the ID number or use the button to copy the ID to the
    clipboard. The ID of this board is currently 1860.
    
    

 4. Return to the Grafana dashboard. Select the Dashboard icon, consisting of
    four squares, and choose + Import.
    
    

 5. In the Import via grafana.com box, enter the ID 1860 from the previous step.
    Then select the Load button.
    
    

 6. At the next screen, confirm the import details. Choose Prometheus as the
    data source and click the Import button.
    
    

 7. The Node Exporter Full dashboard takes effect immediately. It displays the
    performance metrics and state of the client node, including the Memory, RAM,
    and CPU details. Several drop-down menus at the top of the screen allow
    users to select the host to observe and the time period to highlight.
    
    The following example demonstrates how a client reacts when stressed by a
    demanding Python program. The CPU Busy widget indicates how the CPU is
    pinned near the maximum. If this occurs during normal operating conditions,
    it potentially indicates more CPU power is required.
    
    


CONCLUSION

Prometheus is a system monitoring application that polls client systems for key
metrics. Each client node must use an exporter to collect and expose the
requested data. Prometheus is most effective when used together with the Grafana
visualization tool. Grafana imports the metrics from Prometheus and presents
them using an intuitive dashboard structure.

To integrate the components, download and install Prometheus on a central server
and configure Prometheus as a service. Install the Prometheus Node Exporter on
each client to collect the data and configure Prometheus to poll the clients.
Install Grafana on the same server as Prometheus and configure Prometheus as a
data source. Finally, import a dashboard to display the metrics from the client.
For more information on Prometheus, see the Prometheus Overview and
Documentation. Grafana can be best understood by reading the Introduction to
Grafana.


MORE INFORMATION

You may wish to consult the following resources for additional information on
this topic. While these are provided in the hope that they will be useful,
please note that we cannot vouch for the accuracy or timeliness of externally
hosted materials.

 * Grafana Labs
 * Grafana Dashboard Library
 * Grafana Documentation
 * Introduction to Grafana
 * Prometheus
 * Prometheus Tutorials
 * Prometheus Overview and Documentation
 * Prometheus Downloads Page
 * Prometheus GitHub page
 * Node Exporter GitHub page
 * Node Exporter Documentation
 * Node Exporter Full Grafana Dashboard
 * How to build a Dashboard in Grafana

This page was originally published on Tuesday, June 13, 2023.

ubuntu
 * Report an Issue
 * View File
 * Edit File

 * Share on Twitter
 * Share on Facebook
 * Share on Hacker News

--------------------------------------------------------------------------------


YOUR FEEDBACK IS IMPORTANT

Let us know if this guide was helpful to you.

Provide Feedback

--------------------------------------------------------------------------------

Join the conversation.
Read other comments or post your own below. Comments must be respectful,
constructive, and relevant to the topic of the guide. Do not post external links
or advertisements. Before posting, consider if your comment would be better
addressed by contacting our Support team or asking on our Community Site.
The Disqus commenting system for Linode Docs requires the acceptance of
Functional Cookies, which allow us to analyze site usage so we can measure and
improve performance. To view and create comments for this article, please update
your Cookie Preferences on this website and refresh this web page. Please note:
You must have JavaScript enabled in your browser.

Please enable JavaScript to view the <a
href=http://disqus.com/?ref_noscript>comments powered by Disqus.</a>comments
powered by Disqus
© 2003-2023 Linode LLC.
All rights reserved.
Cookie Preferences

 * Site Map
 * Support
 * Partners
 * Careers
 * Accessibility Commitment
 * Press Center
 * Legal Center
 * System Status

WHY CHOOSE US

 * Why Choose Us
 * Global Infrastructure
 * Cloud Simplified
 * Predictable Pricing
 * Support Experience
 * Free Bundled Services
 * Customer Stories
 * Cloud for Business
 * Our Approach
 * What is Cloud Computing?

COMPANY

 * About
 * Accessibility Commitment
 * Partners
 * Press Center
 * Careers
 * Legal

PRODUCTS

 * Products Overview
 * Dedicated CPU
 * Shared CPU
 * High Memory
 * Premium CPU
 * GPU
 * Kubernetes
 * Block Storage
 * Object Storage
 * Backups
 * Managed Databases
 * Cloud Firewall
 * DDoS Protection
 * DNS Manager
 * NodeBalancers
 * VLAN
 * Managed
 * Professional Services
 * Cloud Manager
 * API
 * CLI
 * Terraform Provider
 * Ansible Collection

INDUSTRIES

 * Digital Agencies
 * Ecommerce
 * Education
 * Gaming
 * Managed Hosting
 * Managed Service Providers
 * Media
 * SaaS

MARKETPLACE

 * Browse Marketplace
 * Submit Marketplace App

PRICING

 * Pricing List
 * Cloud Estimator
 * Cloud Pricing Calculator

COMMUNITY

 * Community Overview
 * Q&A
 * Developer Portal
 * Affiliate Program
 * Beta Program
 * Customer Referral Program
 * Partner Program
 * Startup Programs
 * Blog
 * Content Resources
 * Events
 * Promotional Offers
 * Distributions
 * Kernels

CONTACT

 * Support
 * System Status
 * Log in

FOLLOW US

 * Twitter
 * Instagram
 * YouTube
 * LinkedIn
 * GitHub