-
Notifications
You must be signed in to change notification settings - Fork 884
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into prometheus-exporter
- Loading branch information
Showing
17 changed files
with
786 additions
and
96 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
groups: | ||
- id: service | ||
prefix: service | ||
brief: > | ||
A service instance. | ||
attributes: | ||
- id: name | ||
type: string | ||
required: always | ||
brief: > | ||
Logical name of the service. | ||
note: > | ||
MUST be the same for all instances of horizontally scaled services. | ||
examples: ["shoppingcart"] | ||
- id: namespace | ||
type: string | ||
brief: > | ||
A namespace for `service.name`. | ||
note: > | ||
A string value having a meaning that helps to distinguish a group of services, | ||
for example the team name that owns a group of services. | ||
`service.name` is expected to be unique within the same namespace. | ||
If `service.namespace` is not specified in the Resource then `service.name` | ||
is expected to be unique for all services that have no explicit namespace defined | ||
(so the empty/unspecified namespace is simply one more valid namespace). | ||
Zero-length namespace string is assumed equal to unspecified namespace. | ||
examples: ["Shop"] | ||
- id: instance.id | ||
type: string | ||
required: always | ||
brief: > | ||
The string ID of the service instance. | ||
note: > | ||
MUST be unique for each instance of the same `service.namespace,service.name` pair | ||
(in other words `service.namespace,service.name,service.id` triplet MUST be globally unique). | ||
The ID helps to distinguish instances of the same service that exist at the same time | ||
(e.g. instances of a horizontally scaled service). It is preferable for the ID to be persistent | ||
and stay the same for the lifetime of the service instance, however it is acceptable that | ||
the ID is ephemeral and changes during important lifetime events for the service | ||
(e.g. service restarts). | ||
If the service has no inherent unique ID that can be used as the value of this attribute | ||
it is recommended to generate a random Version 1 or Version 4 RFC 4122 UUID | ||
(services aiming for reproducible UUIDs may also use Version 5, see RFC 4122 | ||
for more recommendations). | ||
examples: ["627cc493-f310-47de-96bd-71410b7dec09"] | ||
- id: version | ||
type: string | ||
brief: > | ||
The version string of the service API or implementation. | ||
examples: ["2.0.0"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,47 @@ | ||
groups: | ||
- id: telemetry | ||
prefix: telemetry | ||
brief: > | ||
The telemetry SDK used to capture data recorded by the instrumentation libraries. | ||
attributes: | ||
- id: sdk.name | ||
type: string | ||
brief: > | ||
The name of the telemetry SDK as defined above. | ||
examples: ["opentelemetry"] | ||
- id: sdk.language | ||
type: | ||
allow_custom_values: true | ||
members: | ||
- id: cpp | ||
value: "cpp" | ||
- id: dotnet | ||
value: "dotnet" | ||
- id: erlang | ||
value: "erlang" | ||
- id: go | ||
value: "go" | ||
- id: java | ||
value: "java" | ||
- id: nodejs | ||
value: "nodejs" | ||
- id: php | ||
value: "php" | ||
- id: python | ||
value: "python" | ||
- id: ruby | ||
value: "ruby" | ||
- id: webjs | ||
value: "webjs" | ||
brief: > | ||
The language of the telemetry SDK. | ||
- id: sdk.version | ||
type: string | ||
brief: > | ||
The version string of the telemetry SDK. | ||
examples: ["1.2.3"] | ||
- id: auto.version | ||
type: string | ||
brief: > | ||
The version string of the auto instrumentation agent, if used. | ||
examples: ["1.2.3"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,116 @@ | ||
groups: | ||
- id: messaging | ||
prefix: messaging | ||
brief: > | ||
This document defines the attributes used in | ||
messaging systems. | ||
attributes: | ||
- id: system | ||
type: string | ||
required: always | ||
brief: 'A string identifying the messaging system.' | ||
examples: ['kafka', 'rabbitmq', 'activemq'] | ||
- id: destination | ||
type: string | ||
required: always | ||
brief: > | ||
The message destination name. This might be equal to the span name | ||
but is required nevertheless. | ||
examples: ['MyQueue', 'MyTopic'] | ||
- id: destination_kind | ||
type: | ||
allow_custom_values: false | ||
members: | ||
- id: queue | ||
value: "queue" | ||
brief: "A message sent to a queue" | ||
- id: topic | ||
value: "topic" | ||
brief: "A message broadcasted to the subscribers of the topic" | ||
required: | ||
conditional: 'Required only if the message destination is either a `queue` or `topic`.' | ||
brief: 'The kind of message destination' | ||
- id: temp_destination | ||
type: boolean | ||
required: | ||
conditional: 'If missing, it is assumed to be false.' | ||
brief: 'A boolean that is true if the message destination is temporary.' | ||
- id: protocol | ||
type: string | ||
brief: 'The name of the transport protocol.' | ||
examples: ['AMQP', 'MQTT'] | ||
- id: protocol_version | ||
type: string | ||
brief: 'The version of the transport protocol.' | ||
examples: '0.9.1' | ||
- id: url | ||
type: string | ||
brief: 'Connection string.' | ||
examples: ['tibjmsnaming://localhost:7222', 'https://queue.amazonaws.com/80398EXAMPLE/MyQueue'] | ||
- id: message_id | ||
type: string | ||
brief: 'A value used by the messaging system as an identifier for the message, represented as a string.' | ||
examples: '452a7c7c7c7048c2f887f61572b18fc2' | ||
- id: conversation_id | ||
type: string | ||
brief: > | ||
The [conversation ID](#conversations) identifying the conversation to which the message belongs, | ||
represented as a string. Sometimes called "Correlation ID". | ||
examples: 'MyConversationId' | ||
- id: message_payload_size_bytes | ||
type: number | ||
brief: > | ||
The (uncompressed) size of the message payload in bytes. | ||
Also use this attribute if it is unknown whether the compressed or uncompressed payload size is reported. | ||
examples: 2738 | ||
- id: message_payload_compressed_size_bytes | ||
type: number | ||
brief: 'The compressed size of the message payload in bytes.' | ||
examples: 2048 | ||
constraints: | ||
- any_of: | ||
- 'net.peer.name' | ||
- 'net.peer.ip' | ||
- include: network | ||
|
||
- id: messaging.producer | ||
prefix: messaging | ||
extends: messaging | ||
span_kind: producer | ||
brief: 'Semantic convention for producers of messages sent to a messaging systems.' | ||
|
||
- id: messaging.producer.synchronous | ||
prefix: messaging | ||
extends: messaging | ||
span_kind: client | ||
brief: > | ||
Semantic convention for clients of messaging systems that produce messages | ||
and synchronously wait for responses. | ||
- id: messaging.consumer | ||
prefix: messaging | ||
extends: messaging | ||
span_kind: consumer | ||
brief: 'Semantic convention for a consumer of messages received from a messaging system' | ||
attributes: | ||
- id: operation | ||
type: | ||
allow_custom_values: false | ||
members: | ||
- id: receive | ||
value: "receive" | ||
- id: process | ||
value: "process" | ||
brief: > | ||
A string identifying the kind of message consumption as defined in the | ||
[Operation names](#operation-names) section above. | ||
If the operation is "send", this attribute MUST NOT be set, since the | ||
operation can be inferred from the span kind in that case. | ||
- id: messaging.consumer.synchronous | ||
prefix: messaging | ||
extends: messaging.consumer | ||
span_kind: server | ||
brief: > | ||
Semantic convention for servers that consume messages received from messaging systems | ||
and always send back replies directed to the producers of these messages. |
Oops, something went wrong.