Skip to content

AWS PrivateLink Endpoint Services

Collect monitoring data from AWS PrivateLink Endpoint Services.

Configuration

Install Func

We recommend enabling the hosted Func service under Guance Integrations - Extensions. All prerequisites are installed automatically. Then proceed to install the script.

To deploy Func yourself, see Self-hosted Func.

Enable the Script

Tip: Prepare the required AWS access key in advance. For simplicity, you can grant the global read-only permission ReadOnlyAccess.

Enable the Script in Hosted Func

  1. Sign in to the Guance console.
  2. Open the Integrations menu and select Cloud Account Management.
  3. Click Add Cloud Account, select AWS, and enter the required information. Skip this step if the cloud account is already configured.
  4. Click Test. If the test succeeds, click Save. If it fails, verify the configuration and test again.
  5. In Cloud Account Management, find the added cloud account and click it to open its details.
  6. Click Integrations on the cloud account details page. Find AWS PrivateLink Endpoint Services in the Not Installed list, click Install, and complete installation in the dialog.

Enable the Script Manually

  1. Sign in to the Func console, click Script Market to open the Guance script market, and search for integration_aws_vpc_endpoint_service
  2. Click Install, then enter the parameters: AWS AK ID, AK Secret, and account name.
  3. Click Deploy Startup Script. The system automatically creates the Startup script set and configures the startup script. Set regions to the actual regions and set metrics in cloudwatch_configs.targets to ActiveConnections, BytesProcessed, EndpointsCount, NewConnections, and RstPacketsSent. Then publish and enable automatic triggers.
  4. Once enabled, the automatic trigger appears under Management / Automatic Trigger Configuration. Click Execute to run it immediately without waiting for the next scheduled time. After a short wait, check the task execution records and logs.

Verification

  1. Under Management / Automatic Trigger Configuration, confirm that the task has a corresponding automatic trigger. Check its task records and logs for errors.
  2. In Guance, open Infrastructure / Custom and check for asset information.
  3. In Guance, open Metrics and check for the monitoring data.

Metrics

After configuring AWS cloud monitoring, the default metrics are listed below. You can configure collection of additional metrics. The measurement is aws_AWS/PrivateLinkServices. AWS PrivateLink Endpoint Services Metric Details

MetricName MetricDescribe Dimensions Unit
ActiveConnections_Average Active connections through endpoints RegionId, Service Id, Az, Load Balancer Arn, VPC Endpoint Id count
BytesProcessed_Sum Bytes exchanged in both directions between endpoint services and endpoints RegionId, Service Id, Az, Load Balancer Arn, VPC Endpoint Id B
EndpointsCount_Average Endpoints connected to the endpoint service RegionId, Service Id count
NewConnections_Sum New connections established through endpoints RegionId, Service Id, Az, Load Balancer Arn, VPC Endpoint Id count
RstPacketsSent_Sum RST packets sent from the endpoint service to endpoints RegionId, Service Id, Az, Load Balancer Arn, VPC Endpoint Id count

Feedback

Is this page helpful?