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. |
| 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_ |