Informes de métricas de facturación

En esta página se describe cómo usar Service Infrastructure para permitir que los servicios gestionados envíen datos de uso de facturación para que Facturación de Cloud pueda cobrar a los consumidores de servicios. Por ejemplo, puede definir una métrica llamada library.appspot.com/books/borrowed para medir el número de libros que ha pedido prestado un cliente y definir un código de producto (SKU) y un precio para ella.

La API Service Control acepta métricas para luego agruparlas por lotes, acumularlas y reenviarlas a Cloud Billing. Por su parte, Cloud Billing las ingiere y genera facturas basadas en el modelo de precio predefinido. Si no hay ningún modelo de precios predefinido, Facturación de Cloud simplemente ignora las métricas de facturación. Para definir el modelo de precios, póngase en contacto con su gestor de cuentas de partner. Google Cloud

Configurar la facturación

Antes de enviar los datos de facturación a la API Service Control, tienes que especificar la siguiente información en la configuración del servicio:

  • Recursos monitorizados: puede recoger el uso de facturación de cada recurso. Los recursos monitorizados necesitan al menos una clave de etiqueta cloud.googleapis.com/location para indicar la ubicación del uso de facturación.

  • Métricas: puedes generar informes de una o más métricas. Cada métrica mide el uso de un tipo de recurso concreto. Solo se admiten métricas DELTA con valores INT64 para la facturación.

  • Configuración de facturación: te permite especificar las métricas que se enviarán a Facturación de Cloud.

En el siguiente ejemplo de configuración de servicio se define una métrica que calcula el número de libros que se han prestado a un cliente. Un cliente puede invocar el método services.report para registrar valores en la métrica. Consulta billing.proto para obtener más información sobre la configuración de facturación.

# 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

Informes de métricas de facturación

Cuando hayas terminado de configurar la supervisión en la configuración del servicio y hayas enviado dicha configuración mediante la API Service Management, puedes llamar a la API Service Control para generar informes de las métricas. En el siguiente ejemplo se usa el comando gcurl para mostrar la llamada. Para obtener información sobre cómo configurarlo, consulta el artículo Primeros pasos con la 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