Einrichtung monitor-analytics Web App

Installation der Webapp

Für die Installation der Usagelog Webapp des service.monitor Analytics deployen Sie die ausgelieferte war-Datei ([CD-CONTENTS]/software/analytics/web/monitor-analytics.war) im gewünschten Servlet Container.

Für die Änderung des Standardkonfiguration, kopieren Sie die application.properties Datei (\monitor-analytics\WEB-INF\classes\custom-application.properties) nach [data.directory.location]/application.properties, ändern Sie die gewünschten Werte und starten Sie den Servlet Container neu oder aktualisieren Sie den Context.

Dies kann erforderlich sein, wenn Elasticsearch auf einen anderen Host als http://localhost:9200 ausgeführt wird. In diesem Fall muss die Service URL geändert werden, sodass sich die Webapp mit Elasticsearch verbindet. Sollte Elasticsearch Nutzernamen und Password verlangen, so können diese hier auch konfiguriert werden.

application.properties
analytics.elasticsearch.service.url=http://myserver:9200/analytics-*/_search
analytics.elasticsearch.service.user=<user>
analytics.elasticsearch.service.pwd=<password>

Das Lizenzverzeichnis kann durch Ändern der Eigenschaft analytics.license.dir angepasst werden.

Die Datei \monitor-analytics\WEB-INF\classes\default-application.properties bietet einen Übersicht aller Standardwerte der genutzten Eigenschaften.

Die service.monitor Analytics Webapp dient als Sicherheitslayer für Anfragen an die Elasticsearch-Indizes. Zum Schutz der gespeicherten Daten gegen ungewünschten Zugriff wird die Änderung folgender Einstellungen AUSDRÜCKLICH EMPFOHLEN

  • security.user.admin.name

  • security.user.admin.pw

Außerdem sollte ein Hash-Algorithmus für die Verschlüsselung gewählt werden. Dazu sollte dem Wert von security.user.pwenc einer der folgenden Algorithmen zugewiesen werden MD5 | SHA-1 | SHA-256 | SHA-384 | SHA-512

Beachten Sie, dass security.user.admin.pw anschließend das verschlüsselte Passwort speichert, z.B

security.user.pwenc=SHA-256
security.user.admin.pw=b18474123c790f30c300b6bb9ee146a4959b6bcd5eef20244b925d69ea996690

Bei Installation des Logstash Dienstes auf einen anderen Host als localhost, ist es notwendig, diesen über die application.properties zu konfigurieren;

application.properties
analytics.gelf.server=myserver.domain.de
analytics.gelf.port=12201

Zusätzlich kann der Port für die ausgehenden, erfassten Daten geändert werden. Wenn der Port in der application.properties Datei angepasst wird, so muss analog der Port für eingehende Daten in der Logstash Konfiguration [CD-CONTENTS]/software/analytics/elasticsearch/logstash/pipelines/ct-analytics/logstash-analytics-100-input.conf geändert und geöffnet werden.

Damit die Änderungen wirksam werden, muss anschließend muss die zugehörige Komponente neu gestartet werden.