Enable the Monitoring API

This page describes how to enable and authorize use of theMonitoring API v3. You must enable this API before you can use it.

Enable the Monitoring API

To determine whether the Monitoring API is enabled or to enable theAPI, use either the Google Cloud console or the Google Cloud CLI.

Google Cloud console

  1. In the Google Cloud console, select the Google Cloud project forwhich you want to enable the API,and then go to theAPIs & Services page:

    Go toAPIs & Services

  2. Click theEnable APIs and Service button.

  3. Search for "Monitoring".

  4. In the search results, click through to "Stackdriver Monitoring API".

  5. If "API enabled" is displayed, then the API is already enabled. Ifnot, then clickEnable.

gcloud CLI

  1. If you have not already installed the Google Cloud CLI on yourworkstation, seeInstalling the gcloud CLI.

  2. To see if the Monitoring API is enabled, run the followingcommand on your workstation, after replacingPROJECT_ID with theID of the project for which you want to enable the API:

    gcloud services list --project=PROJECT_ID

    Ifmonitoring.googleapis.com appears in the output, the API isenabled.

  3. If the API is not enabled, then run the following command to enable it:

    gcloud services enable monitoring --project=PROJECT_ID

    For more information, seegcloud services.

Authorize use of the Monitoring API

Access to the Monitoring API is controlled byIdentity and Access Management (IAM) roles and permissions.There is a permission associated with each method, andpermissions for related methods are clustered into roles, which can thenbe granted to users. For more information, seeControl access with IAM.

After access to an API is authorized, the API can be used from anywhere.For example, you can call thetimeSeries.listmethod from your local workstation. You can also use the API to sendmetrics against any entity that can be represented as a monitored resource.SeeMonitored-resource types for user-defined metricsfor the list of available types.

If you are writing an application that uses therecommendedclient libraries, these librariesauthorize your application by usingApplication Default Credentials.

You might also be able to use API keys in some situations, but service accountsare generally recommended. API keys are useful in clients likebrowsers and mobile applications that don't have a backend server.For more information, seeUsing API Keys.

You can find out more about authentication and authorizationin ourAuthentication guide.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.