Accès anticipéSur invitation, et les SDK ne sont pas encore publiés.Demander une invitation
Aller au contenu
Docs

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

SDKDétection
Swiftdevelopment pour un build Debug ou tout build sur le simulateur, testflight pour un build installé depuis TestFlight, production sinon (l'App Store)
Androiddevelopment quand l'app est débogable (tout build debug), production sinon
React Native, FlutterCelle du SDK natif : la règle de Swift sur iOS, celle d'Android sur Android
JavaScript, navigateurdevelopment sur un hôte localhost, 127.0.0.1, [::1] ou *.localhost, production partout ailleurs
JavaScript, Nodeproduction quand NODE_ENV=production, development sinon
Python, Go, JVMLa 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.