Journalisation des données
En vigueur le 28 octobre 2026
| Application | TreeCraft : hiérarchies de tickets, une application Jira Cloud conçue sur Atlassian Forge |
|---|---|
| Fiche Marketplace | À venir. TreeCraft n’est pas encore sur le Marketplace d’Atlassian, et sa clé d’application sera ajoutée ici lorsqu’elle le sera. |
| Identifiant de l’application Forge | ari:cloud:ecosystem::app/2f99b935-aba0-4b23-8784-05691aaac4b9 |
| Éditeur | Logiciels Plugincraft inc., Québec, Canada |
En bref
- Les journaux de l’application contiennent des identifiants, des nombres, des statuts et des codes d’erreur.
- Ils ne contiennent jamais de résumés de tickets, de texte de requêtes, de valeurs de champs, de noms ni d’adresses courriel.
- Un test automatisé fait échouer la compilation si du code journalise autre chose.
- Atlassian garde les journaux, et ne les garde pas à l’emplacement de résidence des données de votre site.
Ce que sont les journaux
Lorsqu’une fonction Forge de l’application s’exécute, elle peut écrire des lignes de journal. Atlassian les conserve et les met à la disposition de Plugincraft en tant que développeur. L’application n’utilise aucun service de journalisation externe. Comme les journaux ne sont pas conservés à l’emplacement de résidence des données de votre site et que le développeur peut les lire, l’application n’y met jamais de contenu de clients.
Ce qu’une ligne de journal peut contenir
| Type | Exemples |
|---|---|
| Identifiants | Un identifiant de hiérarchie, un identifiant d’élément, des identifiants de lignes de règles, un nom de file avec les identifiants de son travail, un numéro de version. |
| Nombres et tentatives | Combien de tickets une tâche a vérifiés, modifiés, écartés ou n’a pas pu lire; combien de tentatives a faites une reprise. |
| Statuts et raisons | Le statut HTTP d’un appel à Jira; la raison et l’attente d’une réponse « trop de requêtes »; d’une erreur, seulement son type, son code, son statut et l’endroit où elle a été levée (les premières lignes de la pile). |
| Les propres noms de l’application | Un nom de résolveur, un type de tâche, un nom de file, un identifiant de route REST, ainsi que le type de module et la clé que la plateforme nomme pour un appel refusé. Ce sont des noms du manifeste de l’application. |
| Points Jira | Une fois par minute et par instance, ce que Jira indique comme reste de la limite de rafale par seconde de l’application, sous forme de nombres et d’une heure UTC. Un appel ou une tâche qui dépense 100 points ou plus journalise ses points et ses requêtes par route, sans les identifiants, par exemple /rest/api/:x/issue/:x/changelog. |
| Durées de l’API REST | Une ligne par appel : l’identifiant de la route, le statut, le code d’erreur de l’application, les millisecondes par phase et le nombre d’instructions de base de données et de requêtes à Jira. |
Ce que les journaux ne contiennent jamais
- Des résumés, descriptions, commentaires ou valeurs de champs de tickets.
- Du texte de requêtes (JQL ou requêtes arborescentes), de formules ou de notes.
- Des noms de hiérarchies, de dossiers, de personnes ou de champs.
- Des adresses courriel.
- Les mots d’un message d’erreur. Les réponses de Jira, le texte d’une requête et les mots d’une valeur se retrouvent dans les messages d’erreur : l’application ne journalise donc que le type de l’erreur, son code, son statut et l’endroit où elle a été levée. La réponse de Jira à un appel échoué est gardée en mémoire pour le code et n’est jamais journalisée.
- Le chemin, les paramètres ou le corps d’une requête de l’API REST.
- Des identifiants de connexion ou des jetons. L’application n’en garde aucun.
Comment c’est appliqué
- Chaque ligne de journal passe par une seule fonction de l’application. Elle écrit ce qui a échoué avec des identifiants, des nombres et des statuts, et d’une erreur seulement son type, son code, son statut et ses lignes de pile.
- Un test automatisé fait échouer la compilation si du code journalise d’une autre façon, ou si une ligne de journal montre autre chose que les identifiants, nombres et noms permis. Le test couvre tout le code serveur de l’application, y compris l’API REST.
- Un nom n’est ajouté à la liste permise que lorsqu’on sait qu’il ne contiendra jamais de contenu de clients.
Conservation
Atlassian fixe la durée pendant laquelle Forge garde les journaux des applications. Durée de conservation : 30 jours. La documentation d’Atlassian pour les développeurs d’applications dit : « Les journaux ne sont disponibles que pour les 30 derniers jours » (traduction libre). Plugincraft ne copie les journaux dans aucun autre système et ne les lit que pour trouver et corriger des problèmes. Un administrateur de site peut en tout temps retirer au développeur l’accès aux journaux de son site.
Le paquet de soutien
Le paquet de soutien n’est pas un journal. Un administrateur le produit dans l’application pour l’envoyer au soutien. Il contient des versions, des réglages, des nombres et des identifiants, et aucun texte de tickets, aucune valeur de champs ni aucune adresse courriel. L’administrateur peut afficher tout le fichier avant de l’envoyer et décide de l’envoyer ou non. Les courriels de soutien sont conservés comme le décrit la politique de confidentialité.
Documents connexes
- Traitement des données : conservation et suppression
- Diagramme d’architecture et flux de données (protégé par mot de passe : demandez l’accès à info@plugincraft.ca)
- Aperçu de la sécurité
- Politique de confidentialité