otelaws

Documentation

Index

• Constants
• func AppendMiddlewares(apiOptions *[]func(*middleware.Stack) error, opts ...Option)
• func DefaultAttributeBuilder(ctx context.Context, in middleware.InitializeInput, ...) []attribute.KeyValue
• func DefaultAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue
• func DynamoDBAttributeBuilder(ctx context.Context, in middleware.InitializeInput, ...) []attribute.KeyValue
• func DynamoDBAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue
• func OperationAttr(operation string) attribute.KeyValue
• func RegionAttr(region string) attribute.KeyValue
• func RequestIDAttr(requestID string) attribute.KeyValue
• func SNSAttributeBuilder(ctx context.Context, in middleware.InitializeInput, ...) []attribute.KeyValue
• func SNSAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue
• func SQSAttributeBuilder(ctx context.Context, in middleware.InitializeInput, ...) []attribute.KeyValue
• func SQSAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue
• func SemVersion() string
• func ServiceAttr(service string) attribute.KeyValue
• func SystemAttr() attribute.KeyValue
• func Version() string
• type AttributeBuilder
• type AttributeSetter
• type Option
  • func WithAttributeBuilder(attributeBuilders ...AttributeBuilder) Option
  • func WithAttributeSetter(attributesetters ...AttributeSetter) Option
  • func WithTextMapPropagator(propagator propagation.TextMapPropagator) Option
  • func WithTracerProvider(provider trace.TracerProvider) Option

Constants

const (
	RegionKey    attribute.Key = "aws.region"
	RequestIDKey attribute.Key = "aws.request_id"
	AWSSystemVal string        = "aws-api"
)

AWS attributes.

const (
	// ScopeName is the instrumentation scope name.
	ScopeName = "go.opentelemetry.io/contrib/instrumentation/github.com/aws/aws-sdk-go-v2/otelaws"
)

Functions

func AppendMiddlewares

func AppendMiddlewares(apiOptions *[]func(*middleware.Stack) error, opts ...Option)

AppendMiddlewares attaches OTel middlewares to the AWS Go SDK V2 for instrumentation. OTel middlewares can be appended to either all aws clients or a specific operation. Please see more details in https://aws.github.io/aws-sdk-go-v2/docs/middleware/

func DefaultAttributeBuilder

func DefaultAttributeBuilder(ctx context.Context, in middleware.InitializeInput, out middleware.InitializeOutput) []attribute.KeyValue

DefaultAttributeBuilder checks to see if there are service specific attributes available to set for the AWS service. If there are service specific attributes available then they will be included.

func DefaultAttributeSetter

func DefaultAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue

DefaultAttributeSetter checks to see if there are service specific attributes available to set for the AWS service. If there are service specific attributes available then they will be included.

Deprecated: Use DefaultAttributeBuilder instead. This will be removed in a future release.

func DynamoDBAttributeBuilder

func DynamoDBAttributeBuilder(ctx context.Context, in middleware.InitializeInput, out middleware.InitializeOutput) []attribute.KeyValue

DynamoDBAttributeBuilder sets DynamoDB specific attributes depending on the DynamoDB operation being performed.

func DynamoDBAttributeSetter

func DynamoDBAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue

DynamoDBAttributeSetter sets DynamoDB specific attributes depending on the DynamoDB operation being performed.

Deprecated: Use DynamoDBAttributeBuilder instead. This will be removed in a future release.

func OperationAttr

func OperationAttr(operation string) attribute.KeyValue

OperationAttr returns the AWS operation attribute.

func RegionAttr

func RegionAttr(region string) attribute.KeyValue

RegionAttr returns the AWS region attribute.

func RequestIDAttr

func RequestIDAttr(requestID string) attribute.KeyValue

RequestIDAttr returns the AWS request ID attribute.

func SNSAttributeBuilder

func SNSAttributeBuilder(ctx context.Context, in middleware.InitializeInput, out middleware.InitializeOutput) []attribute.KeyValue

SNSAttributeBuilder sets SNS specific attributes depending on the SNS operation is being performed.

func SNSAttributeSetter

func SNSAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue

SNSAttributeSetter sets SNS specific attributes depending on the SNS operation is being performed.

Deprecated: Use SNSAttributeBuilder instead. This will be removed in a future release.

func SQSAttributeBuilder

func SQSAttributeBuilder(ctx context.Context, in middleware.InitializeInput, out middleware.InitializeOutput) []attribute.KeyValue

SQSAttributeBuilder sets SQS specific attributes depending on the SQS operation being performed.

func SQSAttributeSetter

func SQSAttributeSetter(ctx context.Context, in middleware.InitializeInput) []attribute.KeyValue

SQSAttributeSetter sets SQS specific attributes depending on the SQS operation being performed.

Deprecated: Use SQSAttributeBuilder instead. This will be removed in a future release.

func SemVersion

func SemVersion() string

SemVersion is the semantic version to be supplied to tracer/meter creation.

Deprecated: Use Version instead.

func ServiceAttr

func ServiceAttr(service string) attribute.KeyValue

ServiceAttr returns the AWS service attribute.

func SystemAttr

func SystemAttr() attribute.KeyValue

SystemAttr return the AWS RPC system attribute.

func Version

func Version() string

Version is the current release version of the AWS SDKv2 instrumentation.

Types

type AttributeBuilder

type AttributeBuilder func(ctx context.Context, in middleware.InitializeInput, out middleware.InitializeOutput) []attribute.KeyValue

AttributeBuilder returns an array of KeyValue pairs, it can be used to set custom attributes.

type AttributeSetter

type AttributeSetter func(context.Context, middleware.InitializeInput) []attribute.KeyValue

AttributeSetter returns an array of KeyValue pairs, it can be used to set custom attributes.

Deprecated: Use AttributeBuilder instead. This will be removed in a future release.

type Option

type Option interface {
	// contains filtered or unexported methods
}

Option applies an option value.

func WithAttributeBuilder

func WithAttributeBuilder(attributeBuilders ...AttributeBuilder) Option

WithAttributeBuilder specifies an attribute setter function for setting service specific attributes. If none is specified, the service will be determined by the DefaultAttributeBuilder function and the corresponding attributes will be included.

func WithAttributeSetter

func WithAttributeSetter(attributesetters ...AttributeSetter) Option

WithAttributeSetter specifies an attribute setter function for setting service specific attributes. If none is specified, the service will be determined by the DefaultAttributeBuilder function and the corresponding attributes will be included.

func WithTextMapPropagator

func WithTextMapPropagator(propagator propagation.TextMapPropagator) Option

WithTextMapPropagator specifies a Text Map Propagator to use when propagating context. If none is specified, the global TextMapPropagator is used.

func WithTracerProvider

func WithTracerProvider(provider trace.TracerProvider) Option

WithTracerProvider specifies a tracer provider to use for creating a tracer. If none is specified, the global TracerProvider is used.