Early AccessNur auf Einladung, und die SDKs sind noch nicht veröffentlicht.Einladung anfragen
Zum Inhalt springen
Docs

Umgebungen

Debug-Builds, TestFlight und der App Store senden an dasselbe Projekt, und jedes Event sagt, woher es kommt.

Jedes Event trägt ein environment, sodass ein Projekt Events aus Entwicklung, Beta und Produktion enthalten kann, ohne sie zu vermischen. Das Dashboard zeigt eine Umgebung auf einmal oder alle zusammen.

Die Namen

Jedes SDK benennt die Umgebung auf seine Weise (siehe unten). Setzt du sie selbst, geht jeder andere Name: Kleinbuchstaben, Ziffern, - und _, bis zu 32 Zeichen, beginnend mit einem Buchstaben oder einer Ziffer (staging, internal, staging-eu).

Wie jedes SDK sie erkennt

SDKErkennung
Swiftdevelopment für einen Debug-Build oder jeden Build im Simulator, testflight für einen über TestFlight installierten Build, sonst production (der App Store)
Androiddevelopment, wenn die App debuggable ist (jeder Debug-Build), sonst production
React Native, FlutterDie des nativen SDKs: die Regel von Swift auf iOS, die von Android auf Android
JavaScript, Browserdevelopment auf localhost, 127.0.0.1, [::1] oder einem *.localhost-Host, überall sonst production
JavaScript, Nodeproduction bei NODE_ENV=production, sonst development
Python, Go, JVMDie Umgebungsvariable LYRELOG_ENVIRONMENT, sonst production

Überschreiben

Setze environment in der Konfiguration des SDKs. In Swift behält nil die Erkennung bei (null auf Android und in Flutter, undefined in React Native), sodass du sie mit einer eigenen Regel kombinieren kannst:

Lyrelog.start(Configuration(
    endpoint: URL(string: "https://ingest.lyrelog.com")!,
    apiKey: "lyr_ing_...",
    environment: isInternalTester ? "internal" : nil   // nil = detected
))

Lyrelog.detectedEnvironment gibt zurück, was das Swift-SDK von sich aus wählen würde.

Deine eigenen Läufe sind development

Ein Build, den du aus Xcode startest, jeder Build im Simulator, ein Android-Debug-Build (auch aus React Native oder mit flutter run) und eine Webseite auf localhost senden alle development. Das Dashboard öffnet auf production: Wähle also in der oberen Leiste development (oder All environments), um deine ersten Events zu sehen.

Die TestFlight-Prüfung liest den App-Store-Beleg (Receipt) des Builds: Ein TestFlight-Build hat einen Sandbox-Beleg. Ein Release-Build, den du selbst installierst (ad hoc oder direkt aus Xcode mit der Release-Konfiguration), hat keinen und zählt daher als production. Setze environment selbst, wenn das eine Rolle spielt.

Über HTTP setzt du resource.environment. Ein Event ohne diesen Wert wird als production gespeichert.

Im Dashboard

Die Auswahl in der oberen Leiste listet die Umgebungen der letzten 30 Tage mit der Zahl ihrer Events auf, dazu All environments. Deine Wahl merkt sich dein Browser pro Projekt. Solange du keine gewählt hast, öffnet das Dashboard die Standardumgebung des Projekts: production, außer ein Inhaber ändert sie in den Settings, wo sie auch All sein kann. Jede Seite zu Events folgt dieser Auswahl. Siehe Umgebungen und Plattformen.

Der Abschnitt Environments in den Settings zeigt außerdem, wie die Umgebung für die Plattformen des Projekts bestimmt wird.