收不到事件
事件没有出现的常见原因,以及如何判断是哪一种。
先用 curl 发送一个事件(参见快速开始)。响应本身就能告诉你大部分问题所在。
| 你看到的 | 原因 | 怎么办 |
|---|---|---|
200,带 "accepted":0 和一个 rejected 列表 | 每一行都写明了被拒绝的原因 | 修正它指出的字段(参见常见的行错误)。不要重发被拒绝的行。 |
401 unknown or revoked key | 密钥错误、已被撤销,或者不是 Lyrelog 的密钥 | 重新复制密钥,或在 API keys 新建一个 |
403 this key cannot write events | 这是一个 Read events 密钥 | 改用 Send events 密钥(lyr_ing_) |
415 | Content-Type 不是 application/x-ndjson | 设置这个 header |
429,带 plan、limit 和 used | Free 套餐本月的配额已用完 | SDK 会保留这些事件,到下个月再发送。参见套餐与用量 |
429,带 source_limit | 某个地址用公开密钥发送的事件已用完当天的每日配额 | 从服务器发送时,请使用服务器密钥(lyr_srv_)。否则事件会在下一个 UTC 日恢复。参见单个地址的每日配额 |
429 rate limit for this project | 每分钟超过 60,000 个事件 | 等待 Retry-After 指定的时间 |
425,带 verification_required | 项目只接受来自该平台的已验证事件,而这一批没有经过验证 | SDK 会保留并重试。无法证明自身的构建、模拟器、仿真器和设备永远无法通过:在需要用到它们时,请在项目设置中关闭该选项。参见已验证事件 |
503 | 服务器繁忙,或暂时无法连接存储 | 在 Retry-After 之后重发相同的字节(SDK 会自动这样做) |
某个 3xx | 端点错误 | 使用 https://ingest.lyrelog.com |
| 已接受,但控制台里没有 | 控制台一次只显示一个环境:从 Xcode 运行的构建、模拟器、Android debug 构建、localhost,以及没有设置 NODE_ENV=production 的 Node 都会发送 development | 在顶栏中选择 development 或 All environments,以及 All platforms |
| 已接受,但时间不对 | ts 早于保留期限,或比当前时间超前一天以上,因此按到达时间存储 | 查看属性 _lyrelog_ts_clamped,并发送当前时间 |
| Swift 应用完全没有发送 | 当同意状态为 .pending 或 .denied 时,SDK 不会发送任何内容 | 参见同意 |
| Android 应用完全没有发送 | 当同意状态为 PENDING 或 DENIED 时 SDK 不会发送任何内容,或者端点不在它接受的范围内 | 参见同意和开发和测试中 |
| React Native 或 Flutter 应用完全没有发送 | 同意状态为 pending 或 denied,端点不在原生 SDK 接受的范围内,或者添加包之后没有重新构建应用 | 参见 React Native 和 Flutter 的“同意”,以及 Flutter 的开发和测试中 |
| JVM 服务器完全没有发送 | 密钥为空(start 返回 false,什么也不做),或者进程在 shutdown hook 来得及发送之前就结束了 | 参见开始使用和立即发送(flush)和停止 |
| 服务器发出的事件显示在错误的国家 | 国家取自发送方的地址 | 参见国家 |
SDK 的提示信息
每个 SDK 都会报告自己遇到的问题(端点错误、密钥被拒、某一批被丢弃),而不会让你的应用崩溃:
| SDK | 在哪里查看 |
|---|---|
| Swift | 统一日志(unified log),子系统 com.lyrelog.sdk:在 Console.app 或 Xcode 的控制台中查看 |
| Android | Logcat,标签 Lyrelog,debug 级别 |
| React Native | 原生 SDK 的日志:iOS 上是统一日志(Xcode 的控制台),Android 上是 logcat,同上。缺少密钥或原生模块时,开发构建会在 Metro 中输出一条 console.warn |
| Flutter | 原生 SDK 的日志:iOS 上是统一日志(Xcode 的控制台),Android 上是 logcat,同上。设置 mirrorToConsole: true 后,每个事件也会打印在那里 |
| JavaScript | 以 [lyrelog] 开头的 console.warn 行 |
| Python | lyrelog logger(标准 logging) |
| Go | Config.ErrorLog,未设置时在 stderr 上输出一次遇到的第一个问题 |
| JVM | 标准错误输出中以 lyrelog: 开头的行,每个进程一次,或者 Configuration.diagnostics |
还是没解决?
请写信到 hello@lyrelog.com,附上项目 id(在 Project settings 的 Details 中)以及你发送事件的时间。不要发送任何密钥。