package trace

import "cloud.google.com/go/cloudsqlconn/internal/trace"

Index ¶

• func InitMetrics() error
• func RecordBytesReceived(ctx context.Context, num int64, instance, dialerID string)
• func RecordBytesSent(ctx context.Context, num int64, instance, dialerID string)
• func RecordDialError(ctx context.Context, instance, dialerID string, err error)
• func RecordDialLatency(ctx context.Context, instance, dialerID string, latency int64)
• func RecordOpenConnections(ctx context.Context, num int64, dialerID, instance string)
• func RecordRefreshResult(ctx context.Context, instance, dialerID string, err error)
• type Attribute
• func AddDialerID(dialerID string) Attribute
• func AddInstanceName(name string) Attribute
• type EndSpanFunc
• func StartSpan(ctx context.Context, name string, attrs ...Attribute) (context.Context, EndSpanFunc)

Functions ¶

func InitMetrics ¶

func InitMetrics() error

InitMetrics registers all views once. Without registering views, metrics will not be reported. If any names of the registered views conflict, this function returns an error to indicate an internal configuration problem.

func RecordBytesReceived ¶

func RecordBytesReceived(ctx context.Context, num int64, instance, dialerID string)

RecordBytesReceived reports the number of bytes received from Cloud SQL

func RecordBytesSent ¶

func RecordBytesSent(ctx context.Context, num int64, instance, dialerID string)

RecordBytesSent reports the number of bytes sent to Cloud SQL

func RecordDialError ¶

func RecordDialError(ctx context.Context, instance, dialerID string, err error)

RecordDialError reports a failed dial attempt. If err is nil, RecordDialError is a no-op.

func RecordDialLatency ¶

func RecordDialLatency(ctx context.Context, instance, dialerID string, latency int64)

RecordDialLatency records a latency value for a call to dial.

func RecordOpenConnections ¶

func RecordOpenConnections(ctx context.Context, num int64, dialerID, instance string)

RecordOpenConnections records the number of open connections

func RecordRefreshResult ¶

func RecordRefreshResult(ctx context.Context, instance, dialerID string, err error)

RecordRefreshResult reports the result of a refresh operation, either successfull or failed.

Types ¶

type Attribute ¶

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

Attribute annotates a span with additional data.

func AddDialerID ¶

func AddDialerID(dialerID string) Attribute

AddDialerID creates an attribute to identify a particular dialer.

func AddInstanceName ¶

func AddInstanceName(name string) Attribute

AddInstanceName creates an attribute with the Cloud SQL instance name.

type EndSpanFunc ¶

type EndSpanFunc func(error)

EndSpanFunc is a function that ends a span, reporting an error if necessary.

func StartSpan ¶

func StartSpan(ctx context.Context, name string, attrs ...Attribute) (context.Context, EndSpanFunc)

StartSpan begins a span with the provided name and returns a context and a function to end the created span.

Source Files ¶

metrics.go trace.go