能否检查Firestore读取来源？如何量化客户端与云函数读取量以降本？

以下是几种实用方法，帮你区分客户端与Google Cloud Functions发起的Firestore读取请求数量：

1. 利用Cloud Logging筛选统计 #

Firestore所有操作都会记录到Cloud Logging中，可通过日志属性区分请求来源：

• 打开Cloud Logging控制台，用查询语句过滤读取操作：

  resource.type="firestore_database" AND (protoPayload.methodName:"google.firestore.v1.Firestore.ReadDocument" OR protoPayload.methodName:"google.firestore.v1.Firestore.RunQuery")
  

• 区分来源：
  • Cloud Functions请求：protoPayload.authentication.principalEmail字段显示云函数服务账号（格式如[项目ID]@appspot.gserviceaccount.com）
  • 客户端请求：该字段显示用户邮箱（已登录）或空值/匿名标识（未登录）
• 可创建自定义日志指标，将两类请求分别统计，在Cloud Monitoring中查看长期趋势

2. 代码添加自定义请求标记 #

在SDK中嵌入自定义标识，让日志更易区分：

• 客户端（Web/移动SDK）：初始化Firestore时添加自定义请求头（以Web SDK为例）：

  import { initializeApp } from "firebase/app";
  import { getFirestore } from "firebase/firestore";
  
  const app = initializeApp(firebaseConfig);
  const db = getFirestore(app);
  db.settings({
    customHeaders: { "X-Request-Source": "client-app" }
  });
  

• Cloud Functions：初始化Admin SDK时添加标识：

  const admin = require("firebase-admin");
  admin.initializeApp();
  const db = admin.firestore();
  db.settings({
    customHeaders: { "X-Request-Source": "cloud-functions" }
  });
  

• 后续在Cloud Logging中，可通过protoPayload.requestMetadata.requestHeaders.X-Request-Source精准过滤两类请求

3. 自定义监控指标追踪 #

通过上报自定义指标直接统计数量：

• 客户端：封装Firestore读取方法，每次调用时用Firebase Analytics上报事件：

  import { getAnalytics, logEvent } from "firebase/analytics";
  
  async function getDocument(docRef) {
    const data = await docRef.get();
    logEvent(getAnalytics(), "firestore_client_read", { collection: docRef.parent.id });
    return data;
  }
  

• Cloud Functions：每次读取时上报自定义指标到Cloud Monitoring：

  const { MetricServiceClient } = require("@google-cloud/monitoring");
  const metricClient = new MetricServiceClient();
  
  async function trackFunctionRead() {
    const request = {
      name: metricClient.projectPath("[你的项目ID]"),
      timeSeries: [{
        metric: { type: "custom.googleapis.com/firestore/function_read" },
        points: [{ value: { int64Value: "1" } }]
      }]
    };
    await metricClient.createTimeSeries(request);
  }
  

• 可在Cloud Monitoring或Firebase Analytics控制台直接查看统计数据

优化建议 #

量化后针对性降本：

• Cloud Functions端：用内存缓存或Firestore缓存避免重复读取相同数据
• 客户端：优化查询条件，用where限制返回数据，启用本地缓存减少网络请求

内容的提问来源于stack exchange，提问作者faccio