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> <> provided that graphql.operation.type and are available. If 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.

AttributeTypeDescriptionExamplesRequirement Level
graphql.documentstringThe GraphQL document being executed. [1]query findBookById { bookById(id: ?) { name } }Recommended
graphql.operation.namestringThe name of the operation being executed.findBookByIdRecommended
graphql.operation.typestringThe type of the operation being executed.query; mutation; subscriptionRecommended

[1]: The value may be sanitized to exclude sensitive information.

graphql.operation.type MUST be one of the following:

queryGraphQL query
mutationGraphQL mutation
subscriptionGraphQL subscription