Documentation ¶
Overview ¶
Package api provides functions to trace the google.golang.org/api package.
Example ¶
package main import ( "fmt" apitrace "gitlab.com/otavio3/go-tracer/contrib/google.golang.org/api" cloudresourcemanager "google.golang.org/api/cloudresourcemanager/v1" ) 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) } }
Output:
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewClient ¶
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 ¶
WithAnalytics enables Trace Analytics for all started spans.
func WithAnalyticsRate ¶
WithAnalyticsRate sets the sampling rate for Trace Analytics events correlated to started spans.
func WithContext ¶
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 ¶
WithScopes sets the scopes used to create the oauth2 config for Google APIs.
func WithServiceName ¶
WithServiceName sets the service name in the config. The default service name is inferred from the API definitions based on the http request route.