From 2134365c486dfd0cbefb2d242c10321c72746212 Mon Sep 17 00:00:00 2001
From: Brian Tiger Chow <brian.holderchow@gmail.com>
Date: Sun, 16 Nov 2014 04:18:47 -0800
Subject: [PATCH] docs(eventlog)

License: MIT
Signed-off-by: Brian Tiger Chow <brian@perfmode.com>
---
 util/eventlog/log.go | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/util/eventlog/log.go b/util/eventlog/log.go
index 06b8e5444..46cfc2683 100644
--- a/util/eventlog/log.go
+++ b/util/eventlog/log.go
@@ -63,17 +63,24 @@ type eventLogger struct {
 }
 
 func (el *eventLogger) Event(ctx context.Context, event string, metadata ...Loggable) {
+
+	// get any existing metadata from the context
 	existing, err := MetadataFromContext(ctx)
 	if err != nil {
 		existing = Metadata{}
 	}
+
+	// accumulate metadata
 	accum := existing
 	for _, datum := range metadata {
 		accum = DeepMerge(accum, datum.Loggable())
 	}
+
+	// apply final attributes to reserved keys
 	accum["event"] = event
 	accum["system"] = el.system
 	accum["time"] = util.FormatRFC3339(time.Now())
 
+	// TODO roll our own event logger
 	logrus.WithFields(map[string]interface{}(accum)).Info(event)
 }