map.apps Nutzerinteraktionen

Ablauf

Ausführen der Statements aus dev-console/ct-analytics.txt in der Kibana Dev Konsole
Import von Kibana Dashboards, Queries und Index Patterns aus Datei kibana/ct-analytics/export.ndjson
Konfiguration der Logstash-Pipeline ct-analytics
Einrichtung der Ingest-Pipeline ingest/ct-monitor-analytics.txt (siehe unten)
Hochladen der Analytics-Bundles in map.apps Manager (siehe unten)
Konfiguration von map.apps (siehe unten)

Elastic Ingest Pipeline publizieren

Die Ingest-Pipeline fügt den Ereignissen weitere Zeit-Werte hinzu.

Die Inhalte von

ingest/ct-monitor-temporal.txt
ingest/ct-monitor-analytics.txt

über die Kibana Dev Tools > Console senden.

Analytics Bundles hochladen

Um die Bundles zur Erfassung von Interaktionsdaten von service.monitor Analytics zu nutzen, installieren Sie diese im map.apps Manager.

Loggen Sie sich als Admin im map.apps Manager ein.
Wechseln Sie zum Bundles Tab.
Klicken Sie + Erstellen und wählen Sie die Datei ct-monitor-analytics-js-[VERSION].jar aus.

Konfiguration von map.apps

Neben dem Upload der Bundles, müssen Sie die unten aufgeführten Eigenschaften in der application.properties von map.apps hinzufügen oder ändern. Starten Sie anschließend den Servlet Container neu oder aktualisieren Sie den Kontext.

Der Pfad des map.apps data.directory.location unterscheidet sich von dem des service.monitor Analytics.

application.properties (map.apps)

#### service.monitor Integration
analytics.service.url=/monitor-analytics/resources/usage/log
analytics.message.src=map.apps
appservice.default.bundles=system,templatelayout,analytics_restservice

servicemonitor.base.url=/monitor

analytics.service.url

HTTP-Endpunkt zum Erfassen von Nutzungsdaten durch die service.monitor Analytics Webapp.

Property-Status: neu
Default: <host>/monitor-analytics/resources/usage/log

analytics.message.src

Name der Nachrichtenquelle (für spätere Analysen).

Property-Status: neu
Default: map.apps

appservice.default.bundles

Bundles, die für jede neu angelegte App geladen werden.

Wenn Sie die Eigenschaft um das analytics_restservice Bundle ergänzen, senden alle neu angelegten Apps standardmäßig die erfassten Daten an die analytics.service.url. Dies geschieht auch dann, wenn das analytics_restservice Bundle nicht im allowedBundles-Bereich der neuen App gelistet wird und vereinfacht so die einmalige Aktivierung vom service.monitor Analytics für alle neu angelegten Apps.

Wenn Sie eine App über die Live-Konfiguration in map.apps bearbeiten und speichern, werden die hier aufgeführten Bundles zur app.json hinzugefügt. Diese Änderung bleibt auch dann erhalten, wenn Bundles wieder aus der appservice.default.bundles Liste entfernt werden.

Diese Eigenschaft wird nur für Apps angewendet, die über den map.apps App Dienst bereitgestellt werden, und nicht für Apps, die im Dateisystem gespeichert sind.

Property-Status: liegt möglicherweise schon in der Datei vor
Default: system,templatelayout,analytics_restservice

servicemonitor.base.url

HTTP-Endpunkt zum Aufruf der /monitor-Webapp innerhalb des map.apps Managements.

Property-Status: neu
Default: <host>/monitor

Sollte map.apps und service.monitor Analytics nicht auf einem gemeinsamen Host betrieben werden, fügen Sie den entsprechenden Host den allowedProxyUrls in der map.apps application.properties Datei hinzu.

Aktivierung des Loggings pro App

Um die Protokollierung für eine einzelne App zu aktivieren, fügen Sie ein Bundle mit der Komponente writer (z.B. analytics_restservice) zum Abschnitt allowedBundles in der app.json hinzu. Um stattdessen die Protokollierung für alle neu erstellten Anwendungen zu aktivieren, siehe appservice.default.bundles.

app.json

{
  "load": {
    "allowedBundles": [
      ...
      "analytics_restservice"
    ]
  }
  ...
}