Lab
Cloud

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.

Get started Contact sales

Path Info

Level

Intermediate

Duration

45m

Last updated

Aug 19, 2025

Challenge

Install and Run Pushgateway

Create a user and group for Pushgateway:

sudo useradd -M -r -s /bin/false pushgateway

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

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

Start and enable the pushgateway service:

sudo systemctl enable pushgateway

sudo systemctl start pushgateway

Verify the service is running and serving metrics:

sudo systemctl status pushgateway

curl localhost:9091/metrics

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
```

Author

Pluralsight Skills

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.

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.

Ready to get started?

View individual plans View team plans