Release notes

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.

For a combined list of all release notes for the products in Google Cloud's operations suite, see Consolidated release notes.

You can see the latest product updates for all of Google Cloud on the Google Cloud page, or browse and filter all release notes in the Google Cloud Console.

To get the latest product updates delivered to you, add the URL of this page to your feed reader, or add the feed URL directly: https://cloud.google.com/feeds/stackdriver-release-notes.xml

July 29, 2021

Monitoring Query Language (MQL) no longer requires you to use strict form when you create MQL-based alerting policies by using the Monitoring API. You can now provide queries in concise form. The query is stored as you provide it; concise queries are not converted to strict form.

July 26, 2021

The new External HTTP(S) Load Balancers dashboard in Monitoring provides powerful visualizations to help you understand and troubleshoot connectivity issues on your external load balancers.

July 13, 2021

Metrics Explorer, a stand-alone charting tool that lets you quickly chart and explore time-series data, has a new interface and supports enhanced aggregation options. For more information, see Metrics Explorer.

The VM instances page has a new Processes tab in Preview. This tab adds charts for process metrics to the charts provided by the existing CPU, Memory, Disk, and Network tabs.

July 12, 2021

You can now install the Logging and Monitoring agents on multiple VMs from the Inventory tab on the Cloud Monitoring VM Instances page. You can select multiple VMs in your fleet for agent installation. The page generates the necessary installation command and provides a link to Cloud Shell, where you can run the command.

A warning annotation is now added to charts when they are missing data due to a data outage. When the annotation is absent, data gaps aren't due to a data outage. For common reasons why a chart might contain a data gap, see Gaps in chart data.

July 07, 2021

Preview: Cloud Logging now supports alerts based on matching the content of your logs. When triggered, a log-based alert notifies you that a match has appeared in your logs and opens an incident in Cloud Monitoring. You can create log-based alerts by using the Logs Explorer or the Monitoring API. For more information, see Monitoring your logs and Using log-based alerts.

July 02, 2021

You can now display summaries of single-condition alerting policies on a custom dashboard. A policy summary includes a display of the monitored time series, the threshold, and chips that show the number of open incidents and whether the policy is disabled. For more information about Alert charts, see the following pages:

Dashboard-wide filters now apply to all charts on a dashboard. Prior to this change, these filters didn't apply to MQL-configured charts.

June 30, 2021

The Monitoring dashboards page in the Cloud Console now includes a collection of sample dashboards. The sample dashboards provide support for many common applications. You can preview, install, and then customize these dashboards. For more information, see Installing sample dashboards.

The Ops Agent is now Generally Available as version 2.0.0. This agent combines logging and metrics into a single agent. The Ops Agent is targeted toward specialized logging workloads that require higher throughput and improved resource efficiency.

For installation information, see Installing the Ops Agent. For information about migrating from an earlier version, see the transition guide.

The GA version of the Ops Agent can be configured to collect specific sets of metrics, as described in Configuring the Ops Agent. There is a small number of metrics that the GA version of the Ops Agent handles differently from the Preview versions of the Ops Agent and the Monitoring agent; see Differences in metric collection.

June 28, 2021

The Incidents page now provides an option to permanently close incidents if no data for that incident has arrived in the most recent alerting period. For more information, see Closing incidents.

Cloud Monitoring is launching a new Observability tab on Compute Engine's VM instance details page. This tab replaces the Monitoring tab. The enhanced Observability tab provides access to logs and greater visibility into CPU, disk, and network metrics.

June 15, 2021

You can now view Monitoring data for certain logs, such as Google Kubernetes Engine logs, in the Logs Explorer. For more information, see Viewing Monitoring data.

June 01, 2021

A JSON editor has been integrated with the dashboard page. In addition to using the JSON editor to change the contents of the dashboard, you can save the current dashboard definition to a local system, and you can upload a dashboard definition to your Google Cloud project. For more information, see Managing dashboards through the Cloud Console.

May 12, 2021

Cloud Monitoring is introducing metrics scopes. For a Google Cloud project, its metrics scope defines the projects whose metrics the project can view and monitor:

  • When you create a project, its metrics scope is set to self.
  • You can modify a project's metrics scope to include other Google Cloud projects, or to include AWS accounts. For more information, see Viewing metrics for multiple projects.
  • A Google Cloud project can be included in multiple metrics scopes.

For more information about metrics scopes, see Configuring your project for Cloud Monitoring.

The replacement of Cloud Monitoring Workspaces with metrics scopes is complete.

All of your existing Cloud Monitoring Workspaces have been migrated to the new data model.

May 05, 2021

Cloud Monitoring has added new ways to interact with charts. You can now select a range of lines displayed on chart, shift the time axis by using your pointer, and have new controls to expand the chart around a specific point in time. Charts displaying distribution data include 50th, 95th, and 99th percentile lines as an optional overlay. For more information, see Exploring charted data.

May 04, 2021

The Query Editor for Monitoring Query Language (MQL) has been reimplemented. In addition to autocompletion and error detection, it now supports code folding and a find-and-replace capability. For more information, see Using the Query Editor.

May 03, 2021

The Inventory tab on the Cloud Monitoring VM Instances dashboard now offers the ability to filter and sort the instance table by any combination of columns. In addition, new health scorecards report a variety of metrics and statistics related to the health and status of your VMs and agents.

April 27, 2021

You can now install the Cloud Logging agent, Cloud Monitoring agent, and Ops Agent on VMs running OpenSUSE Leap versions 15, 15.1, and 15.2.

April 19, 2021

Cloud Monitoring Workspaces are changing. Over the next few weeks, new capabilities are being deployed:

  • A Cloud Monitoring Workspace will be created automatically for a Google Cloud project. This change replaces the manual creation process.
  • The restriction that you can view the metrics for a project from only one Workspace is being eliminated. You'll be able to view the metrics for a project from multiple Workspaces.
  • Navigation to a Workspace that manages metrics from multiple projects is changing. For information on this change, see Navigating to a Workspace.

April 16, 2021

The Cloud Operations for GKE monitoring dashboard now allows you to manage and display service-level objectives (SLOs) that you define for your applications. For more information, see the Managing SLOs section of the Observing your GKE clusters guide.

April 15, 2021

Compute Engine's Instance Groups Monitoring tab now includes charts for your managed instance groups. Charted metrics include group size, CPU utilization, disk I/O, and more. You can select the time window for the charts and view the corresponding logs from the integrated logs viewer panel. You can also use the links on each chart to create alerting policies or to analyze the data in Metrics Explorer.

The Cloud Operations for GKE monitoring dashboard now includes a column called Error logs that displays the number of error logs associated with an entity based on the selected time range. You can also select which columns to display in the tables. For more information, see the Configuring the dashboard tables section of the Observing your GKE clusters guide.

April 13, 2021

The Cloud Operations for GKE monitoring dashboard now provides a Metrics tab in the resource details panel. This tab also includes a menu option to create a new alert policy. For more information, see Observing your GKE clusters.

April 12, 2021

The dashboard save feature now displays the date and time of the last save operation. You can also disable and enable autosave. For more information, see Configuring dashboards.

The Cloud Operations for GKE monitoring dashboard now provides an Alerts tab in the resource details panel. This tab also includes a link to create a new alert policy. For more information, see Observing your GKE clusters.

April 09, 2021

For new alerts created through the Cloud Console, the default behavior is to send a notification only when the incident is created. For alerts created by using the API, the default behavior is to send notifications when incidents are opened and closed. For all alerts, the alert's Policy detail page displays when notifications are sent. To change this behavior, you must use the Cloud Console to edit the policy. For more information, see Managing Policies.

April 08, 2021

The Google Cloud Ops Agent is now available in Preview. This agent combines logging and metrics into a single agent that is targeted toward specialized logging workloads that require higher throughput and improved resource efficiency. It supports both Linux and Windows Compute Engine VMs.

Cloud Operations now offers the ability to install the Google Cloud Ops Agent via Ansible on Linux and Windows Compute Engine VMs.

Cloud Operations now offers the ability to provision the Google Cloud Ops Agent via Terraform on Linux and Windows Compute Engine VMs.

March 04, 2021

Compute Engine's VM Instances dashboard now provides an Operations menu. The "View metrics" menu option brings you to the Infrastructure summary dashboard in Monitoring. The "View logs" menu option brings you to the Logs Explorer page in Logging.

Compute Engine's VM instance details page now offers a guided installation path for the Monitoring agent when it is not detected on the VM.

Kubernetes Engine's Clusters and Workloads dashboards now provide an Operations menu. The "View metrics" menu option brings you to the GKE Dashboard in Monitoring. The "View logs" menu option brings you to the Logs Explorer page in Logging.

February 19, 2021

The Incident details page has been completely revised, making it easier to investigate and manage incidents. New features include a timeline of incidents, the addition of a chart with time-range controls and a link to Metrics Explorer, a log for recording the investigative history. For more information, see Investigating incidents.

January 26, 2021

The gcloud commands for managing Agent Policies are now available in beta. For more information, refer to the gcloud documentation for Agent Policies.

December 23, 2020

Alerting is now Generally Available for Monitoring Query Language (MQL). For more information, see Alerting policies with MQL.

December 16, 2020

The dashboard editor that lets you create and edit all dashboard widget types, including gauges, scorecards, and text boxes, is now Generally Available. With this editor, you can quickly configure dashboard widgets by using Basic Mode, you can access all aggregation options with Advanced Mode, and you can use Monitoring Query Language when you select MQL Mode. When you set the dashboard layout to mosaic mode, you can resize and reposition widgets. For more information, see Custom dashboards.

December 04, 2020

Slack notification channels: All notification channels created before November 20 have been fixed, and new notification channels will be created correctly. Notification channels created between November 21 and December 3 need to be manually updated, as described in Adding the Monitoring app to a Slack channel.

November 25, 2020

If you created Slack notification channels after November 20, 2020, your channels are not receiving notifications. For information about resolving this issue, see Adding the Monitoring app to a Slack channel.

November 16, 2020

A new dashboard editor is available in Preview. The new editor lets you create and edit all dashboard widget types, including gauges, scorecards, and text boxes. With mosaic-mode, you can resize and reposition widgets. The configuration tabs - Basic, Advanced, MQL - let you choose how you want to configure your widgets. For more information, see Custom dashboards.

November 12, 2020

Compute Engine's VM instance details page now displays "Memory Utilization" and "Disk Space Utilization" charts. In addition, a new "Monitor VM Instances" link lets you go directly to the VM instances dashboard in Cloud Monitoring.

November 09, 2020

Monitoring Query Language (MQL) adds Preview support for macros. For more information, see MQL macros.

November 05, 2020

Enhancements to the VM Details page. A new Event Timeline shows important events as bars on a timeline. Hovering over any event bar displays summary information about the event and provides a link to the Incident Details page for the event.

October 26, 2020

Enhancements to the pre-configured Monitoring VM Instances dashboard. The inventory table now includes a Logging Agent Status column, and the Logging agent can be installed by using a UI workflow from the table.

October 15, 2020

The Ops Agent is now available in Preview. Ops Agent provides a single agent to collect logs and metrics on Compute Engine instances.

Note that the Ops Agent uses new configuration files that are not compatible with the standalone Cloud Monitoring and Cloud Logging agents.

October 05, 2020

Alerting is now available for Monitoring Query Language (MQL). For more information, see Alerting policies with MQL.

September 09, 2020

The API for creating and managing alerting policies is now Generally Available. For information on using this API, see Managing alerting policies by API.

August 28, 2020

Cloud Trace exemplars can now be viewed in Cloud Monitoring. For more information about Trace exemplars, see Cloud Trace exemplars. For more information about viewing exemplars, see Exploring charted data.

August 13, 2020

The new, out-of-the-box Infrastructure Summary dashboard for Compute Engine VMs provides a single-pane-of-glass view into your VM fleet and load balancers. At a glance, you can see the top 5 VMs across a variety of key metrics including memory, CPU, sent/received traffic, latency, disk read/write, and more.

August 12, 2020

Enhancements to the pre-configured Monitoring VM Instances dashboard. The inventory table now includes a Monitoring Agent Status column, and the Monitoring agent can be installed by using a UI workflow from the table. The Explore tab gives an overview of additional metrics being sent (including agent metrics, custom metrics, and logs-based metrics) as well as a set of quick links to learn more about each type of metric. You can also use the Recommended Alerts button on the dashboard to configure fleet-wide alerts.

July 10, 2020

SLO monitoring for microservices is now Generally Available in the Cloud Console. This feature lets you create service-level objectives (SLOs) and set up alerting policies to monitor their performance using auto-generated dashboards with metrics, logs, and alerts in a single place. For more information, see SLO monitoring.

July 07, 2020

Monitoring Query Language (MQL) is now Generally Available for querying data and creating charts. 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.

June 15, 2020

The Service Monitoring API is now Generally Available. 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 material.

June 08, 2020

Enhancements to the pre-configured Compute Engine VM Instances dashboard. Compute Engine cross-fleet metrics and detail views specific to CPU, Disk, Memory, and Network are now available. Use filters to narrow down the set of VMs being inspected, and use the time selector or in-chart time selection to change the time window. VMs with the Monitoring agent installed get detailed memory and disk analysis out of the box.

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 "alerting-noreply@google.com" instead of "alerts@stackdriver.com".

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.

The 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 material.

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.

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

The Uptime Configuration API is now complete and GA. The API, part of the Stackdriver Monitoring API, lets you create, edit, and manage uptime checks.

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

Documentation for using OpenCensus to capture custom metrics in Java applications is now available. See Custom metrics with OpenCensus for more information.

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.

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 IAM roles, any roles that load Stackdriver Monitoring dashboards now require additional IAM permissions. The monitoring.dashboards.* and 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

The AlertPolicy and NotificationChannels APIs are now in Beta release. See Alerting policies and Notification channels for more information.

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 monitoring-noreply@stackdriver.google.com to monitoring-noreply@google.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 StackdriverMonitoring.

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

Beta release: The Monitoring agent can now export collectd and statsd metrics as Stackdriver custom metrics. For more information, see Custom Metrics from the Agent and the agent's StatsD plugin

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

HTTPS(S) Load Balancer metrics are available in Beta release to use in Monitoring. For details, see the GCP loadbalancing metrics and the https_lb_rule monitored resource.

Cloud Interconnect custom dashboards and alert monitoring are available in Beta release. For details, see the GCP interconnect metrics and the interconnect and interconnect_attachment monitored resources.

HTTPS(S) Load Balancer metrics are available in Beta release to use in Monitoring. For details, see the GCP loadbalancing metrics and the https_lb_rule monitored resource.

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, asia-southeast1.

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 (iis,mssql, 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.

Cloud Dataflow: Cloud Dataflow is now integrated with Monitoring. For more details, see the Big Data and Machine Learning Blog.

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 documentation for metrics and custom metrics has been reorganized and extended for the Monitoring API v3. See Metrics, Using Metrics, and Metrics List.

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.

You can now monitor Amazon Web Services (AWS) accounts alongside your Google Cloud Platform (GCP) projects. Read about Stackdriver Accounts and install the new monitoring agent.

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

The Monitoring API v3 is now available. Users are encouraged to begin upgrading from the Cloud Monitoring API v2. See What's new in the v3 API and look at the new code samples on GitHub.

September 29, 2015

Charts now have a View Logs option in their settings menu.

January 07, 2015