github aws-observability/aws-otel-python-instrumentation v0.23.0
Release v0.23.0

57 minutes ago

What's Changed

  • fix(crewai): record full tool definitions (name, description, and parameters) on CrewAI chat, invoke_agent, and invoke_workflow spans (#972)

  • fix: add the experimental opt-in OTEL_AWS_EXPERIMENTAL_LOGS_SIZE_ESTIMATE_UNLIMITED_DEPTH=true to include content nested beyond three levels when estimating CloudWatch Logs batch sizes. The default depth remains 3. This interim workaround reduces depth-related underestimation while legacy Gen AI log paths are migrated. (#944)

  • feat: support disabling Bedrock SDK instrumentation Setting OTEL_PYTHON_DISABLED_INSTRUMENTATIONS=bedrock skips SDK telemetry from Bedrock GenAI operations in botocore and aiobotocore, while keeping AgentCore and other AWS services instrumented. (#976)

  • fix(langchain): resolve response model and ID from generation metadata (#974)

  • feat: add CrewAI LiteAgent support. The CrewAI instrumentor now handles the LiteAgentExecution* events emitted by standalone Agent.kickoff() / kickoff_async(), so these runs produce an invoke_agent span and their LLM and tool spans stay in the caller's trace instead of each starting a new trace. (#955)

  • fix: prevent the GenAI nested CLIENT span processor from retaining state for remote or untracked parents, abandoned spans, or children that end after their parents. (#971)

  • fix: CrewAI error spans now set error.type to the exception class (for example TimeoutError), or _OTHER when it is unknown, instead of the full error message. The message could contain task descriptions, tool arguments or provider details, and made error.type unusable for grouping errors. The message is still recorded as the span status description. (#962)

  • fix(langchain): record gen_ai.tool.definitions (name, description, and parameters) on LangChain/LangGraph LLM spans for tools bound to the model, matching the upstream OpenTelemetry LangChain instrumentation (#966)

  • fix: in Lambda, treat OTEL_EXPORTER_OTLP_ENDPOINT as a custom trace endpoint, as the OTLP exporter spec requires. Setting only the generic endpoint previously fell back to the X-Ray UDP exporter, so traces never reached the configured collector (#562)

Upstream Components

  • opentelemetry-api - 1.45.2
  • opentelemetry-sdk - 1.45.2
  • opentelemetry-exporter-otlp-proto-grpc - 1.45.2
  • opentelemetry-exporter-otlp-proto-http - 1.45.2
  • opentelemetry-propagator-b3 - 1.45.2
  • opentelemetry-propagator-jaeger - 1.45.2
  • opentelemetry-exporter-otlp-proto-common - 1.45.2
  • opentelemetry-sdk-extension-aws - 2.1.0
  • opentelemetry-propagator-aws-xray - 1.0.2
  • opentelemetry-distro - 0.66b2
  • opentelemetry-processor-baggage - 0.66b2
  • opentelemetry-propagator-ot-trace - 0.66b2
  • opentelemetry-instrumentation - 0.66b2
  • opentelemetry-instrumentation-aws-lambda - 0.66b2
  • opentelemetry-instrumentation-aio-pika - 0.66b2
  • opentelemetry-instrumentation-aiohttp-client - 0.66b2
  • opentelemetry-instrumentation-aiokafka - 0.66b2
  • opentelemetry-instrumentation-aiopg - 0.66b2
  • opentelemetry-instrumentation-asgi - 0.66b2
  • opentelemetry-instrumentation-asyncpg - 0.66b2
  • opentelemetry-instrumentation-boto3sqs - 0.66b2
  • opentelemetry-instrumentation-botocore - 0.66b2
  • opentelemetry-instrumentation-celery - 0.66b2
  • opentelemetry-instrumentation-confluent-kafka - 0.66b2
  • opentelemetry-instrumentation-dbapi - 0.66b2
  • opentelemetry-instrumentation-django - 0.66b2
  • opentelemetry-instrumentation-falcon - 0.66b2
  • opentelemetry-instrumentation-fastapi - 0.66b2
  • opentelemetry-instrumentation-flask - 0.66b2
  • opentelemetry-instrumentation-grpc - 0.66b2
  • opentelemetry-instrumentation-httpx - 0.66b2
  • opentelemetry-instrumentation-jinja2 - 0.66b2
  • opentelemetry-instrumentation-kafka-python - 0.66b2
  • opentelemetry-instrumentation-logging - 0.66b2
  • opentelemetry-instrumentation-mysql - 0.66b2
  • opentelemetry-instrumentation-mysqlclient - 0.66b2
  • opentelemetry-instrumentation-pika - 0.66b2
  • opentelemetry-instrumentation-psycopg2 - 0.66b2
  • opentelemetry-instrumentation-pymemcache - 0.66b2
  • opentelemetry-instrumentation-pymongo - 0.66b2
  • opentelemetry-instrumentation-pymysql - 0.66b2
  • opentelemetry-instrumentation-pyramid - 0.66b2
  • opentelemetry-instrumentation-redis - 0.66b2
  • opentelemetry-instrumentation-remoulade - 0.66b2
  • opentelemetry-instrumentation-requests - 0.66b2
  • opentelemetry-instrumentation-sqlalchemy - 0.66b2
  • opentelemetry-instrumentation-sqlite3 - 0.66b2
  • opentelemetry-instrumentation-starlette - 0.66b2
  • opentelemetry-instrumentation-system-metrics - 0.66b2
  • opentelemetry-instrumentation-threading - 0.66b2
  • opentelemetry-instrumentation-tornado - 0.66b2
  • opentelemetry-instrumentation-tortoiseorm - 0.66b2
  • opentelemetry-instrumentation-urllib - 0.66b2
  • opentelemetry-instrumentation-urllib3 - 0.66b2
  • opentelemetry-instrumentation-wsgi - 0.66b2
  • opentelemetry-instrumentation-cassandra - 0.66b2
  • cachetools - 6.2.4
  • urllib3 >= 2.7.0; python_version >= '3.10'
  • requests ~= 2.25
  • certifi >= 2026.10.18
  • protobuf - 6.33.5
  • pyyaml - 6.0.3
  • python-dateutil >= 2.7.0
  • bytecode; python_version >= '3.10' and python_version < '3.12'

Release Artifacts

This release publishes to public ECR and PyPi.

Lambda Layer

This release includes the AWS OpenTelemetry Lambda Layer for Python version 0.23.0-6fcf8b6.

Lambda Layer ARNs:

Region Layer ARN
af-south-1 arn:aws:lambda:af-south-1:904233096616:layer:AWSOpenTelemetryDistroPython:28
ap-east-1 arn:aws:lambda:ap-east-1:888577020596:layer:AWSOpenTelemetryDistroPython:28
ap-east-2 arn:aws:lambda:ap-east-2:412664885777:layer:AWSOpenTelemetryDistroPython:9
ap-northeast-1 arn:aws:lambda:ap-northeast-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
ap-northeast-2 arn:aws:lambda:ap-northeast-2:615299751070:layer:AWSOpenTelemetryDistroPython:31
ap-northeast-3 arn:aws:lambda:ap-northeast-3:615299751070:layer:AWSOpenTelemetryDistroPython:31
ap-south-1 arn:aws:lambda:ap-south-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
ap-south-2 arn:aws:lambda:ap-south-2:796973505492:layer:AWSOpenTelemetryDistroPython:28
ap-southeast-1 arn:aws:lambda:ap-southeast-1:615299751070:layer:AWSOpenTelemetryDistroPython:30
ap-southeast-2 arn:aws:lambda:ap-southeast-2:615299751070:layer:AWSOpenTelemetryDistroPython:31
ap-southeast-3 arn:aws:lambda:ap-southeast-3:039612877180:layer:AWSOpenTelemetryDistroPython:28
ap-southeast-4 arn:aws:lambda:ap-southeast-4:713881805771:layer:AWSOpenTelemetryDistroPython:28
ap-southeast-5 arn:aws:lambda:ap-southeast-5:152034782359:layer:AWSOpenTelemetryDistroPython:19
ap-southeast-6 arn:aws:lambda:ap-southeast-6:313828097273:layer:AWSOpenTelemetryDistroPython:8
ap-southeast-7 arn:aws:lambda:ap-southeast-7:980416031188:layer:AWSOpenTelemetryDistroPython:19
ca-central-1 arn:aws:lambda:ca-central-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
ca-west-1 arn:aws:lambda:ca-west-1:595944127152:layer:AWSOpenTelemetryDistroPython:19
cn-north-1 arn:aws-cn:lambda:cn-north-1:440179912924:layer:AWSOpenTelemetryDistroPython:19
cn-northwest-1 arn:aws-cn:lambda:cn-northwest-1:440180067931:layer:AWSOpenTelemetryDistroPython:19
eu-central-1 arn:aws:lambda:eu-central-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
eu-central-2 arn:aws:lambda:eu-central-2:156041407956:layer:AWSOpenTelemetryDistroPython:28
eu-north-1 arn:aws:lambda:eu-north-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
eu-south-1 arn:aws:lambda:eu-south-1:257394471194:layer:AWSOpenTelemetryDistroPython:28
eu-south-2 arn:aws:lambda:eu-south-2:490004653786:layer:AWSOpenTelemetryDistroPython:28
eu-west-1 arn:aws:lambda:eu-west-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
eu-west-2 arn:aws:lambda:eu-west-2:615299751070:layer:AWSOpenTelemetryDistroPython:31
eu-west-3 arn:aws:lambda:eu-west-3:615299751070:layer:AWSOpenTelemetryDistroPython:31
il-central-1 arn:aws:lambda:il-central-1:746669239226:layer:AWSOpenTelemetryDistroPython:28
me-central-1 arn:aws:lambda:me-central-1:739275441131:layer:AWSOpenTelemetryDistroPython:27
mx-central-1 arn:aws:lambda:mx-central-1:610118373846:layer:AWSOpenTelemetryDistroPython:19
sa-east-1 arn:aws:lambda:sa-east-1:615299751070:layer:AWSOpenTelemetryDistroPython:31
us-east-1 arn:aws:lambda:us-east-1:615299751070:layer:AWSOpenTelemetryDistroPython:34
us-east-2 arn:aws:lambda:us-east-2:615299751070:layer:AWSOpenTelemetryDistroPython:31
us-west-1 arn:aws:lambda:us-west-1:615299751070:layer:AWSOpenTelemetryDistroPython:38
us-west-2 arn:aws:lambda:us-west-2:615299751070:layer:AWSOpenTelemetryDistroPython:38

Don't miss a new aws-otel-python-instrumentation release

NewReleases is sending notifications on new releases.