This page documents production updates to Monitoring. You can periodically check this page for announcements about new or updated features, bug fixes, known issues, and deprecated functionality.
You can see the latest product updates for all of Google Cloud on the Google Cloud release notes page.
To get the latest product updates delivered to you, add the URL of this page to your
reader, or add the feed URL directly:
May 20, 2020
Cloud Monitoring introduces an improved experience for viewing and managing incidents. Improvements include performance optimizations for Workspaces with large numbers of incidents, summary statics, and the ability to filter by alerting policy name, metric type, and resource type. For more information, see Incidents and events.
May 19, 2020
Alert notifications delivered by email now come from "email@example.com" instead of "firstname.lastname@example.org".
May 14, 2020
Starting in version 6.0.2, the Cloud Monitoring agent is available for the Ubuntu LTS 20.04 (Focal Fossa) distribution.
May 08, 2020
Monitoring Query Language (MQL) is now available in Beta. MQL is an expressive, text-based interface to Cloud Monitoring time-series data. With MQL, you can create charts you can't create any other way. You can access MQL from both the Cloud Console and the Monitoring API. For more information, see Introduction to Monitoring Query Language.
April 28, 2020
The 5.x version of the Cloud Monitoring agent for Linux is deprecated. Users are encouraged to upgrade their agents as soon as possible.
stack-install.sh and the
install-monitoring-agent.sh installation scripts for the Cloud Monitoring agent for Linux are deprecated. Refer to the Installing the Cloud Monitoring agent guide for the latest installation procedures.
March 30, 2020
You can now write time-series data for custom and Prometheus metrics at the rate of 1 data point every 10 seconds. This was previously limited to 1 point every minute.
Data for custom and Prometheus metrics is now retained for 24 months. Previously, the retention period was 6 weeks.
February 24, 2020
Stackdriver Monitoring is available exclusively in the Cloud Console. For more information, see Monitoring in the GCP Console.
Stackdriver Monitoring agent version 6.0.0 is now available for the following distributions:
- CentOS 7
- Ubuntu LTS 16.04 (Xenial Xerus) and Ubuntu LTS 18.04 (Bionic Beaver)
- Ubuntu Minimal LTS 16.04 (Xenial Xerus) and Ubuntu Minimal LTS 18.04 (Bionic Beaver)
- Amazon Linux AMI (except Amazon Linux 2.0 AMI)
February 19, 2020
Starting in version 6.0.0, the Stackdriver Monitoring agent is available for the Ubuntu 19.10 (Eoan Ermine) distribution.
February 18, 2020
Stackdriver Monitoring agent version 6.0.0 is now available for the Debian 9 distribution.
February 14, 2020
You can now send notifications from your alerting policies to Cloud Pub/Sub topics. For more information, see Notification options.
The Stackdriver Monitoring Dashboard API is now Generally Available. You can use this feature to programmatically manage your dashboards and charts. See Managing dashboards by API for documentation, and
Dashboard for reference material.
February 11, 2020
Stackdriver Monitoring agent version 6.0.0 has been released to the CentOS 8 distribution.
February 06, 2020
Starting in version 6.0.0, the Stackdriver Monitoring agent is available for the Debian 10 distribution.
January 31, 2020
Stackdriver Monitoring Agent version 6.0.0 is now available, and the release will gradually roll out to the various Linux distributions. This version is built on a fork of
collectd version 5.8.1 and includes the following changes:
Stackdriver Monitoring agent version 6.0.0 is now available for the SUSE and SUSE Linux Enterprise Server (SLES) Linux distributions.
January 13, 2020
Stackdriver Monitoring in the Cloud Console is Generally Available and is the default option. For a limited period of time, you also have the option to use the classic Stackdriver Monitoring Console. Your configuration information, such as uptime checks and alerting policies, is accessible and changeable, from the Cloud Console and from the classic Stackdriver Monitoring Console. For more information, see Monitoring in the GCP Console.
December 13, 2019
Google Kubernetes Engine (GKE) version 1.15, which is now generally available, drops support for GKE versions 1.12 and earlier. As a result, the beta version of Stackdriver Kubernetes Engine Monitoring is no longer supported. If your GKE clusters are running version 1.12 or earlier, then you must upgrade them as soon as possible.
December 11, 2019
Legacy Stackdriver support for Google Kubernetes Engine (GKE) is deprecated. If you're using Legacy Stackdriver, then you must migrate to Stackdriver Kubernetes Engine Monitoring before Legacy Stackdriver is decommissioned. For more information, see Legacy Stackdriver support for GKE deprecation.
December 09, 2019
The Stackdriver Monitoring Dashboard API is now in Beta release. You can use this feature to programmatically manage your dashboards and charts. See Managing dashboards by API for documentation, and
Dashboard for reference material.
December 04, 2019
Stackdriver Monitoring in the Cloud Console is in beta release. Your configuration information, such as uptime checks and alerting policies, is accessible and changeable, from the Cloud Console and from the classic Stackdriver Monitoring Console. For more information about the beta, see Monitoring in the GCP Console.
November 14, 2019
The Service Monitoring API is now in Beta release. You can use this feature to
create services, set service-level objectives (SLOs), and create alerting
policies to monitor your SLOs. See
Service monitoring for documentation, and
services for reference
September 10, 2019
When creating a new Google Kubernetes Engine (GKE) cluster, Stackdriver Kubernetes Engine Monitoring is now the default Stackdriver support option. This is a change from prior versions where Stackdriver Logging and Stackdriver Monitoring were the default Stackdriver support option. For more information, see Overview of Stackdriver support for GKE.
August 08, 2019
Stackdriver Monitoring has two new uptime check features: SSL certificate validation and regex negation content matching.
May 21, 2019
Stackdriver Kubernetes Engine Monitoring is now generally available. Users of the legacy Stackdriver support for monitoring and logging for Google Kubernetes Engine are encouraged to migrate to Stackdriver Kubernetes Engine Monitoring as soon as possible.
May 02, 2019
Stackdriver Workspace creation is now a one-step operation. For more information, go to Getting a Workspace quickly.
April 23, 2019
The OpenCensus library is now generally available as the official library for user-defined metrics in Stackdriver Monitoring. The Custom metrics with OpenCensus page includes samples in Go, Java, Node.js, and Python.
March 18, 2019
March 15, 2019
Stackdriver agents are subject to an updated deprecation policy. As part of this transition, the next major version of the Stackdriver Monitoring and Stackdriver Logging agents will stop supporting operating systems that are at the end of their lifecycle, as well as some third-party agent plugins.
February 08, 2019
The Stackdriver Monitoring Agent now supports Ubuntu 18.04 LTS ("Bionic Beaver").
December 06, 2018
A mechanism to collect monitoring data from Prometheus clients, which can be deployed as a sidecar in the same Kubernetes pod as a working Prometheus server, is now available. See Using Prometheus for more information.
December 05, 2018
November 16, 2018
The new UI for creating alerting policies is now complete and Generally Available. This interface, based on Metrics Explorer, offers fine-grained control over the selection of the metrics used in alerting conditions. See Managing Alerting Policies for more information.
October 10, 2018
A new UI for creating alerting policies is available in Beta. This interface, based on Metrics Explorer, offers fine-grained control over the selection of the metrics used in alerting conditions. See Managing Alerting Policies for more information.
September 19, 2018
Stackdriver Kubernetes Monitoring (Beta) for Kubernetes version 1.10.6 and above, restores the managed support for Kubernetes Monitoring. You can also upgrade your existing clusters to this release, no matter which (if any) Stackdriver support they had before. Note the warnings about incompatibilities between the old and new Stackdriver support.
September 18, 2018
The legends for Stackdriver charts have been significantly improved. Legends now support more than one labeled column. The legend provides a selected set of columns as a default, but users can choose the columns they want to see in the legend. All columns are sortable. The legend detects a configuration of columns that exceeds the available space, and provides scrollbars. The resizing of the legends is also improved. For details, see Configuring Legends.
September 10, 2018
"Stackdriver accounts" have been renamed "Workspaces" to reflect their use as a "single pane of glass" through which you view resources from multiple projects and AWS accounts. There is no change in their functionality, but we have improved the documentation for them. For more information, see Workspaces.
June 29, 2018
On July 1, 2018 at 00:00 PDT, Stackdriver switches to consumption-based pricing. For more information, see Stackdriver Pricing.
June 19, 2018
If you want to minimize the AWS permissions you give to Stackdriver, then see Minimal AWS Permissions.
June 18, 2018
Between June 18, 2018 at 06:00 PDT and July 1, 2018 at 00:00 PDT, your use of Stackdriver is free. The service tiers have been removed, and you can experience all features without incurring costs. Thereafter, Stackdriver switches to consumption-based pricing. For more information, see Upcoming Pricing.
May 24, 2018
Any Stackdriver free trials created after May 29, 2018 will expire on June 30, 2018. After June 30, 2018, free trials will be replaced with a free monthly allocation of logs and metrics. For more information about Stackdriver's new consumption-based pricing, see Stackdriver Upcoming Pricing.
May 23, 2018
Custom dashboards and pages for resource groups are now limited to 25 charts. Any dashboards or groups pages with more than 25 charts will continue to work, but you will not be able to add additional charts to them.
May 22, 2018
You can now see your Monitoring usage metrics and estimate your bill for your usage of Monitoring, according to the new Stackdriver pricing and in advance of billing enforcement. See Estimating your bills for details.
May 21, 2018
A new UI for creating conditions in alerting policies is available in Beta. This UI, based on Metrics Explorer, offers fine-grained control over the selection of the metrics used in alerting conditions. See Managing Alerting Policies for more information.
May 11, 2018
If you are using custom Cloud IAM roles, any roles that load Stackdriver Monitoring dashboards now require additional IAM permissions. The
monitoring.publicWidgets.* permissions are now public, and custom roles used to load dashboards must now include them. See Stackdriver Monitoring Access Control for more information.
May 02, 2018
Stackdriver Kubernetes Monitoring is released in Beta for Kubernetes 1.10 clusters running in Kubernetes Engine. The previous Stackdriver support is still available for those who do not opt into this Beta release. The release introduces new monitored resource types and new Kubernetes metrics. The monitoring features are free to customers during the Beta period.
April 26, 2018
You can now use variables in the documentation associated with alerting policies to pull specific details about the alert into notifications, to create playbook information for responders. See Additional documentation tools for more information. The Webhooks and Slack notification channels now receive a copy of this enhanced documentation as part of alert notifications. Additionally, email notifications from alerting policies now use HTML-formatted messages.
April 19, 2018
Boolean metrics can now be queried and charted.
April 17, 2018
The Using Alerting Policies documentation has been updated to provide additional guides and links to sample code for managing alerting policies and notification channels programmatically. The update also removes some obsolete service-tier information.
March 28, 2018
Stackdriver now loads charts much more quickly, especially when the chart contains a long time span.
March 26, 2018
A new option on the Dashboards menu, Public Charts, lets you see a list of all the shared charts. You can also use this page to remove sharing from a chart. The on-chart indicator that the chart is shared has been removed.
March 12, 2018
Beginning on June 30, 2018, Stackdriver is switching to consumption-based pricing, including revised quotas. For more information, see Stackdriver Upcoming Pricing.
March 08, 2018
January 29, 2018
The Stackdriver email reports that you can configure for your Stackdriver
account have been improved. Issues with the content and the
delivery of reports have been fixed, and the from address for the reports has
been changed from
email@example.com. The Utilization section, present only
if the Monitoring Agent is installed,
now lists the 10 groups with the highest utilization, and a new summary row
reports overall utilization for the Stackdriver account.
January 17, 2018
The name of the Monitoring agent process on Windows has been
updated. It now shows up in the system process list as
January 08, 2018
The performance of the Monitoring dashboards and charts has been improved. Additionally, a new version of Metrics Explorer is available, and the metric-selection interface has been greatly improved, allowing arbitrary label filtering and group-by functionality. This interface is also used for creating dashboard charts, making the process consistent across the two tasks. See Using Charts for more information.
December 14, 2017
Alerting events page: An updated implementation has required some user interface changes. The alerting events page (Alerting > Events) no longer shows a heatmap or counts of events in each category.
November 08, 2017
The Monitoring agents for Linux and Windows VM instances now report errors for unrecognized metrics. The errors are written to the agent log on your VM instance. If the Logging agent is also running on the VM instance, then the logs are also available in Stackdriver Logging. The error messages are, "Unsupported collectd plugin/type combination" and "Unsupported collectd ID." Previously, these metrics were dropped silently. See the agent's Troubleshooting Checklist for more information.
November 05, 2017
Documentation for the deprecated Cloud Monitoring API v2 has been removed. The API was turned down in August, 2017.
October 19, 2017
October 17, 2017
Beta release: The Uptime Configuration API and uptime metrics are now available. The API, part of the Stackdriver Monitoring API, lets you create and edit uptime checks. The status of your checks is recorded in the uptime metrics.
October 02, 2017
Calls to createTimeSeries now fail without writing any data points if the request includes more than one point in the same time series. Formerly, in some cases, one data point would be written in each time series and a status of 500 would be returned by the call.
September 13, 2017
Object Stores Resources: Google Cloud Storage metrics and Amazon S3 metrics are now separated in the Stackdriver UI into their own service dashboards. The "Object Stores" dashboard is replaced by "Cloud Storage" or "S3", depending on which service you are using.
September 08, 2017
Cloud Interconnect custom dashboards and alert monitoring are available in
Beta release. For details, see the
interconnect metrics and
August 23, 2017
Dashboard filtering: Custom dashboards and resource list pages now support filtering on groups. Each page that supports filtering now has a filter bar under the header where you specify the group.
July 10, 2017
Heatmaps for distribution metrics: Heatmaps are available in dashboard charts. Select a distribution metric from either the Custom or Logging metric groups and specify Heatmap.
IAM for Stackdriver Monitoring is now complete and GA. New IAM roles include Monitoring Editor and Monitoring Admin, and there is full support for custom roles. For more information, see Monitoring Access Control.
Agent permissions in VM instances: The agent no longer needs the Project Editor IAM role; it only needs the Monitoring Metric Writer role (
roles/monitoring.metricWriter). For more information, see Monitoring Access Control.
Windows process metrics now include all processes accessible to the Monitoring agent. See Agent process metrics.
Windows Server 2016 is supported by the current Monitoring agent.
Stacked charts: The order of data streams in stacked charts has been reversed, so that the first stream is on the top and the last stream is on the bottom. This order is consistent with the chart legend and hovercard.
June 05, 2017
Uptime checks have a new overview and detail dashboards. See Uptime Checks.
Singapore region support:
Stackdriver now supports the Singapore region,
May 01, 2017
New metric and resource types: There are new Cloud Platform metric and resource types, including those for Cloud Bigtable, Cloud Dataflow, Cloud DNS, Cloud Internet of Things, Cloud Pub/Sub, Cloud Spanner, and Stackdriver Logging. Microsoft Windows system and application metrics (
pagefile) are available as Agent metrics and can be used for charting and alerting.
April 02, 2017
v2beta2 API turndown: The deprecated v2beta1 and v2beta2 APIs will be shut down during August 2017.
March 31, 2017
Time shifting (Beta): You can now compare your current metric data with data from 1 day, 1 week, or 4 weeks ago. See Compare to past in the Advanced options for line chart creation.
Faster chart legends: Charts involving custom and logs-based metrics now have faster legends that include instance names with the metric name where available. You can quickly identify instances and sort the metrics by name.
Faster user interface: Initial page load times have been reduced across the user interface.
Cloud ML: Cloud Machine Learning Engine metrics are available for dashboards and alerting.
Cloud Spanner: Cloud Spanner metrics are available for dashboards and alerting.
Monitoring agent: Although the statsd plugin is distributed with the Monitoring agent, there are not yet any instructions for using the plugin with Monitoring.
February 06, 2017
Process owner: When sending process metrics, the Stackdriver Monitoring agent now returns a stringified UID if the process owner name is not set. Previously, the agent would not send process owner information, which was then treated by the Monitoring API as malformed input and discarded. Available in stackdriver-agent/5.5.2-359. See Determining the agent version.
Lost input from the Monitoring agent: Malformed data from the Monitoring agent could cause Stackdriver Monitoring to lose well-formed input bundled in the same request. Now, only the malformed input is lost. You do not have to update your agent for this fix.
Selectable uptime check regions: Stackdriver Monitoring now lets you select the geographic region(s) that check your service.
January 18, 2017
New AWS regions: Monitoring now supports the AWS Canada (ca-central-1) and London (eu-west-2) regions.
December 12, 2016
Account IDs in URLs: Monitoring has added the Stackdriver account ID to its URLs. You can now open multiple tabs for different accounts and more easily share links with coworkers. URLs without the account ID use the most recently accessed Stackdriver account.
December 08, 2016
Incident pages (Beta): See Alerting > Incidents. Each open incident now has a detail page that collects a graph of the incident, links to affected resources, and the comments made on the incident.
Metrics Explorer (Beta): See Resources > Metric Explorer. Select a monitored resource type and metric. You can aggregate data across your instances.
November 21, 2016
Time series: The recommended maximum rate of writing data points to a single time series is changed from 1/sec to 1/min. See Writing metric data.
Chart options: You can now display data as stacked bar charts and stacked area charts, using the Stacked option under Chart Types. Stacked bar charts are automatically aligned to hour boundaries. Stacked area charts work best with metrics received at 1-minute intervals.
New AWS region: Monitoring now supports the AWS region us-east-2.
Chart snapshots: You can now download images of charts in PNG format. Choose Download Image from the More menu. The chart legend is not presently rendered.
Group support for metrics: When charting custom and logs-based metrics, a new Group filter appears under Advanced Options. The effect of the filter is not shown until after you save the chart.
October 20, 2016
GA: Monitoring is generally available to Google Cloud Platform customers. Individual features that are in Alpha or Beta release are marked as such in the documentation.
Pricing: Stackdriver is now available in Basic and Premium service tiers. All existing and new Stackdriver accounts are entered into a 30-day free trial of the Premium Tier. At the end of the trial period, you could lose some functionality you had during the Beta release unless you upgrade to the Premium Tier. For more details, see Pricing.
API v3: The Stackdriver Monitoring API v3 is now generally available.
Monitoring agent: A new version of the Stackdriver Monitoring Agent, v5.5.2-349, is available. Its improvements include an update to collectd 5.5.2, support MongoDB 3.0, agent health metrics, and bundled
statsd, tail, and network plugins. For more information, see Installing the Monitoring Agent.
Custom metrics: Custom metric descriptors are created as needed when you write time series data. See Auto-creation of custom metrics.
Charting: You can use log scales in your charts, and you can zoom both the x- and y-axes by clicking-and-dragging.
New metrics: New metrics are now available from Cloud Router, BigQuery, and TaskQueues (pull metrics). See the Metrics List.
Creating alerts: We have introduced a new, more streamlined user interface for creating and editing alerting policies.
September 11, 2016
The Google Monitoring API (v3) is now known as the Stackdriver Monitoring API (v3). This change does not affect any code.
The Monitoring v2 API is now deprecated. It is still named the Google Cloud Monitoring API in APIs & services.
July 26, 2016
Some documentation pages have moved in the table of contents, but their URLs are the same or have redirections. All agent-related pages are now part of the How-To section, Using the Monitoring Agent. The former "Using Metrics" page has been reorganized into several pages under Using Custom Metrics.
June 09, 2016
The Stackdriver Monitoring API v3 reference documentation now includes code samples for each method. For example, see metricDescriptors.list. Sample Code will continue to be available on GitHub.
June 06, 2016
Metrics List is now a comprehensive list of all metrics available in Monitoring, including metrics gathered by the monitoring agent and metrics from Amazon Web Services.
April 27, 2016
The documentation has been reorganized. The documentation landing page and the left-side navigation entries have changed. Existing URLs to individual documentation pages will be redirected if necessary.
The Quickstart has been simplified. It now includes setting up a virtual machine instance and installing both the monitoring and logging agents.
March 23, 2016
Google Cloud Monitoring is now Stackdriver Monitoring, part of the Google Stackdriver suite of products.
When installing the monitoring agent on an Amazon EC2 VM instance running Microsoft Windows, ignore the following error message if you get it only once after the service is started: "StackdriverAgent is running on an AWS instance but project ID is not set."
March 17, 2016
September 29, 2015
Charts now have a View Logs option in their settings menu.
January 07, 2015
First beta release of Google Cloud Monitoring powered by Stackdriver.