mcpField
U
usage-logging

usage-logging

github.com/athola开发34399 次安装1 天前更新
代码仓库

关于 usage-logging

usage-logging 是用于记录操作用量与成本的会话感知型 Skill，并以结构化 JSONL 保存日志。它适合需要审计记录、跨会话成本跟踪、用量分析或调试历史的团队。

主要功能

  1. 01自动创建会话并设置超时
  2. 02结构化 JSONL 操作日志
  3. 03查询近期操作
  4. 04汇总用量与预估成本

适用场景

  1. 01审计服务操作
  2. 02跨会话跟踪 Token 用量和成本
  3. 03分析近期用量
  4. 04根据操作历史调试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill usage-logging

安装后在 Claude Code 中输入/usage-logging确认已加载。

附带文件modules/log-formats.mdmodules/session-patterns.md

详细介绍

使用情况日志

概述

记录单次调用的成本和使用事件。如需执行汇总预算，请使用 quota-management。

用于跟踪跨插件操作的会话感知型日志基础设施。 提供结构化 JSONL 日志记录，并自动管理会话，以便进行审计追踪和分析。

适用场景

  • 需要操作审计追踪
  • 跟踪跨会话的成本
  • 构建使用情况分析
  • 根据操作历史进行调试

不适用场景

  • 无需日志记录的简单操作

核心概念

会话管理

会话用于归类相关操作：

  • 首次操作时自动创建
  • 闲置 1 小时后超时
  • 使用唯一会话 ID 进行跟踪
日志条目结构
{
  "timestamp": "2025-12-05T10:30:00Z",
  "session_id": "session_1733394600",
  "service": "my-service",
  "operation": "analyze_files",
  "tokens": 5000,
  "success": true,
  "duration_seconds": 2.5,
  "metadata": {}
}

验证： 使用 --help 标志运行命令，以确认其可用性。

快速入门

初始化日志记录器
from leyline.usage_logger import UsageLogger

logger = UsageLogger(service="my-service")

验证： 使用 --help 标志运行命令，以确认其可用性。

记录操作
logger.log_usage(
    operation="analyze_files",
    tokens=5000,
    success=True,
    duration=2.5,
    metadata={"files": 10},
)

验证： 使用 --help 标志运行命令，以确认其可用性。

查询使用情况
# Recent operations
recent = logger.get_recent_operations(hours=24)

# Usage summary
summary = logger.get_usage_summary(days=7)
print(f"Total tokens: {summary['total_tokens']}")
print(f"Total cost: ${summary['estimated_cost']:.2f}")

# Recent errors
errors = logger.get_recent_errors(count=10)

验证： 使用 --help 标志运行命令，以确认其可用性。

集成模式

# In your skill's frontmatter
dependencies: [leyline:usage-logging]

验证： 使用 --help 标志运行命令，以确认其可用性。

标准集成流程：

  1. 为服务初始化日志记录器
  2. 操作完成后记录操作
  3. 查询数据以进行分析和调试

日志存储

默认位置：~/.claude/leyline/usage/{service}.jsonl

# View recent logs
tail -20 ~/.claude/leyline/usage/my-service.jsonl | jq .

# Query by date
grep "2025-12-05" ~/.claude/leyline/usage/my-service.jsonl

验证： 使用 --help 标志运行命令，以确认其可用性。

详细资源

  • 会话模式：会话管理请参阅 modules/session-patterns.md
  • 日志格式：结构化格式请参阅 modules/log-formats.md

完成条件

  • 已记录包含所有必需字段的操作
  • 已跟踪会话以便归类
  • 可查询日志以进行分析

评论

支持 Markdown