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
| SDK | Erkennung |
|---|---|
| Swift | development für einen Debug-Build oder jeden Build im Simulator, testflight für einen über TestFlight installierten Build, sonst production (der App Store) |
| Android | development, wenn die App debuggable ist (jeder Debug-Build), sonst production |
| React Native, Flutter | Die des nativen SDKs: die Regel von Swift auf iOS, die von Android auf Android |
| JavaScript, Browser | development auf localhost, 127.0.0.1, [::1] oder einem *.localhost-Host, überall sonst production |
| JavaScript, Node | production bei NODE_ENV=production, sonst development |
| Python, Go, JVM | Die 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.