Integration mit anderen con terra Produkten / Server-seitiges Logging

Diese Seite beinhaltet die folgenden Abschnitte:

Integration mit con terra security.manager
- Installations- und Konfigurationsschritte
Integration mit con terra map.apps
- Installations- und Konfigurationsschritte
Notwendige jar-Dateien für die Integration von map.apps und security.manager
Integration mit anderen con terra Produkten
Logging-Parameter

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

Die *.jar Dateien aus [CD-CONTENTS]/software/service.monitor Analytics web/service-log/lib und /lib-ext kopieren
1. nach [security.manager]/webapps/wss/WEB-INF/lib
2. nach [security.manager]/webapps/administration/WEB-INF/lib
Die Datei [CD-CONTENTS]/software/service.monitor Analytics web/service-log/spring-log-bean-sample-security.manager.xml enthält eine vorkonfigurierte WebSecurityProcessor-Bean, welche kopiert werden muss:
1. nach [security.manager]/webapps/administration/WEB-INF/classes/spring-security-config.xml
2. nach [security.manager]/webapps/wss/WEB-INF/classes/spring-security-config.xml
Um die Bean zu aktivieren, muss diese in der SpringWebProcessor-Liste referenziert werden. Die Datei [CD-CONTENTS]/software/service.monitor Analytics web/service-log/security-manager-<version>/spring-security-config-wss.xml hilft beim Verständnis solcher Stellen, die bei den Konfigurationsänderungen berücksichtigt werden sollten.
Diese Konfigurationsanpassung muss in ähnlicher Weise für die Datei [CD-CONTENTS]/software/service.monitor Analytics web/service-log/security-manager-<version>/spring-security-config-administration.xml wiederholt werden (/administration-Webanwendung).

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

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

Die *.jar Dateien aus [CD-CONTENTS]/software/service.monitor Analytics web/service-log/lib und /lib-ext kopieren
1. nach [map.apps]/WEB-INF/lib
Die Datei [CD-CONTENTS]/software/service.monitor Analytics web/service-log/spring-log-bean-sample-map.apps.xml enthält eine vorkonfigurierte WebSecurityFilter-Bean, welche kopiert werden muss:
1. nach [map.apps]/WEB-INF/classes/spring-filter-config.xml
Um die Bean zu aktivieren, muss diese in der SpringFilterChain-Liste referenziert werden. Die Datei [CD-CONTENTS]/software/service.monitor Analytics web/service-log/map.apps-<version>/spring-filter-config.xml hilft beim Verständnis der Stelle, die bei den Konfigurationsänderungen berücksichtigt werden muss.
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
Der Servlet-Container muss nach erfolgter Änderung neu gestartet werden.

Notwendige jar-Dateien für die Integration von map.apps und security.manager

Im Ordner service-log/lib liegen Dateien für die Integrationsszenarien vor:

ct-analytics-usagelog-api-1.x.jar
ct-analytics-usagelog-api-2.x.jar
gelfclient-<version>.jar
netty-all-<version>.FINAL.jar

security.manager benötigt immer ct-analytics-usagelog-api-1.x.jar. Ebenso map.apps abgesehen von den Versionen beginnend mit 4.7, welche ct-analytics-usagelog-api-2.x.jar verwenden.

Es können weitere Dateien aus dem Ordner service-log/lib-ext notwendig sein. Details stellen die folgenden Tabellen dar:

security.manager
Version	Dateien aus `/lib-ext` für `administration-webapp`	Dateien aus `/lib-ext` für `wss-webapp`
4.4	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`
4.5	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`
4.6.4	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`
4.7.1	`jackson-core-2.8.3.jar`	`ct-rest-support-1.3.0.jar jackson-core-2.8.3.jar`
4.8.0		`ct-rest-support-1.3.0.jar`
4.9		`ct-rest-support-1.3.0.jar`
4.10		`ct-rest-support-1.3.0.jar`
4.10.1		`ct-rest-support-1.4.17.jar`
4.11		`ct-rest-support-1.4.17.jar`
4.12	`ct-rest-support-1.4.17.jar`	`ct-rest-support-1.4.17.jar`
4.13	`ct-rest-support-1.4.17.jar`	`ct-rest-support-1.4.17.jar`
4.14	`ct-rest-support-1.4.17.jar`	`ct-rest-support-1.4.17.jar`
4.14.1
4.15	, unter Nutzung der fertig konfigurierten `spring-filter-config.xml`	, unter Nutzung der fertig konfigurierten `spring-filter-config.xml`
4.16.x	, unter Nutzung der fertig konfigurierten `spring-filter-config.xml`	, unter Nutzung der fertig konfigurierten `spring-filter-config.xml`

map.apps
Version	Dateien aus `/lib-ext
3.x	Bitte Integrationsdateien aus service.monitor Analytics 4.3.0 nutzen.
4.0	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.3.0.jar` funktioniert in dieser Kombination nicht
4.1	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.0.jar` funktioniert in dieser Kombination nicht
4.2.0	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.3.jar` funktioniert in dieser Kombination nicht
4.2.1 / 4.2.2	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.4.jar` funktioniert in dieser Kombination nicht
4.3	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.4.jar` funktioniert in dieser Kombination nicht
4.4	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.7.jar` funktioniert in dieser Kombination nicht
4.5.1	, nur in Kombination mit `ct-rest-support-1.4.17.jar`, das der map.apps Auslieferung beiligende `ct-rest-support-1.4.11.jar` funktioniert in dieser Kombination nicht
4.6
4.7	, bitte `ct-analytics-usagelog-api-2.x.jar` verwenden
4.8	, bitte `ct-analytics-usagelog-api-2.x.jar` verwenden
4.9	, bitte `ct-analytics-usagelog-api-2.x.jar` verwenden

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