1. Docs
2. Integrations
3. Amazon Web Services (AWS)
4. AWS PrivateLink

Connect to Honeycomb with AWS PrivateLink

Table of Contents

AWS PrivateLink allows you to create a private connection to Honeycomb’s API over AWS networks.

This has the following advantages:

• Limits API traffic over the internet as requests to https://api.honeycomb.io are transparently handled within AWS networks
• If your infrastructure relies on outbound firewalls, you can manage access to the Honeycomb API with security groups (or rules on your firewall appliance)
• Reduced costs for high volume traffic with other services on PrivateLink. Contact your Honeycomb account team for details.

Before You Begin 

Honeycomb must grant access to each AWS account that requires access to the Honeycomb API via AWS PrivateLink. Contact your Honeycomb account team for details.

Honeycomb hosts an AWS PrivateLink endpoint in the us-east-1 region. VPCs within the region may access it directly, and VPCs outside of this region can utilize VPC Peering.

Configuration Using the AWS Console 

1. Visit the Amazon VPC console in us-east-1.
2. From the left navigation, select Endpoints and choose Create endpoint.
3. For Service category, choose PrivateLink Ready partner services.
4. For the Service name, enter com.amazonaws.vpce.us-east-1.vpce-svc-0878e9afcbb4c4333
5. Select Validate. If the service fails to validate, reach out to your Honeycomb account team.
6. From the Select a VPC list, select the VPCs that contain the services sending traffic to Honeycomb.
7. From the Additional settings dropdown, ensure that Enable DNS name is enabled. This requires that “Enable DNS hostnames” and “Enable DNS support” are enabled for this VPC.
8. Select one subnet per Availability Zone that the PrivateLink Endpoint will be created in. This subnet must contain your services or the ability to route to all subnets where your services are run.
9. Select a security group that allows inbound access on port 443 from your VPC’s network block, such as 10.0.0.0/8. If you do not see a security group, you may need to create one.
10. Choose Create endpoint. The Endpoint console shows a “Pending” status until it is “Available.” Once available, your infrastructure transparently sends data through the connection.

Refer to the AWS documentation on Interface Endpoints for more details about endpoint configuration.

Example Configuration Using Terraform 

resource "aws_vpc_endpoint" "honeycomb" {
  vpc_id            = aws_vpc.main.id
  service_name      = "com.amazonaws.vpce.us-east-1.vpce-svc-0878e9afcbb4c4333"
  vpc_endpoint_type = "Interface"

  subnet_ids         = data.aws_subnets.private.ids

  security_group_ids = [
    aws_security_group.honeycomb_private_endpoint.id,
  ]

  private_dns_enabled = true
}

data "aws_subnets" "private" {
  filter {
    name   = "vpc-id"
    values = [aws_vpc.main.id]
  }
}

resource "aws_security_group" "honeycomb_private_endpoint" {
  name        = "honeycomb_private_endpoint"
  description = "Traffic to Honeycomb endpoint"
  vpc_id      = aws_vpc.main.id

  ingress {
    description      = "TLS from VPC"
    from_port        = 443
    to_port          = 443
    protocol         = "tcp"
    cidr_blocks      = [aws_vpc.main.cidr_block]
    ipv6_cidr_blocks = [aws_vpc.main.ipv6_cidr_block]
  }

  egress {
    from_port        = 0
    to_port          = 0
    protocol         = "-1"
    cidr_blocks      = ["0.0.0.0/0"]
    ipv6_cidr_blocks = ["::/0"]
  }

  tags = {
    Name = "honeycomb_private_endpoint"
  }
}

Monitoring the PrivateLink Endpoint 

AWS captures metrics for each VPC endpoint. These metrics are accessible through the AWS Console and published to CloudWatch. Learn how to send AWS CloudWatch metrics to Honeycomb.

From the AWS Console:

1. Visit the Amazon VPC console in us-east-1.
2. From the left navigation, select Endpoints and choose the endpoint ID.
3. Select the Monitoring tab.

Did you find what you were looking for?

Yes No

---

If you have questions, join our Pollinators Community Slack!
Pro/Enterprise users can visit Honeycomb Support or email support@honeycomb.io.

Submit