docs(messaging): add gcp_pubsub as a messaging system (#490)
Co-authored-by: Johannes Tax <johannes@johannes.tax> Co-authored-by: Joao Grassi <joao@joaograssi.com> Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>
This commit is contained in:
parent
d9c24b436e
commit
30ea09f5c4
|
|
@ -36,7 +36,7 @@
|
||||||
| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |
|
| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |
|
||||||
| `messaging.rocketmq.message.type` | string | Type of message. | `normal` |
|
| `messaging.rocketmq.message.type` | string | Type of message. | `normal` |
|
||||||
| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |
|
| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |
|
||||||
| `messaging.system` | string | A string identifying the messaging system. | `kafka`; `rabbitmq`; `rocketmq`; `activemq`; `AmazonSQS` |
|
| `messaging.system` | string | A string identifying the messaging system. | `kafka`; `rabbitmq`; `rocketmq`; `activemq` |
|
||||||
|
|
||||||
**[1]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
|
**[1]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,5 +20,6 @@ Technology specific semantic conventions are defined for the following messaging
|
||||||
* [Kafka](kafka.md): Semantic Conventions for *Apache Kafka*.
|
* [Kafka](kafka.md): Semantic Conventions for *Apache Kafka*.
|
||||||
* [RabbitMQ](rabbitmq.md): Semantic Conventions for *RabbitMQ*.
|
* [RabbitMQ](rabbitmq.md): Semantic Conventions for *RabbitMQ*.
|
||||||
* [RocketMQ](rocketmq.md): Semantic Conventions for *Apache RocketMQ*.
|
* [RocketMQ](rocketmq.md): Semantic Conventions for *Apache RocketMQ*.
|
||||||
|
* [Google Cloud Pub/Sub](gcp-pubsub.md): Semantic Conventions for *Google Cloud Pub/Sub*.
|
||||||
|
|
||||||
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
|
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,13 @@
|
||||||
|
<!--- Hugo front matter used to generate the website version of this page:
|
||||||
|
linkTitle: Google Cloud Pub/Sub
|
||||||
|
--->
|
||||||
|
|
||||||
|
# Semantic Conventions for Google Cloud Pub/Sub
|
||||||
|
|
||||||
|
**Status**: [Experimental][DocumentStatus]
|
||||||
|
|
||||||
|
The Semantic Conventions for [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) extend and override the [Messaging Semantic Conventions](README.md) that describe common messaging operations attributes in addition to the Semantic Conventions described on this page.
|
||||||
|
|
||||||
|
`messaging.system` MUST be set to `"gcp_pubsub"`.
|
||||||
|
|
||||||
|
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
|
||||||
|
|
@ -287,7 +287,7 @@ messages were received). For each message it accounts for, the "Deliver" or
|
||||||
| [`messaging.message.envelope.size`](../attributes-registry/messaging.md) | int | The size of the message body and metadata in bytes. [12] | `2738` | Recommended: [13] |
|
| [`messaging.message.envelope.size`](../attributes-registry/messaging.md) | int | The size of the message body and metadata in bytes. [12] | `2738` | Recommended: [13] |
|
||||||
| [`messaging.message.id`](../attributes-registry/messaging.md) | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` | Recommended: [14] |
|
| [`messaging.message.id`](../attributes-registry/messaging.md) | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` | Recommended: [14] |
|
||||||
| [`messaging.operation`](../attributes-registry/messaging.md) | string | A string identifying the kind of messaging operation. [15] | `publish` | Required |
|
| [`messaging.operation`](../attributes-registry/messaging.md) | string | A string identifying the kind of messaging operation. [15] | `publish` | Required |
|
||||||
| [`messaging.system`](../attributes-registry/messaging.md) | string | A string identifying the messaging system. | `kafka`; `rabbitmq`; `rocketmq`; `activemq`; `AmazonSQS` | Required |
|
| [`messaging.system`](../attributes-registry/messaging.md) | string | A string identifying the messaging system. | `kafka`; `rabbitmq`; `rocketmq`; `activemq` | Required |
|
||||||
| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
|
| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
|
||||||
| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: If `network.peer.address` is set. |
|
| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: If `network.peer.address` is set. |
|
||||||
| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [16] | `amqp`; `mqtt` | Recommended |
|
| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [16] | `amqp`; `mqtt` | Recommended |
|
||||||
|
|
|
||||||
|
|
@ -205,4 +205,4 @@ groups:
|
||||||
- id: system
|
- id: system
|
||||||
type: string
|
type: string
|
||||||
brief: 'A string identifying the messaging system.'
|
brief: 'A string identifying the messaging system.'
|
||||||
examples: ['kafka', 'rabbitmq', 'rocketmq', 'activemq', 'AmazonSQS']
|
examples: ['kafka', 'rabbitmq', 'rocketmq', 'activemq']
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue