Navigate back to the homepage

Improve observability using Stackdriver metrics programmatically

Nancy Chauhan,ย 
May 20th, 2022 ยท 2 min read

A few months back, I worked on building an observability solution for data pipelines ๐Ÿ› . Observability of data pipelines helps determine completeness, accuracy, efficiency and consistency for any data uploaded through either batch or streaming sources.

There was the use case where I had to get the count of messages published in a pub/sub topic for streaming sources. I was exploring various ways to achieve this, and one of the quickest ways I found was using Stackdriver. ๐Ÿš€

What is Stackdriver?

Google Stackdriver is a suite of tools that facilitates monitoring, analyzing and debugging your cloud-powered applications. It provides visibility into your applicationsโ€™ performance, availability, and health and infrastructure.

Stackdriver provides tools for collecting logs, metrics, and alerts and provides visibility into the cloud environment with charts, a dashboard, service-level objective monitoring and uptime checks. It is integrated with other Google cloud products. Logs and metrics from Pub/Sub, Compute, GKE, etc., are available on Stackdriver.

What is Google cloud monitoring API?

You can consume Stackdriver metrics programmatically with Google Cloud Monitoring API using its REST & gRPC interface. Google also provide client libraries for different languages to easily integrate with the API.

How to use this API?

We can use metric names and labels to query for time series or we can use Metric Query Language (MQL) for advance querying in our code. Letโ€™s discuss some terminologies before getting deep dive into our demo.


Collection of measurements that determines the performance of your application and system services. There are 1500 metrics that Stackdriver provides.


It is a monitored component for which Stackdriver collector collects metrics. Example of a resource: Pub/Sub topic, a Compute instance.


Metrics and resource tags describe a timeseries. It contains measurements of the resource for time intervals.

Using operators and aggregations we can transform the raw timeseries data into a form suitable for our use case. For example, we might be interested in calculating the average CPU usage of Compute instances over a period of the day.

Letโ€™s build it ๐Ÿ”จ

We are going to develop a Java application that reads a number of messages in a Pub/Sub topic. The illustration below describes what we are trying to achieve.

Get metrics!

I have built the project and pushed the code on Github. Letโ€™s understand how it works!

Here we are querying the published messages to multiple Pub/Sub topics that match a regex aggregated over the period of a day. It gives us a list of timeseries that matches the query. Using the value from the timeseries we can perform some interesting actions!

This will print the message count for each topic that matches the query.

Here is the output ๐Ÿ’ป:

What can we do with it?

Once you have the raw values we can use them to :

  • Building Kubernetes operator that auto-scales pods based on publish rate of messages.
  • Autoscaling VMs based on publish rate of messages.
  • Consuming metrics directly to show in a reporting dashboard to your clients, laying the foundation for more transparency/observability for your clients. โœจ
  • Building custom alerting tooling.

More articles from Nancy Chauhan

What did I learn after running the wrong set of migrations on the database?

Recently at my work, I applied the wrong set of migrations in the database. It eventually broke the stuff and no one could access the system. I panicked, but I focused more on learning new things!

March 15th, 2022 ยท 4 min read

Thank you, next

2021 had been all about chaos, adapting, supporting each other, taking care of yourself, exploring and prioritising your needs. The first half of 2021 had been quite challenging with a lot of chaos. Human interaction almost went digital. We witnessed the most difficult phase of the pandemic ever. It was all about remaining calm in the storm.

January 1st, 2022 ยท 3 min read
ยฉ 2018โ€“2022 Nancy Chauhan
Link to $ to $ to $ to $ to $