summaryrefslogtreecommitdiff
path: root/vendor/open-telemetry/sdk/Trace/SpanDataInterface.php
blob: 37132b9e5ff19c3afae2aecc7df671115e2c7e5d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<?php

declare(strict_types=1);

namespace OpenTelemetry\SDK\Trace;

use OpenTelemetry\API\Trace as API;
use OpenTelemetry\SDK\Common\Attribute\AttributesInterface;
use OpenTelemetry\SDK\Common\Instrumentation\InstrumentationScopeInterface;
use OpenTelemetry\SDK\Resource\ResourceInfo;

/**
 * Represents an immutable snapshot of a {@see API\SpanInterface}.
 *
 * @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.6.1/specification/trace/sdk.md#additional-span-interfaces
 */
interface SpanDataInterface
{
    public function getName(): string;
    public function getKind(): int;
    public function getContext(): API\SpanContextInterface;
    public function getParentContext(): API\SpanContextInterface;
    public function getTraceId(): string;
    public function getSpanId(): string;
    public function getParentSpanId(): string;
    public function getStatus(): StatusDataInterface;
    public function getStartEpochNanos(): int;
    public function getAttributes(): AttributesInterface;

    /** @return list<EventInterface> */
    public function getEvents(): array;

    /** @return list<LinkInterface> */
    public function getLinks(): array;

    public function getEndEpochNanos(): int;
    public function hasEnded(): bool;
    public function getInstrumentationScope(): InstrumentationScopeInterface;
    public function getResource(): ResourceInfo;

    /** @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.6.1/specification/trace/sdk_exporters/non-otlp.md#dropped-events-count */
    public function getTotalDroppedEvents(): int;

    /** @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.6.1/specification/trace/sdk_exporters/non-otlp.md#dropped-links-count */
    public function getTotalDroppedLinks(): int;
}