Rapports

La génération de rapports est un processus qui exige des ressources importantes. Elle implique la collecte d'informations diverses provenant de plusieurs tables d'une base de données et leur fusion en un document unifié. Examinons les défis susceptibles de survenir lors de la création de rapports sur une instance On-Premise. Ces problèmes proviennent principalement du matériel du serveur, mais leur détection est souvent discrète. Il est donc impératif de comprendre de manière exhaustive les causes sous-jacentes.

Les rapports ne sont pas créés

Ceci est un problème assez courant sur les instances autonomes Navixy qui ne sont pas correctement administrées. Lorsque vous tentez de générer un rapport, vous voyez une indication de chargement, mais cela prend une durée infinie et le rapport n'est pas réellement généré. Si vous ouvrez l'onglet Réseau des outils de développement de votre navigateur, vous pouvez voir que la requête API pour la génération du rapport échoue avec 504 Gateway Time-out erreur.

La raison est un espace disque libre insuffisant. Si votre plateforme fonctionne sur deux serveurs, il s'agit ici du serveur d'application (où les services Java sont exécutés).

La plateforme est configurée pour suspendre les processus gourmands en ressources lorsque le disque est rempli à 99 %. Dans certains cas (sur les instances déployées avant 2022), cela se produit lorsque le disque est rempli à plus de 90 %. Cela vise à préserver les fonctionnalités de base, éviter un débordement complet du disque et vous donner le temps de résoudre le problème.

La première chose à faire est de vérifier que le disque est effectivement plein. Si ce n'est pas le cas, il pourrait s'agir d'une défaillance de la plateforme qui doit être signalée au support technique.

Assurez-vous que le disque a la taille recommandée selon les exigences système pour le matériel serveur. Si l'espace disque est inférieur à la recommandation, vous devez prendre des mesures d'urgence pour l'augmenter.

L'étape suivante consiste à déterminer ce qui a provoqué le débordement du disque. Si vous n'avez que la plateforme Navixy sur votre serveur, l'espace libre est généralement occupé par les journaux de la plateforme. La base de données peut également occuper de l'espace si elle est située sur le même lecteur — elle augmente inévitablement de taille au fil du temps. Dans ce dernier cas, vous devez agir immédiatement, car le manque d'espace libre pour écrire dans la base de données peut entraîner son inopérabilité et une perte d'informations.

Si vous avez de nombreux appareils enregistrés sur votre serveur (plusieurs milliers), les journaux des services backend peuvent occuper une quantité d'espace importante — parfois un seul fichier peut dépasser 1 Go. Cependant, les journaux ne croissent pas indéfiniment, car leur cycle de vie par défaut est de 7 jours, après quoi ils sont supprimés.

Comme solution temporaire (et non recommandée) au problème d'espace en cas d'urgence, vous pouvez supprimer les fichiers journaux des jours précédents, puisqu'ils ne sont pas nécessaires au fonctionnement actuel de la plateforme. Toutefois, gardez à l'esprit que dans une semaine les journaux s'accumuleront à nouveau et occuperont approximativement la même quantité d'espace disque.

La génération des rapports prend beaucoup de temps

Face à ce scénario, il devient crucial d'évaluer le problème en tenant compte à la fois de la période concernée et du nombre d'appareils pour lesquels le rapport est généré. Naturellement, à mesure que le nombre d'appareils et la durée augmentent, la plateforme requiert davantage de temps et de ressources pour récupérer les données nécessaires dans la base de données et générer le rapport.

Causes possibles d'une génération de rapports lente :

• Manque de RAM ou vitesse de disque insuffisante est la raison la plus fréquente. Avec l'augmentation du nombre d'appareils et d'utilisateurs, votre serveur peut commencer à manquer de ressources pour fonctionner efficacement. Vos administrateurs système doivent analyser les performances du serveur.

• Charge élevée sur le serveur pendant les heures de travail. Si vos utilisateurs génèrent de nombreux rapports simultanément, ou si beaucoup de données sont demandées via l'API, cela peut affecter la performance globale de la plateforme.

• Limites excessives pour les rapports. Si vous avez précédemment modifié les limites par défaut, la charge peut augmenter de manière significative.

• Configuration MySQL incorrecte. Si la configuration a été modifiée pour une quelconque raison et diffère de la norme, la base de données elle-même peut ne pas fonctionner efficacement.

• Logiciels superflus sur le serveur ou charge externe sur la base de données. Parfois, des clients utilisent des logiciels tiers (sans lien avec Navixy) sur le même serveur que la plateforme pour effectuer certaines tâches spécifiques. Il arrive même que des logiciels tiers collectent directement des informations depuis la base de données, générant des charges imprévisibles. Cela est fortement déconseillé.

• Mauvais fonctionnement de la plateforme. Malheureusement, des défaillances logicielles se produisent parfois, mais elles sont assez rares ; vous devez donc d'abord exclure toutes les causes ci‑dessus. Si vous êtes certain que la lenteur de génération des rapports est causée par une défaillance de la plateforme, signalez-la au support technique en fournissant toutes les informations qui vous ont permis de parvenir à une telle conclusion.