api

Documentation

Overview

Package api provides functions to trace the google.golang.org/api package.

Example

package main

import (
	"fmt"

	cloudresourcemanager "google.golang.org/api/cloudresourcemanager/v1"

	apitrace "github.com/liquidm/dd-trace-go/contrib/google.golang.org/api"
)

func main() {
	// create an oauth2 client suitable for use with the google APIs
	client, _ := apitrace.NewClient(
		// set scopes like this, which will vary depending on the service
		apitrace.WithScopes(cloudresourcemanager.CloudPlatformScope))
	svc, _ := cloudresourcemanager.New(client)

	// call google api methods as usual
	res, _ := svc.Projects.List().Do()
	for _, project := range res.Projects {
		fmt.Println(project.Name)
	}
}

Index

• func NewClient(options ...Option) (*http.Client, error)
• func WrapRoundTripper(transport http.RoundTripper, options ...Option) http.RoundTripper
• type Option
  • func WithAnalytics(on bool) Option
  • func WithAnalyticsRate(rate float64) Option
  • func WithContext(ctx context.Context) Option
  • func WithScopes(scopes ...string) Option
  • func WithServiceName(serviceName string) Option

Examples

• Package

Functions

func NewClient

func NewClient(options ...Option) (*http.Client, error)

NewClient creates a new oauth http client suitable for use with the google APIs with all requests traced automatically.

func WrapRoundTripper

func WrapRoundTripper(transport http.RoundTripper, options ...Option) http.RoundTripper

WrapRoundTripper wraps a RoundTripper intended for interfacing with Google APIs and traces all requests.

Types

type Option

type Option func(*config)

An Option customizes the config.

func WithAnalytics

func WithAnalytics(on bool) Option

WithAnalytics enables Trace Analytics for all started spans.

func WithAnalyticsRate

func WithAnalyticsRate(rate float64) Option

WithAnalyticsRate sets the sampling rate for Trace Analytics events correlated to started spans.

func WithContext

func WithContext(ctx context.Context) Option

WithContext sets the context in the config. This can be used to set span parents or pass a context through to the underlying client constructor.

func WithScopes

func WithScopes(scopes ...string) Option

WithScopes sets the scopes used to create the oauth2 config for Google APIs.

func WithServiceName

func WithServiceName(serviceName string) Option

WithServiceName sets the service name in the config. The default service name is inferred from the API definitions based on the http request route.