Sentinelle

Intégration de Sentry dans le SDK mobile Stonly

1. Aperçu

Le kit de développement logiciel (SDK) mobile de Stonly est livré avec un client Sentry intégré.

Sentry est un outil d'observabilité standard du secteur que nous utilisons en interne pour surveiller le SDK lui-même, et non votre code applicatif. Il nous permet de :

• surveiller la stabilité du SDK dans les environnements de production,

• Détecter automatiquement les plantages, les exceptions et les erreurs non gérées provenant du code du SDK.

• réagir plus rapidement aux problèmes,

• Collecter des indicateurs de performance (par exemple, l'impact du démarrage à froid, le temps de rendu des guides, la latence du réseau) afin de pouvoir optimiser les versions futures.

Sentry s'exécute dans une configuration isolée et sécurisée, dédiée au SDK Stonly . Il n'interfère pas avec votre propre instance Sentry si vous utilisez également Sentry dans votre application.

2. Ce qui est collecté

Le SDK ne signale que les événements provenant de l'intérieur du SDK Stonly . Plus précisément :

• Erreurs et plantages détectés dans les limites du SDK (traces de pile, version du SDK, version du système d'exploitation, modèle de périphérique).

• Traces de performance pour les opérations du SDK (par exemple, temps de chargement du guide, appels réseau vers le backend Stonly ).

• Métadonnées techniques anonymes : version du SDK, plateforme, version du système d’exploitation, classe d’appareil.

Le SDK n'envoie pas :

• le code source de votre application, le contenu de l'écran ou les captures d'écran,

• données personnelles des utilisateurs finaux (noms, adresses électroniques, etc.),

• Erreurs au niveau de l'application qui se produisent en dehors du code du SDK.

3. Comportement par défaut

La surveillance Sentry est activée par défaut lors de l'initialisation du SDK. Aucune configuration supplémentaire n'est requise pour en bénéficier.

Si vos exigences en matière de confidentialité ou de conformité interdisent la télémétrie tierce, vous pouvez vous désinscrire à tout moment en utilisant l'API décrite ci-dessous.

4. Se désinscrire

Le SDK propose une méthode dédiée pour désactiver la surveillance Sentry. Appelez-la avant Stonly.Widget.widgetId afin d'éviter la capture d'événements au démarrage.

iOS (Obj C)

 @import Stonly; //... StonlyWidget.sentryEnabled = false;// Disable Sentry monitoring before initialization StonlyWidget.widgetId = @"<WIDGET_ID>";// Initialize the SDK as usual

iOS (Swift)

 import Stonly //... Stonly.Widget.isSentryEnabled = false // Disable Sentry monitoring before initialization Stonly.Widget.widgetId = "<WIDGET_ID>"// Initialize the SDK as usual

Android (Kotlin/Java)

 import com.stonly.sdk.Stonly //... Stonly.setSentryEnabled(false) // Disable Sentry monitoring before initialization Stonly.setWidgetId("YOUR_WIDGET_ID",application,uiType,datacenter)// Initialize the SDK as usual

4. Confidentialité et conformité

• L'instance Sentry utilisée par le SDK est détenue et exploitée par Stonly .

• Les données sont traitées conformément à notre politique de confidentialité .

• Le SDK ne collecte pas, de par sa conception, les données personnelles de vos utilisateurs finaux.

• Si vous avez une politique stricte de non-utilisation de la télémétrie, utilisez la procédure de désactivation ci-dessus et documentez la modification dans vos notes de version.

5. FAQ

Q : Cela va-t-il entrer en conflit avec mon propre SDK Sentry ?

Non. Le client Sentry de Stonly est isolé et utilise son propre DSN ; il n'interceptera ni ne dupliquera les événements de l'instance Sentry de votre application.

Q : L'activation de Sentry a-t-elle un impact sur les performances de l'application ?

La surcharge est minimale. Sentry est configuré avec un échantillonnage conservateur pour les traces de performance et ne signale que les événements relevant du SDK.

Q : Puis-je vérifier ce qui est envoyé ?

Non. Pour des raisons de sécurité, le contenu des événements émis par le client Sentry intégré n'est pas exposé à l'inspection par l'application hôte.

Q : Le choix de se désinscrire est-il conservé d'une session à l'autre ?

Oui. La désactivation s'effectue via une option de configuration dans le SDK. Tant que cette option est activée (par exemple, avant chaque appel à Stonly.setWidgetId dans le code de démarrage de votre application), la surveillance Sentry restera désactivée pour chaque session.

Q : La désactivation du mode de retrait désactive-t-elle également les autres données de télémétrie du SDK ?

Ce paramètre contrôle uniquement la surveillance de la stabilité et des performances basée sur Sentry. Les analyses fonctionnelles (par exemple, les vues de guide) sont régies par votre configuration Stonly existante.