Skip to content

adk-telemetry: support Vorpal bridge schema v2 - #274

Merged
Asher Johnson Hogan (asherjh) merged 2 commits into
release/planner-landing-pagefrom
users/asherj/agentconfig-telemetry-identity
Sep 12, 2026
Merged

Asher Johnson Hogan (asherjh) merged 2 commits into
release/planner-landing-pagefrom
users/asherj/agentconfig-telemetry-identity

Conversation

@asherjh

Copy link
Copy Markdown

Establishes the schema-version 2 receiver contract for Vorpal's first telemetry shipment and initializes ADK tenant context from the authenticated AgentConfiguration client.

  • validates immutable batch IDs, source timestamps, mount-relative timing, sequence numbers, levels, themes, and canonical operation UUIDs
  • projects envelope, host, occurrence, and operation metadata through the existing adk.client.event emission and buffering path
  • preserves raw build, platform, user-agent, and operation values through dedicated fields while retaining generic property scrubbing
  • keeps deterministic bridge rejections structured through the real app-only FastMCP call_tool path
  • documents the emitted Kusto field set, chronology, and retry deduplication key
  • seeds tenant ID and cached tenant name from the authenticated landing-page client

Testing

  • python -m pytest tests/test_adk_telemetry.py tests/test_adk_mcp_report_client_events.py tests/mcp/agentconfig/test_server_contract.py tests/mcp/agentconfig/test_widget_protocol.py tests/mcp/agentconfig/test_skill_orchestration.py -q
  • python -m ruff check solutions/ess-maker-skills/scripts/adk_telemetry.py solutions/ess-maker-skills/src/mcp/agentconfig_landing_page/server.py tests/test_adk_telemetry.py tests/test_adk_mcp_report_client_events.py tests/mcp/agentconfig/test_server_contract.py

Establish the receiver contract Vorpal needs for its first telemetry shipment while ensuring authenticated landing-page sessions populate ADK tenant context.

- validate schema-v2 batches, source chronology, host context, and operation UUIDs
- project the fixed v2 client field set through emission, buffering, and retries
- forward every envelope field through the app-only FastMCP tool boundary
- initialize telemetry identity from the authenticated AgentConfiguration tenant
- document the Kusto projection and cover accepted/rejected contract behavior

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: c1ee87cf-b50d-4bcf-aeb4-28a3ba909c88
Align the ADK schema-v2 receiver with Vorpal's timezone-aware ISO timestamp contract so Kusto retains the source timestamp in its supplied representation.

- require eventTimestamp as a timezone-aware ISO-8601 string
- project the value unchanged as client_event_timestamp
- update query documentation and bridge contract coverage
- remove the temporary local bridge diagnostic

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: c1ee87cf-b50d-4bcf-aeb4-28a3ba909c88
@asherjh
Asher Johnson Hogan (asherjh) merged commit 4a53e95 into release/planner-landing-page Sep 12, 2026
6 checks passed
@asherjh
Asher Johnson Hogan (asherjh) deleted the users/asherj/agentconfig-telemetry-identity branch September 12, 2026 02:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants