Monitoring Query Language (MQL)

On October 22, 2024, Monitoring Query Language (MQL) will no longer be a recommended query language for Cloud Monitoring.

  • On October 22, 2024, certain usability features will be turned off.
  • On July 22, 2025, MQL will no longer be available for new dashboards and alerts in the Google Cloud console, and Google Cloud customer support will end. Existing MQL dashboards and alerts will continue to work, and you will still be able to create MQL dashboards and alerts using the Cloud Monitoring API.

We recommend moving to PromQL, the open-source standard for querying time series. PromQL offers similar functionality to MQL, with a wider user base and more community resources.

Key points and dates

MQL is not being shut down. You will still be able to create and run MQL queries, and dashboards and alerting policies that use MQL queries will continue to work.

October 22, 2024

On October 22, 2024, the following MQL usability features will be turned off:

  • Inline autocompletion in the MQL code editor. The editor will no longer suggest completion strings for metric names, resource names, functions, operators, syntactic elements, label keys and values, and project IDs when you type Monitoring Query Language queries.
  • Conversion of queries between the Metrics Explorer query builder and MQL.

July 22, 2025

On July 22, 2025, the following will occur:

  • You will no longer be able to create new MQL charts, dashboards, or alerting policies by using the Google Cloud console. You can still create dashboards and alerting policies with MQL queries by using the Cloud Monitoring API.
  • Google Cloud customer support for cases involving writing valid MQL ends.

Required and recommended actions

No action is required to continue using your existing MQL assets, and you can create new MQL assets by using the Cloud Monitoring API.

We recommend that you begin using PromQL or the interactive query builder for dashboards, alerting policies, and other workflows. For more information about using PromQL to create Cloud Monitoring charts, dashboards, and alerting policies, see PromQL in Cloud Monitoring.