Integration mit anderen con terra Produkten / Server-seitiges Logging

service.monitor Analytics kann in andere Produkte integriert werden, so dass auch dort aktive Daten über die Nutzung der Applikationen gesammelt werden. Ist die Integration erfolgt, werden folgende Parameter beim Zugriff des Clients mitprotokolliert:

  • grundlegende HTTP Anfrageparameter (URL, Protokoll)

  • grundlegende HTTP Antwortparameter (Dauer HTTP Status Code)

  • User Agent

  • Authentifizierungsinformationen

  • Client IP

Integration mit con terra security.manager

Um Informationen über Requests an security.manager zu sammeln, muss der der Installation zugehörige GelfWebSecurityProcessor aktiviert werden. Der Prozessor sendet seine Daten üblicherweise per UDP Protokoll an die Logstash Pipeline, alternativ ist TCP-Versand möglich.

Installations- und Konfigurationsschritte

  1. Die *.jar Dateien aus [CD-CONTENTS]/analytics/web/service-log/lib

    1. nach [security.manager]/webapps/wss/WEB-INF/lib

    2. nach [security.manager]/webapps/administration/WEB-INF/lib

  2. Die Datei [CD-CONTENTS]/analytics/web/service-log/security.manager-<version>/spring-filter-config-administration.xml:

    1. nach [security.manager]/webapps/administration/WEB-INF/classes/spring-filter-config.xml

  3. Die Datei [CD-CONTENTS]/analytics/web/service-log/security.manager-<version>/spring-filter-config-wss.xml:

    1. nach [security.manager]/webapps/wss/WEB-INF/classes/spring-filter-config.xml

  4. Die konkrete Definition der Verbindungsparameter erfolgt in [SECURITY_MANAGER_DATA_FOLDER]/application.properties

    analytics.gelf.server=myserver.domain.de
analytics.gelf.port=12201
analytics.message.src=security.manager
analytics.log.enabled=true

  5. Der Servlet-Container muss nach erfolgter Änderung neu gestartet werden.

Integration mit con terra map.apps

Um Informationen über Requests an map.apps zu sammeln, muss der der Installation zugehörige GelfWebSecurityFilter aktiviert werden. Der Prozessor sendet seine Daten üblicherweise per UDP Protokoll an die Logstash Pipeline, alternativ ist TCP-Versand möglich.

Installations- und Konfigurationsschritte

  1. Die *.jar Dateien aus [CD-CONTENTS]/analytics/web/service-log/lib

    1. nach [map.apps]/WEB-INF/lib

  2. Die Datei [CD-CONTENTS]/analytics/web/service-log/map.apps-<version>/spring-filter-config.xml nach [map.apps]/WEB-INF/classes/spring-filter-config.xml kopieren

    1. Die konkrete Definition der Verbindungsparameter erfolgt in [MAP_APPS_DATA_FOLDER]/application.properties

      analytics.gelf.server=myserver.domain.de
analytics.gelf.port=12201
analytics.message.src=map.apps
analytics.log.enabled=true

  3. Der Servlet-Container muss nach erfolgter Änderung neu gestartet werden.

Übersicht der Integration von map.apps und security.manager

security.manager
Version Kommentar

< 4.15

Bitte aktualisieren Sie zunächst security.manager

4.15 - 4.18

Vorgehen wie oben beschrieben

ab 4.19

wss-Webapplikation ist bereits für die Integration vorbereitet, Konfiguration über application.properties
map.apps
Version Kommentar

ab 4.7

Vorgehen wie oben beschrieben

Integration mit anderen con terra Produkten

Viele con terra Produkte unterstützen die oben dargestellten Integrationswege mit service.monitor Analytics. Bitte fragen Sie nach Support Plus oder Dienstleistungen für zusätzliche Unterstützung.

Logging-Parameter

useragent

Informationen über Browsers und Betriebssystem.

Beispiel:

"user_agent": "Mozilla/5.0 (Windows NT 6.1; WOW64; rv:41.0) Gecko/20100101 Firefox/41.0"
client_ip

Anonymisierte Client IP

Beispiel:

"client_ip": "123.12.12.000"
request

Informationen zu Anfrage-Parametern

Beispiel:

"request": {
  "server_host": "test.remote.host.com",
  "url_query": "?queryProperty=testvalue",
  "server_context: "/wss",
  "referrer": "http://www.mytest.de",
  "protocol": "https"
}
auth

Authentifizierungsinformationen

Beispiel:

"auth": {
  "authenticated": true,
  "user_id": "userA",
  "login_time": "2011-17-10 11:17:50",
  "group_name": "sampleGroup",
  "roles": [
    "admin",
    "editor"
  ]
}
response

Informationen zu Antwort-Parametern

Beispiel:

"response": {
  "status": 200
}
response_time

Antwortzeit in Nano-Sekunden
und Antwortzeit in Milli-Sekunden

Beispiel:

"response_time": 12345678,
"response_time_ms": 1234.5678