Environnements
Les builds Debug, TestFlight et l'App Store envoient au même projet, et chaque événement dit d'où il vient.
Chaque événement porte un environment, si bien qu'un même projet peut contenir des événements
de développement, de bêta et de production sans les mélanger. Le tableau de bord affiche un
environnement à la fois, ou tous.
Les noms
Chaque SDK nomme l'environnement à sa façon (ci-dessous). N'importe quel autre nom fonctionne si
vous le définissez vous-même : lettres minuscules, chiffres, - et _, jusqu'à 32 caractères,
en commençant par une lettre ou un chiffre (staging, internal, staging-eu).
Comment chaque SDK le détecte
| SDK | Détection |
|---|---|
| Swift | development pour un build Debug ou tout build sur le simulateur, testflight pour un build installé depuis TestFlight, production sinon (l'App Store) |
| Android | development quand l'app est débogable (tout build debug), production sinon |
| React Native, Flutter | Celle du SDK natif : la règle de Swift sur iOS, celle d'Android sur Android |
| JavaScript, navigateur | development sur un hôte localhost, 127.0.0.1, [::1] ou *.localhost, production partout ailleurs |
| JavaScript, Node | production quand NODE_ENV=production, development sinon |
| Python, Go, JVM | La variable d'environnement LYRELOG_ENVIRONMENT, sinon production |
Le remplacer
Définissez environment dans la configuration du SDK. En Swift, nil conserve la détection
(null sur Android et dans Flutter, undefined dans React Native), ce qui permet de la combiner
avec votre propre règle :
Lyrelog.start(Configuration(
endpoint: URL(string: "https://ingest.lyrelog.com")!,
apiKey: "lyr_ing_...",
environment: isInternalTester ? "internal" : nil // nil = detected
))Lyrelog.detectedEnvironment renvoie ce que le SDK Swift choisirait de lui-même.
Vos propres exécutions sont en development
Un build lancé depuis Xcode, tout build sur le simulateur, un build debug Android (y compris
depuis React Native ou flutter run) et une page web sur localhost envoient tous
development. Le tableau de bord s'ouvre sur production : choisissez development (ou
All environments) dans la barre du haut pour voir vos premiers événements.
La vérification TestFlight lit le reçu App Store du build : un build TestFlight a un reçu de
sandbox. Un build Release que vous installez vous-même (ad hoc, ou directement depuis Xcode avec
la configuration Release) n'en a pas, il compte donc comme production. Définissez
environment vous-même si cela compte.
En HTTP, définissez resource.environment. Un événement envoyé sans environnement
est stocké en production.
Dans le tableau de bord
Le sélecteur de la barre du haut liste les environnements vus ces 30 derniers jours, avec le
nombre d'événements de chacun, plus All environments. Votre choix est mémorisé par projet
dans votre navigateur. Tant que vous n'en avez pas choisi, le tableau de bord s'ouvre sur
l'environnement par défaut du projet : production, sauf si un propriétaire le change dans
Settings, où il peut aussi valoir All. Toutes les pages consacrées aux
événements suivent le sélecteur. Voir
Environnements et plateformes.
La section Environments de Settings montre aussi comment l'environnement est déterminé pour les plateformes du projet.