Skip to content

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.
  • Labs icon Lab
  • A Cloud Guru
Google Cloud Platform icon

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

Path Info

Clock icon Intermediate
Clock icon 45m
Clock icon Jun 12, 2020

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:

      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
      Description=Prometheus Pushgateway
    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
        - 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:


The Cloud Content team comprises subject matter experts hyper focused on services offered by the leading cloud vendors (AWS, GCP, and Azure), as well as cloud-related technologies such as Linux and DevOps. The team is thrilled to share their knowledge to help you build modern tech solutions from the ground up, secure and optimize your environments, and so much more!

What's a lab?

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.

Provided environment for hands-on practice

We will provide the credentials and environment necessary for you to practice right within your browser.

Guided walkthrough

Follow along with the author’s guided walkthrough and build something new in your provided environment!

Did you know?

On average, you retain 75% more of your learning if you get time for practice.

Start learning by doing today

View Plans