Add static methods to global tracer for annotations, links, message events (#178)

* Add static methods to global tracer

* Add setters to global tracer for annotations, links, message events

Author: chingor13

src/Trace/Tracer.php

@@ -239,6 +239,68 @@ public static function addAttribute($attribute, $value, $options = [])
         return self::$instance->addAttribute($attribute, $value, $options);
     }
 
+    /**
+     * Add an annotation to the provided Span
+     *
+     * @param string $description
+     * @param array $options [optional] Configuration options.
+     *
+     *      @type Span $span The span to add the annotation to.
+     *      @type array $attributes Attributes for this annotation.
+     *      @type \DateTimeInterface|int|float $time The time of this event.
+     */
+    public static function addAnnotation($description, $options = [])
+    {
+        if (!isset(self::$instance)) {
+            return;
+        }
+        return self::$instance->addAnnotation($description, $options);
+    }
+
+    /**
+     * Add a link to the provided Span
+     *
+     * @param string $traceId
+     * @param string $spanId
+     * @param array $options [optional] Configuration options.
+     *
+     *      @type Span $span The span to add the link to.
+     *      @type string $type The relationship of the current span relative to
+     *            the linked span: child, parent, or unspecified.
+     *      @type array $attributes Attributes for this annotation.
+     *      @type \DateTimeInterface|int|float $time The time of this event.
+     */
+    public static function addLink($traceId, $spanId, $options = [])
+    {
+        if (!isset(self::$instance)) {
+            return;
+        }
+        return self::$instance->addLink($traceId, $spanId, $options);
+    }
+
+    /**
+     * Add an message event to the provided Span
+     *
+     * @param string $type
+     * @param string $id
+     * @param array $options [optional] Configuration options.
+     *
+     *      @type Span $span The span to add the message event to.
+     *      @type int $uncompressedSize The number of uncompressed bytes sent or
+     *            received.
+     *      @type int $compressedSize The number of compressed bytes sent or
+     *            received. If missing assumed to be the same size as
+     *            uncompressed.
+     *      @type \DateTimeInterface|int|float $time The time of this event.
+     */
+    public static function addMessageEvent($type, $id, $options = [])
+    {
+        if (!isset(self::$instance)) {
+            return;
+        }
+        return self::$instance->addMessageEvent($type, $id, $options);
+    }
+
     /**
      * Returns the current span context.
      *

tests/unit/Trace/TracerTest.php

@@ -58,4 +58,68 @@ public function testForceEnabled()
 
         $this->assertTrue($tracer->spanContext()->enabled());
     }
+
+    public function testGlobalAttributes()
+    {
+        $rt = Tracer::start($this->reporter->reveal(), [
+            'sampler' => new AlwaysSampleSampler(),
+            'skipReporting' => true
+        ]);
+        Tracer::addAttribute('foo', 'bar');
+        $spans = $rt->tracer()->spans();
+        $span = $spans[count($spans) - 1];
+        $this->assertEquals(['foo' => 'bar'], $span->attributes());
+    }
+
+    public function testGlobalAnnotation()
+    {
+        $rt = Tracer::start($this->reporter->reveal(), [
+            'sampler' => new AlwaysSampleSampler(),
+            'skipReporting' => true
+        ]);
+        Tracer::addAnnotation('some description', [
+            'attributes' => [
+                'foo' => 'bar'
+            ]
+        ]);
+        $spans = $rt->tracer()->spans();
+        $span = $spans[count($spans) - 1];
+
+        $this->assertCount(1, $span->timeEvents());
+        $annotation = $span->timeEvents()[0];
+        $this->assertEquals('some description', $annotation->description());
+        $this->assertEquals(['foo' => 'bar'], $annotation->attributes());
+    }
+
+    public function testGlobalMessageEvent()
+    {
+        $rt = Tracer::start($this->reporter->reveal(), [
+            'sampler' => new AlwaysSampleSampler(),
+            'skipReporting' => true
+        ]);
+        Tracer::addMessageEvent('SENT', 'message-id');
+        $spans = $rt->tracer()->spans();
+        $span = $spans[count($spans) - 1];
+
+        $this->assertCount(1, $span->timeEvents());
+        $messageEvent = $span->timeEvents()[0];
+        $this->assertEquals('SENT', $messageEvent->type());
+        $this->assertEquals('message-id', $messageEvent->id());
+    }
+
+    public function testGlobalLink()
+    {
+        $rt = Tracer::start($this->reporter->reveal(), [
+            'sampler' => new AlwaysSampleSampler(),
+            'skipReporting' => true
+        ]);
+        Tracer::addLink('trace-id', 'span-id');
+        $spans = $rt->tracer()->spans();
+        $span = $spans[count($spans) - 1];
+
+        $this->assertCount(1, $span->links());
+        $link = $span->links()[0];
+        $this->assertEquals('trace-id', $link->traceId());
+        $this->assertEquals('span-id', $link->spanId());
+    }
 }