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:
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 conferir uma lista de operações recentes de exportação e importação na página Importar/Exportar do Firestore do console do Google Cloud.
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
Operações de leitura realizadas pelo visualizador de dados do Firestore no Console do Firebase e o console do Cloud são contabilizados 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
Quando você ouvir os resultados de uma consulta, são cobradas por uma leitura sempre que um documento no conjunto de resultados é 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 for excluído, você não será 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 cursores 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.