Rapporteren over factureringsstatistieken

Op deze pagina wordt beschreven hoe u service-infrastructuur kunt gebruiken om beheerde services in staat te stellen om gebruiksgegevens voor facturering te verzenden, zodat Cloud Billing kosten in rekening kan brengen voor servicegebruikers. U kunt bijvoorbeeld een statistiek definiëren met de naam library.appspot.com/books/borrowed om het aantal door een klant geleende boeken te meten en hiervoor een SKU (Stock Keeping Unit) en prijs te definiëren.

De Service Control API accepteert statistieken. Deze worden gegroepeerd, verzameld en doorgestuurd naar Cloud Billing. Cloud Billing verwerkt deze statistieken en genereert facturen op basis van het vooraf gedefinieerde prijsmodel. Als er geen vooraf gedefinieerd prijsmodel is, negeert Cloud Billing eenvoudigweg de factureringsstatistieken. Neem contact op met uw partneraccountmanager van Google Cloud Platform om het prijsmodel te definiëren, .

Facturering configureren

Voordat u factureringsgegevens naar de Service Control API verzendt, moet u drie verschillende soorten informatie in uw serviceconfiguratie opgeven:

  • Gecontroleerde resources: U kunt het factureringsgebruik voor elke resource verzamelen. De gecontroleerde resources hebben ten minste één labelsleutel cloud.googleapis.com/location nodig om de locatie van het factureringsgebruik aan te geven.

  • Statistieken: U kunt een of meer statistieken rapporteren. Elke statistiek meet het gebruik van een bepaald type resource. Alleen DELTA-statistieken met INT64-waarden worden ondersteund voor facturering.

  • Factureringsconfiguratie: Hiermee kunt u de statistieken opgeven die naar Cloud Billing moeten worden verzonden.

In het volgende voorbeeld van een serviceconfiguratie wordt één statistiek gedefinieerd die het aantal boeken meet dat door een klant is geleend. Een client kan de methode services.report aanroepen om over waarden voor de statistiek te rapporteren. Zie billing.proto voor informatie over de factureringsconfiguratie.

# 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

Rapporteren over factureringsstatistieken

Nadat u controle in de serviceconfiguratie heeft geconfigureerd en de configuratie naar de Service Management API heeft gepusht, kunt u de Service Control API aanroepen om over statistieken te rapporteren. In het volgende voorbeeld wordt de opdracht gcurl gebruikt om de aanroep te demonstreren. Zie Aan de slag met de Service Control API voor meer informatie over hoe u dit in kunt stellen.

$ 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