Best Practices für die Nutzungsberichte

Bei nutzungsbasierten SaaS-Produkten wird die Nutzung im Google Cloud Marketplace einem einzelnen Google Cloud-Projekt zugeordnet, das im Feld usageReportingId angegeben ist. In einigen Szenarien kann ein SaaS-Produkt innerhalb der Organisation eines Kunden freigegeben und in vielen Kundenprojekten verwendet werden. Um eine genauere Kostenzuordnung zu ermöglichen, empfehlen wir, dass nutzungsbasierte SaaS-Produkte das optionale Feld userLabels in ihrem Vorgang im Nutzungsbericht enthalten.

Wenn Ihr Dienst bereits ein Konzept von Ressourcenlabels unterstützt, empfehlen wir, diese Labels in Ihren Nutzungsberichten weiterzuleiten. Labels müssen den Syntaxanforderungen entsprechen.

Nutzungslabels

Die folgenden Labels sind für Cloud Marketplace reserviert. Mithilfe dieser Labels können Sie zusätzlichen Kontext für die Nutzung auf Ihrer Dienstplattform identifizieren. Wir empfehlen, diese Labels standardmäßig in Ihre Nutzungsberichte aufzunehmen.

Labels werden an Cloud Billing-Tools zur Kostenverwaltung weitergeleitet, einschließlich Kostenberichte und Abrechnungsexporte.

Beispiel für die Kennzeichnung der Nutzung

Angenommen, Ihre Organisation bietet ein Speicherprodukt namens SaaS Storage Solutions an.

Ein Kunde, Carl, hat Ihr Speicherangebot für sein Google Cloud-Projekt e-commerce-website gekauft, um die Datenbanken user_profiles_db und products_db für seine E-Commerce-Website zu hosten:

• user_profiles_db enthält Informationen zu Nutzern, die die Website von Carl besuchen.
• products_db enthält Informationen zu Produkten, die Carl auf seiner Website verkauft.

Wenn Sie Carl eine detaillierte Kostenaufschlüsselung seiner Nutzung zur Verfügung stellen möchten, können Sie mit dem Schlüssel/Wert-Paar userLabels die Nutzungskosten für jede Datenbank separat erfassen.

Wenn Sie beispielsweise die Kosten für die products_db-Speichernutzung von Carl erfassen möchten, können Sie den folgenden Bericht senden, aus dem hervorgeht, dass Carl für seinen products_db-Speicher 100 Einheiten bezahlt:

operation = {
  'operationId': '<UUID>',
  'operationName': 'db-total-storage',
  'consumerId': 'project:carl_website',
  'startTime': '<Timestamp>',
  'endTime': '<Timestamp>',
  'metricValues': [{
      'int64Value': 100,
  }],
  'userLabels': {
    'cloudmarketplace.googleapis.com/container_name': 'e-commerce-website',
    'cloudmarketplace.googleapis.com/resource_name': 'products_db'
  }
}

service.services().report(
  serviceName=service_name, body={
    'operations': [operation]
}).execute()

In diesem Beispiel ist service_name die Projekt-ID von Carls Google Cloud-Projekt.

Ein detaillierteres Beispiel für die Verwendung von userLabels finden Sie im Codelab zu SaaS.