# README
Warning
OpenCensus and OpenTracing have merged to form OpenTelemetry, which serves as the next major version of OpenCensus and OpenTracing.
OpenTelemetry has now reached feature parity with OpenCensus, with tracing and metrics SDKs available in .NET, Golang, Java, NodeJS, and Python. All OpenCensus Github repositories, except census-instrumentation/opencensus-python, will be archived on July 31st, 2023. We encourage users to migrate to OpenTelemetry by this date.
To help you gradually migrate your instrumentation to OpenTelemetry, bridges are available in Java, Go, Python, and JS. Read the full blog post to learn more.
aws
aws package defines an exporter that publishes spans to AWS X-Ray.
Installation
go get contrib.go.opencensus.io/exporter/aws
To Do
-
Publish spans in a separate goroutine -
Support propagation of http spans -
Support remote spans -
Verified works with ELB/ALB -
Report errors / exceptions -
Publish partial segments; currently only completed segments are published to aws
# Packages
No description provided by the author
# Functions
NewExporter returns an implementation of trace.Exporter that uploads spans to AWS X-Ray.
ParseTraceHeader parses an Amazon trace header to OpenCensus span context.
TraceHeader converts an OpenCensus span context to AWS X-Ray trace header.
WithAPI - optional manually constructed api instance.
WithBlacklist filters out the spans those names match one of the given regexps.
WithBufferSize - specifies the maximum number of spans to buffer before publishing them; defaults to 100.
WithInterval - specifies longest time before buffered spans are published; defaults to 1s.
WithOnExport - function to be called when spans are published to AWS; useful if you would like the traceID used for AWS.
WithOrigin - specifies the aws origin of the span; currently supported are OriginEC2, OriginECS, and OriginEB.
WithOutput - optional writer for error messages.
WithRegion - optional aws region to send xray messages to.
WithServiceName - specifies the service name the exporter will report to xray.
WithVersion - specifies the version of the application running.
# Structs
Exporter is an implementation of trace.Exporter that uploads spans to AWS XRay.
HTTPFormat implements propagation.HTTPFormat to propagate traces in HTTP headers for for Amazon services: ELB, ALB, Lambda, etc.
OnExport structure passed when a root segment is published.
# Interfaces
No description provided by the author