evlog.
入门

安装 evlog

框架
在 TypeScript 项目中安装 evlog。支持 Nuxt、Next.js、SvelteKit、Hono、Express、Fastify、Elysia、NestJS 以及独立脚本。

evlog 支持 Nuxt、Next.js、SvelteKit、Nitro、NestJS 以及任何 TypeScript 服务端框架。

在我的项目中安装 evlog

安装

pnpm add evlog

使用 Agent 技能

如果你使用了 AI 助手（如 Claude Code、Cursor 等），安装 evlog 技能以获得引导式设置和代码审查：

Terminal
npx skills add https://www.evlog.dev

Your AI assistant can then help you set up evlog, review your logging patterns, and migrate existing code to wide events. See Agent Skills for details.

选择你的框架

安装包后，按照对应框架的设置指南进行操作：

Nuxt

带有自动导入的 useLogger、createError 和 parseError 的模块。

Next.js

createEvlog() 工厂函数与 withEvlog() 处理程序包装器。

SvelteKit

handle 与 handleError 钩子，使用 event.locals.log。

Nitro

适用于 Nitro v2 和 v3 的插件式钩子模块。

TanStack Start

使用 Nitro v3 模块与异步上下文。

React Router

使用 context.get(loggerContext) 的中间件。

NestJS

使用全局中间件的 EvlogModule.forRoot()。

Express

使用 req.log 的中间件。

Hono

使用 c.get('log') 的中间件。

Fastify

使用 request.log 的插件。

Elysia

使用 log 作为路由上下文的插件。

oRPC

withEvlog() handler wrapper + evlog() procedure middleware.

Cloudflare Workers

用于请求作用域日志记录器的工厂函数。
查看完整的 框架集成 页面，以获取对比表和所有可用集成，包括 Standalone TypeScript、Astro 以及 Custom Integration。

TypeScript 配置

evlog 附带完整的 TypeScript 类型定义，无需额外配置。

evlog 需要 TypeScript 5.0 或更高版本以获得最佳的类型推断。

下一步

为什么从 evlog 开始

添加结构化日志的最便宜时机是在第一条请求到来之前。Day 0 就选择 evlog，你的应用就能继承结构化表面、类型化目录、审计轨迹、AI SDK 遥测，以及一个你以后无需自己搭建的 drain 管道。

快速开始

几分钟内上手 evlog。学习日志 API、为广泛事件创建 createLogger、处理请求的 useLogger，以及结构化错误。