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:
- Compute Engine
- Cloud Storage
Google Kubernetes Engine (GKE)
Para ver detalhes dos custos do cluster do GKE em uma exportação de dados detalhada, é necessário também ativar a alocação de custos para o GKE.
Cloud Functions
Cloud Run
Cloud SQL
Spanner
App Engine
Firestore e Datastore
Memorystore for Redis
Bigtable
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 |
|---|---|---|
| Compute Engine | service.description e resource.name ou
resource.global_name |
A coluna |
| Cloud Storage | service.description e 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. |
| Cloud Functions | service.description e resource.name ou
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 |
| Spanner | service.description e resource.global_name |
A coluna |
| App Engine | 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 |
| BigQuery | service.description e resource.name ou
resource.global_name
|
A coluna |
| Dataflow | service.description e resource.name ou
resource.global_name
|
A coluna |
| Memorystore for Redis | service.description e resource.global_name |
A coluna |
| Bigtable | 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, 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
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 compromisso de uso 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 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:
|
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 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. |
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 sejam mapeados 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 | projeto-exemplo | Normal | US$ 60 |
| 123456-ABCDEF-123456 | projeto-teste | Normal | US$ 40 |
| 123456-ABCDEF-123456 | [vazio] | Tributo | 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 | Tributo | US$ 6 |
| 123456-ABCDEF-123456 | projeto-teste | Tributo | US$ 4 |
Erros e ajustes
No caso improvável de que os dados do Faturamento do Cloud contenham um erro ou exijam um ajuste, eles serão anexados com dados que anulam o erro. Todas as colunas permanecerão as mesmas, exceto estas:
costcreditusage.amountexport_time
Se você precisar determinar quais dados são novos, faça isso consultando export_time.
Nos dados exportados, o mês da fatura dos ajustes e os tributos associados ao Faturamento do Cloud reflete o mês em que o ajuste foi emitido. No entanto, o ajuste pode ser aplicado a uma fatura em um mês diferente do mês de emissão. Para saber se e onde um ajuste é aplicado, você precisará analisar os documentos da fatura ou da nota de crédito/débito disponíveis na página de documentos do Console do Google Cloud. Para mais detalhes sobre como analisar ajustes e como eles são aplicados, consulte Compreender notas e ajustes.
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
<atrack-type="tasks"track-name="internallink"track-metadata-position="body" l10n-attrs-original-order="href,track-type,track-name,track-metadata-position" l10n-encrypted-href="iUWjxJRweELRfbeZQy/YQwc9zZofjBXGTjbrIegRjdnVz6nUhi3jRGB4DwvsPvv3">As tags são recursos na forma de pares de chave-valor que podem ser anexados diretamente a recursos ou por herança. Use as tags para executar estornos, auditorias e outras análises de alocação de custos. Também é possível usar tags e a aplicação condicional de políticas para um controle refinado em toda a hierarquia de recursos.</atrack-type="tasks"track-name="internallink"track-metadata-position="body">
As tags têm um modelo de permissões robusto e podem ser compatíveis com herança, gerenciamento centralizado, padronização de nomenclatura e integração com mecanismo de política, enquanto <atrack-type="tasks"track-name="internallink"track-metadata-position="body" l10n-attrs-original-order="href,track-type,track-name,track-metadata-position" l10n-encrypted-href="VL5eQBNGQ+VFZ8Ic4FEC0gc9zZofjBXGTjbrIegRjdloWDKjJtF205jHQgIOO0QT5mGjae8t5DMH2GXg6ydeww==">rótulos são ferramentas separadas que permitem anotar recursos.</atrack-type="tasks"track-name="internallink"track-metadata-position="body">
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:
- Instâncias do Compute Engine
- Buckets do Cloud Storage
- Instâncias do Spanner
- Serviços do Cloud Run
- Repositórios do Artifact Registry
- Instâncias do Memorystore para Redis
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 aos seus 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
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 | adjustment | 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.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.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.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 `ivory-vim-309221.billing_export_dataset.gcp_billing_export_resource_v1_018ADD_3CEBBB_A4DF22`, 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 | personalization | 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.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