Créer des rapports sur les métriques de facturation

Vous trouverez sur cette page la procédure à suivre pour autoriser les services gérés à envoyer des données d'utilisation pour la facturation via Service Infrastructure. De cette façon, Cloud Billing sera en mesure de facturer les clients de ces services. Par exemple, vous pouvez définir une métrique appelée library.appspot.com/books/borrowed pour mesurer le nombre de livres empruntés par un client et définir une unité de stockage (code SKU) et son prix.

L'API Service Control accepte les métriques, puis les regroupe et les transfère à Cloud Billing. Celui-ci ingère ces métriques et génère des factures en fonction du modèle de prix prédéfini. S'il n'y en a aucun, Cloud Billing ne tient simplement pas compte des métriques de facturation. Pour définir un modèle de prix, veuillez contacter votre responsable de compte partenaire Google Cloud.

Configurer la facturation

Avant d'envoyer des données de facturation à l'API Service Control, vous devez spécifier trois informations distinctes dans votre configuration de service :

• Ressources surveillées : vous pouvez recueillir les données d'utilisation pour la facturation de chaque ressource. Les ressources surveillées nécessitent au moins une clé d'étiquette cloud.googleapis.com/location pour indiquer l'emplacement de l'utilisation de la facturation.

• Métriques : vous pouvez générer des rapports sur une ou plusieurs métriques. Chacune d'elles mesure l'utilisation d'un type de ressource donné. Seules les métriques DELTA assorties de valeurs INT64 sont acceptées pour la facturation.

• Configuration de la facturation : vous permet de spécifier les métriques à envoyer à Cloud Billing.

Dans l'exemple de configuration de service suivant, nous définissons une métrique mesurant le nombre de livres empruntés par un utilisateur. Un client peut appeler la méthode services.report pour générer des rapports sur les valeurs de la métrique. Consultez la section billing.proto pour en savoir plus sur la configuration de la facturation.

# library
monitored_resources:
 - type: library.appspot.com/branch
   labels:
   - key: cloud.googleapis.com/location
     description: The cloud location.
   - key: library.appspot.com/city
     description: The city where the library branch is located in.

# The metrics to be used.
metrics:
- name: library.appspot.com/books/borrowed
  metric_kind: DELTA
  value_type: INT64
  unit: '1'

# The billing configuration.
billing:
  consumer_destinations:
  - monitored_resource: library.appspot.com/branch
    metrics:
    - library.appspot.com/books/borrowed

Créer des rapports sur les métriques de facturation

Une fois que vous avez configuré la surveillance dans la configuration du service et envoyé la configuration à l'aide de l'API Service Management, vous pouvez appeler l'API Service Control pour générer des rapports sur les métriques. L'exemple suivant démontre l'appel en question à l'aide de la commande gcurl. Pour savoir comment le configurer, consultez la page Premiers pas avec l'API Service Control.

$ gcurl -d "{
  'operations': [ {
    'operationId': '8356d3c5-f9b5-4274-b4f9-079a3731e6e5',
    'consumerId': 'project:library-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'cloud.googleapis.com/location': 'us-west1',
      'library.appspot.com/city': 'Kirkland',
    },
    'metricValueSets': [ {
      'metricName': 'library.appspot.com/books/borrowed',
      'metricValues': [ { 'int64Value': '10' } ]
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/library.appspot.com:report