Este documento fornece informações de referência sobre o esquema de dados detalhados de custo de uso do Cloud Billing 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:
|
|
|
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 |
| 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 rótulos para filtrar os recursos:
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 |
| 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 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 (UE ou EUA), os dados do Cloud Billing vão ficar 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 compatível, seus dados do Cloud Billing vão ficar 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 a exportação de dados foi explicitamente desativada.
- 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. |
invoice.publisher_type |
String | Indica o editor associado à transação. Esse campo permite a divisão de faturas entre transações feitas diretamente com o Google (próprio) e transações feitas com um parceiro (terceiro), o que também indica quais regulamentos podem ser aplicados à transação. Os valores possíveis são:
|
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. |
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. |
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 em que 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 em que 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
Desconto por uso contínuo: CPU).
Se o campo |
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 uso contínuo com base em gastos.
Os valores |
credits.type |
String | Este campo descreve a finalidade ou a origem do credits.id.
Os tipos de crédito incluem:
|
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.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 a um problema.
|
adjustment_info.description |
String | A descrição do ajuste e a causa. |
adjustment_info.type |
String | O tipo de ajuste. Os tipos incluem:
|
adjustment_info.mode |
String | Como o ajuste foi emitido. Os modos incluem:
|
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.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:
|
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.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.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 apenas 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_timeusage_end_timeexport_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 de uso mostram 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 ao exemplo a seguir, que mostra uma responsabilidade total de impostos de US $10.
billing_account_id |
project.id |
cost_type |
cost |
|---|---|---|---|
| 123456-ABCDEF-123456 | projeto-exemplo | Normal | US$ 60 |
| 123456-ABCDEF-123456 | projeto-teste | 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 | projeto-exemplo | Normal | US$ 60 |
| 123456-ABCDEF-123456 | projeto-teste | Normal | US$ 40 |
| 123456-ABCDEF-123456 | projeto-exemplo | Imposto | US$ 6 |
| 123456-ABCDEF-123456 | projeto-teste | 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:
costcreditusage.amountexport_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ê vai encontrar 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ê vai 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 para 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 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 conferir 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.
Como o esquema de custo de uso detalhado inclui todos os campos do esquema de custo de uso padrão, os exemplos de consulta fornecidos para os dados padrão exportados para o BigQuery também funcionam com os dados detalhados 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
totalsoma 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_exactconverte 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 |
Temas relacionados
Tópicos relacionados aos dados exportados do Cloud Billing
- Configurar a exportação de dados do Cloud Billing para o BigQuery
- Exemplo de consultas para a exportação de dados do Faturamento do Cloud para o BigQuery
- Visualizar gastos ao longo do tempo com o Looker Studio
Relatórios de custos e preços disponíveis no Console do Google Cloud
- Visualizar relatórios do Faturamento do Cloud e tendências de custo
- Visualizar e fazer o download dos detalhes de custo da fatura ou do extrato
- Visualizar e fazer o download dos preços dos serviços de nuvem do Google
- Noções básicas sobre o valor economizado com os relatórios de detalhamento de custos
- Analisar a eficácia dos descontos por uso contínuo
- Ver o histórico de custos e pagamentos