Tasks

[nikhilNava]

Tasks

1. Introduce client IP address tracking
2. Introduce size limit on span

[Copilot]

Pull request overview

This pull request introduces two key features to the observability framework: client IP address tracking and span size limiting to prevent oversized telemetry data.

• Client IP tracking for both regular callers and agent-to-agent scenarios with automatic IPv4/IPv6 validation and normalization
• Span size limitation (250KB) with intelligent attribute truncation that prioritizes removing largest attributes first
• Reorganization of trace processor attributes to distinguish between common and invoke-agent-specific contexts

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
tests/observability/core/test_utils.py	New test file validating IP address normalization for IPv4/IPv6 and edge cases
tests/observability/core/test_invoke_agent_scope.py	Added constant imports and test for caller agent client IP attribute propagation
tests/observability/core/test_baggage_builder.py	Added tests for caller_client_ip method with IPv4/IPv6 validation scenarios
tests/observability/core/exporters/test_utils.py	New test file validating span truncation logic for various span sizes
libraries/.../core/utils.py	Added validate_and_normalize_ip utility function for IP validation using ipaddress module
libraries/.../core/trace_processor/util.py	Moved execution source attributes to COMMON_ATTRIBUTES and added caller client IP
libraries/.../middleware/baggage_builder.py	Added caller_client_ip method with IP validation, removed deprecated source_metadata_id method
libraries/.../core/invoke_agent_scope.py	Added client IP validation and span attribute setting for agent-to-agent callers
libraries/.../exporters/utils.py	Implemented truncate_span_if_needed function with 250KB size limit and largest-first truncation
libraries/.../exporters/agent365_exporter.py	Integrated span truncation into the _map_span method
libraries/.../core/constants.py	Added GEN_AI_CALLER_CLIENT_IP_KEY and GEN_AI_CALLER_AGENT_USER_CLIENT_IP constants
libraries/.../core/agent_details.py	Added agent_client_ip field and updated docstrings for clarity

---

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.