Release Notes 4.6

What’s New

ArcGIS SOC Prozess-Analyse

Auf Basis von System-Metriken sind nun Analysen auf Basis von Kennwerten von ArcSOC-Prozessen möglich. Dies umfasst die Entwicklung der Prozess-Anzahl, deren Speicherplatz-Nutzung und CPU-Bedarf. Die Diagramme ermöglichen somit die Beurteilung der aktuellen und historischen Systemauslastung von ArcGIS Server Hosts. Der Betrieb kann einschätzen, wie stark die Systemlast durch ArcGIS-Server-Anfragen über den Tagesverlauf variiert oder sich langfristig entwickelt. Durch diese Informationen können bestehende Ressourcen-Engpässe erkannt oder Planungsbedarf für Systemskalierung erkannt werden.

Systemweite Benachrichtungen im Ausnahmefall

Die in Elasticsearch gesammelten Daten von service.monitor können nun als Auslöser für Nachrichten aus dem service.monitor Benachrichtigungssystem dienen. Mögliche Anwendungsfälle sind zum Beispiel:

  • CPU-Last auf dem ArcGIS Server seit 5 Minuten über 95%

  • Mehr als 10 ERROR-Log-Meldungen aus con terra Anwendungen in den letzten 15 Minuten

  • Fehlgeschlagene FME-Server Jobs

Updatehinweise

Falls Sie bei dem Update mehrere Versionen überspringen, befolgen Sie bitte auch alle Update-Hinweise der dazwischenliegenden Versionen.
Im Zuge eines Upgrades müssen alle Elasticsearch zugehörigen Objekte wie Pipelines, Templates, Kibana Diagramme und Ingest Pipelines aktualisiert werden.

Properties

Die Properties der beiden Webapplikationen monitor und monitor-analytics sind angeglichen und mit den anderen con terra Produkten harmonisiert worden. Dies betrifft die Properties des Mailing:

  • mail.host wird zu mailing.host.
    Diese Änderung muss in externen application.properties-Dateien nachgetragen werden.

Aktualisierung von Elastic Index Lifecycle Management Policies & Templates

Wenn bereits service.monitor 4.5 eingesetzt wird, wird eine Aktualisierung der Index Lifecyle Policies und Index Templates für die eingesetzten Datenquellen nötig (resources/analytics/elasticsearch/dev-console). In den Templates wird ein Fehler mit der alias-Konfiguration behoben und das Verwenden von Elastic Ingest Pipelines verankert.

Ist seit Version 4.5 bereits die Datenquelle zu map.apps Nutzerinteraktionen aktiv, dann müssen folgende Schritte ausgeführt werden (SRVMON-718):

  • Aktualisierung von ILM und Index Template wie oben beschrieben

  • Ausführen der einzelnen Statements unten, dazu muss -000001 mit dem Wert des aktuellsten Index ausgetauscht werden (dies kann für die einzelnen Indizes unterschiedlich sein)

Update analytics usagelog indices config
POST ct-analytics-app*/_alias/analytics-usagelog-app
POST ct-analytics-app-000001/_alias/analytics-usagelog-app
{"is_write_index":true}


POST ct-analytics-map*/_alias/analytics-usagelog-map
POST ct-analytics-map-000001/_alias/analytics-usagelog-map
{"is_write_index":true}

POST ct-analytics-log*/_alias/analytics-usagelog-log
POST ct-analytics-log-000001/_alias/analytics-usagelog-log
{"is_write_index":true}

POST ct-analytics-server*/_alias/analytics-usagelog-server
POST ct-analytics-server-000001/_alias/analytics-usagelog-server
{"is_write_index":true}

POST ct-analytics-tool*/_alias/analytics-usagelog-tool
POST ct-analytics-tool-000001/_alias/analytics-usagelog-tool
{"is_write_index":true}

DELETE ct-analytics-app*/_alias/ct-analytics-app
DELETE ct-analytics-tool*/_alias/ct-analytics-tool
DELETE ct-analytics-map*/_alias/ct-analytics-map
DELETE ct-analytics-log*/_alias/ct-analytics-log
DELETE ct-analytics-server*/_alias/ct-analytics-server

Im Falle der Verwendung von service.monitor mit FME Server Jobs sind ebenso manuelle Anpassungen nötig, falls die Funktionalität bereits eingesetzt wird (SRVMON-733). Durch einen Fehler kam es hier zu einer falschen Zuordnung von Indexen, Alias und Patterns (ct-fme-jobs vs. ct-fme-job).

Die Bestandsdaten müssen in das unter ILM-Verwaltung stehende Index-Pattern ct-fme-jobs-* kopiert werden. Dies geschieht über eine Reindexierung in den Alias ct-fme-jobs. Danach kann der Alt-Index ct-fme-job entfernt werden.

Correct FME Jobs Index data location
# re-index pre-existing entries to index alias
POST _reindex?wait_for_completion=false
{
  "source": {
    "index": "ct-fme-job"
  },
  "dest": {
    "index": "ct-fme-jobs"
  }
}
# once re-indexing has finished and after verifying all fme jobs have been transfered, the old index is safe to delete
DELETE /ct-fme-job

# same procedure for fme jobroutes
POST _reindex?wait_for_completion=false
{
  "source": {
    "index": "ct-fme-jobroute"
  },
  "dest": {
    "index": "ct-fme-jobroutes"
  }
}
DELETE /ct-fme-jobroute

Benachrichtigungen: Aktualisierung des Monitoring Datenbankschemas

Bitte führen Sie das SQL-Skript für Ihre Datenbank unter resources/sql/upgrade/4.6 aus.

Monitoring: Oracle DB Datentyp-Prüfung

Falls Soe Oracle DB nutzen: Bitte prüfen Sie, ob bereits mit dem letzten Upgrade resources/sql/upgrade/4.5/oracle-schema-changes.sql ausgeführt wurde.

Analytics Bundles für map.apps

Die Bundles zur Erhebung der Nutzerinteraktionen folgen nun einem eigene Release Zyklus und sind von z.B. usagelog_restservice nach analytics_restservice umbenannt worden. Dies muss bei der Referenzierung der Bundles in der app.json oder den application.properties von map.apps beachtet werden.

Ausgelaufene Unterstützung

map.apps basierte Dashboards

Die im map.apps Manager verankerten Analytics-Dashboards sind nicht mehr Teil dieses Releases. Sämtliche Dashboard-Weiterentwicklungen werden in Elastic Kibana stattfinden. Sollten Sie weiterhin die map.apps basierten Dashboards verwenden wollen, so können Sie die entsprechenden Bundles aus Version 4.5 verwenden. Zusätzlich muss in map.apps die Fähigkeit zum Betrieb von Linie 3 App wiederhergestellt werden. In diesem Fall wird der Einsatz der Dashboards als map.apps App und nicht innerhalb des map.apps Managers empfohlen.

Monitoring Diagramme

Die Fähigkeit zur grafischen Darstellung von Monitoring-Daten in der montoring-Webapplikation wurde entfernt. Aktivieren Sie alternativ das Übersenden von Monitoring-Ereignissen an Elastic und nutzen die Monitoring Kibana Dashboards.

Monitoring UI-Designs

Für das UI-Layout der Monitoring-Komponente wird nur noch das everlasting benannte Design unterstützt.

weiteres

  • Apache Tomcat 8 (Monitoring Webapplikation)

  • Java 8 (Monitoring Webapplikation)

Abkündigungen

  • INSPIRE-Fähigkeiten von Monitoring (Rules)

Bekannte Einschränkungen

Die folgende Liste enthält zum Veröffentlichkeitszeitpunkt bekannte Probleme der Version 4.6:

Issue Komponente Beschreibung

SRVMON-88

Monitoring

Provisioning of means to monitor INSPIRE Quality of Service requirements

Changelog

4.6.1

Fixed Issues

SRVMON-671

[Usagelog API] Attempt to access the attribute resolution of an undefined object

SRVMON-734

info.txt - property "info" is not filled correctly for monitor and monitor-analytics webapp

SRVMON-737

Web applications do not log due to wrong log4j2 dependency

SRVMON-738

Accessing monitor alerting page does not check user’s authentication status

SRVMON-745

Docs: Link to support site in wrong language

SRVMON-735

FME Jobs Dashboard - Engine Workload hover info does not contain correct date values & multiple engines are not reflected

SRVMON-747

FME Jobs Dashboard - Jobs only shown when start and end time differs in minutes or hours

4.6.0

New Features

SRVMON-723

Extension of the Analytics/map.apps dashboards

SRVMON-702

Bind notification template to a "harvested" Kibana Rule

SRVMON-701

ArcSOC Metric Analysis

SRVMON-699

Enable user notification of Elastic Alert Rules via monitoring

SRVMON-698

Kibana Dashboard for Monitoring data

SRVMON-697

Create monitoring event data Elastic Ingest Pipeline for extracting folder, service, host

SRVMON-694

[Elastic Alerting] Send user notification for Elastic Index Alerts through monitoring

SRVMON-690

Replace classical Monitoring diagrams w/ new Kibana Monitoring Dashboards

SRVMON-684

Provide Docker Image for service.monitor Monitoring

SRVMON-678

Provide map.apps Analytics integration for new search UI

Fixed Issues

SRVMON-733

Index-Pattern, Alias and Index Template Pattern are wrongly configured for fme-job harvesting

SRVMON-722

ArcGIS timeout analysis is faulty

SRVMON-718

[ILM] Inconsistent alias definition stops index rollover from working

SRVMON-673

Implementation in map.apps fails due to missing 'X-Frame-Options' 'sameorigin'

SRVMON-729

"Hilfe"-Link points to wrong location (Monitoring Dashboard)

SRVMON-663

Allow ArcGIS elapsed time values to be read using both floating point and floating comma format