gtrace

README

Google Cloud Trace in Go for Cloud Run and Cloud Functions

Documentation

Overview

Package gtrace implements tracing for Google Cloud Run and Cloud Functions.

Example

package main

import (
	"net/http"
	"os"

	"github.com/ncruces/go-gcp/glog"
	"github.com/ncruces/go-gcp/gtrace"
)

func main() {
	go gtrace.Init()
	glog.Notice("Starting server...")

	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}

	http.HandleFunc("/", http.NotFound)

	glog.Critical(http.ListenAndServe(":"+port, gtrace.NewHTTPHandler()))
}

Index

• Variables
• func Init() (err error)
• func NewHTTPClient() *http.Client
• func NewHTTPHandler() http.Handler
• func NewHTTPTransport() http.RoundTripper
• type HTTPFormat

Examples

• Package

Variables

var ProjectID string = os.Getenv("GOOGLE_CLOUD_PROJECT")

ProjectID should be set to the Google Cloud project ID.

Functions

func Init

func Init() (err error)

Init initializes Cloud Trace. Can be called multiple times. Logs the error if called asynchronously.

func NewHTTPClient

func NewHTTPClient() *http.Client

NewHTTPClient returns a tracing http.Client.

func NewHTTPHandler

func NewHTTPHandler() http.Handler

NewHTTPHandler returns a tracing http.Handler.

func NewHTTPTransport

func NewHTTPTransport() http.RoundTripper

NewHTTPTransport returns a tracing http.RoundTripper.

Types

type HTTPFormat

type HTTPFormat struct {
	propagation.HTTPFormat
}

HTTPFormat implements propagation.HTTPFormat to propagate traces in HTTP headers for Cloud Trace.