OpenTelemetry Boto Instrumentation

Instrument Boto to trace service requests.

There are two options for instrumenting code. The first option is to use the opentelemetry-instrument executable which will automatically instrument your Boto client. The second is to programmatically enable instrumentation via the following code:

Usage

from opentelemetry.instrumentation.boto import BotoInstrumentor
import boto


# Instrument Boto
BotoInstrumentor().instrument()

# This will create a span with Boto-specific attributes
ec2 = boto.ec2.connect_to_region("us-west-2")
ec2.get_all_instances()

API

class opentelemetry.instrumentation.boto.BotoInstrumentor(*args, **kwargs)[source]

Bases: opentelemetry.instrumentation.instrumentor.BaseInstrumentor

A instrumentor for Boto

See BaseInstrumentor

instrumentation_dependencies()[source]

Return a list of python packages with versions that the will be instrumented.

The format should be the same as used in requirements.txt or setup.py.

For example, if an instrumentation instruments requests 1.x, this method should look like:

def instrumentation_dependencies(self) -> Collection[str]:

return [‘requests ~= 1.0’]

This will ensure that the instrumentation will only be used when the specified library is present in the environment.

Return type

Collection[str]

opentelemetry.instrumentation.boto.flatten_dict(dict_, sep='.', prefix='')[source]

Returns a normalized dict of depth 1 with keys in order of embedding

opentelemetry.instrumentation.boto.add_span_arg_tags(span, aws_service, args, args_names, args_traced)[source]