---
title: "用例"
description: "每个配方解决一个问题：浏览器日志、AI SDK 调用、用户身份、防篡改审计轨迹、工具遥测、派生上下文。"
canonical_url: "https://evlog.zhcndoc.com/use-cases/overview"
---
# 用例

> 每个配方解决一个问题：浏览器日志、AI SDK 调用、用户身份、防篡改审计轨迹、工具遥测、派生上下文。

用例是**配方**，而不是功能。每个用例都使用你已经了解的相同 evlog 基础构件解决一个具体问题：宽事件、结构化错误、drain、enricher。它们作为独立章节存在，是因为每个用例都有足够的内容规模（每个包含多个页面和专门的示例），值得直接导航，但它们不是独立的运行时：使用相同的 logger、相同的 drain pipeline、相同的类型。

<table>
<thead>
  <tr>
    <th>
      你想要……
    </th>
    
    <th>
      查看
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      跟踪一个 Node.js 请求，从响应 ID 到 JSON 事件，包括一次失败的支付
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/structured-logging-nodejs">
        Node.js 请求日志
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      通过批处理、重试和 <code>
        sendBeacon
      </code>
      
       回退将浏览器日志发送到你的服务器
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/client-logging">
        客户端日志
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      捕获每次 AI SDK 调用，包括令牌使用量、工具调用、流式传输指标和成本
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/ai-sdk/overview">
        AI SDK
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      在每个宽事件中识别经过身份验证的用户（以及其组织／角色）
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/better-auth/overview">
        Better Auth
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      使用哈希链、拒绝记录和支持脱敏的差异构建防篡改审计轨迹
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/audit/overview">
        审计日志
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      使用每次运行一个宽事件、同意和披露来为 CLI 和自动化添加检测
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/telemetry/overview">
        Telemetry
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      让决策模型针对每个事件回答一个问题，并保留那些静默失败的 200 响应
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/signals/overview">
        Signals
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      从 <a href="https://eve.dev" rel="nofollow">
        eve
      </a>
      
       agent 回合中导出宽事件（令牌、工具、drain）
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/eve">
        eve
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      为每个事件添加派生上下文（User-Agent、地理位置、请求大小、trace 上下文）
    </td>
    
    <td>
      <a href="https://evlog.zhcndoc.com/use-cases/enrichers">
        Enrichers
      </a>
    </td>
  </tr>
</tbody>
</table>

## 它们之间的关系

```text
your app code
     │
     ▼
┌──────────────────────────────────────────────────────────────────┐
│   evlog logger                                                   │
│                                                                  │
│   ┌─────────────────┐   ┌─────────────────┐   ┌──────────────┐   │
│   │ Client logs     │   │ AI SDK wrapper  │   │ Audit logger │   │
│   │ (browser → API) │   │ (token / tools) │   │ (hash chain) │   │
│   └─────────────────┘   └─────────────────┘   └──────────────┘   │
│            │                     │                    │          │
│            └─────────────────────┼────────────────────┘          │
│                                  ▼                               │
│                       enrich  →  drain                           │
│                       (User-Agent, geo, trace, …)                │
└──────────────────────────────────────────────────────────────────┘
```

每个用例都是选择启用的。根据应用的需要采用相应的用例。它们共存于相同的 logger、相同的 drain pipeline 和相同的 enrich 链中。

## 接下来去哪里

- 想从零开始构建一个新用例？先从 [宽事件](https://evlog.zhcndoc.com/learn/wide-events) 开始了解概念模型。
- 需要把生成的事件发送到某个地方？选择一个 [适配器](https://evlog.zhcndoc.com/integrate/adapters/overview)。
- 想编写你自己的可复用 enricher / 插件用例？参见 [自定义 Enrichers](https://evlog.zhcndoc.com/extend/custom-enrichers) 或 [插件](https://evlog.zhcndoc.com/extend/plugins)。

---

- [客户端日志](https://evlog.zhcndoc.com/use-cases/client-logging)
- [AI SDK](https://evlog.zhcndoc.com/use-cases/ai-sdk/overview)
- [审计日志](https://evlog.zhcndoc.com/use-cases/audit/overview)
- [Telemetry](https://evlog.zhcndoc.com/use-cases/telemetry/overview)
- [Signals](https://evlog.zhcndoc.com/use-cases/signals/overview)


## Sitemap

See the full [sitemap](https://evlog.zhcndoc.com/sitemap.md) for all pages.