抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

收不到事件

事件没有出现的常见原因,以及如何判断是哪一种。

先用 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_)
415Content-Type 不是 application/x-ndjson设置这个 header
429,带 plan、limit 和 usedFree 套餐本月的配额已用完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 的控制台中查看
AndroidLogcat,标签 Lyrelog,debug 级别
React Native原生 SDK 的日志:iOS 上是统一日志(Xcode 的控制台),Android 上是 logcat,同上。缺少密钥或原生模块时,开发构建会在 Metro 中输出一条 console.warn
Flutter原生 SDK 的日志:iOS 上是统一日志(Xcode 的控制台),Android 上是 logcat,同上。设置 mirrorToConsole: true 后,每个事件也会打印在那里
JavaScript以 [lyrelog] 开头的 console.warn 行
Pythonlyrelog logger(标准 logging)
GoConfig.ErrorLog,未设置时在 stderr 上输出一次遇到的第一个问题
JVM标准错误输出中以 lyrelog: 开头的行,每个进程一次,或者 Configuration.diagnostics

还是没解决?

请写信到 hello@lyrelog.com,附上项目 id(在 Project settings 的 Details 中)以及你发送事件的时间。不要发送任何密钥。