Featured resource
2025 Tech Upskilling Playbook
Tech Upskilling Playbook

Build future-ready tech teams and hit key business milestones with seven proven plays from industry leaders.

Check it out
  • Lab
    • Libraries: If you want this lab, consider one of these libraries.
    • Cloud
Google Cloud Platform icon
Labs

Installing Prometheus Pushgateway

The Prometheus pull model provides a highly resilient method for gathering metrics. However, there are a few cases where this model is not a good fit. Prometheus Pushgateway serves as a middleman, providing a push-based method for gathering metrics without compromising the simplicity of Prometheus server. In this lab, you will have the opportunity to install and configure your own Prometheus Pushgateway instance. This will give you some hands-on experience with the process of setting up Pushgateway.

Google Cloud Platform icon
Lab platform
Lab Info
Level
Intermediate
Last updated
Sep 19, 2025
Duration
45m

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.
Table of Contents
  1. Challenge

    Install and Run Pushgateway
    1. Log in to the Prometheus server.

    2. Create a user and group for Pushgateway:

      sudo useradd -M -r -s /bin/false pushgateway
      
    3. Download and install the Pushgateway binary:

      wget https://github.com/prometheus/pushgateway/releases/download/v1.2.0/pushgateway-1.2.0.linux-amd64.tar.gz
      
      tar xvfz pushgateway-1.2.0.linux-amd64.tar.gz
      
      sudo cp pushgateway-1.2.0.linux-amd64/pushgateway /usr/local/bin/
      
      sudo chown pushgateway:pushgateway /usr/local/bin/pushgateway
      
    4. Create a systemd unit file for Pushgateway:

      sudo vi /etc/systemd/system/pushgateway.service
      
      [Unit]
      Description=Prometheus Pushgateway
      Wants=network-online.target
      After=network-online.target
      
      [Service]
      User=pushgateway
      Group=pushgateway
      Type=simple
      ExecStart=/usr/local/bin/pushgateway
      
      [Install]
      WantedBy=multi-user.target
      
    5. Start and enable the pushgateway service:

      sudo systemctl enable pushgateway
      
      sudo systemctl start pushgateway
      
    6. Verify the service is running and serving metrics:

      sudo systemctl status pushgateway
      
      curl localhost:9091/metrics
      
  2. Challenge

    Configure Pushgateway as a Scrape Target for Prometheus Server
    1. Edit the Prometheus config:

      sudo vi /etc/prometheus/prometheus.yml
      
    2. Under the scrape_configs section, add a scrape configuration for Pushgateway. Be sure to set honor_labels: true:

      - job_name: 'Pushgateway'
        honor_labels: true
        static_configs:
        - targets: ['localhost:9091']
      
    3. Restart Prometheus to load the new configuration:

      sudo systemctl restart prometheus
      
    4. Use expression browser to verify you can see Pushgateway metrics in Prometheus. You can access expression browser in a web browser at http://<PROMETHEUS_SERVER_PUBLIC_IP>:9090.

    5. Run a query to view some Pushgateway metric data:

      pushgateway_build_info
      
About the author

Pluralsight Skills gives leaders confidence they have the skills needed to execute technology strategy. Technology teams can benchmark expertise across roles, speed up release cycles and build reliable, secure products. By leveraging our expert content, skill assessments and one-of-a-kind analytics, keep up with the pace of change, put the right people on the right projects and boost productivity. It's the most effective path to developing tech skills at scale.

Real skill practice before real-world application

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Learn by doing

Engage hands-on with the tools and technologies you’re learning. You pick the skill, we provide the credentials and environment.

Follow your guide

All labs have detailed instructions and objectives, guiding you through the learning process and ensuring you understand every step.

Turn time into mastery

On average, you retain 75% more of your learning if you take time to practice. Hands-on labs set you up for success to make those skills stick.

Get started with Pluralsight