快速开始
创建项目,复制它的采集密钥,发送第一个事件,然后在控制台里找到它。
Lyrelog 是一项托管服务,目前处于抢先体验阶段,仅限受邀使用。请在 lyrelog.com 申请访问权限,用邀请链接即可创建账户。控制台位于 app.lyrelog.com,应用把事件发送到 https://ingest.lyrelog.com。
给第一个项目命名
创建账户后,控制台会打开 Welcome 页面。给项目起个名字,并选择事件的来源:iOS 或 macOS 应用、网站、Node、Python 或 Go 服务,或者其他任何通过 HTTP 发送的程序。你的选择决定了接下来看到的代码片段,以及项目的平台。
每个应用建一个项目。如果应用还有网站和后端,它们都可以发送到同一个项目(参见平台)。之后的项目可以在 Projects 里点 New project 创建。只有组织的所有者才能创建项目。
复制采集密钥
项目一创建好,Lyrelog 就会显示它的采集密钥 lyr_ing_...,以及要粘贴到应用里的代码。请立即复制密钥: 服务器只保存它的哈希值,所以之后无法再次显示。如果弄丢了,可以在项目的 API keys 页面新建一个。
采集密钥只能发送事件,不能读取,因此可以放心地打包进应用里。参见密钥。后端则应该改用服务器密钥发送(在 API keys 页面的 Send events from a server),它发送的事件是已验证的。
发送第一个事件
SDK 尚未发布
Swift、Android、React Native、Flutter、JavaScript、Python、Go 和 JVM 的 SDK 目前还无法安装。现在请用 curl 发送第一个事件,或者用任意语言通过 HTTP API 发送。
在 macOS 或 Linux 终端中(需要用到 uuidgen 和 date),把 lyr_ing_... 替换为你的密钥,然后运行:
curl -X POST https://ingest.lyrelog.com/v1/events:batch \
-H "Authorization: Bearer lyr_ing_..." \
-H "Content-Type: application/x-ndjson" \
--data-binary "{\"event_id\":\"$(uuidgen | tr A-Z a-z)\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"message\":\"hello_lyrelog\",\"resource\":{\"environment\":\"production\"}}"每个事件都需要一个新的 UUID 作为 event_id,并以当前时间作为 ts。如果事件的 ts 早于项目的保留期限,或者比当前时间超前一天以上,它也不会丢失:系统会按到达时间存储它,并把发送时的时间放进属性 _lyrelog_ts_clamped。响应会告诉你存储了多少行:
{"accepted":1,"rejected":[]}返回的不是这样?参见收不到事件。
看到事件到达
Welcome 页面会等待第一个事件,并在它到达时提示你。从那里打开项目:Events 页面会列出 hello_lyrelog。点击它即可查看完整的事件。
没看到?
控制台一次只显示一个环境,默认打开项目的默认环境 production。对于在 Xcode 中运行的构建、模拟器、localhost 上的页面,以及未设置 NODE_ENV=production 的 Node,SDK 都会把环境设为 development,所以你用 SDK 发出的头几个事件会在 development 下:在顶栏中选择它,或者选择 All environments。上面的 curl 设置了 "environment":"production";没有 resource.environment 的事件也会存为 production。参见环境。
用脚本读取(可选)
在项目的 API keys 页面选择 New key,把 What it can do 设为 Read events,然后复制 lyr_read_... 密钥。如果你上次登录已超过 10 分钟,创建只读密钥时需要重新登录。请把它保存在服务器上:它能读取项目的所有事件。
export LYRELOG_READ_KEY=lyr_read_...
curl -s -G https://app.lyrelog.com/v1/events \
-H "Authorization: Bearer $LYRELOG_READ_KEY" \
--data-urlencode "message=hello_lyrelog"参见 Read API。
下一步
应用
Web 与服务器