Migrationsleitfaden IsyFact 5.x

Die auf dieser Seite aufgeführten Hinweise sollen der Entwicklung bei der Umstellung einer auf IsyFact 4.x basierenden Anwendung auf IsyFact 5.x helfen.

1. Geschäftsanwendung

…​

2. Bausteine

2.1. isy-persistence

2.1.1. Änderungen

Der Baustein JPA/Hibernate wurde aufgelöst.

2.1.2. Auswirkung

Damit entfällt die Bibliothek isy-persistence. Hilfsfunktionen zur Definition von Enums und zur Prüfung der Schema-Version wurden in den Baustein Util in die Bibliothek isy-util verschoben. Alle weitere Funktionalität entfällt und wird durch die direkte Verwendung des Produkts Spring Data ersetzt.

2.2. isy-ueberwachung

2.2.1. Änderungen

Mit der Version 5.0.0 von isy-ueberwachung wurden die folgenden zeitbeschränkten Metriken entfernt:

  • AnzahlAufrufeLetzteMinute: Anzahl der Anrufe in der letzten Minute

  • AnzahlTechnicalExceptionsLetzteMinute: Anzahl der technischen Fehler in der letzten Minute

  • AnzahlBusinessExceptionsLetzteMinute: Anzahl der geschäftlichen Fehler in der letzten Minute

Diese Metriken waren zuvor über die ServiceStatistik-Schnittstelle verfügbar und wurden automatisch bei Micrometer in der IsyMetricsAutoConfiguration registriert.

2.2.2. Auswirkung

Anwendungen, die auf diese Metriken zur Überwachung oder Alarmierung angewiesen sind, müssen ihre Überwachungskonfigurationen anpassen. Die übrigen Metriken ohne Zeitbeschränkung funktionieren weiterhin normal:

  • AnzahlAufrufe: Gesamtzahl der Anrufe

  • AnzahlTechnicalExceptions: Gesamtzahl der technischen Fehler

  • AnzahlBusinessExceptions: Gesamtzahl der fachlichen Fehler

  • DurchschnittsDauerLetzteAufrufe: Durchschnittsdauer der letzten Anrufe (Defaultwert: 10)

2.2.3. Hinweis

Mithilfe der in Prometheus verfügbaren Funktionen lässt sich die gewohnte Funktionalität nahezu vollständig nachbilden.

3. Dokumentation

…​