Habilita la API de Monitoring

A fin de poder usar la API de Monitoring, primero debes habilitarla y autorizar a los usuarios para acceder a ella.

En esta página, se describe cómo habilitar la API de Monitoring v3 y autorizar su uso.

Habilita la API

La API de Monitoring debe estar habilitada para que pueda usarse. Puedes verificar el estado de la API y habilitarla, si es necesario, mediante la herramienta de línea de comandos de gcloud del SDK de Cloud o Cloud Console.

SDK de Cloud

  1. Si aún no instalaste el SDK de Cloud en tu estación de trabajo, consulta SDK de Google Cloud.

  2. Para ver si la API de Monitoring está habilitada, ejecuta el siguiente comando en tu estación de trabajo:

    gcloud services list
    

    Si monitoring.googleapis.com aparece en el resultado, la API está habilitada.

  3. Si la API no está habilitada, ejecuta el siguiente comando para habilitarla:

    gcloud services enable monitoring
    

Para obtener más información, consulta gcloud services.

Cloud Console

Ir a API y servicios

  1. Selecciona el proyecto que usarás para acceder a la API.
  2. Haz clic en el botón Habilitar las API y el servicio.
  3. Busca “Stackdriver”.
  4. En los resultados de la búsqueda, haz clic en "API de Cloud Monitoring".
  5. Si se muestra "API habilitada", significa que la API ya está habilitada. De lo contrario, haz clic en el botón Habilitar.

Autoriza el uso de la API

Las funciones y los permisos de administración de identidades y accesos (IAM) controlan el acceso a la API. Hay un permiso asociado con cada método y los permisos de los métodos relacionados se agrupan en clústeres dentro de funciones, que luego se pueden otorgar a los usuarios. Consulta Control de acceso para obtener más información.

Una vez que el acceso a la API esté autorizado, la API se puede usar desde cualquier ubicación. Por ejemplo, puedes usar el método timeSeries.list desde tu estación de trabajo local. También puedes usar la API para enviar métricas en cualquier entidad que pueda se representar como un recurso supervisado. Consulta Elige un tipo de recurso supervisado para ver la lista de tipos disponibles. Sin embargo, el agente de Cloud Monitoring está diseñado para ejecutarse en una VM en la nube y no funciona en una estación de trabajo local.

Si escribes una aplicación que usa la API de Monitoring, las bibliotecas cliente recomendadas autorizan tu aplicación mediante las credenciales predeterminadas de la aplicación. Esto oculta los detalles de la autorización del código de tu aplicación.

Es posible que también puedas usar claves de API en algunas situaciones pero, por lo general, se recomiendan las cuentas de servicio. Las claves de API son útiles en clientes como los navegadores y las aplicaciones para dispositivos móviles que no tienen un servidor de backend. Consulta Usa claves de API para obtener más información.

Puedes obtener más información sobre la autenticación y la autorización para las API de Cloud en nuestra Guía de autenticación.

Usa las bibliotecas cliente

Una vez que hayas habilitado y autorizado el uso de la API, estarás listo para comenzar a escribir código. Consulta Bibliotecas cliente para comenzar a usar las bibliotecas cliente de Monitoring.