アーリーアクセス招待制です。SDK はまだ公開されていません。招待をリクエスト
本文へスキップ
ドキュメント

環境

Debug ビルド、TestFlight、App Store は同じプロジェクトに送信し、どこから来たかは各イベントに記録されます。

すべてのイベントは environment を持つので、1 つのプロジェクトに開発版、ベータ版、本番のイベントを混ぜずに保持できます。ダッシュボードは一度に 1 つの環境、またはすべての環境を表示します。

名前

環境の名前の付け方は SDK ごとに異なります(下記)。自分で設定する場合はほかの名前も使えます。小文字の英字、数字、-、_ からなる 32 文字以内で、英字か数字で始まる名前です(staging、internal、staging-eu)。

各 SDK の判定方法

SDK判定
SwiftDebug ビルドとシミュレーター上のすべてのビルドは 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 セクションには、プロジェクトのプラットフォームごとに環境がどう決まるかも表示されます。