Merge 2b1844f into b6d84fe

README.md

@@ -59,14 +59,16 @@ var opts = {
 http.request(opts, function (res) {
     res.setEncoding('utf8');
     res.on('error', function (err) {
-        span.logEvent('request_error', err);
+        // assuming no retries, mark the span as failed
+        span.setTag(opentracing.Tags.ERROR, true);
+        span.log({'event': 'error', 'error.object': err);
         span.finish();
     });
     res.on('data', function (chunk) {
-        span.logEvent('data_received', chunk);
+        span.log({'event': 'data_received', 'data': chunk});
     });
-    res.on('end', function(err) {
-        span.logEvent('request_end', err);
+    res.on('end', function() {
+        span.log({'event': 'request_end'});
         span.finish();
     });
 }).end();

src/tracer.js

@@ -34,6 +34,13 @@ export default class Tracer {
      *         childOf: parent.context(),
      *     });
      *
+     *     // Start a new async (FollowsFrom) Span:
+     *     var child = Tracer.startSpan('Subroutine', {
+     *         references: [
+     *             opentracing.followsFrom(parent.context())
+     *         ],
+     *     });
+     *
      * @param {string} name - the name of the operation.
      * @param {object} [fields] - the fields to set on the newly created span.
      * @param {string} [fields.operationName] - the name to use for the newly