aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto
diff options
context:
space:
mode:
authorrobot-contrib <robot-contrib@yandex-team.com>2024-01-26 12:10:01 +0300
committerAlexander Smirnov <alex@ydb.tech>2024-01-26 20:49:31 +0300
commitde5550f847db018c6d29f627e935cc319fc98845 (patch)
tree949f8c2b118b69c4f5637dc69e67be31a06b0c8b /contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto
parenta479df7090c08abeb1345866b69d964b061e2c2a (diff)
downloadydb-de5550f847db018c6d29f627e935cc319fc98845.tar.gz
Update contrib/libs/opentelemetry-proto to 1.1.0
Diffstat (limited to 'contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto')
-rw-r--r--contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto57
1 files changed, 57 insertions, 0 deletions
diff --git a/contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto b/contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto
index b2869edc42..a1fdfa3ac9 100644
--- a/contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto
+++ b/contrib/libs/opentelemetry-proto/opentelemetry/proto/trace/v1/trace.proto
@@ -55,6 +55,9 @@ message ResourceSpans {
// A list of ScopeSpans that originate from a resource.
repeated ScopeSpans scope_spans = 2;
+ // The Schema URL, if known. This is the identifier of the Schema that the resource data
+ // is recorded in. To learn more about Schema URL see
+ // https://opentelemetry.io/docs/specs/otel/schemas/#schema-url
// This schema_url applies to the data in the "resource" field. It does not apply
// to the data in the "scope_spans" field which have their own schema_url field.
string schema_url = 3;
@@ -70,6 +73,9 @@ message ScopeSpans {
// A list of Spans that originate from an instrumentation scope.
repeated Span spans = 2;
+ // The Schema URL, if known. This is the identifier of the Schema that the span data
+ // is recorded in. To learn more about Schema URL see
+ // https://opentelemetry.io/docs/specs/otel/schemas/#schema-url
// This schema_url applies to all spans and span events in the "spans" field.
string schema_url = 3;
}
@@ -103,6 +109,22 @@ message Span {
// field must be empty. The ID is an 8-byte array.
bytes parent_span_id = 4;
+ // Flags, a bit field. 8 least significant bits are the trace
+ // flags as defined in W3C Trace Context specification. Readers
+ // MUST not assume that 24 most significant bits will be zero.
+ // To read the 8-bit W3C trace flag, use `flags & SPAN_FLAGS_TRACE_FLAGS_MASK`.
+ //
+ // When creating span messages, if the message is logically forwarded from another source
+ // with an equivalent flags fields (i.e., usually another OTLP span message), the field SHOULD
+ // be copied as-is. If creating from a source that does not have an equivalent flags field
+ // (such as a runtime representation of an OpenTelemetry span), the high 24 bits MUST
+ // be set to zero.
+ //
+ // [Optional].
+ //
+ // See https://www.w3.org/TR/trace-context-2/#trace-flags for the flag definitions.
+ fixed32 flags = 16;
+
// A description of the span's operation.
//
// For example, the name can be a qualified method name or a file name
@@ -236,6 +258,16 @@ message Span {
// dropped_attributes_count is the number of dropped attributes. If the value is 0,
// then no attributes were dropped.
uint32 dropped_attributes_count = 5;
+
+ // Flags, a bit field. 8 least significant bits are the trace
+ // flags as defined in W3C Trace Context specification. Readers
+ // MUST not assume that 24 most significant bits will be zero.
+ // When creating new spans, the most-significant 24-bits MUST be
+ // zero. To read the 8-bit W3C trace flag (use flags &
+ // SPAN_FLAGS_TRACE_FLAGS_MASK). [Optional].
+ //
+ // See https://www.w3.org/TR/trace-context-2/#trace-flags for the flag definitions.
+ fixed32 flags = 6;
}
// links is a collection of Links, which are references from this span to a span
@@ -274,3 +306,28 @@ message Status {
// The status code.
StatusCode code = 3;
}
+
+// SpanFlags represents constants used to interpret the
+// Span.flags field, which is protobuf 'fixed32' type and is to
+// be used as bit-fields. Each non-zero value defined in this enum is
+// a bit-mask. To extract the bit-field, for example, use an
+// expression like:
+//
+// (span.flags & SPAN_FLAGS_TRACE_FLAGS_MASK)
+//
+// See https://www.w3.org/TR/trace-context-2/#trace-flags for the flag definitions.
+//
+// Note that Span flags were introduced in version 1.1 of the
+// OpenTelemetry protocol. Older Span producers do not set this
+// field, consequently consumers should not rely on the absence of a
+// particular flag bit to indicate the presence of a particular feature.
+enum SpanFlags {
+ // The zero value for the enum. Should not be used for comparisons.
+ // Instead use bitwise "and" with the appropriate mask as shown above.
+ SPAN_FLAGS_DO_NOT_USE = 0;
+
+ // Bits 0-7 are used for trace flags.
+ SPAN_FLAGS_TRACE_FLAGS_MASK = 0x000000FF;
+
+ // Bits 8-31 are reserved for future use.
+}