Cette page explique comment activer l'API Monitoring v3 et autoriser son utilisation. Vous devez activer cette API avant de pouvoir l'utiliser.
Activer l'API Monitoring
Pour déterminer si l'API Monitoring est activée ou pour l'activer, utilisez la console Google Cloud ou la Google Cloud CLI.
console Google Cloud
Dans la console Google Cloud, sélectionnez le projet Google Cloud pour lequel vous souhaitez activer l'API, puis accédez à la page API et services:
Cliquez sur le bouton Activer des API et des services.
Recherchez "Monitoring".
Dans les résultats de recherche, cliquez sur "API Cloud Monitoring".
Si "API activée" s'affiche, cela signifie que l'API est déjà activée. Sinon, cliquez sur Activer.
gcloud CLI
Si vous n'avez pas encore installé la Google Cloud CLI sur votre poste de travail, consultez Installer la gcloud CLI.
Pour voir si l'API Monitoring est activée, exécutez la commande suivante sur votre poste de travail, après avoir remplacé PROJECT_ID par l'ID du projet pour lequel vous souhaitez activer l'API:
gcloud services list --project=PROJECT_ID
Si
monitoring.googleapis.com
apparaît dans le résultat, l'API est activée.Si l'API n'est pas activée, exécutez la commande suivante pour l'activer:
gcloud services enable monitoring --project=PROJECT_ID
Pour en savoir plus, consultez les sections sur
gcloud services
Autoriser l'utilisation de l'API Monitoring
L'accès à l'API Monitoring est contrôlé par des rôles et des autorisations IAM (Identity and Access Management). Une autorisation est associée à chaque méthode, et les autorisations des méthodes connexes sont regroupées en rôles, qui peuvent ensuite être accordés aux utilisateurs. Pour en savoir plus, consultez la page Contrôler les accès avec IAM.
Une fois l'accès à une API autorisé, vous pouvez l'utiliser depuis n'importe quel emplacement.
Par exemple, vous pouvez appeler la méthode timeSeries.list
à partir de votre poste de travail local.
Vous pouvez également utiliser l'API pour envoyer des métriques sur toute entité pouvant être représentée en tant que ressource surveillée.
Pour obtenir la liste des types disponibles, consultez la section Types de ressources surveillées pour les métriques définies par l'utilisateur.
Si vous écrivez une application qui utilise les bibliothèques clientes recommandées, celles-ci autorisent votre application à l'aide des identifiants par défaut de l'application.
Vous pouvez également utiliser des clés API dans certaines situations, mais les comptes de service sont généralement recommandés. Les clés API sont utiles dans les clients tels que les navigateurs et les applications mobiles qui ne possèdent pas de serveur backend. Pour plus d'informations, consultez la page Utiliser des clés API.
Consultez notre guide d'authentification pour en savoir plus sur l'authentification et l'autorisation.