Assistance
Connecter votre compte
Créer un jeton
- Dans Sentry, ouvrez User settings → Personal Tokens (en auto-hébergé : les réglages équivalents des jetons d’authentification) et créez un nouveau jeton.
-
Choisissez les scopes. Pour une consultation en lecture seule :
org:read,project:read,event:read. Pour trier depuis l’app, ajoutezevent:write(résoudre, archiver, attribuer) etmember:read(choix du responsable). - Copiez le jeton et collez-le dans l’écran de connexion de Tracebell. Les scopes ne peuvent pas être modifiés après la création : s’il en manque, créez un nouveau jeton.
Serveurs auto-hébergés
Choisissez « Auto-hébergé » sur l’écran de connexion et saisissez l’URL de votre serveur. L’app utilise les mêmes chemins d’API que sentry.io. Votre serveur doit être accessible depuis votre iPhone (directement ou via un VPN) en HTTPS.
Problèmes courants
- « Jeton refusé » juste après l’avoir collé : vérifiez qu’il n’est pas tronqué et qu’il ne contient pas d’espaces superflus ; les jetons sont longs. En auto-hébergé, vérifiez aussi que l’URL ne comporte aucun chemin après le nom d’hôte.
- Boutons grisés (résoudre/attribuer) : il manque
event:writeoumember:readà votre jeton. Créez un nouveau jeton avec ces scopes. - Tout fonctionnait, puis plus rien : le jeton a probablement été révoqué, ou votre appartenance à l’organisation a changé. Reconnectez-vous avec un nouveau jeton.
- Les listes sont lentes ou ne s’actualisent plus : Sentry applique des limites de requêtes par endpoint. L’app ralentit automatiquement ses requêtes et reprend dès que la limite est réinitialisée.
Notifications push
Avec le forfait gratuit, les appareils enregistrés reçoivent un résumé quotidien des nouvelles issues (vers 22 h UTC / 7 h JST), et chaque appareil enregistré reçoit un récapitulatif hebdomadaire. Tracebell Advanced remplace le résumé quotidien par l’envoi en temps réel de chaque événement (création, régression, résolution), avec ses filtres. La configuration est la même dans les deux cas :
- Dans Tracebell, ouvrez Profil → Notifications, touchez Activer les notifications et autorisez les notifications.
- Touchez Configurer les notifications push. Dans Sentry, ouvrez Settings → Developer Settings → Custom Integrations et créez une Internal Integration : réglez Issue & Event sur Read (Sentry l’exige pour s’abonner aux webhooks d’issues), laissez toutes les autres autorisations sur « No Access », activez Alert Rule Action et abonnez le webhook aux événements issue.
- Copiez le Client Secret de l’intégration, collez-le dans l’app et touchez Enregistrer cet appareil. L’app affiche alors votre URL de webhook personnelle.
- Collez cette URL dans le champ Webhook URL de l’intégration dans Sentry, puis enregistrez. Si vous le souhaitez, ajoutez « Send a notification via Tracebell » à vos règles d’alerte.
- De retour dans l’app, envoyez une notification de test. Avec Advanced, choisissez les types d’événements qui vous notifient en temps réel et, si vous le souhaitez, limitez-les à certains Projets (50 au maximum) et à un Niveau minimal (Info, Warning, Error ou Fatal).
La création d’une Internal Integration nécessite généralement le rôle Admin, Manager ou Owner dans l’organisation. Si vous avez le rôle Member, demandez à un Owner de la configurer, ou utilisez l’app sans notifications push.
Note sur la confidentialité : le relais ne détient jamais votre jeton Sentry et ne conserve pas les titres des issues, qui ne font que transiter par lui vers le service push d’Apple pour livrer la notification. Voir la politique de confidentialité.
Fonctionnement des filtres
- Ils s’appliquent aux notifications push en temps réel et au démarrage automatique des activités en direct. Le résumé quotidien (forfait gratuit) et le récapitulatif hebdomadaire comptent toujours chaque nouvelle issue, et les issues que vous suivez sur l’écran verrouillé ne sont pas filtrées.
- Les alertes de métriques ne sont filtrées que par projet. Lorsque Sentry n’indique pas le projet ou le niveau d’un événement, celui-ci est transmis plutôt qu’écarté.
Activité en direct (Advanced)
Ouvrez une issue non résolue et touchez Suivre sur l’écran verrouillé. L’activité en direct affiche la phase de l’issue, ses événements, ses utilisateurs, ses alertes et le moment où elle a été vue pour la dernière fois, sur l’écran verrouillé et dans la Dynamic Island. Elle se termine quand l’issue est résolue ou archivée, et vous pouvez arrêter le suivi à tout moment.
- Les mises à jour en arrière-plan passent par le relais push : elles nécessitent donc que les notifications soient configurées (voir ci-dessus) pour l’organisation de l’issue. Elles arrivent quand Sentry envoie un webhook pour l’issue, et non à intervalles réguliers ; ajouter « Send a notification via Tracebell » à une règle d’alerte d’issue les rend plus fréquentes. Sans notifications, l’activité en direct n’est mise à jour que lorsque Tracebell est ouvert et affiche « Ouvrez Tracebell pour actualiser » au bout de 30 minutes.
- Redémarrage : l’activité en direct d’une issue suivie peut redémarrer quand l’issue régresse ou qu’une alerte se déclenche.
- Après une fermeture forcée : si vous fermez Tracebell en le balayant dans le sélecteur d’app, ou si le mode Économie d’énergie est activé ou si l’actualisation en arrière-plan est désactivée pour Tracebell, iOS peut empêcher l’app de démarrer des activités en direct ou d’envoyer leur jeton de mise à jour au relais en arrière-plan. Une activité en direct démarrée dans ces conditions affiche « Ouvrez Tracebell pour actualiser » au bout de 30 minutes, même si les notifications sont configurées. Ouvrez Tracebell et les mises à jour reprennent.
- Démarrer automatiquement (Profil → Notifications, désactivé par défaut) : une issue qui régresse dans les projets que vous surveillez, à votre niveau minimal ou au-dessus, peut démarrer d’elle-même une activité en direct, mais seulement si aucune activité en direct Tracebell n’est en cours.
- Limites : jusqu’à 3 activités en direct peuvent être en cours en même temps ; en suivre une quatrième met fin à celle dont la dernière mise à jour est la plus ancienne. iOS décide de la fréquence à laquelle une app peut démarrer des activités en direct en arrière-plan, et le relais envoie au plus 4 démarrages par heure : un démarrage peut donc être ignoré. iOS met fin à toute activité en direct au bout de 8 heures.
- Rien ne s’affiche ? Vérifiez que les activités en direct sont activées pour Tracebell dans l’app Réglages d’iOS, puis utilisez Envoyer une activité en direct de test dans Profil → Notifications et verrouillez votre iPhone : une activité en direct de test apparaît dans environ 10 secondes.
- En mode démo, vous pouvez suivre une issue d’exemple ; elle affiche des mises à jour d’exemple tant que l’app est ouverte.
Icônes de l’app (Advanced)
Ouvrez Profil → Apparence → Icône de l’app et choisissez Papier, Mono, Signal, Ambre ou Menthe ; Classique est toujours disponible. iOS confirme chaque changement par une courte alerte. Sans Advanced, et en mode démo, toucher une icône affiche un aperçu et l’icône de votre écran d’accueil ne change pas. Si Advanced prend fin, l’icône choisie reste en place jusqu’à ce que vous reveniez à Classique.
Achats
- Forfaits : Tracebell Advanced est proposé en abonnement mensuel (¥500 / $2.99) ou annuel (¥4,000 / $24.99, essai gratuit de 14 jours), ou en achat unique à vie (¥9,700 / $99.99). Les pourboires proposés dans l’app soutiennent le développement et ne débloquent rien.
- Restaurer : Profil → Forfait → Restaurer les achats (utilisez le même compte Apple).
- Annuler : les abonnements se gèrent dans les réglages de votre compte App Store, pas dans l’app.
- Les remboursements sont gérés par Apple sur reportaproblem.apple.com.
Suggestions et bugs
Écrivez à [email protected] en décrivant ce que vous attendiez et ce qui s’est passé. Les captures d’écran sont utiles, mais pensez à flouter d’abord toute information sensible.