tracing

package
v0.5.12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 17, 2026 License: Apache-2.0 Imports: 26 Imported by: 0

Documentation

Index

Constants

View Source
const (
	HeaderFlyTraceId = "fly-trace-id"
	HeaderFlySpanId  = "fly-span-id"
)

Variables

This section is empty.

Functions

func CMDSpan added in v0.1.148

func CMDSpan(ctx context.Context, spanName string, opts ...trace.SpanStartOption) (context.Context, trace.Span)

func CreateLinkSpan added in v0.1.148

func CreateLinkSpan(ctx context.Context, res *http.Response)

func ExtractProcessContext added in v0.5.12

func ExtractProcessContext(ctx context.Context) (context.Context, bool)

ExtractProcessContext reads the remote parent supplied by a supervising process.

func FinishWorkflow added in v0.5.12

func FinishWorkflow(ctx context.Context)

FinishWorkflow ends the observation when an interactive session starts.

func GetTracer

func GetTracer() trace.Tracer

func InitTraceProvider

func InitTraceProvider(ctx context.Context, appName string) (*sdktrace.TracerProvider, error)

func InitTraceProviderWithoutApp added in v0.2.37

func InitTraceProviderWithoutApp(ctx context.Context) (*sdktrace.TracerProvider, error)

func NewTransport

func NewTransport(inner http.RoundTripper) http.RoundTripper

func ProcessEnvironment added in v0.5.12

func ProcessEnvironment(ctx context.Context) []string

ProcessEnvironment returns environment overrides for a child process.

func RecordCancellation added in v0.4.108

func RecordCancellation(ctx context.Context, span trace.Span) []attribute.KeyValue

RecordCancellation annotates a span without changing its status. Call before cleanup, using the operation's context (which may be a child of the span's).

func RecordError

func RecordError(ctx context.Context, span trace.Span, err error, description string)

func RecordErrorEvent added in v0.4.108

func RecordErrorEvent(ctx context.Context, span trace.Span, err error, opts ...trace.EventOption)

RecordErrorEvent records the original error along with the cancellation cause at the point the error is observed. Causes are metadata, not additional errors: expected cleanup must not turn a successful operation into a failed span.

func RunWorkflow added in v0.5.11

func RunWorkflow(ctx context.Context, name, app string, run func(context.Context) error) error

RunWorkflow traces a single command with the existing flyctl trace exporter. An unavailable exporter does not prevent the command from running.

func SpanContextFromHeaders added in v0.1.148

func SpanContextFromHeaders(res *http.Response) trace.SpanContext

func StartWorkflowPhase added in v0.5.12

func StartWorkflowPhase(ctx context.Context, name string) (context.Context, func(error))

StartWorkflowPhase returns a completion function for a phase that finishes asynchronously.

func WithDeployTrace added in v0.4.122

func WithDeployTrace(ctx context.Context) context.Context

WithDeployTrace marks this deploy and downstream requests for unconditional retention.

func WorkflowPhase added in v0.5.11

func WorkflowPhase(ctx context.Context, name string, run func(context.Context) error) error

func WorkflowStep added in v0.5.11

func WorkflowStep[T any](ctx context.Context, name string, run func(context.Context) (T, error)) (T, error)

WorkflowStep records a phase of a traced workflow. Its error is conveyed as a status because command errors can contain secrets or connection strings.

Types

type InstrumentedTransport

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

func (*InstrumentedTransport) RoundTrip

func (t *InstrumentedTransport) RoundTrip(req *http.Request) (*http.Response, error)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL