Best practice per i report sull'utilizzo

Per i prodotti SaaS basati sull'utilizzo, Google Cloud Marketplace attribuisce l'utilizzo a un singolo progetto Google Cloud, specificato dal campo usageReportingId. In alcuni scenari, un prodotto SaaS può essere condiviso in modo ampio all'interno dell'organizzazione di un cliente e utilizzato in numerosi progetti del cliente. A attivare il supporto per un'attribuzione dei costi più specifica, è consigliabile che i I prodotti SaaS includono il campo facoltativo userLabels nel report sull'utilizzo operazione.

Se il tuo servizio supporta già un concetto di etichette delle risorse, consigliamo di inoltrare le etichette nei report sull'utilizzo. Le etichette devono essere conformi ai requisiti di sintassi.

Etichette di utilizzo

Cloud Marketplace riserva le seguenti etichette. Puoi utilizzare queste etichette per identificare un contesto aggiuntivo per l'utilizzo all'interno della piattaforma di servizi. Me consigliamo di includere queste etichette nei report sull'utilizzo per impostazione predefinita.

Chiave di etichettaValore etichettaDescription>
cloudmarketplace.googleapis.com/resource_name USER_SUPPLIED Il nome della risorsa associata a una metrica di utilizzo.
cloudmarketplace.googleapis.com/container_name USER_SUPPLIED Il nome di un contenitore di risorse.

Le etichette vengono inoltrate alla gestione dei costi della fatturazione Cloud inclusi i report sui costi e esportazioni della fatturazione.

Esempio di etichettatura di utilizzo

Per questo esempio, immagina che la tua organizzazione offra un prodotto di archiviazione chiamato Soluzioni di archiviazione SaaS.

Un cliente, Carl, ha acquistato la tua offerta di archiviazione per il suo progetto Google Cloud e-commerce-website per ospitare i database user_profiles_db e products_db per il suo sito web di e-commerce:

  • user_profiles_db contiene informazioni sugli utenti che visitano il sito di Carlo.
  • products_db contiene informazioni sui prodotti venduti da Carlo sul suo sito.

Se vuoi fornire a Carl un'analisi dettagliata dei costi di utilizzo, puoi utilizza la coppia chiave-valore userLabels per segnalare il costo di utilizzo per ogni separatamente il database.

Ad esempio, per segnalare il costo attribuito all'utilizzo dello spazio di archiviazione products_db di Carlo, puoi inviare il seguente report, che indica che lo spazio di archiviazione products_db di Carlo costa 100 unità:

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 questo esempio, service_name è l'ID progetto di Google Cloud di Carl progetto.

Per un esempio più dettagliato di utilizzo di userLabels, consulta le Codelab SaaS.