Relatórios de métricas de faturação

Esta página descreve como usar a infraestrutura de serviços para permitir que os serviços geridos enviem dados de utilização de faturação para que a faturação do Google Cloud possa cobrar os consumidores de serviços. Por exemplo, pode definir uma métrica denominada library.appspot.com/books/borrowed para medir o número de livros emprestados por um cliente e definir uma unidade de gestão de stock (SKU) e um preço para a mesma.

A API Service Control aceita métricas, que agrupa, agrega e encaminha para a Faturação do Google Cloud. O Cloud Billing carrega estas métricas e gera faturas com base no modelo de preços predefinido. Se não existir um modelo de preços predefinido, o Cloud Billing ignora simplesmente as métricas de faturação. Para definir o modelo de preços, contacte o seu Google Cloud gestor de conta de parceiro.

Configurar a faturação

Antes de enviar dados de faturação para a API Service Control, tem de especificar três informações diferentes na configuração do serviço:

  • Recursos monitorizados: pode recolher a utilização de faturação para cada recurso. Os recursos monitorizados precisam de, pelo menos, uma chave de etiqueta cloud.googleapis.com/location para indicar a localização da utilização de faturação.

  • Métricas: pode comunicar uma ou mais métricas. Cada métrica mede a utilização de um determinado tipo de recurso. Apenas as métricas DELTA com valores INT64 são suportadas para faturação.

  • Configuração de faturação: permite-lhe especificar as métricas a enviar para a faturação na nuvem.

A configuração do serviço de exemplo seguinte define uma métrica que mede o número de livros emprestados por um cliente. Um cliente pode invocar o método services.report para comunicar valores na métrica. Consulte o ficheiro billing.proto para ver detalhes sobre a configuração de faturação.

# 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

Relatórios de métricas de faturação

Depois de configurar a monitorização na configuração do serviço e enviar a configuração do serviço através da API Service Management, pode chamar a API Service Control para comunicar métricas. O exemplo seguinte usa o comando gcurl para demonstrar a chamada. Para obter informações sobre como configurar esta opção, consulte o artigo Introdução à 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