环境
Debug 构建、TestFlight 和 App Store 发往同一个项目,每个事件都会注明来自哪个环境。
每个事件都带有 environment,因此一个项目可以同时容纳开发、测试和生产环境的事件,而不会混在一起。
控制台一次显示一个环境,或者全部环境。
名称
每个 SDK 用自己的方式命名环境(见下文)。如果你自己设置,任何其他名称也都可以:小写字母、数字、- 和 _,
最多 32 个字符,以字母或数字开头(staging、internal、staging-eu)。
各 SDK 如何检测环境
| SDK | 检测方式 |
|---|---|
| Swift | Debug 构建或模拟器上的任何构建为 development,从 TestFlight 安装的构建为 testflight,其他情况(App Store)为 production |
| Android | 应用可调试时(所有 debug 构建)为 development,否则为 production |
| React Native、Flutter | 沿用底层原生 SDK 的规则:iOS 上同 Swift,Android 上同 Android |
| JavaScript,浏览器 | 主机为 localhost、127.0.0.1、[::1] 或 *.localhost 时为 development,其他任何地方为 production |
| JavaScript,Node | NODE_ENV=production 时为 production,否则为 development |
| Python、Go、JVM | 环境变量 LYRELOG_ENVIRONMENT,未设置时为 production |
覆盖检测结果
在 SDK 的配置中设置 environment。在 Swift 中,nil 表示保留自动检测(Android 和 Flutter 中为 null,
React Native 中为 undefined),因此你可以把它和自己的规则结合起来:
Lyrelog.start(Configuration(
endpoint: URL(string: "https://ingest.lyrelog.com")!,
apiKey: "lyr_ing_...",
environment: isInternalTester ? "internal" : nil // nil = detected
))Lyrelog.detectedEnvironment 返回 Swift SDK 自行检测会选出的环境。
你自己运行的构建属于 development
从 Xcode 运行的构建、模拟器上的任何构建、Android debug 构建(包括通过 React Native 或 flutter run 运行的),
以及 localhost 上的网页,发送的都是 development。控制台默认打开 production,所以要看到你的第一批事件,
请在顶栏中选择 development(或 All environments)。
TestFlight 的检测读取的是构建的 App Store 收据:TestFlight 构建带有 sandbox 收据。你自己安装的 Release 构建
(ad hoc,或直接从 Xcode 以 Release 配置安装)没有收据,因此算作 production。如果这一点对你很重要,请自己设置
environment。
通过 HTTP 发送时,设置 resource.environment。未带环境的事件会按 production 存储。
在控制台中
顶栏中的选择器列出最近 30 天出现过的环境及各自的事件数,另外还有 All environments。你的选择按项目记在浏览器中。
在你选择之前,控制台会打开项目的默认环境:默认是 production,除非所有者在 Settings
中更改了它,也可以设为 All。所有与事件相关的页面都跟随这个选择器。参见
环境与平台。
Settings 中的 Environments 部分还会显示项目所含各平台的环境是如何确定的。