graphql

Documentation

Overview

Package graphql provides functions to trace the graph-gophers/graphql-go package (https://github.com/graph-gophers/graphql-go).

We use the tracing mechanism available in the https://godoc.org/github.com/graph-gophers/graphql-go/trace subpackage. Create a new Tracer with `NewTracer` and pass it as an additional option to `MustParseSchema`.

Example

package main

import (
	"log"
	"net/http"

	graphql "github.com/graph-gophers/graphql-go"
	"github.com/graph-gophers/graphql-go/relay"
	graphqltrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go"
)

type resolver struct{}

func (*resolver) Hello() string { return "Hello, world!" }

func main() {
	s := `
		schema {
			query: Query
		}
		type Query {
			hello: String!
		}
	`
	schema := graphql.MustParseSchema(s, new(resolver),
		graphql.Tracer(graphqltrace.NewTracer()))
	http.Handle("/query", &relay.Handler{Schema: schema})
	log.Fatal(http.ListenAndServe(":8080", nil))

	// then:
	// $ curl -XPOST -d '{"query": "{ hello }"}' localhost:8080/query
}

Index

• func NewTracer(opts ...Option) trace.Tracer
• type Option
  • func WithServiceName(name string) Option
• type Tracer
  • func (t *Tracer) TraceField(ctx context.Context, label string, typeName string, fieldName string, ...) (context.Context, trace.TraceFieldFinishFunc)
  • func (t *Tracer) TraceQuery(ctx context.Context, queryString string, operationName string, ...) (context.Context, trace.TraceQueryFinishFunc)

Examples

• Package

Functions

func NewTracer

func NewTracer(opts ...Option) trace.Tracer

NewTracer creates a new Tracer.

Types

type Option

type Option func(*config)

Option represents an option that can be used customize the Tracer.

func WithServiceName

func WithServiceName(name string) Option

WithServiceName sets the given service name for the client.

type Tracer

type Tracer struct {
	// contains filtered or unexported fields
}

A Tracer implements the graphql-go/trace.Tracer interface by sending traces to the Datadog tracer.

func (*Tracer) TraceField

func (t *Tracer) TraceField(ctx context.Context, label string, typeName string, fieldName string, trivial bool, args map[string]interface{}) (context.Context, trace.TraceFieldFinishFunc)

TraceField traces a GraphQL field access.

func (*Tracer) TraceQuery

func (t *Tracer) TraceQuery(ctx context.Context, queryString string, operationName string, variables map[string]interface{}, varTypes map[string]*introspection.Type) (context.Context, trace.TraceQueryFinishFunc)

TraceQuery traces a GraphQL query.