Security and network / AWS PrivateLink
Verify and troubleshoot AWS PrivateLink
EnterpriseConfirm Revyl traffic reaches your service, fix common failures, and revoke access
AWS PrivateLink is available on Enterprise plans. Contact your Revyl account team or support@revyl.ai to enable it for your organization before you start.
Verify the connection
Work through these in order. Each check rules out one layer.
Endpoint connection is Available
aws ec2 describe-vpc-endpoint-connections \
--region <service-region> \
--filters Name=service-id,Values=<your-service-id> \
--query "VpcEndpointConnections[].[VpcEndpointId,VpcEndpointOwner,VpcEndpointState]" \
--output tableExpect one row with owner 992382537093 (Revyl) and state available.
Targets are healthy in every zone
aws elbv2 describe-target-health \
--target-group-arn <your-target-group-arn> \
--query "TargetHealthDescriptions[].[Target.Id,Target.AvailabilityZone,TargetHealth.State]" \
--output tableEvery target should be healthy. With cross-zone load balancing on, one
healthy target is enough for all zones.
Traffic is arriving at the NLB
In CloudWatch, under the AWS/NetworkELB namespace, watch NewFlowCount and
ActiveFlowCount for your NLB while Revyl runs a check. On an NLB that only
serves Revyl, a rise during the check means the PrivateLink leg works. On a
shared NLB, your other clients keep these metrics busy, so they prove nothing
about Revyl. Confirm Revyl's request in your target access logs at the time of
the check instead. If your targets can parse it, proxy protocol v2 on the
target group also works: its header carries the VPC endpoint ID. Targets that
cannot parse proxy protocol reject every connection once it is on.
TCP_Target_Reset_Count or TCP_ELB_Reset_Count spikes point at your targets
or listener.
A real job succeeds
Ask Revyl to run the connectivity check again, then run a build or test that depends on the private service. Successful dependency resolution or API calls confirm DNS, routing, and TLS all line up.
Common problems
What to send Revyl support
When you contact support@revyl.ai about a PrivateLink issue, include:
- Your Revyl organization and endpoint service name.
- The hostname and port that fails, and the approximate time of the failure.
- The exact client error, for example the build log line or the app error.
- Output of the endpoint connection and target health checks above.
Do not send credentials, tokens, or certificate private keys.
Offboarding
You can revoke Revyl's access at any time, without involving Revyl.
Reject the endpoint connection. Traffic stops right away.
aws ec2 reject-vpc-endpoint-connections \
--region <service-region> \
--service-id <your-service-id> \
--vpc-endpoint-ids <revyl-endpoint-id>