Este documento fornece informações de referência para o esquema dos dados de custos de utilização detalhados da faturação do Google Cloud que são exportados para cada tabela no BigQuery.
Os dados de custos de utilização detalhados fornecem todas as informações incluídas nos dados de custos de utilização padrão, juntamente com campos adicionais que fornecem dados de custos detalhados ao nível dos recursos, como uma máquina virtual ou um SSD que gera utilização. A exportação detalhada inclui informações de custos detalhadas sobre os seguintes serviços:
|
|
|
Identifique dados de custos detalhados por serviço
Para analisar informações de custos detalhadas numa exportação detalhada, use a tabela seguinte para identificar a coluna que contém informações sobre recursos específicos.
Descrição do serviço | Coluna | Como identificar recursos |
---|---|---|
AlloyDB para PostgreSQL | service.description e resource.name ou
resource.global_name |
A coluna |
App Engine | service.description e resource.name ou
resource.global_name |
A coluna |
BigQuery | service.description e resource.name ou
resource.global_name
|
A coluna |
Bigtable | service.description e resource.global_name |
A coluna |
Cloud Data Fusion | service.description e resource.name ou
resource.global_name |
A coluna |
Cloud Deploy | service.description e resource.name ou
resource.global_name |
A coluna |
Funções do Cloud Run | service.description e resource.name ou
resource.global_name |
A coluna |
Cloud Logging | service.description e resource.global_name |
A coluna |
Cloud Run | service.description e resource.name ou
resource.global_name |
A coluna |
Cloud SQL | service.description e resource.global_name |
A coluna |
Cloud Storage | service.description e resource.global_name |
A coluna |
Compute Engine | service.description e resource.name ou
resource.global_name |
A coluna |
Dataflow | service.description e resource.name ou
resource.global_name
|
A coluna |
Dataproc Metastore | service.description e resource.name ou
resource.global_name |
A coluna |
Firestore e Datastore | service.description e resource.name ou
resource.global_name |
A coluna |
Google Kubernetes Engine (GKE) | labels.key |
Use as seguintes chaves de etiquetas para filtrar os recursos:
Para ver os custos detalhados do cluster do GKE na exportação de dados de custos detalhados, também tem de ativar a atribuição de custos para o GKE. Consulte exemplos de consultas para filtrar dados do GKE em exportações do BigQuery. |
Microsoft AD gerido | service.description e resource.name ou
resource.global_name |
A coluna |
Memorystore for Redis | service.description e resource.global_name |
A coluna |
Secret Manager | service.description , resource.name e
resource.global_name |
A coluna |
Spanner | service.description e resource.global_name |
A coluna |
Veja exemplos de consultas de dados detalhados para os seus recursos.
Esquema de dados de custos de utilização detalhados
No conjunto de dados do BigQuery, os dados detalhados dos custos de utilização Google Cloud
são carregados numa tabela de dados denominada
gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>
.
Quando usa os dados de custos de utilização detalhados no BigQuery, tenha em atenção o seguinte:
- O esquema da tabela para a exportação detalhada de dados de faturação do Google Cloud pode mudar ao longo do tempo, por exemplo, quando são adicionados novos campos à exportação detalhada. Para proteger as suas consultas de alterações futuras ao esquema, em vez de usar consultas que referenciam diretamente as colunas exportadas, recomendamos que use vistas do BigQuery para normalizar os dados, de modo que a tabela apresente o mesmo esquema às suas consultas. Saiba mais acerca desta limitação.
- Quando seleciona ou cria um conjunto de dados do BigQuery para os seus dados de custos de utilização detalhados, pode selecionar qualquer localização do conjunto de dados suportada para utilização com dados de faturação do Google Cloud.
- Quando ativa a exportação de dados de custos de utilização detalhados pela primeira vez na faturação do Google Cloud, se selecionar um conjunto de dados configurado para usar uma localização multirregional (UE ou EUA), os dados de faturação do Google Cloud ficam disponíveis retroativamente a partir do início do mês anterior. Os dados são exportados por ordem cronológica. Para o preenchimento inicial dos dados exportados, a exportação dos dados de faturação do Google Cloud retroativos pode demorar até cinco dias antes de começar a ver os dados de utilização mais recentes.
- Se ativar a exportação dos dados de custos de utilização detalhados e selecionar um conjunto de dados configurado para usar uma localização de região suportada, os dados de faturação do Google Cloud vão estar disponíveis a partir da data em que ativou a exportação.
- Se ativou, desativou e, posteriormente, reativou a exportação dos dados de custos de utilização detalhados, os dados de faturação do Google Cloud podem não estar disponíveis para o período em que a exportação de dados foi explicitamente desativada.
- Saiba mais sobre a frequência dos carregamentos de dados nas suas tabelas do BigQuery.
- Consulte outras limitações que podem afetar a exportação dos seus dados de faturação para o BigQuery, como conjuntos de dados com chaves de encriptação geridas pelo cliente (CMEK) ativadas.
- Tenha em conta o volume de dados adicional que as tabelas do BigQuery podem precisar e o custo adicional quando ativa os dados de custos de utilização detalhados em vez da exportação dos dados de custos de utilização padrão. A maior granularidade das informações ao nível do recurso pode aumentar o número de linhas, que são agregadas no formato de custo de utilização padrão. Recomendamos que reveja o artigo Controle os custos no BigQuery para ver mais práticas recomendadas de gestão dos custos do BigQuery.
Campo | Tipo | Descrição |
---|---|---|
billing_account_id |
String | O ID da conta de faturação do Google Cloud ao qual a utilização está associada. Para revendedores: para custos de utilização gerados por uma subconta do Cloud Billing, este é o ID da subconta e não o ID da conta do Cloud Billing do revendedor principal. |
invoice.month |
String | O ano e o mês (AAAAMM) da fatura que inclui os itens de linha de custos. Por exemplo: "201901" é equivalente a janeiro de 2019. Pode usar este campo para obter as cobranças totais na fatura. Consulte os exemplos de consultas de exportação da faturação do Google Cloud para o BigQuery. |
invoice.publisher_type |
String | Indica o publicador associado à transação. Este campo suporta a divisão de faturas entre transações feitas diretamente com a Google (origem) e transações feitas com um parceiro (terceiros), o que também indica que regulamentos podem aplicar-se à transação. Os valores possíveis são:
|
cost_type |
String | O tipo de custo que este elemento publicitário representa: normal, imposto, ajuste ou erro de arredondamento. |
service.id |
String | O ID do serviço ao qual a utilização está associada. |
service.description |
String | O Google Cloud serviço que comunicou os dados de faturação do Google Cloud. |
sku.id |
String | O ID do recurso usado pelo serviço. Para ver a lista completa de SKUs, consulte Google Cloud SKUs. |
sku.description |
String | Uma descrição do tipo de recurso usado pelo serviço. Por exemplo, um tipo de recurso para o Cloud Storage é Standard Storage US. |
usage_start_time |
Indicação de tempo | A hora de início do período de utilização por hora no qual o custo indicado foi calculado. A utilização e os custos de todos os serviços são apresentados com granularidade horária, o que significa que a utilização de serviços de longa duração é distribuída por várias janelas horárias.
Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de data/hora. Veja também: Diferenças entre os dados exportados e as faturas. |
usage_end_time |
Indicação de tempo | A hora de fim do período de utilização por hora no qual o custo indicado foi calculado. A utilização e os custos de todos os serviços são apresentados com granularidade horária, o que significa que a utilização de serviços de longa duração é distribuída por várias janelas horárias.
Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de data/hora. Veja também: Diferenças entre os dados exportados e as faturas. |
project |
Struct | project contém campos que descrevem o projeto do Google Cloud Billing, como ID, número, nome, ancestry_numbers e etiquetas.
|
project.id |
String | O ID do Google Cloud projeto que gerou os dados do Cloud Billing. |
project.number |
String | Um identificador único anónimo gerado internamente para o Google Cloud projeto que gerou os dados de faturação na nuvem. Nos seus registos de apoio técnico e outras comunicações com o cliente, a Google vai referir-se aos seus projetos através deste número de projeto. |
project.name |
String | O nome do Google Cloud projeto que gerou os dados de faturação do Google Cloud. |
project.ancestry_numbers |
String | Os antecessores na hierarquia de recursos do projeto identificado pelo
project.id especificado (por exemplo, my-project-123).
Por exemplo: /ParentOrgNumber/ParentFolderNumber/. Saiba mais acerca da hierarquia de recursos. |
project.ancestors | Struct |
Este campo descreve a estrutura e o valor da hierarquia de recursos de um elemento publicitário de custo, incluindo projetos, pastas e organizações. Os antepassados são ordenados do nó para a raiz (projeto, pasta e, em seguida, organização). |
project.ancestors.resource_name | String | O
nome do recurso relativo para cada antepassado no formato "resourceType/resourceNumber". A utilização de project.ancestors.resource_name oferece uma vista mais completa de
project.ancestry_numbers . |
project.ancestors.display_name | String | O nome que criou para o seu recurso na consola. |
project.labels.key | String | Se as etiquetas estiverem presentes, a parte chave do par de chave-valor que compõe a etiqueta no projeto onde a utilização ocorreu. Google Cloud Para mais informações acerca da utilização de etiquetas, consulte o artigo Utilizar etiquetas. |
project.labels.value |
String | Se existirem etiquetas, a parte value do par de chave-valor que compõe a etiqueta no Google Cloud projeto onde a utilização ocorreu. Para mais informações sobre a utilização de etiquetas, consulte o artigo Usar etiquetas. |
labels.key |
String | Se existirem etiquetas, a parte da chave do par de chave-valor que compreende a etiqueta no Google Cloud recurso onde a utilização ocorreu. Para mais informações sobre a utilização de etiquetas, consulte o artigo Usar etiquetas. |
labels.value |
String | Se existirem etiquetas, a parte value do par de chave-valor que compreende a etiqueta no Google Cloud recurso onde a utilização ocorreu. Para mais informações sobre a utilização de etiquetas, consulte o artigo Usar etiquetas. |
system_labels.key |
String | Se existirem etiquetas do sistema, a parte chave do par de chave-valor que compreende a etiqueta gerada pelo sistema no recurso onde a utilização ocorreu. Veja também, Etiquetas do sistema disponíveis. |
system_labels.value |
String | Se existirem etiquetas do sistema, a parte value do par de chave-valor que compreende a etiqueta gerada pelo sistema no recurso onde a utilização ocorreu. Veja também, Etiquetas do sistema disponíveis. |
location.location |
String | Localização de utilização ao nível de uma multirregião, um país, uma região ou uma zona;
ou global para
os recursos não têm uma localização específica.
Para mais informações, consulte
Geografia e regiões e
Google Cloud localizações.
|
location.country |
String | Quando location.location é um país, uma região ou uma zona, este campo é o país de utilização, por exemplo, US .
Para mais informações, consulte
Geografia e regiões e
Google Cloud localizações.
|
location.region |
String | Quando location.location é uma região ou uma zona, este campo é
a região de utilização, por exemplo, us-central1 .
Para mais informações, consulte
Geografia e regiões e
Google Cloud localizações.
|
location.zone |
String | Quando location.location é uma zona, este campo é a zona de utilização, por exemplo, us-central1-a .
Para mais informações, consulte
Geografia e regiões e
Google Cloud localizações.
|
cost |
Flutuante | Custo de acordo com o modelo de consumo aplicável incluindo quaisquer descontos negociados refletidos nos preços personalizados no contrato associado à sua conta de faturação do Google Cloud (se aplicável). |
currency |
String | A moeda na qual o custo é faturado. Para mais informações, consulte o artigo Moeda local para faturação e pagamentos. |
currency_conversion_rate |
Flutuante | A taxa de câmbio de dólares americanos para a moeda local. Ou seja,
cost ÷ currency_conversion_rate
é o custo em dólares dos EUA. |
usage.amount |
Flutuante | A quantidade de usage.unit usada. |
usage.unit |
String | A unidade base na qual a utilização de recursos é medida. Por exemplo, a unidade base para o armazenamento padrão é byte-segundos. |
usage.amount_in_pricing_units
|
Flutuante | A quantidade de usage.pricing_unit usada.
|
usage.pricing_unit
|
String | A unidade na qual a utilização de recursos é medida, de acordo com a API Cloud Billing Catalog. |
credits |
Struct | credits contém campos que descrevem a estrutura e o valor dos créditos associados aos SKUs da Google Maps Platform. Google Cloud |
credits.id |
String | Se estiver presente, indica que existe um crédito associado ao SKU do produto.
Os valores credits.id são um identificador único alfanumérico
(por exemplo, 12-b34-c56-d78) ou uma descrição do tipo de crédito
(como
Desconto por utilização comprometida: CPU).
Se o campo |
credits.full_name |
String | O nome do crédito associado ao SKU do produto. Esta é uma
descrição legível de um código alfanumérico credits.id .
Alguns exemplos incluem:
Crédito de avaliação gratuita ou
Desconto por utilização comprometida baseado em gastos.
Os valores |
credits.type |
String | Este campo descreve a finalidade ou a origem do credits.id .
Os tipos de créditos incluem:
|
credits.name |
String | Uma descrição do crédito aplicado à conta do Cloud Billing. |
credits.amount |
Flutuante | O valor do crédito aplicado à utilização. |
adjustment_info |
Struct | adjustment_info contém campos que descrevem a estrutura e o valor de um ajuste aos elementos publicitários de custo associados a uma conta de faturação do Google Cloud.
Os valores |
adjustment_info.id |
String | Se estiver presente, indica que um ajuste está associado a um item de linha de custo. adjustment_info.id é o ID exclusivo de todos os ajustes associados a um problema.
|
adjustment_info.description |
String | Uma descrição do ajuste e da respetiva causa. |
adjustment_info.type |
String | O tipo de ajuste. Os tipos incluem:
|
adjustment_info.mode |
String | Como foi emitido o ajuste. Os modos incluem:
|
export_time |
Indicação de tempo | Um tempo de processamento associado a uma anexação de dados do Cloud Billing.
Este valor aumenta sempre com cada nova exportação. Consulte também as diferenças entre os dados exportados e as faturas abaixo. |
tags |
Struct | Campos que descrevem a etiqueta, como a chave, o valor e o espaço de nomes. |
tags.key |
String | O nome abreviado ou o nome a apresentar da chave associada a esta etiqueta específica. |
tags.value |
String | Os recursos anexados a um |
tags.inherited |
Booleano | Indica se uma associação de etiquetas é herdada (Tags Inherited = True) ou direta/não herdada (Tags Inherited = False). Pode criar uma associação de etiquetas a um recurso principal na hierarquia de recursos. |
tags.namespace |
String | Representa a hierarquia de recursos que define a chave e os valores da etiqueta. O espaço de nomes pode ser combinado com os diminutivos da chave da etiqueta e do valor da etiqueta para criar um nome totalmente qualificado e globalmente único para a chave da etiqueta ou o valor da etiqueta. |
cost_at_list |
Flutuante | Custo segundo o preço de tabela de acordo com o modelo de consumo predefinido. |
transaction_type |
String | O tipo de transação do vendedor. O tipo de transação pode ser um dos seguintes:
|
seller_name |
String | O nome legal do vendedor. |
price |
Struct | Campos que descrevem a estrutura e os valores relacionados com os preços cobrados pela utilização. |
price.list_price |
Numérico | Preço de tabela do SKU de acordo com o modelo de consumo predefinido. |
price.effective_price_default |
Numérico | Preço do SKU de acordo com o modelo de consumo predefinido, incluindo todos os descontos negociados refletidos nos preços personalizados no contrato associado à sua conta de faturação do Google Cloud (se aplicável). |
price.list_price_consumption_model |
Numérico | Preço de tabela do SKU de acordo com o modelo de consumo aplicável antes de quaisquer descontos negociados refletidos nos preços personalizados no contrato associado à sua conta de faturação do Google Cloud (se aplicável). |
price.effective_price |
Numérico | Preço do SKU de acordo com o modelo de consumo aplicável, incluindo todos os descontos negociados refletidos nos preços personalizados no contrato associado à sua conta de faturação do Google Cloud (se aplicável). |
price.tier_start_amount |
Numérico | O número de unidades do limite inferior para o nível de preços de um SKU. Para mais informações, consulte o artigo Acerca dos níveis de preços. |
price.unit |
String | A unidade de utilização na qual o preço é especificado e a utilização de recursos é medida. |
price.pricing_unit_quantity |
Numérico | O número de unidades do limite inferior para o nível de preços de um SKU. Para mais informações, consulte o artigo Acerca dos níveis de preços. |
cost_at_effective_price_default |
Numérico | Custo de acordo com o modelo de consumo predefinido, incluindo quaisquer descontos negociados refletidos nos preços personalizados no contrato associado à sua conta de faturação do Google Cloud (se aplicável). |
cost_at_list_consumption_model |
Numérico | Custo de acordo com o modelo de consumo aplicável antes de quaisquer descontos negociados refletidos nos preços personalizados no contrato associado à sua conta do Cloud Billing (se aplicável). |
consumption_model |
Struct | Campos que descrevem o modelo de consumo aplicável. |
consumption_model.id |
String | O ID do modelo de consumo. |
consumption_model.description |
String | A descrição do modelo de consumo. |
Campos adicionais disponíveis para a exportação de dados de custos de utilização detalhados | ||
resource |
Struct | Os campos que descrevem a estrutura e o valor das informações relevantes para os recursos de serviço (como uma máquina virtual ou um SSD) que geram utilização. |
resource.global_name |
String | Um identificador de serviço globalmente exclusivo para o recurso que gerou a utilização relevante. |
resource.name |
String | Um identificador específico do serviço para o recurso que gerou a utilização relevante. Pode ser uma entrada gerada pelo utilizador. |
subscription |
Struct | Campos que descrevem os seus compromissos baseados em gastos ou recursos. Pode usar estes campos para analisar as suas taxas para compromissos específicos. |
subscription.instance_id |
String | O ID da subscrição associado a um compromisso. |
Compreenda os dados de custos de utilização padrão e detalhados
As secções seguintes descrevem os dados de custos de utilização padrão e detalhados exportados para o BigQuery.
Acerca das etiquetas
Os dados de custos de uma etiqueta específica mostram apenas a utilização a partir da data em que a etiqueta foi aplicada a um recurso. Por exemplo, se adicionar a etiqueta environment:dev
a uma VM do Compute Engine a 15 de janeiro de 2024, qualquer análise para
environment:dev
inclui apenas a utilização dessa VM desde 15 de janeiro.
Também pode ver dados de etiquetas em momentos diferentes para diferentes serviços, consoante o momento em que cada serviço os fornece.
Marcadores do sistema disponíveis
As etiquetas do sistema são pares de chave-valor para metadados importantes sobre o recurso que gerou a utilização. As seguintes etiquetas do sistema são incluídas automaticamente na utilização aplicável.
system_labels.key |
Exemplo system_labels.value |
Descrição |
---|---|---|
compute.googleapis.com/machine_spec |
n1-standard-1, custom-2-2048 | Configuração da máquina virtual. Consulte Tipos de máquinas para mais informações. |
compute.googleapis.com/cores |
Para n1-standard-4, este valor é 4; para custom-2-2048, este valor é 2 | O número de vCPUs disponíveis para a máquina virtual. |
compute.googleapis.com/memory |
Para n1-standard-4, este valor é 15360 (ou seja, 15 GB * 1024 MB/GB); para custom-2-2048, este valor é 2048 | A quantidade de memória (em MB) disponível para a máquina virtual. |
compute.googleapis.com/is_unused_reservation |
verdadeiro; falso | Indica a utilização que foi reservada através de Reservas zonais mas não foi usada. |
compute.googleapis.com/reservation_name |
my-a2-reservation | O diminutivo da reserva do Compute Engine. |
compute.googleapis.com/reservation_project_id |
my-gcp-project | O ID do projeto proprietário da reserva do Compute Engine. |
storage.googleapis.com/object_state |
live; noncurrent; soft_deleted; multipart | O estado do objeto de armazenamento que está a ser cobrado. |
Diferenças entre os dados exportados e as faturas
Google Cloud Os produtos comunicam os dados de utilização e custos aos processos de faturação do Google Cloud em intervalos variáveis. Como resultado, pode haver um atraso entre a sua utilização dos serviços Google Cloud e a disponibilidade da utilização e dos custos para visualização na faturação do Google Cloud. Normalmente, os custos estão disponíveis no prazo de um dia, mas, por vezes, podem demorar mais de 24 horas.
No final de um mês civil, a utilização comunicada tardiamente pode não ser incluída na fatura desse mês e, em vez disso, pode ser transferida para a fatura do mês seguinte.
Quando consulta os seus custos através de campos de data/hora, os dados devolvidos podem recolher a utilização comunicada tardiamente que não foi originalmente incluída na fatura gerada para o mesmo mês de utilização. Como resultado, os dados de faturação na nuvem devolvidos podem não ser mapeados diretamente para essa fatura.
Os campos de indicação de tempo incluem:
usage_start_time
usage_end_time
export_time
Para devolver dados da Faturação na nuvem que mapeiam diretamente uma fatura, consulte
invoice.month
em vez de campos de data/hora.
Impostos
A partir de 1 de setembro de 2020, os dados de custos de utilização mostram a sua responsabilidade fiscal para cada um dos seus projetos, em vez de como um único item de linha. Se tiver consultas ou visualizações que dependam de dados fiscais, pode ter de atualizar as consultas para ter em conta estas alterações.
Por exemplo, para os custos registados antes de 1 de setembro, os dados de custos de utilização são semelhantes ao exemplo seguinte, que mostra uma responsabilidade fiscal total de 10 USD.
billing_account_id |
project.id |
cost_type |
cost |
---|---|---|---|
123456-ABCDEF-123456 | example-project | Normal | 60 € |
123456-ABCDEF-123456 | test-project | Normal | 40 USD |
123456-ABCDEF-123456 | [vazio] | Imposto | 10 € |
Para custos registados após 1 de setembro, os 10 $são divididos em 6 $para
example-project
e 4 $para test-project
:
billing_account_id |
project.id |
cost_type |
cost |
---|---|---|---|
123456-ABCDEF-123456 | example-project | Normal | 60 € |
123456-ABCDEF-123456 | test-project | Normal | 40 USD |
123456-ABCDEF-123456 | example-project | Imposto | 6 € |
123456-ABCDEF-123456 | test-project | Imposto | 4 € |
Erros e ajustes
No caso raro de os seus dados do Cloud Billing conterem um erro ou exigirem um ajuste, são anexados dados corretivos. Estes ajustes enquadram-se numa de duas categorias: modificações ou correções de faturação.
Modificações de faturação
As modificações de faturação aparecem como itens de linha separados. Se recebeu uma modificação da faturação, é apresentado um novo elemento publicitário na exportação da faturação do Google Cloud para o BigQuery a indicar a alteração. Os ajustes apresentados correspondem aos documentos de fatura, nota de crédito e nota de débito disponíveis na área Documentos da secção Faturação na Google Cloud consola.
Para mais informações sobre as modificações de faturação e como são aplicadas, consulte o artigo Compreenda os memorandos e os ajustes.
Correções
As correções aparecem como novos dados que anulam os dados incorretos nos RFCs de origem. Em alguns casos, os novos dados substituem a cobrança incorreta. Todas as colunas na exportação de dados de faturação correspondem aos dados originais, exceto as seguintes colunas:
cost
credit
usage.amount
export_time
Por exemplo, imagine que lhe são cobrados 10 € pela sua utilização do SKU A
a 1 de janeiro. Na fatura de janeiro (emitida no início de fevereiro), vai ver uma cobrança de 10 € para SKU A
. No entanto, a 2 de fevereiro, Google Cloud emitiu uma correção contra SKU A
, reduzindo o custo de utilização para 5 USD. Vai receber
dois itens de linha adicionais na fatura de fevereiro (emitida no início de março):
- -10 € pela utilização a 1 de janeiro (anulando a cobrança original)
- 5 € pela utilização a 1 de janeiro (indicando a cobrança pretendida)
Estes novos itens têm uma coluna adjustment_info
na exportação de dados de faturação. A fatura original de janeiro, que apresenta o valor cobrado em excesso, não é ajustada.
Pode validar as cobranças na exportação de dados de faturação, vendo os custos por usage_start_time
e agrupando por Day
.
Nestas vistas, as correções ou os encargos relativos à utilização rentabilizada tardiamente são
acumulados, e não tem de se preocupar com dados temporariamente incorretos.
Se quiser informações mais detalhadas sobre as suas correções, veja todas as cobranças num mês de faturação e procure cobranças cuja data de utilização tenha ocorrido antes do mês de faturação. Estes encargos são o resultado de correções ou utilização monetizada tardiamente.
O exemplo de código seguinte mostra como criar uma consulta básica que devolve o custo total das correções ou da utilização monetizada tardiamente:
SELECT
SUM(cost)
+ SUM(IFNULL((SELECT SUM(c.amount)
FROM UNNEST(credits) c), 0))
AS total
FROM `project.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE
invoice.month = '202311' AND
DATE(TIMESTAMP_TRUNC(usage_start_time, Day, 'US/Pacific')) < '2023-11-01';
Por exemplo, para um exemplo de consulta que devolve uma discriminação de custos por serviço, para encargos de fatura, em que a data de utilização ocorreu antes do mês da fatura, consulte o artigo Consulte os detalhes de custos para ver correções ou utilização monetizada tardiamente por serviço para um mês de faturação especificado em "Consultas de exemplo para a exportação de dados de faturação do Google Cloud".
Acerca dos créditos promocionais em contratos de preços personalizados
Se tiver um contrato de preços personalizado, pode receber créditos promocionais para usar no Google Cloud como parte do contrato. Por exemplo, pode receber 1000 € para usar em recursos do Compute Engine. Normalmente, os créditos promocionais são considerados uma forma de pagamento. Quando disponíveis, os créditos promocionais são aplicados automaticamente para reduzir o valor total da fatura.
Os termos do seu contrato especificam se os créditos promocionais se aplicam aos seus custos calculados ao preço de tabela de um SKU ou ao preço líquido (após os descontos).
Se os seus créditos promocionais se aplicarem a custos calculados ao preço
de tabela, no relatório Tabela de custos, existe um serviço denominado Invoice
com um SKU denominado Contract billing adjustment
. Este SKU ajusta os seus créditos para que se apliquem aos custos ao preço de tabela. Para ver a utilização a que se destina o ajuste, consulte as colunas system.labels
. A chave em
system.labels.key
é cloud-invoice.googleapis.com/sku_id
e o valor em
system.labels.value
contém o ID do SKU ao qual o crédito e o ajuste foram aplicados.
Acerca das etiquetas
As etiquetas são recursos sob a forma de pares de chave-valor que podem ser anexados a recursos diretamente ou através da herança. Pode usar etiquetas para fazer estornos, auditorias e outras análises de atribuição de custos. Também pode usar etiquetas e a aplicação condicional de políticas para ter um controlo detalhado na sua hierarquia de recursos.
Os marcadores têm um modelo de autorizações robusto e podem suportar a herança, a gestão centralizada, a normalização da nomenclatura e a integração do motor de políticas, enquanto as etiquetas são uma ferramenta separada que lhe permite anotar recursos.
Os dados de etiquetas aparecem nas exportações do BigQuery para recursos, projetos, pastas e organizações.
Etiquetas disponíveis
As exportações de Custos padrão e Custos detalhados para recursos, projetos, pastas e organizações incluem estes campos para dados de etiquetas: chave de etiquetas, valor de etiquetas, etiquetas herdadas e espaço de nomes de etiquetas.
As etiquetas ao nível do recurso na exportação de dados de faturação do Google Cloud estão disponíveis para os seguintes recursos:
- Clusters, instâncias e cópias de segurança do AlloyDB for PostgreSQL
- Repositórios do Artifact Registry
- Instâncias do Bigtable
- Serviços e trabalhos do Cloud Run
- Contentores do Cloud Storage
- Instâncias do Compute Engine
- Instâncias do Memorystore for Redis
- Secrets globais e regionais do Secret Manager
- Instâncias do Spanner
- Bases de dados do Firestore
Limitações das etiquetas
- A propagação das etiquetas para as exportações do BigQuery pode demorar até uma hora. Se uma etiqueta tiver sido adicionada ou removida no prazo de uma hora, ou se um recurso existir há menos de uma hora, pode não aparecer na exportação.
Exemplos de consultas de custos de utilização detalhados
Esta secção fornece exemplos de como consultar os dados de custos de utilização detalhados da faturação do Google Cloud exportados para o BigQuery.
Uma vez que o esquema de custos de utilização detalhado inclui todos os campos do esquema de custos de utilização padrão, os exemplos de consultas fornecidos para os dados padrão exportados para o BigQuery também funcionam com os dados detalhados exportados. Os exemplos de consultas padrão não são escritos para obter nenhuma das informações ao nível do recurso fornecidas com a opção de exportação de custos de utilização detalhada. Quando criar consultas para os dados detalhados, pode usar um exemplo de consulta padrão como modelo, atualizar o nome da tabela e adicionar qualquer um dos campos disponíveis no esquema de custos de utilização detalhados.
Valores comuns usados nos exemplos de consultas de custos detalhadas
Os exemplos de consultas nesta secção usam o seguinte valor para Nome da tabela:
project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX
Devolva os custos ao nível do recurso numa fatura
As consultas seguintes demonstram duas formas de ver os valores de custos e créditos ao nível do recurso numa fatura através de dados de faturação exportados.
- O campo
total
soma diretamente os valores de custo e crédito de vírgula flutuante, o que pode resultar em erros de arredondamento de vírgula flutuante. - O campo
total_exact
converte os custos e os valores de crédito em micros antes de os somar e, em seguida, converte-os novamente em dólares após a soma, evitando o erro de arredondamento de ponto flutuante.
Soma dos custos de cada recurso, por fatura
Esta consulta mostra o total da fatura para cada resource.name
por mês, como uma soma dos custos normais, impostos, ajustes e erros de arredondamento. Todos os custos não associados a um item ao nível do recurso são agregados no nome null
para o mês.
SQL padrão
SELECT invoice.month, resource.name, SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS total, (SUM(CAST(cost * 1000000 AS int64)) + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64)) FROM UNNEST(credits) c), 0))) / 1000000 AS total_exact FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX` GROUP BY 1, 2 ORDER BY 1 ASC, 2 ASC ;
Por exemplo, o resultado da consulta anterior pode ser:
Linha | mês | nome | total | total_exact |
---|---|---|---|---|
1 | 201901 | null | $1005.004832999999984 | 1005,00 $ |
2 | 201901 | backend1 | 781,8499760000028 $ | 781,85 € |
3 | 201902 | null | $953,0034923645475983 | 953,03 € |
4 | 201902 | backend1 | 992,3101739999999717 € | 992,31 $ |
5 | 201902 | bitnami-launchpad-wordpress-1-wordpress | 1,2817819999999998 USD | 1,28 € |
Devolve detalhes por tipo de custo para cada recurso, por mês de faturação
Esta consulta mostra os totais de cada cost_type
para cada resource.name
por mês. Os tipos de custos incluem custos normais, impostos, ajustes e erros de arredondamento. Todos os custos não associados a um item ao nível do recurso são agregados
no nome null
para o mês.
SQL padrão
SELECT invoice.month, cost_type, resource.name, SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS total, (SUM(CAST(cost * 1000000 AS int64)) + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64)) FROM UNNEST(credits) c), 0))) / 1000000 AS total_exact FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX` GROUP BY 1, 2, 3 ORDER BY 1 ASC, 2 ASC, 3 ASC ;
Por exemplo, o resultado da consulta anterior pode ser:
Linha | mês | cost_type | nome | total | total_exact |
---|---|---|---|---|---|
1 | 201901 | regular | null | $1000.501209987994782 | 1000,50 $ |
2 | 201901 | rounding_error | null | –$0.500489920049387 | –$0,50 |
3 | 201901 | tax | null | $10.000329958477891 | 10,00 $ |
4 | 201901 | ajuste | null | –$5.002572999387045 | –$5.00 |
5 | 201901 | regular | backend1 | 410,998795012082947 $ | 411,00 $ |
2 | 201901 | rounding_error | backend1 | –$0.2404900489920378 | –$0,24 |
3 | 201901 | tax | backend1 | $4.105840329977189 | 4,11 € |
Obtenha uma discriminação dos custos do cluster do Google Kubernetes Engine (GKE)
Esta secção fornece exemplos de filtragem dos custos do cluster do GKE nos relatórios de exportação do BigQuery. Para saber mais sobre os custos dos clusters do GKE, visite o artigo Veja a discriminação dos custos dos clusters.
Filtre os custos do GKE
As consultas de exemplo seguintes mostram como filtrar e agrupar os custos do GKE para tipos de recursos suportados por nome do cluster, espaço de nomes e etiqueta.
Custos do cluster do GKE antes dos créditos
SELECT SUM(cost) AS cost_before_credits, labels.value AS cluster_name FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX` LEFT JOIN UNNEST(labels) as labels ON labels.key = "goog-k8s-cluster-name" GROUP BY labels.value ;
Custos do GKE após créditos por espaço de nomes
SELECT labels.value as namespace, SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS cost_after_credits, FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX` LEFT JOIN UNNEST(labels) as labels ON labels.key = "k8s-namespace" GROUP BY namespace ;
Custos do GKE por SKU
SELECT project.id AS project_id, labels.value AS cluster_name, sku.id AS sku_id, sku.description AS sku_description, SUM(cost) AS cost FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX` JOIN UNNEST(labels) AS labels ON labels.key = "goog-k8s-cluster-name" GROUP BY cluster_name, project_id, sku_description, sku_id ;
Exemplos de consultas com etiquetas
Os exemplos seguintes ilustram formas de consultar os seus dados com etiquetas.
Calcule os custos por mês de faturação com etiquetas
A consulta seguinte demonstra como pode usar os custos de devolução por mês de faturação
para a etiqueta cost_center
.
SELECT invoice.month AS invoice_month, tag.value AS cost_center, ROUND((SUM(CAST(cost AS NUMERIC)) + SUM(IFNULL((SELECT SUM (CAST(c.amount AS NUMERIC)) FROM UNNEST(credits) AS c), 0))), 2) AS net_cost FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`, UNNEST(tags) AS tag WHERE tag.key = "cost_center" AND tag.namespace = "821092389413" GROUP BY invoice.month, tag.value ORDER BY invoice.month, tag.value;
Por exemplo, o resultado da consulta anterior pode ser:
Linha | invoice_month | cost_center | net_cost |
---|---|---|---|
1 | 202208 | android_mobile_apps | 9,93 |
2 | 202208 | ios_mobile_apps | 9,93 |
3 | 202209 | android_mobile_apps | 25,42 |
4 | 202209 | ios_mobile_apps | 25,4 |
5 | 202209 | personalização | 16,08 |
Veja os custos dos recursos não etiquetados
Esta consulta mostra o total da fatura para recursos não etiquetados, agrupados por mês da fatura.
SELECT invoice.month AS invoice_month, ROUND((SUM(CAST(cost AS NUMERIC)) + SUM(IFNULL((SELECT SUM(CAST(c.amount AS NUMERIC)) FROM UNNEST(credits) AS c), 0))), 2) AS net_cost FROM `project-ID.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX` WHERE "color" NOT IN (SELECT key FROM UNNEST(tags)) GROUP BY invoice_month ORDER BY invoice_month;
Por exemplo, o resultado da consulta anterior pode ser:
Linha | invoice_month | net_cost |
---|---|---|
1 | 202202 | 0 |
2 | 202203 | 16,81 |
3 | 202204 | 54,09 |
4 | 202205 | 55,82 |
5 | 202206 | 54,09 |
6 | 202207 | 55,83 |
7 | 202208 | 31,49 |
Consultar com marcadores do sistema
As etiquetas do sistema para Google Cloud reservas oferecem uma visibilidade melhorada da utilização das suas reservas. Permitem-lhe acompanhar que instâncias estão a consumir que reservas e analisar os custos associados à capacidade usada e não usada diretamente no BigQuery.
Estes exemplos usam duas etiquetas do sistema:
compute.googleapis.com/reservation_name
compute.googleapis.com/reservation_project_id
Estas etiquetas estão presentes nos registos de faturação do Google Cloud de ambas as instâncias que consomem uma reserva e a parte não utilizada de uma reserva.
Os exemplos seguintes demonstram como consultar a exportação de faturação do BigQuery para analisar o consumo de reservas através de etiquetas do sistema.
Antes de começar
Para consultar através de etiquetas do sistema, tem de ter a exportação da faturação do Cloud para o BigQuery ativada, especificamente a exportação de dados de custos de utilização detalhados. Esta exportação contém as informações ao nível do recurso, incluindo etiquetas do sistema, necessárias para ver as novas etiquetas de reserva.
Para configurar ou validar o BigQuery Export, consulte a seguinte documentação:
- Vista geral da exportação de dados de faturação para o BigQuery
- Configure a exportação de dados de faturação para o BigQuery
- Compreenda o esquema de exportação de dados detalhados
Certifique-se de que o conjunto de dados do BigQuery está configurado para receber a
exportação detalhada. Normalmente, o nome da tabela está no formato
gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>
.
Veja o consumo de uma determinada instância
Esta consulta permite-lhe verificar se uma determinada instância usou uma reserva durante um período específico e, se for o caso, qual foi a reserva.
SELECT
t.usage_start_time,
sl_reservation.value AS reservation_name,
t.sku.description AS sku_description,
SUM(t.usage.amount) AS total_usage_amount
FROM
project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
UNNEST(t.system_labels) AS sl_reservation
ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
WHERE
t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
t.resource.name LIKE '%tc-billing-case1-instance-1757983787%'
GROUP BY t.usage_start_time, reservation_name, t.sku.description
ORDER BY t.usage_start_time, reservation_name, t.sku.description;
Resultado de exemplo:
usage_start_time | reservation_name | sku_description | total_usage_amount |
---|---|---|---|
2025-09-16 00:00:00.000000 UTC | Núcleo da instância E2 em execução nas Américas | 597 | |
2025-09-16 01:00:00.000000 UTC | Núcleo da instância E2 em execução nas Américas | 3009 | |
2025-09-16 01:00:00.000000 UTC | tc-billing-case1-res0-1757983787 | Núcleo da instância E2 em execução nas Américas | 591 |
2025-09-16 02:00:00.000000 UTC | Núcleo da instância E2 em execução nas Américas | 10 | |
2025-09-16 02:00:00.000000 UTC | tc-billing-case1-res0-1757983787 | Núcleo da instância E2 em execução nas Américas | 3054 |
2025-09-16 02:00:00.000000 UTC | tc-billing-case1-res1-1757983787 | Núcleo da instância E2 em execução nas Américas | 37 |
Nota:
- Filtragem de SKUs: limitar o SKU aos núcleos da CPU oferece uma distribuição de recursos mais clara. Pode ajustar este valor para outros recursos reservados, como RAM, LocalSSD, TPU ou GPU.
- Consumo a pedido: quando reservation_name e reservation_project_id são nulos, a instância está a consumir recursos a pedido.
Quando várias linhas com reservation_name e reservation_project_id diferentes correspondem a uma instância específica num determinado período, indica que a reserva consumida da instância mudou durante esse período. A parte de utilização detalha o consumo.
Analise a distribuição da utilização para uma determinada reserva
Esta consulta ajuda a compreender a distribuição da utilização de uma determinada reserva partilhada, mostrando a capacidade usada ou não usada entre diferentesGoogle Cloud projetos que podem consumir a reserva em questão.
SELECT
t.project.id AS consumer_project_id,
t.sku.description AS sku_description,
CASE
WHEN t.resource.global_name NOT LIKE '%instances/%' THEN 'Unused Capacity'
WHEN t.resource.name IS NOT NULL AND t.resource.name != '' THEN 'Instance Usage'
ELSE 'Other Reservation Cost'
END AS usage_category,
SUM(t.usage.amount) AS total_usage_amount,
t.usage.unit AS usage_unit,
SUM(t.cost) AS total_cost_usd
FROM
project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
UNNEST(t.system_labels) AS sl_reservation
ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
LEFT JOIN
UNNEST(t.system_labels) AS sl_project_id
ON sl_project_id.key = 'compute.googleapis.com/reservation_project_id'
WHERE
t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
sl_reservation.value LIKE '%tc-billing-case2-res-1757983801%'
GROUP BY consumer_project_id, t.sku.description, usage_category,
usage_unit
ORDER BY consumer_project_id, usage_category;
Resultados de exemplo:
consumer_project_id | sku_description | usage_category | total_usage_amount | usage_unit | total_cost_usd |
---|---|---|---|---|---|
disco-sector-292704 | Núcleo da instância E2 em execução nas Américas | Utilização da instância | 14551 | segundos | 0,088158 |
flash-freehold-292704 | Núcleo da instância E2 em execução nas Américas | Utilização da instância | 7347 | segundos | 0,044512 |
united-sandbox-303721 | Núcleo da instância E2 em execução nas Américas | Capacidade não usada | 7936 | segundos | 0,04808 |
Apresenta todas as instâncias que consomem uma reserva
Da mesma forma, podemos escrever uma consulta para compreender todas as instâncias que consumiram uma determinada reserva durante um determinado período.
SELECT
t.usage_start_time,
t.usage_end_time,
t.project.id AS consumer_project_id,
t.resource.name AS instance_name,
t.usage.amount AS usage_amount
FROM
project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
UNNEST(t.system_labels) AS sl_reservation
ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
WHERE
t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
sl_reservation.value LIKE '%tc-billing-case2-res-1757983801%' AND t.resource.global_name NOT LIKE '%allocation/%' AND
t.resource.name IS NOT NULL AND t.resource.name != ''
ORDER BY t.usage_start_time, t.project.id, t.resource.name;
Resultados de exemplo:
usage_start_time | usage_end_time | consumer_project_id | instance_name | usage_amount |
---|---|---|---|---|
2025-09-16 00:00:00.000000 UTC | 2025-09-16 01:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins0-1757983801 | 552 |
2025-09-16 00:00:00.000000 UTC | 2025-09-16 01:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins1-1757983801 | 533 |
2025-09-16 00:00:00.000000 UTC | 2025-09-16 01:00:00.000000 UTC | flash-freehold-292704 | projects/978655420110/instances/tc-billing-case2-ins2-1757983801 | 517 |
2025-09-16 01:00:00.000000 UTC | 2025-09-16 02:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins0-1757983801 | 3600 |
2025-09-16 01:00:00.000000 UTC | 2025-09-16 02:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins1-1757983801 | 3600 |
2025-09-16 01:00:00.000000 UTC | 2025-09-16 02:00:00.000000 UTC | flash-freehold-292704 | projects/978655420110/instances/tc-billing-case2-ins2-1757983801 | 3600 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins0-1757983801 | 3022 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins0-1757983801 | 79 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins1-1757983801 | 79 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | disco-sector-292704 | projects/204187533293/instances/tc-billing-case2-ins1-1757983801 | 3086 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | flash-freehold-292704 | projects/978655420110/instances/tc-billing-case2-ins2-1757983801 | 3151 |
2025-09-16 02:00:00.000000 UTC | 2025-09-16 03:00:00.000000 UTC | flash-freehold-292704 | projects/978655420110/instances/tc-billing-case2-ins2-1757983801 | 79 |
Tópicos relacionados
Tópicos relacionados com os dados de faturação do Google Cloud exportados
- Configure a exportação de dados de faturação do Google Cloud para o BigQuery
- Consultas de exemplo para a exportação de dados de faturação do Google Cloud para o BigQuery
- Visualize os gastos ao longo do tempo com o Looker Studio
Relatórios de custos e preços disponíveis na Google Cloud consola
- Veja os relatórios do Cloud Billing e as tendências de custos
- Veja e transfira os detalhes de custos da sua fatura ou extrato
- Veja e transfira os preços dos serviços na nuvem da Google
- Compreenda as suas poupanças com os relatórios de discriminação de custos
- Analise a eficácia dos seus descontos por utilização garantida
- Veja o histórico de custos e pagamentos