Sur cette page

Depannage

Commencez par Tester la connexion dans l’onglet Analyse predictive, puis lisez le tableau Previsions : la plupart des problemes y apparaissent avec leur cause.

Connexion

La ligne Etat indique Cause Solution
Non configure Pas d’URL de l’API de prediction. Saisissez l’adresse du service et enregistrez.
Injoignable : … connection refused ou un timeout Le service ne tourne pas, ou un pare-feu bloque le port. Demarrez le service ; testez curl -k https://<hote>:<port>/health depuis l’hote du Webserver.
Injoignable : … does not match the pinned fingerprint Le certificat du service a change (renouvele, reinstalle). Recuperer le certificat, comparez la nouvelle empreinte avec le service, enregistrez.
Injoignable : … certificate signed by unknown authority Aucune empreinte n’est epinglee et le certificat n’est pas reconnu par l’hote du Webserver. Epinglez-le avec Recuperer le certificat, ou installez un certificat reconnu sur le service.
Joignable, mais il refuse la signature de ce webserver Le service n’a pas la cle publique de ce Webserver : jamais copiee, ou la cle a ete renouvelee. Copiez la Cle de signature (publique) dans le fichier PREDICTION_JWT_PUBLIC_KEY du service.
Joignable … status 500: JWT public key not configured or unreadable PREDICTION_JWT_PUBLIC_KEY designe un fichier absent. Corrigez le chemin ; le service lit le fichier des qu’il apparait.
aucune InfluxDB configuree sur le service Le service n’a pas d’INFLUXDB_URL. Renseignez les variables InfluxDB du service et redemarrez-le.

Tableau des previsions

Vous voyez Cause Solution
Aucun moniteur n’a encore la prediction activee Aucun moniteur n’a Activer allume, ou la liste n’est pas encore rafraichie. Activez la prediction sur un moniteur, puis Lancer les predictions maintenant (sinon la liste est rafraichie toutes les 10 minutes).
Modele En attente longtemps Le service entraine un modele a la fois ; les autres attendent leur tour. Patientez. Le /health du service indique la longueur de la file.
Modele Echec, le survol affiche The training query returned no data InfluxDB ne contient rien pour ce moniteur : l’Integrateur n’ecrit pas dans InfluxDB, ou pas dans la base / le bucket que lit le service. Verifiez la sortie InfluxDB de l’Integrateur et les variables INFLUXDB_* du service. L’entrainement est relance apres 24 heures, ou utilisez Entrainer maintenant.
Modele Echec, le survol affiche Not enough history to train: N usable checks, at least 138 needed Trop peu d’historique (un nouveau moniteur, ou un moniteur souvent en echec). Attendez plus de verifications reussies ; l’entrainement est relance toutes les 24 heures.
Modele Echec, le survol affiche Query would scan 432 Parquet files, exceeding the file limit La limite de 72 heures par requete d’InfluxDB 3 Core, avec un service de prediction anterieur a la 1.5. Mettez le service de prediction en version 1.5 ou plus, qui lit l’historique par tranches.
La prevision affiche Aucun nouveau controle depuis … La verification la plus recente trouvee par le service date de plus de trois periodes du moniteur : le moniteur ou sa sonde est arrete, ou l’Integrateur n’ecrit plus dans InfluxDB. La prevision n’est pas a jour et ne declenche aucune alerte. Verifiez le moniteur, sa sonde et la sortie InfluxDB de l’Integrateur. Le message disparait a la prevision suivante une fois les verifications revenues.
Prevision UNKNOWN avec status 503 de temps en temps Le service a refuse la connexion : PREDICTION_MAX_CONNECTIONS trop bas (fixe a 10 avant la 1.5). Mettez le service a jour, ou augmentez PREDICTION_MAX_CONNECTIONS.
Prevision UNKNOWN avec status 502 … InfluxDB file limit Une requete de prevision a atteint la limite de fichiers d’InfluxDB 3 Core meme dans sa plus petite tranche (15 minutes) : une mesure exceptionnellement dense. Augmentez --query-file-limit sur InfluxDB, ou baissez PREDICTION_LOOKBACK_DAYS.
Pas d’intervalle sur le graphique Le modele a ete entraine avant le service 1.5 (il est reentraine une fois, dans l’heure), c’est un modele LSTM, ou l’historique est trop court pour les mesurer. Attendez le reentrainement, ou Entrainer maintenant.
Son comportement a change recemment : l’intervalle est plus etroit qu’il ne devrait Moins de 70 % des verifications recentes du moniteur sont tombees dans son intervalle a 80 %. Entrainer maintenant apres un changement durable ; sinon il est reentraine chaque semaine.
En attente d’un modele Normal jusqu’a la fin du premier entrainement.
Prevision UNKNOWN avec status 400 … Insufficient data Moins de verifications reussies recentes que le modele n’en demande (60). Le moniteur etait en echec ou en pause ; les previsions reprennent avec assez de verifications reussies.
La prevision indique Pas d’alerte de prevision : … L’historique du moniteur n’annonce pas assez ses depassements pour qu’un avertissement soit fiable ; la fin de la ligne indique pourquoi (pas de seuil, pas assez d’historique, trop peu de depassements passes, pas de signe avant-coureur, trop souvent faux). Voir Risque de depassement. En general rien a corriger : ces depassements arrivent sans prevenir, et les alertes d’anomalie fonctionnent toujours. Sans seuils, renseignez les seuils mineur / majeur / critique du moniteur.
La prevision indique Alertes de prevision suspendues : reentrainement Les seuils ou le nombre de previsions ont change depuis l’entrainement du modele. Rien : le modele se reentraine a la prevision suivante. Avec Entrainement manuel uniquement, utilisez Entrainer maintenant.
Prevision toujours OK Le risque de depassement reste sous le seuil de declenchement du moniteur. Normal pour un moniteur sain. Le survol indique la part d’avertissements justes sur son historique.
Prevision plate ou tres eloignee Historique tres court ou tres irregulier, ou changement de comportement recent. Entrainer maintenant apres le changement ; regardez l’erreur du modele (colonne Entraine).
Un moniteur manque au tableau Sa sonde n’a pas repondu au dernier rafraichissement, ou ce type de moniteur n’est pas prevu (EUM, SNMP, WMI, journaux, repertoires). Verifiez la sonde. Une sonde qui ne repond pas garde ses moniteurs precedents dans la liste.

Alertes

Probleme Cause Solution
Aucune alerte predictive Envoyer des alertes predictives est desactive, ou le moniteur n’a aucun canal active au changement de statut. Activez les deux. Les alertes predictives n’utilisent jamais les canaux en cas d’echec.
Alerte attendue mais non envoyee Un nouvel etat doit tenir sur deux previsions consecutives ; ou l’Integrateur a ce canal desactive. Attendez une prevision de plus ; verifiez le canal dans les parametres de l’Integrateur.
Seulement les alertes de prevision (ou d’anomalie) Alerter sur limite le type. Choisissez Depassement prevu et anomalie.
Le Webserver journalise sendPredNotice … buffering for retry L’Integrateur est injoignable ou anterieur a cette fonction (repond 404). Demarrez ou mettez a jour l’Integrateur. Les alertes en tampon sont retentees pendant une heure.

Journaux

Composant Ou Chercher
Webserver log/webserver.log runPrediction, predMonitors, queuePredTraining, runPredictionTrainingScan, sendPredNotice
Service de prediction sa console, journalctl -u mugnsoft-prediction, ou docker logs prediction training <modele>, trained <modele>, training ... failed, Invalid token
Integrateur log/integrator.log data2integratorHandler - [prediction], forecast_

Traductions

Seuils