Add Annotations, links, time events (#81)

* Tracer is delegated the work of adding attributes, annotations, links, and message events

* Add annotation, link, message event, time event models

* Add AttributeTrait and flesh out the documentation for the new models

* Span can maintain time events and links

* Fix tests

* Can set attributes on a specific span

* Fix extension tracer to add attribute to specified span

* Add addAttributes to static Tracer

* Add tests for adding annotations, links, message events

* Add tests for adding annotations, links, message events in the extension

* Tests for extension

* Spans return links and timeEvents

* Create c types for annotations, links, message events

* return links, annotations, message events as arrays

* Move new data types into their own files

* Create classes for annoations, links, message events

* return model types for links and time events

* Fix extension tests

* Integrate with updates to the extension

* cs fix

* Documentation fixes

* Fix 2 documentation errors

Author: chingor13

ext/README.md

@@ -248,20 +248,60 @@ function opencensus_trace_set_context($traceId, $parentSpanId = null);
 
 ```php
 /**
- * Add a attribute to the current span
+ * Add an attribute to a span.
  *
  * @param string $key
  * @param string $value
+ * @param array $options
+ *
+ *      @type int $spanId The id of the span to which to add the attribute.
+ *            Defaults to the current span.
  */
-function opencensus_trace_add_attribute($key, $value);
+function opencensus_trace_add_attribute($key, $value, $options = []);
+```
+
+### Add an annotation to a span.
 
+```php
 /**
- * Add a attribute to the root current span
+ * Add an annotation to a span
+ * @param string $description
+ * @param array $options
  *
- * @param string $key
- * @param string $value
+ *      @type int $spanId The id of the span to which to add the attribute.
+ *            Defaults to the current span.
+ */
+function opencensus_trace_add_annotation($description, $options = []);
+```
+
+### Add a link to a span.
+
+```php
+/**
+ * Add a link to a span
+ * @param string $traceId
+ * @param string $spanId
+ * @param array $options
+ *
+ *      @type int $spanId The id of the span to which to add the link.
+ *            Defaults to the current span.
+ */
+function opencensus_trace_add_link($traceId, $spanId, $options = []);
+```
+
+### Add a message event to a span.
+
+```php
+/**
+ * Add a message to a span
+ * @param string $type
+ * @param string $id
+ * @param array $options
+ *
+ *      @type int $spanId The id of the span to which to add the attribute.
+ *            Defaults to the current span.
  */
-function opencensus_trace_add_root_attribute($key, $value);
+function opencensus_trace_add_message_event($type, $id, $options = []);
 ```
 
 ## Versioning

ext/config.m4

@@ -3,5 +3,5 @@ PHP_ARG_ENABLE(opencensus, whether to enable my extension,
 
 if test "$PHP_OPENCENSUS" = "yes"; then
   AC_DEFINE(HAVE_OPENCENSUS, 1, [Whether you have OpenCensus])
-  PHP_NEW_EXTENSION(opencensus, opencensus_trace.c opencensus_trace_span.c opencensus_trace_context.c, $ext_shared)
+  PHP_NEW_EXTENSION(opencensus, opencensus_trace.c opencensus_trace_span.c opencensus_trace_context.c opencensus_trace_annotation.c opencensus_trace_link.c opencensus_trace_message_event.c, $ext_shared)
 fi

ext/config.w32

@@ -4,6 +4,6 @@
 ARG_ENABLE("opencensus", "opencensus support", "no");
 
 if (PHP_OPENCENSUS != "no") {
-    EXTENSION('opencensus', 'opencensus_trace.c opencensus_trace_context.c opencensus_trace_span.c');
+    EXTENSION('opencensus', 'opencensus_trace.c opencensus_trace_context.c opencensus_trace_span.c opencensus_trace_annotation.c opencensus_trace_link.c opencensus_trace_message_event.c');
     AC_DEFINE('HAVE_OPENCENSUS', 1);
 }