Semantic Conventions for GraphQL Server
Status: Experimental
This document defines semantic conventions to apply when instrumenting the GraphQL implementation. They map GraphQL operations to attributes on a Span.
The span name MUST be of the format <graphql.operation.type> <graphql.operation.name>
provided that
graphql.operation.type
and graphql.operation.name
are available. If graphql.operation.name
is not available, the
span SHOULD be named <graphql.operation.type>
. When <graphql.operation.type>
is not available, GraphQL Operation
MAY be used as span name.
Attribute | Type | Description | Examples | Requirement Level |
---|---|---|---|---|
graphql.document |
string | The GraphQL document being executed. [1] | query findBookById { bookById(id: ?) { name } } |
Recommended |
graphql.operation.name |
string | The name of the operation being executed. | findBookById |
Recommended |
graphql.operation.type |
string | The type of the operation being executed. | query ; mutation ; subscription |
Recommended |
[1]: The value may be sanitized to exclude sensitive information.
graphql.operation.type
MUST be one of the following:
Value | Description |
---|---|
query |
GraphQL query |
mutation |
GraphQL mutation |
subscription |
GraphQL subscription |