環境
Debug ビルド、TestFlight、App Store は同じプロジェクトに送信し、どこから来たかは各イベントに記録されます。
すべてのイベントは environment を持つので、1 つのプロジェクトに開発版、ベータ版、本番のイベントを混ぜずに保持できます。ダッシュボードは一度に 1 つの環境、またはすべての環境を表示します。
名前
環境の名前の付け方は SDK ごとに異なります(下記)。自分で設定する場合はほかの名前も使えます。小文字の英字、数字、-、_ からなる 32 文字以内で、英字か数字で始まる名前です(staging、internal、staging-eu)。
各 SDK の判定方法
| SDK | 判定 |
|---|---|
| Swift | Debug ビルドとシミュレーター上のすべてのビルドは development、TestFlight からインストールしたビルドは testflight、それ以外(App Store)は production |
| Android | アプリが debuggable のとき(すべての 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 上の Web ページは、どれも development を送ります。ダッシュボードは production で開くので、最初のイベントを見るにはトップバーで development(または All environments)を選んでください。
TestFlight かどうかは、ビルドの App Store レシートで判定します。TestFlight のビルドには sandbox のレシートがあります。自分でインストールした Release ビルド(ad hoc、または Release 構成で Xcode から直接インストールしたもの)にはレシートがないため、production として扱われます。これが問題になる場合は、environment を自分で設定してください。
HTTP では resource.environment を設定します。これを付けずに送ったイベントは production として保存されます。
ダッシュボードでの扱い
トップバーのピッカーには、過去 30 日間にイベントのあった環境が、それぞれのイベント数とともに一覧され、All environments も選べます。選んだ環境はプロジェクトごとにブラウザーに記憶されます。まだ選んでいない場合、ダッシュボードはプロジェクトのデフォルト環境で開きます。デフォルトは production ですが、オーナーが Settings で変更でき、All にもできます。イベントに関するページはすべてピッカーに従います。環境とプラットフォームも参照してください。
Settings の Environments セクションには、プロジェクトのプラットフォームごとに環境がどう決まるかも表示されます。