Informes de métricas de facturación

En esta página se describe cómo usar la infraestructura de servicio para permitir que los servicios administrados envíen datos de uso de facturación y que, de esa forma, Cloud Billing pueda cobrar a los consumidores de dichos servicios. Por ejemplo, puedes definir una métrica llamada library.appspot.com/books/borrowed para contar el número de libros que ha cogido prestados un cliente y, a continuación, definir una referencia de almacén (SKU) y un precio para dicha cifra.

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 ninguno, Cloud Billing ignora las métricas de facturación. Para definir un modelo de precio, ponte en contacto con tu administrador de cuenta de partner de Google Cloud Platform.

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 supervisados: puedes recopilar el uso de facturación de cada recurso. Este tipo de recursos necesitan una clave de etiqueta cloud.googleapis.com/location como mínimo para indicar la ubicación del uso de facturación.

  • Métricas: puedes generar informes de una o más métricas. Cada una de ellas calcula el uso de un tipo de recurso concreto. Para la facturación, solo se aceptan las métricas DELTA con valores INT64.

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

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. Los clientes pueden invocar el método services.report para generar informes de los valores de dicha métrica. Consulta la página 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 demostrar la llamada. Consulta el artículo Primeros pasos con la API Service Control para obtener más información sobre cómo realizar la configuración.

$ 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
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Service Infrastructure