Estrutura da exportação de dados detalhada

Nesta página, você verá informações de referência sobre o esquema de dados detalhados de custo de uso do Cloud Billing que são exportados para cada tabela no BigQuery.

Os dados detalhados de custo de uso fornecem todas as informações incluídas nos dados de custo de uso padrão, além de campos adicionais que fornecem dados de custo granulares e no nível do recurso, como uma máquina virtual ou SSD que gera o uso do serviço. A exportação detalhada inclui informações de custo granulares sobre os seguintes serviços:

  • AlloyDB para PostgreSQL
  • App Engine
  • BigQuery
  • Bigtable
  • Cloud Data Fusion
  • Cloud Deploy
  • Funções do Cloud Run
  • Cloud Logging
  • Cloud Run
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc Metastore
  • Firestore e Datastore
  • Google Kubernetes Engine (GKE)
    Para conferir um detalhamento dos custos dos clusters do GKE em uma exportação de dados detalhada, você também deve ativar a alocação de custos para o GKE.
  • Microsoft AD gerenciado
  • Memorystore for Redis
  • Secret Manager
  • Spanner

Identificar dados de custo granulares por serviço

Para analisar informações de custos granulares em uma exportação detalhada, use a tabela abaixo 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 service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
App Engine service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
BigQuery service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Bigtable service.description e resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.global_name contém um identificador exclusivo do recurso.
Cloud Data Fusion service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Cloud Deploy service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Funções do Cloud Run service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Cloud Logging service.description e resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.global_name contém um identificador exclusivo do recurso.
Cloud Run service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.

: o primeiro dia completo de dados desse serviço é 1º de dezembro de 2022.
Cloud SQL service.description e resource.global_name

A coluna service.description contém o nome do serviço e a coluna resource.global_name contém um identificador exclusivo do recurso.
Cloud Storage service.description e resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.global_name contém um identificador exclusivo do recurso.
Compute Engine service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Dataflow service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Dataproc Metastore service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Firestore e Datastore service.description e resource.name ou resource.global_name

A coluna service.description será o App Engine. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Google Kubernetes Engine (GKE) labels.key

Use as seguintes chaves de rótulos para filtrar os recursos:

  • goog-fleet-project: filtre os recursos do cluster por projeto host da frota, se o cluster estiver registrado em uma frota.
  • goog-k8s-cluster-location: filtre os recursos do GKE por local.
  • goog-k8s-cluster-name: filtre os recursos do GKE por cluster.
  • goog-k8s-node-pool-name: filtre os recursos do cluster por pool de nós.
  • k8s-namespace: filtre os recursos do GKE por namespace.
  • k8s-namespace-labels: filtre os recursos do GKE por rótulo de namespace da frota (somente para clientes do GKE Enterprise).
  • k8s-label: veja todos os recursos do GKE.

Para visualizar os custos granulares de clusters do GKE na exportação detalhada dos dados de custo, também ative a alocação de custos para o GKE.

Veja exemplos de consultas para filtrar dados do GKE nas exportações do BigQuery.
Microsoft AD gerenciado service.description e resource.name ou resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.

.
Memorystore for Redis service.description e resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.global_name contém um identificador exclusivo do recurso.
Secret Manager service.description, resource.name e resource.global_name

A coluna service.description contém o nome do serviço. A coluna resource.name contém o nome fornecido pelo usuário. A coluna resource.global_name contém um identificador exclusivo do recurso.
Spanner service.description e resource.global_name

A coluna service.description contém o nome do serviço e a coluna resource.global_name contém um identificador exclusivo do recurso.

Veja exemplos de consultas de dados granulares para seus recursos.

Esquema detalhado de dados de custo de uso

No conjunto de dados do BigQuery, os dados detalhados de custo do Google Cloud são carregados em uma tabela de dados denominada gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Ao usar os dados detalhados de custo de uso no BigQuery, observe os seguintes detalhes:

  • Ao selecionar ou criar um conjunto de dados do BigQuery para os dados detalhados de custo de uso, é possível selecionar qualquer local de conjunto de dados compatível com o uso com os dados do Cloud Billing.
  • Ao ativar a exportação de dados detalhados de custo de uso pela primeira vez no Cloud Billing, se você selecionar um conjunto de dados configurado para usar um local multirregional, os dados do Cloud Billing (UE ou EUA) ficarão disponíveis retroativamente a partir do início do mês anterior. Os dados são exportados em ordem cronológica. Para a adição retroativa inicial de dados exportados, pode levar até cinco dias para que os dados retroativos do Cloud Billing terminem de exportar antes que você comece a ver os dados de uso mais recentes.
  • Se você ativar a exportação de dados detalhados de custo de uso e selecionar um conjunto de dados configurado para usar um local regional, seus dados do Cloud Billing ficarão disponíveis a partir da data em que você ativou a exportação.
  • Se você ativou, desativou e reativou a exportação de dados de custo de uso detalhados e depois a reativaram, talvez os dados do Cloud Billing não estejam disponíveis para o período em que foram explicitamente desativados.
  • Saiba mais sobre a frequência dos carregamentos de dados nas tabelas do BigQuery.
  • Veja outras limitações que podem afetar a exportação dos seus dados de faturamento para o BigQuery, como conjuntos de dados com chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) ativadas.
  • Considere o volume de dados adicional que as tabelas do BigQuery podem precisar e o custo adicional ao ativar dados detalhados de custo de uso em vez da exportação de dados de custo de uso padrão. O aumento de granularidade das informações no nível de recurso pode aumentar o número de linhas, que são agregadas no formato de custo de uso padrão. Recomendamos que você revise os controles de custo do BigQuery para conhecer outras práticas recomendadas para o gerenciamento dos custos do BigQuery.
Campo Tipo Descrição
billing_account_id String

O ID da Conta de faturamento do Cloud ao qual o uso está associado.

Para revendedores: no caso de custos de uso gerados por uma subconta do Cloud Billing, trata-se do ID da subconta (não o ID da conta do Cloud Billing do revendedor pai).
invoice.month String

O ano e o mês (AAAAMM) da fatura que inclui os itens de linha de custo. Por exemplo: "201901" equivale a janeiro de 2019.

Use este campo para ver as cobranças totais na fatura. Consulte Exportação do Cloud Billing para exemplos de consulta do BigQuery.
cost_type String

O tipo de custo representado por este item de linha: erro regular, imposto, ajuste ou arredondamento.
service.id String O código do serviço que está associado ao uso.
service.description String O serviço do Google Cloud que relatou os dados do Faturamento do Cloud.
sku.id String O ID do recurso usado pelo serviço. Para ver a lista completa de SKUs, consulte SKUs do Google Cloud.
sku.description String Uma descrição do tipo de recurso usado pelo serviço. Por exemplo, um tipo de recurso do Cloud Storage é o armazenamento padrão dos EUA.
usage_start_time Carimbo de data/hora O horário de início da janela de uso por hora em que o custo determinado foi calculado. O uso e os custos de todos os serviços são exibidos com granularidade de hora em hora, o que significa que o uso do serviço de longa duração está distribuído em várias janelas horárias.

Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de carimbo de data/hora. Consulte também Diferenças entre os dados exportados e as faturas abaixo.
usage_end_time Carimbo de data/hora O horário de término da janela de uso por hora em que o custo determinado foi calculado. O uso e os custos de todos os serviços são exibidos com granularidade de hora em hora, o que significa que o uso do serviço de longa duração está distribuído em várias janelas horárias.

Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de carimbo de data/hora. Consulte também Diferenças entre os dados exportados e as faturas abaixo.
project Struct project contém campos que descrevem o projeto do Cloud Billing , como ID, number, name, ancestry_numbers e labels.
project.id String O ID do projeto do Google Cloud que gerou os dados do Cloud Billing.
project.number String Um identificador exclusivo, anônimo e gerado internamente para o projeto do Google Cloud que produziu os dados do Cloud Billing. Nos casos de suporte e em outras comunicações com o cliente, o Google se referirá ao seus projetos com esse número.
project.name String O nome do projeto do Google Cloud que gerou os dados do Cloud Billing.
project.ancestry_numbers String Os ancestrais na hierarquia de recursos do projeto identificado por project.id especificado (por exemplo, my-project-123).

Por exemplo: /ParentOrgNumber/ParentFolderNumber/. Saiba mais sobre a Hierarquia de recursos.
project.ancestors Struct

Esse campo descreve a estrutura e o valor da hierarquia de recursos de um item de linha de custo, incluindo projetos, pastas e organizações. Os ancestrais são ordenados do nó para a raiz (projeto, pasta e organização).

project.ancestors.resource_name String O nome do recurso relativo de cada ancestral no formato "resourceType/resourceNumber". O uso de project.ancestors.resource_name oferecerá uma visualização mais completa de project.ancestry_numbers.
project.ancestors.display_name String O nome que você criou para o recurso no console.
project.labels.key String Se houver rótulos, é a parte chave no par de chave-valor que compreende o rótulo no projeto do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
project.labels.value String Se houver rótulos, é a parte valor no par de chave-valor que compreende o rótulo no projeto do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
labels.key String Se houver rótulos, é a parte chave no par de chave-valor que compreende o rótulo no recurso do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
labels.value String Se houver rótulos, é a parte valor no par de chave-valor que compreende o rótulo no recurso do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
system_labels.key String Se houver rótulos do sistema, é a parte chave no par de chave-valor que compreende o rótulo gerado pelo sistema no recurso onde o uso ocorreu. Consulte também Rótulos do sistema disponíveis.
system_labels.value String Se houver rótulos do sistema, é a parte valor no par de chave-valor que compreende o rótulo gerado pelo sistema no recurso onde o uso ocorreu. Consulte também Rótulos do sistema disponíveis.
location.location String Local do uso no nível de um país, multirregião, região ou zona, ou global para recursos que não têm local específico. Para mais informações, consulte Geografia e regiões e Locais do Google Cloud.
location.country String Quando location.location é um país, região ou zona, este campo é o país de uso, por exemplo, US. Para mais informações, consulte Geografia e regiões e Locais do Google Cloud.
location.region String Quando location.location é uma região ou zona, este campo é a região de uso, por exemplo, us-central1. Para mais informações, consulte Geografia e regiões e Locais do Google Cloud.
location.zone String Quando location.location é uma zona, este campo é a zona de uso, por exemplo, us-central1-a Para mais informações, consulte Geografia e regiões e Locais do Google Cloud.
cost Ponto flutuante O custo do uso antes de qualquer crédito, para uma precisão de até seis casas decimais. Para conseguir o custo total, incluindo os créditos, é preciso incluir credits.amount no custo. Veja esta consulta de exemplo para mais informações.
currency String A moeda em que o custo é cobrado. Para mais informações, consulte Moeda local para faturamento e pagamentos.
currency_conversion_rate Ponto 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 americanos.
usage.amount Ponto flutuante A quantidade de usage.unit usada.
usage.unit String A unidade base em que o uso do recurso é medido. Por exemplo, a unidade base para armazenamento padrão é byte-segundos.
usage.amount_in_pricing_units Ponto flutuante A quantidade de usage.pricing_unit usada.
usage.pricing_unit String A unidade em que o uso de recursos é medido, 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 às SKUs do Google Cloud e da Plataforma Google Maps.
credits.id String Se presente, indica que um crédito está associado à SKU do produto. Os valores de credits.id são um identificador alfanumérico exclusivo (por exemplo, 12-b34-c56-d78) ou uma descrição do tipo de crédito (como 12-b34-c56-d78).

Se o campo credits.id estiver vazio, a SKU do produto não está associada a um crédito.
credits.full_name String O nome do crédito associado à SKU do produto. Esta é uma descrição legível de um credits.id alfanumérico. Por exemplo, Crédito do teste sem custos financeiros ou Desconto por compromisso de uso com base em gastos.

Os valores credits.full_name estão presentes apenas para SKUs com um credits.id alfanumérico. Se o valor de credits.id for uma descrição do tipo de crédito (como Desconto por uso contínuo: CPU), o campo credits.full_name estará vazio.

credits.type String Este campo descreve a finalidade ou a origem do credits.id. Os tipos de crédito incluem:
  • COMMITTED_USAGE_DISCOUNT: Contratos por uso contínuo com base em recursos para o Compute Engine em retorno a preços com muito desconto para uso da VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratos por uso contínuo com base em gastos adquiridos para serviços em troca do seu compromisso em gastar um valor mínimo.
  • DISCOUNT: o tipo de crédito com desconto é usado para créditos recebidos após um limite de gastos contratual ser atingido. Nos relatórios do Cloud Billing disponíveis no Console do Google Cloud, o tipo de crédito com desconto é listado como Descontos com base em gastos (contratuais).
  • FREE_TIER: alguns serviços oferecem uso gratuito de recursos até os limites especificados. Nesses serviços, os créditos são aplicados para implementar o uso de nível gratuito.
  • PROMOTION: o tipo de crédito promocional inclui Teste gratuito do Google Cloud e créditos de campanha de marketing ou outras concessões para usar o Google Cloud. Quando disponíveis, os créditos promocionais são considerados uma forma de pagamento e são aplicados automaticamente para reduzir a fatura total.
  • RESELLER_MARGIN: se você for um revendedor, o tipo de crédito reseller margin indica os descontos do programa para revendedores recebidos em cada item de linha qualificado.
  • SUBSCRIPTION_BENEFIT: créditos ganhos ao adquirir assinaturas de longo prazo para serviços em troca de descontos.
  • SUSTAINED_USAGE_DISCOUNT: o desconto por uso prolongado é um desconto automático que você ganha ao usar recursos específicos do Compute Engine em um período significativo do mês de faturamento.
credits.name String Uma descrição do crédito aplicado à conta de faturamento do Cloud.
credits.amount Ponto flutuante Valor do crédito aplicado ao uso.
adjustment_info Struct adjustment_info contém campos que descrevem a estrutura e o valor de um ajuste nos itens de linha de custo associados a uma conta do Cloud Billing.

Os valores adjustment_info só estarão presentes se o item de linha de custo for gerado para uma modificação do Cloud Billing. Pode ocorrer uma modificação por motivos de correção ou não. O tipo adjustment_info contém detalhes sobre o ajuste, se ele foi emitido para corrigir um erro ou por outros motivos.

adjustment_info.id String Se 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 causados por um problema.
adjustment_info.description String A descrição do ajuste e a causa.
adjustment_info.type String

O tipo de ajuste.

As tarefas incluem:

  • USAGE_CORRECTION: uma correção devido ao uso informado incorretamente.
  • PRICE_CORRECTION: uma correção devido a regras de precificação incorretas.
  • METADATA_CORRECTION: uma correção para corrigir metadados sem alterar o custo.
  • GOODWILL: um crédito emitido para o cliente pela reputação.
  • SALES_BASED_GOODWILL: um crédito emitido para o cliente pela loja, como parte de um contrato.
  • SLA_VIOLATION: um crédito emitido para o cliente devido a uma violação de objetivo de nível de serviço (SLO).
  • BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta para pagamento para outra.
  • ACCOUNT_CLOSURE: um ajuste para levar uma conta encerrada a um saldo zero.
  • GENERAL_ADJUSTMENT: uma modificação geral da conta de faturamento.
adjustment_info.mode String

Como o ajuste foi emitido.

Os modos incluem:

  • PARTIAL_CORRECTION: a correção nega parcialmente o uso e o custo originais.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: a correção rejeita totalmente o uso e o custo originais e emite itens de linha corrigidos com o uso e o custo atualizados.
  • COMPLETE_NEGATION: a correção nega totalmente o uso e o custo originais, e nenhum uso adicional é monetizado novamente.
  • MANUAL_ADJUSTMENT: o ajuste é alocado para custo e uso manualmente.
export_time Carimbo de data/hora Um tempo de processamento associado a um anexo de dados do Faturamento do Cloud. Ele sempre aumentará a cada nova exportação.
Consulte também Diferenças entre os dados exportados e as faturas abaixo.
tags Struct

Campos que descrevem a tag, como chave, valor e namespace.
tags.key String

É o nome curto ou de exibição da chave associada a essa tag específica.
tags.value String

Os recursos anexados a um tags.key. A qualquer momento, exatamente um valor pode ser anexado a um recurso de uma determinada chave.
tags.inherited Booleano

Indica se uma vinculação de tag foi herdada (tags herdadas = True) ou diretas/não herdadas (tags herdadas = False). É possível criar uma vinculação de tag para um recurso pai na hierarquia de recursos.
tags.namespace String

Representa a hierarquia de recursos que define valores e chaves de tags. O namespace pode ser combinado com nomes curtos de chave de tag e valor de tag para criar um nome globalmente exclusivo e totalmente qualificado para a chave de tag ou o valor de tag.
cost_at_list Ponto flutuante

Os preços de tabela associados a todos os itens de linha cobrados da sua conta do Cloud Billing.
transaction_type String

O tipo de transação do vendedor. O tipo de transação pode ser um dos seguintes:

  • GOOGLE = 1: serviços vendidos pelo Google Cloud.
  • THIRD_PARTY_RESELLER = 2: serviços de terceiros revendidos pelo Google Cloud.
  • THIRD_PARTY_AGENCY = 3: serviços de terceiros vendidos por um parceiro, com o Google Cloud atuando como o agente.
seller_name String

A razão social do vendedor.
Campos adicionais disponíveis para a exportação detalhada dos dados de custo de uso
resource Struct

Os campos que descrevem a estrutura e o valor das informações relevantes para recursos de serviço (como uma máquina virtual ou SSD) que geram uso de serviços.
resource.global_name String

Um identificador de serviço globalmente exclusivo para o recurso que gerou o uso relevante.
resource.name String

Um identificador específico do serviço para o recurso que gerou o uso relevante. Ela pode ser uma entrada gerada pelo usuário.
price Struct

Campos que descrevem a estrutura e o valor relacionados aos preços cobrados pelo uso.
price.effective_price Numérico

O preço cobrado pelo uso das SKUs do Google Cloud ou da Plataforma Google Maps e dos níveis de preço da SKU. Se a conta do Cloud Billing tiver preços personalizados de contrato, este será o preço específico da conta de faturamento. Caso contrário, será o preço de tabela do SKU ou do nível do SKU.
price.tier_start_amount Numérico

O número limite de unidades para a camada de preços de uma SKU. Por exemplo, uma SKU com três níveis de preços, como 0 a 100 unidades, 101 a 1.000 unidades e mais de 1.001 unidades, exibirá três linhas de preços para a SKU, com 0, 101 e 1001 no campo price.tier_start_amount que representa a quantidade de unidade inicial para os níveis de preços da SKU.

Saiba mais sobre os níveis de preços.
price.unit String

A unidade de uso em que o preço é especificado e o uso de recursos é medido (como gibibyte, tebibyte, mês, ano, gibibyte hora, mês de gibibyte ou contagem). O valor no campo price.unit corresponde ao valor no campo usage.pricing_unit.
price.pricing_unit_quantity Numérico

A quantidade da unidade do nível do preço da SKU. Por exemplo, se o preço do nível for de US$ 1 por 1000000 bytes, a coluna mostrará 1000000.
subscription Struct

Campos que descrevem seus compromissos baseados em gastos ou em recursos. É possível usar esses campos para analisar as taxas de compromissos específicos.
subscription.instance_id String

O ID da assinatura vinculado a um compromisso.

Entender os dados de custo de uso padrão e detalhados

As seções a seguir descrevem os dados de custo de uso padrão e detalhados exportados para o BigQuery.

Sobre os rótulos

Os dados de custo de um rótulo específico mostram o uso a partir da data em que o rótulo foi aplicado a um recurso. Por exemplo, se você adicionar o rótulo environment:dev a uma VM do Compute Engine em 15 de janeiro de 2024, qualquer análise de environment:dev incluirá apenas o uso dessa VM desde 15 de janeiro.

Também é possível ver os dados dos rótulos em momentos diferentes para serviços diferentes, dependendo de quando cada serviço fornece esses dados.

Rótulos do sistema disponíveis

Os rótulos do sistema são pares de chave-valor para metadados importantes sobre o recurso que gerou o uso. Os seguintes rótulos de sistema são automaticamente incluídos no uso aplicável.

system_labels.key Exemplo de 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áquina para mais informações.
compute.googleapis.com/cores para n1-standard-4 é 4. Para custom-2-2048 é 2 O número de vCPUs disponíveis para a máquina virtual.
compute.googleapis.com/memory para n1-standard-4 é 15360 (isto é, 15 GB * 1024 MB/GB), para custom-2-2048 é 2048 A quantidade de memória (em MB) disponível para a máquina virtual.
compute.googleapis.com/is_unused_reservation true; false Indica o uso que foi reservado por meio de Reservas de zona, mas não usado.
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart O estado do objeto de armazenamento que está sendo cobrado.

Diferenças entre os dados exportados e as faturas

Os produtos do Google Cloud informam dados de uso e custo para processos do Cloud Billing em intervalos variados. Como resultado, pode haver um atraso entre o uso dos serviços do Google Cloud e a disponibilização do uso e dos custos para visualização no Cloud Billing. Normalmente, os custos ficam disponíveis em um dia, mas às vezes podem demorar mais de 24 horas.

No final de um mês, é possível que o uso informado com atraso não esteja incluído na fatura desse mês e, em vez disso, passe para a fatura do mês seguinte.

Quando você consulta seus custos usando campos de carimbo de data/hora, os dados retornados podem identificar o uso informado posteriormente que não foi incluído originalmente na fatura gerada para o mesmo mês de uso. Consequentemente, os dados do Faturamento do Cloud retornados podem não ser mapeados diretamente para essa fatura.

Os campos do carimbo de data/hora incluem:

  • usage_start_time
  • usage_end_time
  • export_time

Para retornar dados do Faturamento do Cloud que mapeia diretamente para uma fatura, consulte invoice.month em vez dos campos de carimbo de data/hora.

Impostos

A partir de 1º de setembro de 2020, os dados de custo diário mostrarão a garantia de impostos de cada um dos seus projetos, em vez de um único item de linha. Se você tiver consultas ou visualizações que dependem de dados fiscais, talvez seja necessário atualizar as consultas para considerar essas alterações.

Por exemplo, para os custos registrados antes de 1º de setembro, os dados de custo de uso são semelhantes aos exemplos a seguir, que mostram uma responsabilidade total de impostos de US$ 10.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normal US$ 60
123456-ABCDEF-123456 test-project Normal US$ 40
123456-ABCDEF-123456 [vazio] Imposto US$ 10

Nos custos registrados após 1º de setembro, os US$ 10 são divididos em US$ 6 para example-project e US$ 4 para test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normal US$ 60
123456-ABCDEF-123456 test-project Normal US$ 40
123456-ABCDEF-123456 example-project Imposto US$ 6
123456-ABCDEF-123456 test-project Imposto US$ 4

Erros e ajustes

No caso raro de os dados do Cloud Billing conterem um erro ou precisarem de um ajuste, eles serão anexados com dados corretivos. Esses ajustes se enquadram em uma destas duas categorias: correções ou modificações de faturamento.

Modificações de faturamento

As modificações de faturamento aparecem como itens de linha separados. Se você recebeu uma modificação de faturamento, um novo item de linha na exportação do Cloud Billing para o BigQuery vai mostrar a alteração. Os ajustes mostrados correspondem aos documentos da fatura, nota de crédito e nota de débito disponíveis na área Documentos da seção Faturamento no console do Google Cloud.

Para mais informações sobre modificações de faturamento e como elas são aplicadas, consulte Noções básicas sobre notas e ajustes.

Correções

As correções aparecem como novos dados que negam dados incorretos nas SKUs de origem. Em alguns casos, novos dados substituem a cobrança incorreta. Todas as colunas na exportação de dados de faturamento corresponderão aos dados originais, exceto as seguintes:

  • cost
  • credit
  • usage.amount
  • export_time

Por exemplo, imagine que você recebeu uma cobrança de R $10 pelo uso do SKU A em 1o de janeiro. Na sua fatura de janeiro (emitida no início de fevereiro), você verá uma cobrança de US $10 para SKU A. No entanto, em 2 de fevereiro, o Google Cloud emitiu uma correção para o SKU A, reduzindo o custo de uso para US $5. Você receberá dois itens de linha adicionais na sua fatura de fevereiro (emitida no início de março):

  • - US$ 10 pelo uso em 1o de janeiro (negando a cobrança original)
  • US$ 5 para uso em 1o de janeiro (informando a cobrança pretendida)

Esses novos itens têm uma coluna adjustment_info na exportação de dados de faturamento. A fatura original de janeiro, que mostra a cobrança a mais, não será ajustada. Para verificar as cobranças na exportação de dados de faturamento, confira seus custos por usage_start_time e agrupe por Day. Nessas visualizações, todas as correções ou cobranças pelo uso com monetização atrasada são acumuladas, e você não precisa se preocupar com dados temporariamente incorretos.

Se você quiser informações mais detalhadas sobre as correções, veja todas as cobranças em um mês de fatura e procure cobranças em que a data de uso ocorreu. antes do mês da fatura. Essas cobranças são resultado de correções ou de uso com monetização tardia.

O exemplo de código a seguir mostra como criar uma consulta básica que retorna o custo total das correções ou do uso monetizado com atraso:

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';

Para conferir um exemplo de consulta que retorna um detalhamento de custos por serviço para cobranças de fatura em que a data de uso ocorreu antes do mês da fatura, consulte Consultar detalhes de custo para conferir correções ou uso monetizado com atraso por serviço em um mês específico da fatura em "Exemplos de consultas de exportação de dados do Cloud Billing".

Sobre créditos promocionais em contratos de preços personalizados

Se você tiver um contrato de preços personalizados, poderá receber créditos promocionais para usar no Google Cloud como parte do contrato. Por exemplo, você pode receber US $1.000 para usar nos recursos do Compute Engine. Os créditos promocionais geralmente são considerados uma forma de pagamento. Quando estiverem disponíveis, os créditos promocionais serão gastos automaticamente a fim de reduzir sua fatura total.

Os termos do seu contrato especificam se os créditos promocionais se aplicam aos custos calculados com o preço de tabela de uma SKU ou o preço líquido (após os descontos).

Se os créditos promocionais se aplicarem a custos calculados no preço de tabela, no relatório da tabela de custos, há um serviço chamado Invoice, com uma SKU chamada Contract billing adjustment. Essa SKU ajusta seus créditos para que sejam aplicadas aos custos no preço de tabela. Para ver o uso a que o ajuste se destina, 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 da SKU a que o crédito e o ajuste se aplicam.

Sobre as tags

Tags são recursos na forma de pares de chave-valor que podem ser anexados a recursos diretamente ou por meio de herança. Use as tags para executar estornos, auditorias e outras análises de alocação de custos. Use as tags e a aplicação condicional de políticas para ter um controle detalhado sobre toda a hierarquia de recursos.

As tags têm um modelo de permissões robusto e podem oferecer suporte a herança, gerenciamento centralizado, padronização de nomenclatura e integração do mecanismo de políticas, enquanto os rótulos são uma ferramenta separada que permite anotar recursos. ,

Os dados de tags aparecem nas exportações do BigQuery para recursos, projetos, pastas e organizações.

Tags disponíveis

As exportações de Custos padrão e Custos detalhados para recursos, projetos, pastas e organizações incluem estes campos para os dados de tags: chaves de tags, valor de tags, tags herdadas e namespace de tags.

As tags no nível do recurso na exportação de dados do Cloud Billing estão disponíveis para os seguintes recursos:

  • Clusters, instâncias e backups do AlloyDB para PostgreSQL
  • Repositórios do Artifact Registry
  • Serviços e jobs do Cloud Run
  • Buckets do Cloud Storage
  • Instâncias do Compute Engine
  • Instâncias do Memorystore para Redis
  • secrets do Secret Manager.
  • Instâncias do Spanner

Limitações das tags

  • As tags podem levar até uma hora para serem propagadas para as exportações do BigQuery. Se uma tag tiver sido adicionada ou removida em uma hora, ou se um recurso existir por menos de uma hora, talvez ela não apareça na exportação.

Exemplos detalhados de consultas de custo de uso

Nesta seção, você verá exemplos sobre como consultar os dados de custo de uso detalhado do Cloud Billing exportados para o BigQuery.

Porque o uso do esquema de custo detalhado inclui todos os campos do esquema de custo de uso padrão, os exemplos de consulta fornecidos ao padrão de dados exportado para o BigQuery também funciona com odetalhada dados exportados. Os exemplos de consulta padrão não são gravados para recuperar qualquer informação no nível do recurso fornecida com a opção de exportação de custo de uso detalhada. Ao criar consultas para dados detalhados, você 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 custo de uso detalhado.

Valores comuns usados no exemplo de consultas de custo detalhadas

Os exemplos de consulta nesta seção usam o seguinte valor para Nome da tabela: project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX

Retornar os custos no nível do recurso em uma fatura

As consultas a seguir demonstram duas maneiras de visualizar valores de custo e crédito no nível do recurso em uma fatura usando dados de faturamento exportados.

  • O campo total soma diretamente o custo de ponto flutuante e os valores de crédito, o que pode acarretar erros de arredondamento de ponto flutuante.
  • O campo total_exact converte custos e valores de crédito em micros antes de somar, depois reconverte para dólares após a soma, o que evita o erro de arredondamento de ponto flutuante.

Soma dos custos de cada recurso, por fatura

Essa consulta mostra o total da fatura de cada resource.name por mês, como uma soma de custos regulares, impostos, ajustes e erros de arredondamento. Todos os custos não associados a um item no nível do recurso são agregados com o nome null do 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 US$ 1005,004832999999984 US$ 1005,00
2 201901 backend1 US$ 781,8499760000028 US$ 781,85
3 201902 null US$ 953,0034923645475983 US$ 953,03
4 201902 backend1 US$ 992,3101739999999717 US$ 992,31
5 201902 bitnami-launchpad-wordpress-1-wordpress US$ 1,2817819999999998 US$ 1,28

Retornar detalhes por tipo de custo para cada recurso, por mês da fatura

Nesta consulta, mostramos os totais de cada cost_type para cada resource.name mês. Os tipos de custos incluem custos regulares, tributos, ajustes e erros de arredondamento. Todos os custos não associados a um item no nível do recurso são agregados de acordo com o nome null do 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 US$ 1000,501209987994782 US$ 1000,50
2 201901 rounding_error null –US$ 0,500489920049387 –US$ 0,50
3 201901 tax null US$ 10,000329958477891 US$ 10,00
4 201901 ajuste null –US$ 5,002572999387045 –US$ 5,00
5 201901 regular backend1 US$ 410,998795012082947 US$ 411,00
2 201901 rounding_error backend1 –US$ 0,2404900489920378 –US$ 0,24
3 201901 tax backend1 US$ 4,105840329977189 US$ 4,11

Ver um detalhamento dos custos de cluster do Google Kubernetes Engine (GKE)

Nesta seção, apresentamos exemplos de filtragem dos custos do cluster do GKE nos relatórios de exportação do BigQuery. Para saber mais sobre os custos do cluster do GKE, acesse Ver o detalhamento dos custos do cluster.

Filtrar custos do GKE

Os exemplos de consultas a seguir mostram como filtrar e agrupar os custos do GKE de acordo com os tipos de recursos compatíveis por nome, namespace e rótulo do cluster.

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 namespace

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 tags

Os exemplos a seguir ilustram formas de consultar seus dados com tags.

Calcular custos por mês da fatura com tags

A consulta a seguir demonstra como usar os custos de devolução por mês da fatura da tag 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

Ver os custos dos recursos sem tags

Essa consulta mostra o total da fatura para recursos sem tag, 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

Relatórios de custos e preços disponíveis no Console do Google Cloud

Anterior
Estrutura da exportação de dados padrão
Próxima
Estrutura da exportação de dados de preços