Como interpretar o relatório de faturamento

Esta página inclui dicas e recursos para ajudar você a entender o relatório de faturamento do Firestore. Esta página abrange as seguintes fontes comuns de dúvidas sobre faturamento:

  • Fora do uso do app, as fontes de custos incluem operações de importação, operações de exportação e uso do console.
  • No seu app, atualizações em tempo real, gravações de ambiente autônomo e deslocamentos de consulta podem fazer com que seu uso aumente mais rápido do que o esperado.
  • Ao usar o painel de uso no console, observe as discrepâncias entre o painel e o relatório de faturamento.

Uso de importação e exportação

Ao detalhar o relatório de faturamento, revise os custos relacionados às operações de importação e exportação. Essas operações realizam operações de leitura e gravação que são contabilizadas no faturamento do Firestore. Dependendo da frequência com que você importa e exporta dados, essas operações podem ser uma fonte significativa de operações faturadas.

Observe que o painel de uso no console não reflete leituras e gravações de operações de importação e exportação. É possível visualizar as operações de importação/exportação e os custos relacionados das seguintes maneiras:

Rótulos de faturamento

As operações de exportação e importação aplicam o rótulo goog-firestoremanaged:exportimport às operações de leitura e gravação. Na página de relatórios do Cloud Billing, é possível usar esse rótulo para visualizar os custos relacionados às operações de importação e exportação:

Acesse o rótulo goog-firestoremanaged no menu de filtros.

Listar operações recentes

É possível ver as operações recentes de importação e exportação usando o console ou o gcloud.

Console do Google Cloud

É possível visualizar uma lista de operações recentes de exportação e importação na página Importação/exportação do Firestore no console do Google Cloud.

Acessar a página "Importar/Exportar"

gcloud

Use o comando operations list para ver todas as operações de exportação e importação em execução e as que foram concluídas recentemente:

gcloud firestore operations list

Registros de auditoria das operações do administrador

O Firestore grava registros de auditoria para operações de exportação, operações de importação e operações de indexação. Para mais informações, consulte Informações sobre a geração de registros de auditoria do Firestore.

Uso do console

As operações de leitura realizadas pelo visualizador de dados do Firestore no Console do Firebase e no Console do Cloud são contabilizadas no uso faturado do Firestore. Ao abrir ou atualizar a página do Firestore, o console carrega documentos para preencher a página. Enquanto a página do Firestore permanece aberta, o console usa consultas em tempo real para atualizar documentos e coleções visíveis.

Ao detalhar o uso, considere o uso do console como outra fonte de operações do Firestore. No seu relatório de faturamento, não há como diferenciar o tráfego de console do tráfego de aplicativos.

Operações faturadas

Além das informações de preços, analise seu app para as seguintes operações, que podem levar ao aumento do faturamento mais rápido do que o esperado:

  • Atualizações em tempo real

    Ao detectar os resultados de uma consulta, você será cobrado por uma leitura sempre que um documento no conjunto de resultados for adicionado ou atualizado. Você também é cobrado por uma leitura quando um documento é removido do conjunto de resultados por ter sido alterado. Por outro lado, quando um documento é excluído, você não é cobrado por uma leitura.

    Revise o escopo dos listeners em tempo real. Detectar os resultados de uma consulta muito ampla ou detectar uma coleção inteira pode resultar em mais operações de leitura do que o necessário.

  • Gravações e exclusões de ambiente autônomo

    Um ambiente autônomo é uma operação que não resulta em alterações nos documentos. Você ainda será cobrado por gravações e exclusões de ambiente autônomo.

    Para uma operação de exclusão, você será cobrado mesmo que o documento fornecido não exista.

    Para uma operação de gravação, você ainda será cobrado se as operações não resultarem em alterações. Por exemplo, uma operação que atualiza um campo de documento para o mesmo valor de campo incorre em cobranças.

  • Deslocamentos de consulta

    As compensações de consulta ignoram um número especificado de resultados, mas eles ainda são contabilizados no faturamento. Devido a esse custo extra, use cursors em vez de deslocamentos.

Discrepâncias no painel de uso

Os painéis de uso do Cloud Firestore nos consoles do Firebase e do Cloud fornecem uma estimativa de uso. Eles podem ajudar você a identificar picos de uso. No entanto, o painel não oferece uma visualização exata das operações faturadas. Geralmente, o uso faturado é maior que o valor exibido no painel. Em todos os casos de discrepância, o relatório de faturamento tem prioridade sobre o painel de uso.

Estas são algumas das operações que causam discrepâncias entre o painel e o uso faturado:

  • Operações de importação e exportação. As leituras e gravações realizadas por essas operações não aparecem no painel de uso.
  • Gravações somente para verificação em um ambiente autônomo. As gravações que apenas verificam a existência ou não de um documento são contabilizadas como operações de leitura faturadas, mas são mostradas como "UPDATE_NOOP" e "DELETE_NOOP", respectivamente, no painel de uso de gravação.
  • Gravações em um ambiente autônomo. Operações que não resultam em uma mudança no banco de dados, como uma atualização que não altera valores de campo ou uma gravação em um documento excluído, podem ser exibidas no painel de uso como "UPDATE_NOOP" ou "DELETE_NOOP". Mesmo que apareçam como "NOOP", elas ainda são contabilizadas como operações faturadas.
  • Gravações recolhidas. Nos casos em que há várias gravações no mesmo documento em uma sequência rápida, o painel de uso pode agrupar diversas gravações e contabilizá-las como apenas uma. No uso de faturamento, cada gravação continua sendo contada separadamente.

    O painel de uso também recolhe gravações em transformações de campo, como carimbos de data/hora do servidor, incrementos numéricos e operações de união de matrizes. Para as transformações de campo, o painel pode contar várias operações como apenas uma.

  • Consultas que não retornam resultados. O custo de consultas sem resultados é o de uma operação de leitura. Esse uso é faturado, mas não aparece no painel.
  • Operações de leitura de entradas de índice lidas. Esse uso é faturado, mas não aparece no painel de uso. Por exemplo, as consultas de agregação cobram pelas entradas de índice lidas, mas esse uso não aparece no painel de uso.

A seguir

Para receber mais ajuda com o relatório de faturamento, entre em contato com o suporte do Cloud Billing.