Práticas recomendadas para a etiquetagem de utilização

Para produtos SaaS baseados na utilização, o Google Cloud Marketplace atribui a utilização a um únicoGoogle Cloud projeto, especificado pelo campo usageReportingId. Em alguns cenários, um produto SaaS pode ser partilhado amplamente na organização de um cliente e usado em muitos projetos de clientes. Para ativar o suporte técnico para uma atribuição de custos mais específica, recomendamos que os produtos SaaS baseados na utilização incluam o campo userLabels opcional no respetivo relatório de utilização operation.

Se o seu serviço já suportar um conceito de etiquetas de recursos, recomendamos que encaminhe essas etiquetas nos seus relatórios de utilização. As etiquetas têm de estar em conformidade com os requisitos de sintaxe.

Etiquetas de utilização

O Cloud Marketplace reserva as seguintes etiquetas. Pode usar estas etiquetas para identificar contexto adicional para utilização na sua plataforma de serviços. Recomendamos que inclua estas etiquetas nos seus relatórios de utilização por predefinição.

Chave da etiqueta	Valor da etiqueta	Descrição>
cloudmarketplace.googleapis.com/resource_name	USER_SUPPLIED	O nome do recurso associado a uma métrica de utilização.
cloudmarketplace.googleapis.com/container_name	USER_SUPPLIED	O nome de um contentor de recursos.

As etiquetas são encaminhadas para as ferramentas de gestão de custos do Cloud Billing, incluindo relatórios de custos e exportações de faturação.

Exemplo de etiquetagem de utilização

Para este exemplo, imagine que a sua organização oferece um produto de armazenamento denominado SaaS Storage Solutions.

Um cliente, o Carlos, comprou a sua oferta de armazenamento para o respetivo Google Cloud projeto e-commerce-website, para alojar as bases de dados user_profiles_db e products_db para o respetivo Website de comércio eletrónico:

• user_profiles_db contém informações sobre os utilizadores que visitam o site de Carlos.
• products_db contém informações sobre os produtos que o Carlos vende no respetivo site.

Se quiser fornecer ao Carlos uma discriminação detalhada dos custos da respetiva utilização, pode usar o par de chave-valor userLabels para comunicar o custo de utilização de cada base de dados separadamente.

Por exemplo, para comunicar o custo atribuído à utilização do armazenamento products_db de Carl, pode enviar o seguinte relatório, que indica que o armazenamento products_db de Carl está a custar-lhe 100 unidades:

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()

Neste exemplo, service_name é o ID do projeto de Carl. Google Cloud

Para ver um exemplo mais detalhado da utilização de userLabels, consulte o codelab de SaaS.