Skip to content

Documentation Update: Need X-Ray VPC endpoint for private VPC deployment mode#59

Merged
kaleko merged 1 commit intomainfrom
fix/xray-vpc-endpoint
Mar 16, 2026
Merged

Documentation Update: Need X-Ray VPC endpoint for private VPC deployment mode#59
kaleko merged 1 commit intomainfrom
fix/xray-vpc-endpoint

Conversation

@gauharbains
Copy link

@gauharbains gauharbains commented Mar 15, 2026

Description of changes:
This PR updates the deployment documentation for deployments in private VPC mode where AgentCore Runtime runs in private subnets without internet access. The OpenTelemetry instrumentation (aws-opentelemetry-distro) is configured on all agent patterns and exports traces to AWS X-Ray. Without the com.amazonaws.{region}.xray VPC interface endpoint reachable from the runtime's subnets, trace export silently fails — the BatchSpanProcessor retries every 5 seconds and never succeeds.

@gauharbains gauharbains requested a review from a team March 15, 2026 19:17
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 15, 2026
@harshitkgupta
Copy link

How changing the deployment.md updates the VPC?

@gauharbains gauharbains changed the title X-Ray VPC endpoint for private (VPC) deployment mode Documentation Update: Need X-Ray VPC endpoint for private VPC deployment mode Mar 15, 2026
@gauharbains
Copy link
Author

How changing the deployment.md updates the VPC? @harshitkgupta

This documentation change is for private VPC deployments, where a user wants to deploy the runtime in their own VPC. The VPC must have certain endpoints configured. This update adds documentation for an additional required endpoint.

@kaleko kaleko merged commit 7f1255a into main Mar 16, 2026
9 checks passed
@kaleko
Copy link
Contributor

kaleko commented Mar 16, 2026

@harshitkgupta for clarification, the way FAST supports VPC deployments is:

  1. Provide instructions for the users to set up their own VPC or configure their existing VPC (FAST does not create any VPCs)
  2. User provides VPC information (e.g. ARN) in the config.yaml
  3. FAST deploys runtime into the existing VPC

This PR just improves the documentation for step # 1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants