什么是蓝图？
每个蓝图包括：- 事件结构建议：最佳事件命名和元数据设计
- 计量配置：建议的聚合类型和过滤器
- 示例代码：多种语言的工作实现示例
- 最佳实践：关于准确性、性能和成本优化的提示
为什么使用蓝图？
Faster Setup
让使用情况跟踪在几分钟内生效，而不是几小时。复制经验证的模式，而不是从零开始设计。
Best Practices Built In
通过经过测试的事件结构、适当的元数据和最佳聚合选择来避免常见错误。
Production Ready
示例代码基于真实世界的实现。只需添加您的 API 密钥即可使用。
可用蓝图
选择与您的用例匹配的蓝图：LLM Blueprint
跟踪 OpenAI、Anthropic、Groq、Gemini、Vercel AI SDK 等的 AI 令牌使用情况。适合：AI 聊天机器人、代码生成器、内容创作工具、AI 驱动的应用程序。您将跟踪的内容：输入令牌、输出令牌、模型使用情况、请求次数。
API Gateway Blueprint
在网关级别对 API 请求进行计量，并支持端点过滤和速率限制。适合：REST API、GraphQL 服务、Webhook 提供商、API 优先平台。您将跟踪的内容：请求次数、端点使用情况、HTTP 方法、响应时间。
Object Storage Blueprint
跟踪云存储服务的文件上传、存储消耗和带宽情况。适合：文件托管、媒体平台、备份服务、文档管理。您将跟踪的内容：存储的字节数、文件上传、下载、存储快照。
Stream Blueprint
衡量视频、音频和实时数据交付的流媒体带宽。适合：视频流、音频平台、直播、实时数据馈送。您将跟踪的内容：使用的带宽、流持续时间、质量级别、并发流数量。
Time Range Blueprint
按计算资源、无服务器函数和长时间运行作业的经过时间计费。适合：无服务器平台、容器托管、计算实例、批处理。您将跟踪的内容：执行时间、计算小时数、函数调用次数、作业持续时间。
如何使用蓝图
蓝图比较
不确定哪个蓝图适合您的需求？以下是快速比较：| 用例 | 蓝图 | 聚合 | 常见元数据 |
|---|---|---|---|
| AI 聊天应用 | LLM | 总和（令牌） | model, input_tokens, output_tokens |
| REST API | API 网关 | 计数 | endpoint, method, status_code |
| 文件存储 | 对象存储 | 总和（字节） | file_size, file_type, operation |
| 视频平台 | 流 | 总和（带宽） | duration, quality, bitrate |
| 无服务器 | 时间范围 | 总和（持续时间） | function_name, execution_time_ms |
自定义实现
没有看到适合您确切用例的蓝图？没问题：- 从最接近的蓝图开始：选择与您的需求最相似的蓝图
- 调整事件结构：修改元数据字段以匹配您的要求
- 调整计量配置：根据需要更改聚合类型或过滤器
- 彻底测试：使用示例使用情况验证计费计算
所有蓝图都是起点。欢迎随意混合不同蓝图的概念或创建完全自定义的实现。