You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2016/03/23 14:07:27 UTC
karaf-decanter git commit: KARAF-4404 - Document the eventadmin
collector
Repository: karaf-decanter
Updated Branches:
refs/heads/master 5a4df7d31 -> f0fb00d4e
KARAF-4404 - Document the eventadmin collector
Project: http://git-wip-us.apache.org/repos/asf/karaf-decanter/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf-decanter/commit/f0fb00d4
Tree: http://git-wip-us.apache.org/repos/asf/karaf-decanter/tree/f0fb00d4
Diff: http://git-wip-us.apache.org/repos/asf/karaf-decanter/diff/f0fb00d4
Branch: refs/heads/master
Commit: f0fb00d4e0719b514a3375279bee3cb1747f932f
Parents: 5a4df7d
Author: Jean-Baptiste Onofré <jb...@apache.org>
Authored: Wed Mar 23 14:07:12 2016 +0100
Committer: Jean-Baptiste Onofré <jb...@apache.org>
Committed: Wed Mar 23 14:07:12 2016 +0100
----------------------------------------------------------------------
.../main/asciidoc/user-guide/collectors.adoc | 29 +++++++++++++++++++-
1 file changed, 28 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/karaf-decanter/blob/f0fb00d4/manual/src/main/asciidoc/user-guide/collectors.adoc
----------------------------------------------------------------------
diff --git a/manual/src/main/asciidoc/user-guide/collectors.adoc b/manual/src/main/asciidoc/user-guide/collectors.adoc
index 434fadb..aa1dd82 100644
--- a/manual/src/main/asciidoc/user-guide/collectors.adoc
+++ b/manual/src/main/asciidoc/user-guide/collectors.adoc
@@ -54,7 +54,6 @@ log4j.rootLogger = DEBUG, out, osgi:DecanterLogCollectorAppender, osgi:VmLogAppe
=====================================================================
-
==== Log Socket
The Decanter Log Socket Collector is an event driven collector. It creates a socket, waiting for incoming event. The expected
@@ -129,6 +128,34 @@ my=stuff
The file collector will tail on karaf.log file, and send any new line in this log file as collected data.
+==== EventAdmin
+
+The Decanter EventAdmin Collector is an event-driven collector, listening for all internal events happening in
+the Apache Karaf Container.
+
+[NOTE]
+================================================
+It's the perfect way to audit all actions performed on resources (features, bundles, configurations, ...) by users
+(via local shell console, SSH, or JMX).
+
+We recommend to use this collector to implement users and actions auditing.
+================================================
+
+The `decanter-collector-eventadmin` feature installs the eventadmin collector:
+
+----
+karaf@root()> feature:install decanter-collector-eventadmin
+----
+
+By default, the eventadmin collector is listening for all OSGi framework and Karaf internal events.
+
+You can specify additional events to trap by providing a `etc/org.apache.karaf.decanter.collector.eventadmin-my.cfg' configuration
+file, containing the EventAdmin topics you want to listen:
+
+----
+event.topics=my/*
+----
+
==== JMX
The Decanter JMX Collector is a polled collector, executed periodically by the Decanter Scheduler.