Paramètres de rétention des journaux Easy Digital Downloads

Easy Digital Downloads enregistre automatiquement diverses activités de votre boutique, telles que les téléchargements de fichiers, les erreurs de paiement, les requêtes API et les envois d'e-mails. Avec le temps, ces journaux peuvent s'accumuler et consommer de l'espace dans la base de données.

Les paramètres de rétention des journaux vous permettent de contrôler la durée de conservation de ces journaux et leur suppression automatique.

Aperçu

Les paramètres de rétention des journaux vous permettent de :

• Automatiser le nettoyage des journaux avec une purge quotidienne planifiée
• Personnaliser les périodes de rétention pour chaque type de journal individuellement
• Contrôler le traitement par lots pour équilibrer performance et rapidité
• Purger manuellement les journaux à la demande lorsque nécessaire
• Conserver les données importantes tout en supprimant les informations obsolètes

Cette fonctionnalité vous aide à maintenir votre base de données légère sans perdre d'informations précieuses sur l'activité récente.

Paramètres de rétention des journaux

Pour accéder aux paramètres de rétention des journaux :

1. Accédez à Téléchargements > Outils dans votre tableau de bord d'administration WordPress.
2. Cliquez sur la page Journalisation des événements.
3. Cliquez sur l'onglet Paramètres.

---

Comprendre les types de journaux

Easy Digital Downloads suit divers événements de la boutique par type de journal, chaque type servant un objectif différent dans les opérations de votre boutique. Ci-dessous se trouvent les types de journaux par défaut inclus avec Easy Digital Downloads, bien que des extensions puissent également enregistrer des types de journaux supplémentaires.

Téléchargements de fichiers

Rétention par défaut : 90 jours

Les journaux de téléchargement de fichiers enregistrent chaque fois qu'un client télécharge un fichier acheté. Ces journaux incluent le client, le produit, le fichier téléchargé, l'adresse IP et l'horodatage.

Comment vous pourriez utiliser ces données :

Vous pouvez examiner les journaux de téléchargement lorsque les clients signalent des problèmes d'accès à leurs fichiers, vérifier qu'un client a bien reçu son téléchargement ou suivre les tendances de téléchargement de vos produits. Ces journaux peuvent également servir de preuve pour les litiges de paiement et les rétrofacturations en prouvant qu'un client a téléchargé avec succès les fichiers achetés. Plusieurs extensions utilisent ces données pour fournir des pages d'historique de téléchargement consultables par le client, appliquer des limites de téléchargement et générer des rapports de licence. Si vous consultez régulièrement l'historique des téléchargements au-delà de quelques mois, avez besoin de preuves pour des litiges, ou utilisez des extensions telles que Software Licensing, All Access, Download Pages ou Recurring Payments, vous pourriez vouloir conserver ces journaux plus longtemps.

Erreurs de paiement

Rétention par défaut : 30 jours

Les journaux d'erreurs de paiement capturent les tentatives de paiement échouées, y compris les messages d'erreur de la passerelle, les identifiants de transaction et les raisons de l'échec.

Comment vous pourriez utiliser ces données :

Vous pouvez examiner les erreurs de paiement lors du dépannage des problèmes de paiement, de l'identification des tendances dans les transactions échouées ou de la collaboration avec votre passerelle de paiement pour résoudre les problèmes. La plupart des propriétaires de boutiques constatent que les journaux d'erreurs récents (dans les 30 à 60 derniers jours) sont suffisants pour le dépannage, car les erreurs plus anciennes ont généralement déjà été étudiées et résolues.

Requêtes API

Rétention par défaut : 60 jours

Les journaux de requêtes API enregistrent toutes les requêtes adressées à l'API REST de votre boutique, y compris le point de terminaison, la méthode de requête, le code de réponse et l'utilisateur.

Comment vous pourriez utiliser ces données :

Vous pouvez examiner les journaux d'API lors du débogage des intégrations avec des services tiers, de la surveillance des modèles d'utilisation de l'API ou du dépannage des problèmes de connexion. Si vous développez ou maintenez activement des intégrations personnalisées, ou si vous avez besoin d'auditer l'accès à l'API à des fins de sécurité, conserver des périodes de rétention plus longues peut être utile.

Journaux d'e-mails

Rétention par défaut : 30 jours

Les journaux d'e-mails suivent tous les e-mails envoyés par Easy Digital Downloads, y compris les reçus d'achat, les liens de téléchargement et les notifications administratives.

Comment vous pourriez utiliser ces données :

Vous pouvez examiner les journaux d'e-mails lorsqu'un client signale ne pas avoir reçu son reçu d'achat ou son lien de téléchargement, dépanner les problèmes de livraison d'e-mails ou vérifier que les notifications administratives ont été envoyées. La plupart des demandes de support client concernant des e-mails manquants concernent des achats récents, de sorte que des périodes de rétention plus courtes fournissent généralement les informations dont vous avez besoin.

---

Configuration de la rétention des journaux

Activation de la suppression automatique

Le commutateur Activer la suppression automatique contrôle si les journaux sont automatiquement supprimés selon un calendrier quotidien. Lorsqu'il est activé, Easy Digital Downloads supprimera les journaux chaque jour en fonction de vos périodes de rétention configurées.

Pour activer la suppression automatique :

1. Accédez à Téléchargements > Outils > Journalisation des événements.
2. Cliquez sur l'onglet Paramètres.
3. Activez le commutateur Activer la suppression automatique.

Le paramètre est enregistré automatiquement lorsque vous l'activez.

Remarque : L'activation du commutateur global n'active pas automatiquement tous les types de journaux. Vous devez également activer les types de journaux individuels (voir ci-dessous).

Définition de la taille des lots

Le paramètre Taille des lots détermine le nombre d'entrées de journal supprimées dans chaque cycle de traitement lors des opérations de suppression.

Plage disponible : 50 à 1 000 entrées par lot
Défaut : 250 entrées par lot

Comment choisir une taille de lot :

• Lots plus petits (50-150) : Plus doux pour les ressources du serveur, mais la suppression prend plus de temps. Idéal pour l'hébergement mutualisé ou les boutiques très fréquentées.
• Lots moyens (200-500) : Approche équilibrée adaptée à la plupart des boutiques. La valeur par défaut de 250 fonctionne bien dans les environnements typiques.
• Lots plus grands (600-1 000) : Suppression plus rapide, mais plus de charge serveur par cycle. Idéal pour les serveurs dédiés ou l'hébergement VPS avec des ressources suffisantes.

Pour ajuster la taille des lots :

1. Localisez le champ Taille des lots dans la section Rétention des journaux.
2. Entrez un nombre compris entre 50 et 1 000.
3. Cliquez ou appuyez sur Tab en dehors du champ.

Le paramètre est enregistré automatiquement lorsque vous quittez le champ.

Configuration des types de journaux individuels

Chaque type de journal possède son propre panneau de configuration avec trois composants :

1. Commutateur d'activation – Active ou désactive la suppression automatique pour ce type de journal.
2. Jours de conservation – Définit la durée de conservation des journaux avant leur suppression.
3. Bouton Supprimer maintenant – Supprime manuellement les journaux immédiatement.

Configuration des périodes de rétention

Pour configurer la durée de conservation des journaux :

1. Accédez au type de journal que vous souhaitez configurer.
2. Entrez le nombre de jours dans le champ Jours à conserver.
3. Cliquez ou appuyez sur Tab en dehors du champ.

Le paramètre est enregistré automatiquement lorsque vous quittez le champ.

Plage disponible : 1 à 3 650 jours (environ 10 ans)

Choix des périodes de rétention :

Votre période de rétention doit équilibrer vos besoins opérationnels et l'efficacité de la base de données. Tenez compte de ces facteurs :

• Besoins du support client : Jusqu'à quand les clients s'enquèrent-ils généralement des commandes ?
• Exigences des extensions : Vos extensions ont-elles besoin de données de journalisation historiques pour fonctionner ?
• Exigences légales : Avez-vous des obligations de conservation des données ?
• Besoins de reporting : Quelle quantité de données historiques analysez-vous ?
• Performances de la base de données : La taille de votre base de données affecte-t-elle les performances du site ?

Il n'y a pas de réponse unique. Les propriétaires de boutiques conservent souvent les journaux de téléchargement de fichiers plus longtemps (60 à 180 jours) pour prendre en charge les pages de téléchargement client et les rapports de licence, tout en conservant les erreurs de paiement et les journaux d'e-mails plus courts (30 à 60 jours) car ils sont principalement utilisés pour le dépannage récent.

Activation de la suppression automatique pour les types de journaux

Même avec le commutateur global Activer la suppression automatique activé, vous devez activer la suppression automatique pour chaque type de journal individuellement.

Pour activer la suppression automatique pour un type de journal :

1. Assurez-vous que le commutateur global Activer la suppression automatique est activé.
2. Recherchez le type de journal que vous souhaitez supprimer automatiquement.
3. Activez son commutateur d'activation individuel.
4. Définissez la valeur souhaitée pour Jours à conserver (si différente de la valeur par défaut).

Les paramètres sont enregistrés automatiquement lorsque vous basculez ou vous éloignez des champs de saisie.

Pour désactiver la suppression automatique pour un type de journal spécifique tout en en gardant d'autres activés :

1. Recherchez le type de journal que vous souhaitez exclure.
2. Désactivez son commutateur d'activation individuel.

Le paramètre est enregistré automatiquement, et ce type de journal ne sera plus supprimé automatiquement, même si le commutateur global reste activé.

---

Planification de la suppression automatique

Lorsque la suppression automatique est activée, Easy Digital Downloads exécute les opérations de suppression une fois par jour pendant les heures creuses pour minimiser l'impact sur les performances de votre boutique.

Comment fonctionne la suppression automatique

Heure : Les opérations de suppression s'exécutent quotidiennement entre 1h00 et 6h00 UTC. Chaque type de journal est traité à une heure décalée, séparée par 15 à 45 minutes.

Processus : Lors de chaque opération de suppression :

1. Easy Digital Downloads identifie les journaux plus anciens que la période de rétention configurée.
2. Les journaux sont supprimés par lots en fonction de la taille de lot configurée.
3. Le traitement continue jusqu'à ce que tous les journaux éligibles soient supprimés.
4. L'opération se termine et attend la prochaine exécution planifiée.

Ce qui est purgé : Seuls les types de journaux dont le commutateur global et le commutateur de type de journal individuel sont activés sont automatiquement purgés. Les types de journaux désactivés sont entièrement ignorés.

Surveillance de la purge automatique

Les opérations de purge automatique s'exécutent silencieusement en arrière-plan. Vous ne recevrez pas de notifications lorsque la purge sera terminée, mais vous pouvez vérifier qu'elle fonctionne en :

• Vérifiant le nombre de vos journaux avant et après l'heure de purge planifiée
• Examinant manuellement les entrées de journal pour confirmer que les anciens journaux sont supprimés
• Utilisant le bouton manuel Purger maintenant pour tester vos paramètres de rétention

---

Purge manuelle

Parfois, vous devez purger les journaux immédiatement plutôt que d'attendre la planification automatique. Le bouton Purger maintenant permet un nettoyage des journaux à la demande.

Quand utiliser la purge manuelle

La purge manuelle est utile lorsque vous devez :

• Nettoyer les journaux immédiatement après avoir modifié les paramètres de rétention
• Libérer de l'espace base de données avant une importation ou une mise à jour majeure
• Tester votre configuration de rétention sans attendre la planification automatique
• Supprimer les anciens journaux avant d'activer la purge automatique
• Effectuer la maintenance selon un calendrier spécifique en dehors de l'horaire automatique

Utilisation de la purge manuelle

Pour purger manuellement les journaux d'un type de journal spécifique :

1. Accédez à Téléchargements > Outils > Journalisation des événements.
2. Cliquez sur l'onglet Paramètres.
3. Trouvez le type de journal que vous souhaitez purger.
4. Cliquez sur le bouton Purger maintenant pour ce type de journal.
5. Attendez que l'opération soit terminée.

Ce qui se passe : Lorsque vous cliquez sur Purger maintenant, Easy Digital Downloads commence immédiatement à supprimer les journaux plus anciens que la période de rétention configurée pour ce type de journal. L'opération traite les journaux par lots en fonction de la taille de lot configurée et continue jusqu'à ce que tous les journaux éligibles soient supprimés.

Vous verrez un retour d'information sur la progression pendant l'opération de purge. Une fois terminée, vous verrez un message de confirmation.

Important : La purge manuelle respecte votre paramètre de période de rétention actuel. Si vous souhaitez purger de manière plus agressive, ajustez le paramètre Jours à conserver avant de cliquer sur Purger maintenant, puis modifiez-le à nouveau par la suite si nécessaire.

Configuration de la purge manuelle uniquement

Si vous préférez purger les journaux manuellement plutôt qu'automatiquement, vous pouvez configurer Easy Digital Downloads pour un fonctionnement manuel uniquement :

1. Activez le commutateur global Activer la purge automatique.
2. Désactiver la bascule individuelle pour chaque type de journal.
3. Définissez vos valeurs Jours de conservation souhaitées.

Les paramètres sont enregistrés automatiquement. Vous pouvez maintenant utiliser les boutons Nettoyer maintenant pour nettoyer les journaux selon votre propre calendrier, et le nettoyage quotidien automatique n'aura pas lieu.

---

Meilleures pratiques

Commencer par la rétention des journaux

Si vous configurez les paramètres de rétention des journaux pour la première fois :

1. Commencer par les valeurs par défaut – Les périodes de rétention par défaut (90 jours pour les téléchargements de fichiers, 30-60 jours pour les autres journaux) conviennent à la plupart des boutiques.
2. Activer progressivement – Activez la suppression automatique pour un type de journal à la fois afin d'observer l'impact.
3. Surveiller votre base de données – Vérifiez la taille de la base de données avant et après le nettoyage pour comprendre les économies d'espace.
4. Tester manuellement d'abord – Utilisez Nettoyer maintenant pour tester votre configuration avant d'activer la suppression automatique.

Ajustement des périodes de rétention

Lorsque vous décidez combien de temps conserver les journaux :

Pour les téléchargements de fichiers :

• Considérez la durée la plus longue de votre abonnement ou de votre licence si vous utilisez Software Licensing ou Recurring Payments
• Tenez compte de votre fenêtre de support client (jusqu'à quand les clients vous contactent-ils ?)
• Équilibrez l'historique de la page de téléchargement client avec l'efficacité de la base de données

Pour les erreurs de paiement :

• Conservez au moins 30 jours pour le dépannage récent
• Une rétention plus longue (60-90 jours) aide à identifier les problèmes récurrents de passerelle de paiement

Pour les requêtes API :

• Adaptez vos besoins de débogage et de surveillance
• Considérez les cycles de test d'intégration et les modèles d'accès des développeurs

Pour les journaux d'e-mails :

• Conservez au moins 30 jours pour répondre aux demandes des clients « Je n'ai pas reçu mon e-mail »
• Une rétention plus longue est rarement nécessaire, sauf si vous avez des exigences de conformité spécifiques

Optimisation de la taille des lots

La taille de lot idéale dépend de votre environnement d'hébergement :

Hébergement mutualisé :

• Les 250 entrées par lot par défaut conviennent à la plupart des environnements d'hébergement mutualisé
• Si vous rencontrez des problèmes de performance lors du nettoyage, réduisez la taille du lot à 100-150
• Surveillez la charge du serveur pendant les périodes de nettoyage et ajustez si nécessaire

Hébergement géré, VPS ou dédié :

• Commencez avec les 250 entrées par lot par défaut
• Augmentez à 500-750 si vous avez de gros volumes de journaux et de bonnes ressources serveur
• Surveillez les performances et ajustez à la hausse pour une meilleure efficacité

Trafic élevé ou entreprise :

• Utilisez 500 à 1 000 entrées par lot pour une suppression plus rapide
• Surveillez les performances de la base de données pendant les opérations de suppression
• Envisagez de planifier une suppression manuelle pendant les fenêtres de maintenance pour des volumes de journaux extrêmement importants

Compatibilité des extensions

Si vous utilisez des extensions qui dépendent des données des journaux :

Licences logicielles :

• Les journaux de téléchargement de fichiers prennent en charge l'application des limites de téléchargement et l'historique des téléchargements des clients
• Envisagez de faire correspondre la rétention à votre cycle de renouvellement de licence typique
• Minimum recommandé : 90 jours

Accès illimité :

• Les journaux de téléchargement suivent l'accès aux fichiers sur plusieurs produits
• Une rétention plus longue fournit un meilleur historique des téléchargements des clients
• Si vous utilisez l'Accès illimité avec Commissions, les journaux de téléchargement de fichiers sont requis pour déterminer les montants des commissions pour chaque période de facturation de Pass
• Minimum recommandé : 90 jours

Pages de téléchargement :

• Crée des pages de téléchargement spécifiques au client montrant l'historique des téléchargements
• Des périodes de rétention plus courtes limitent la profondeur de l'historique consultable par les clients
• Tenez compte de votre fenêtre de support client lors de la définition de la rétention

Paiements récurrents :

• Journaux de téléchargement associés aux produits d'abonnement
• Faites correspondre la rétention à vos cycles de facturation d'abonnement lorsque cela est possible
• Minimum recommandé : 90 jours

---

Dépannage

Suppression automatique non exécutée

Si les journaux ne sont pas automatiquement supprimés :

1. Vérifiez que le commutateur global Activer la suppression automatique est activé.
2. Vérifiez que le commutateur individuel du type de journal est activé.
3. Confirmez que vos paramètres ont été enregistrés (les paramètres s'enregistrent automatiquement lorsque vous basculez ou quittez des champs).
4. Vérifiez l'état de votre cron WordPress (la suppression automatique utilise le cron WordPress).
5. Vérifiez si vous avez un plugin de mise en cache qui pourrait affecter l'exécution du cron.

Test de la planification : Utilisez le bouton Supprimer maintenant pour vérifier que vos paramètres de rétention sont corrects. Si la suppression manuelle fonctionne mais pas la suppression automatique, le problème est probablement lié au cron WordPress plutôt qu'à votre configuration de rétention des journaux.

Problèmes de performance pendant la suppression

Si votre site ralentit pendant la suppression :

1. Réduisez la taille de votre lot pour traiter moins de journaux par cycle.
2. Vérifiez les ressources de votre serveur pendant les heures de suppression (01h00-06h00 UTC).
3. Envisagez d'utiliser la suppression manuelle pendant les fenêtres de maintenance planifiées au lieu de la suppression automatique.
4. Vérifiez l'indexation de votre base de données (les tables de journaux bien indexées sont supprimées plus efficacement).

Trop de données supprimées

Si vous perdez des journaux que vous souhaitiez conserver :

1. Augmentez le paramètre Jours à conserver pour les types de journaux affectés.
2. Vérifiez quand la dernière suppression automatique a eu lieu (elle s'exécute quotidiennement).
3. Utilisez des périodes de rétention plus longues si vous avez besoin de données historiques pour le reporting.
4. Envisagez de désactiver la suppression automatique pour des types de journaux spécifiques que vous souhaitez conserver indéfiniment.

Pas assez de données supprimées

Si la suppression ne libère pas suffisamment d'espace dans la base de données :

1. Diminuez le paramètre Jours à conserver pour supprimer de manière plus agressive.
2. Vérifiez que les journaux plus anciens que votre période de rétention existent réellement (vérifiez les dates des journaux).
3. Utilisez Supprimer maintenant pour traiter immédiatement tous les journaux éligibles.
4. Vérifiez si votre base de données a besoin d'optimisation après de grosses suppressions (consultez votre fournisseur d'hébergement).

---

Questions fréquemment posées

Dois-je perdre l'accès aux téléchargements des clients si je supprime les journaux de téléchargement de fichiers ?

Non. Les entrées de journal enregistrent les téléchargements historiques qui se sont déjà produits. La suppression de ces journaux n'affecte pas les autorisations de téléchargement des clients ni leur capacité à télécharger des fichiers à l'avenir. Les clients peuvent toujours télécharger leurs fichiers achetés, quelles que soient les paramètres de rétention des journaux.

Cependant, les journaux de téléchargement fournissent un contexte historique que certaines extensions utilisent pour le reporting et les fonctionnalités destinées aux clients. Voir la section Compatibilité des extensions ci-dessus pour plus de détails.

Puis-je récupérer les journaux après leur suppression ?

Non. La suppression supprime définitivement les entrées de journal de votre base de données. Assurez-vous que vos périodes de rétention sont appropriées avant d'activer la suppression automatique. En cas de doute, commencez par des périodes de rétention plus longues et diminuez-les progressivement.

Combien d'espace de base de données la suppression permettra-t-elle d'économiser ?

Les entrées de journal individuelles ne prennent généralement pas beaucoup de place, mais les économies d'espace réelles peuvent varier en fonction de votre configuration MySQL, des index de base de données et de la surcharge des tables. Les boutiques à fort trafic avec de nombreux téléchargements, une utilisation fréquente de l'API ou des journaux d'e-mails étendus verront des économies d'espace plus significatives. Les boutiques à faible trafic peuvent avoir un impact minime.

Les résultats peuvent varier en fonction de la configuration de la base de données de votre environnement d'hébergement. Pour estimer les économies potentielles pour votre boutique, examinez le nombre de vos journaux avant la suppression, puis comparez la taille de la base de données avant et après votre première opération de suppression.

La suppression affecte-t-elle les performances du site ?

Les opérations de suppression sont conçues pour avoir un impact minimal sur les performances du site. Le traitement s'effectue par petits lots pendant les heures creuses (1h-6h UTC), et chaque type de journal est décalé pour répartir la charge.

Si vous constatez des impacts sur les performances, réduisez la taille de vos lots pour traiter moins de journaux par cycle.

Puis-je définir des périodes de rétention différentes pour différents téléchargements de fichiers ?

Non. Les paramètres de rétention des journaux s'appliquent à tous les journaux de ce type. Vous ne pouvez pas configurer différentes périodes de rétention pour des produits, clients ou autres critères spécifiques. Tous les journaux de téléchargement de fichiers suivent la même période de rétention.

Que se passe-t-il si je désactive la suppression automatique après l'avoir activée ?

La désactivation de la suppression automatique (globalement ou pour des types de journaux individuels) arrête les futures opérations de suppression planifiées. Elle ne restaure pas les journaux précédemment supprimés. Vos journaux existants resteront dans la base de données dans leur état actuel jusqu'à ce que vous réactiviez la suppression automatique ou utilisiez la suppression manuelle.

Dois-je supprimer les journaux avant de sauvegarder ma base de données ?

Cela dépend de votre stratégie de sauvegarde. Si la taille de la base de données est une préoccupation pour vos sauvegardes, la suppression avant la sauvegarde peut réduire la taille du fichier de sauvegarde et les coûts de stockage. Cependant, si vous souhaitez des enregistrements historiques complets dans vos sauvegardes, conservez les journaux jusqu'à la fin de la sauvegarde.

De nombreux propriétaires de boutiques suppriment les journaux après la fin des sauvegardes pour s'assurer que les données historiques sont préservées dans les archives de sauvegarde.

---

Résumé

Les paramètres de rétention des journaux vous offrent un contrôle flexible sur vos données de journaux Easy Digital Downloads. En configurant des périodes de rétention appropriées, en activant la suppression automatique et en optimisant les tailles de lots pour votre environnement d'hébergement, vous pouvez maintenir une base de données légère et efficace tout en préservant les données de journaux dont vous avez besoin pour les opérations, le support client et les rapports.

Commencez avec les paramètres par défaut, ajustez en fonction des besoins spécifiques de votre boutique et surveillez les résultats pour trouver la configuration qui convient le mieux à votre boutique.