mcpField
S
stream-inspector

stream-inspector

github.com/lytics数据与数据库451 次安装3 周前更新
代码仓库

关于 stream-inspector

stream-inspector 是通过已认证 API 检查 Lytics 入站数据流的技能，提供数据流列表、统计信息和近期事件，帮助排查数据采集与集成情况。

主要功能

  1. 01列出可用数据流和字段
  2. 02查看数据流详情与统计信息
  3. 03浏览近期事件
  4. 04提示事件数据中的错误和异常

适用场景

  1. 01检查集成是否发送了近期事件
  2. 02排查用户档案未更新的原因
  3. 03检查入站事件数据的结构

安装

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

$npx skills add https://github.com/lytics/agent-skills --skill stream-inspector

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

详细介绍

数据流检查器

用途

检查流入 Lytics 的数据流——列出可用数据流、查看其统计信息并浏览近期事件。适用于调试数据收集、验证集成以及了解传入数据的结构。

环境

需要经过身份验证的 API 访问权限。凭据解析请参阅 ../references/auth.md。

API 端点

列出数据流
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
获取数据流名称
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/names" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
获取数据流字段
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/fields" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
获取指定数据流
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
数据流统计信息
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}/stats" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
近期事件
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}/events" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

行为

所有操作均为只读——立即执行。

列出数据流

显示所有数据流的摘要表：

  • 数据流名称、事件数、最近事件时间、字段数
数据流统计信息

显示关键指标：

  • 事件总数、每秒／每分钟／每小时事件数
  • 错误率、处理延迟
  • 活跃／非活跃状态
近期事件

显示最近的事件，包括：

  • 时间戳、关键字段、事件类型
  • 突出显示任何错误或异常
  • 如果事件较复杂，则显示摘要，并提供查看特定事件的选项

使用场景

  • “有哪些数据正在流入？” -> 列出数据流和统计信息
  • “我的集成是否正常运行？” -> 检查数据流统计信息，确认是否有近期事件
  • “数据是什么样的？” -> 浏览近期事件
  • “为什么用户档案没有更新？” -> 检查数据流是否存在错误

错误处理

  • 未找到数据流：列出可用数据流
  • 没有事件：检查集成是否处于活跃状态，并建议检查作业状态

依赖项

  • 使用：../references/auth.md、../references/api-client.md

评论

支持 Markdown