Next.js

ClickStack 可以从你在 Next 13.2+ 的 Next.js 无服务器函数 中提取原生 OpenTelemetry 跟踪。

本指南整合了：

• 控制台日志
• 跟踪

备注

如果你在寻找会话重放/浏览器端监控，你需要安装 浏览器集成 。

安装

启用仪器钩子（v15 及以下版本必需）

要开始，你需要通过在你的 next.config.js 中设置 experimental.instrumentationHook = true; 来启用 Next.js 仪器钩子。

示例：

安装 ClickHouse OpenTelemetry SDK

NPM

Yarn

创建仪器文件

在你的 Next.js 项目根目录中创建一个名为 instrumentation.ts（或 .js）的文件，内容如下：

这将允许 Next.js 导入任何无服务器函数调用的 OpenTelemetry 仪器。

配置环境变量

如果你直接将跟踪发送到 ClickStack，你需要使用以下环境变量启动你的 Next.js 服务器，以将 spans 指向 OTel 收集器：

如果你在 Vercel 上部署，确保所有上述环境变量已为你的部署配置。