Alpha 版：Go 版 Firebase Genkit 目前处于 Alpha 版阶段，这意味着它不受任何服务等级协议 (SLA) 或弃用政策的约束，并且可能会以向后不兼容的方式更改。在 Alpha 版期间，Firebase Genkit 及其文档将会更新和改进。

Google Cloud 遥测和日志记录插件

Google Cloud 插件会将 Firebase Genkit 的遥测数据和日志记录数据导出到 Google Cloud 的运维套件。

前提条件

如果您想在本地运行使用此插件的 flow，则需要安装 Google Cloud CLI 工具。

设置 Google Cloud 账号

此插件需要 Google Cloud 账号（如果您还没有，请注册）和 Google Cloud 项目。

在添加该插件之前，请确保您的项目已启用以下 API：

这些 API 应该会在您的项目的 API 信息中心内列出。

点击此处可详细了解如何启用和停用 API。

配置

如需启用导出到 Google Cloud Tracing、Logging 和 Monitoring 的功能，请导入 googlecloud 软件包并运行 Init()。调用 Init() 后，系统会自动导出您的遥测数据。

import "github.com/firebase/genkit/go/plugins/googlecloud"

if err := googlecloud.Init(
	ctx,
	googlecloud.Config{ProjectID: "your-google-cloud-project"},
); err != nil {
	return err
}

您必须指定要将遥测数据导出到的 Google Cloud 项目。还有一些可选参数：

ForceExport：即使在开发环境中运行（例如使用 genkit start 或 genkit flow:run 时），也要导出遥测数据。这是一种测试集成并在 Google Cloud 中发送首批事件以进行监控的快速方法。

如果您使用此选项，则还需要在本地提供您的 Cloud 凭据：
```
gcloud auth application-default login
```
MetricInterval：导出遥测信息的时间间隔（以纳秒为单位）。默认情况下，该值为 60 秒 (60e9 纳秒)。
LogLevel：要导出的日志条目的最低严重级别。默认情况下为 slog.LevelInfo。

该插件需要您的 Google Cloud 项目凭据。如果您要从 Google Cloud 环境（Cloud Run 等）运行 flow，系统会自动设置凭据。如需在其他环境中运行，您需要设置应用默认凭据。

通过 Google Cloud 的运维套件监控生产环境

部署 flow 后，请前往 Google Cloud 的运维套件，然后选择您的项目。

日志和跟踪记录

在侧边菜单中，找到“Logging“，然后点击“Logs Explorer”。

您会看到与已部署的 flow 关联的所有日志，包括 console.log()。任何带有前缀 [genkit] 的日志都是 Genkit 内部日志，其中包含一些可能对调试有用的信息。例如，格式为 Config[...] 的 Genkit 日志包含用于特定 LLM 推理的温度和 topK 值等元数据。格式为 Output[...] 的日志包含 LLM 回答，而 Input[...] 日志包含提示。Cloud Logging 具有强大的 ACL，可对敏感日志进行精细控制。

注意：：在 Cloud Trace 中，提示和 LLM 回答会从跟踪记录属性中隐去。

对于特定日志行，您可以点击展开的菜单图标并选择“View in trace details”，以找到其各自的跟踪记录。

系统会打开一个跟踪记录预览窗格，您可在其中快速浏览跟踪记录的详细信息。如需查看完整详情，请点击窗格右上角的“在 Trace 中查看”链接。

Cloud Trace 中最突出的导航元素是跟踪记录散点图。该散点图包含在给定时间范围内收集的所有跟踪记录。

点击每个数据点会在散点图下方显示详细信息。

详细视图包含 flow 形状（包括所有步骤）和重要时间信息。Cloud Trace 能够在此视图中交织与给定跟踪记录关联的所有日志。在“日志和事件”下拉菜单中，选择“显示展开的内容”选项。

在生成的视图中，您可以详细检查跟踪记录的上下文中的日志，包括提示和 LLM 回答。

指标

如需查看 Genkit 导出的所有指标，请从侧边菜单中选择“Logging”，然后点击“指标管理”。

指标管理控制台包含一个表格视图，其中包含所有收集的指标，包括与 Cloud Run 及其周围环境相关的指标。点击“工作负载”选项会显示一个包含 Genkit 收集的指标的列表。任何带有前缀 genkit 的指标都是内部 Genkit 指标。

Genkit 会收集多种类别的指标，包括 flow 级指标、操作级指标和生成级指标。每个指标都有几个实用的维度，以便实现强大的过滤和分组功能。

常见的维度包括：

flow_name - flow 的顶级名称。
flow_path - span 及其父级 span 链，直到根 span。
error_code - 如果出现错误，则为相应的错误代码。
error_message - 如果出现错误，则为相应的错误消息。
model - 模型的名称。
temperature - 推理温度值。
topK - 推理 topK 值。
topP - 推理 topP 值。

Flow 级指标

名称	维度
genkit/flow/requests	flow_name、error_code、error_message
genkit/flow/latency	flow_name

操作级指标

名称	维度
genkit/action/requests	flow_name、error_code、error_message
genkit/action/latency	flow_name

生成级指标

名称	维度
genkit/ai/generate	flow_path、model、temperature、topK、topP、error_code、error_message
genkit/ai/generate/input_tokens	flow_path、model、temperature、topK、topP
genkit/ai/generate/output_tokens	flow_path、model、temperature、topK、topP
genkit/ai/generate/input_characters	flow_path、model、temperature、topK、topP
genkit/ai/generate/output_characters	flow_path、model、temperature、topK、topP
genkit/ai/generate/input_images	flow_path、model、temperature、topK、topP
genkit/ai/generate/output_images	flow_path、model、temperature、topK、topP
genkit/ai/generate/latency	flow_path、model、temperature、topK、topP、error_code、error_message