# Private Link

Nimbus lets you set up private connectivity between your cloud provider and Nimbus.

## How it Works

![Datadog to Nimbus](https://ik.imagekit.io/fpjzhqpv1/Excalidraw_8CVOZRM7R.png?updatedAt=1713226588813)

With Nimbus Private Link, you can directly connect your VPC with Nimbus using AWS VPC Endpoints. Note that this is currently only supported for `AWS` accounts in region `us-east-1`.

## Benefits

* cost reduction: with private link, your egress cost go down by 90% (regular egress on AWS is $0.09/GB. With private link, this becomes $0.01/GB)
* compliance and security: prevent sensitive data from traversing the public internet

## Setup

### 1. Create a VPCEndpoint using our cloudformation template

[![Launch Stack](https://cdn.rawgit.com/buildkite/cloudformation-launch-stack-button-svg/master/launch-stack.svg)](https://console.aws.amazon.com/cloudformation/home#/stacks/new?stackName=nimbus-privatelink\&templateURL=https://nimbuscommonstack-nimbuspublicassetsde3f333d-vidman8dlq9v.s3.amazonaws.com/docs/private-link-prod.yaml)

Ensure Cloudformation stack is in status `CREATE_COMPLETE` and VPC Endpoint is Available with has Private DNS names enabled before proceeding

![Nimbus Private Link Setup](https://ik.imagekit.io/fpjzhqpv1/Cursor_and_cust_enable-privatelink_DLjvdf5Bw.png?updatedAt=1713228305706)

### 2. Verify the connection

You can test the endpoint by sending data to `$API_KEY-http-intake.privatelink.logs.us1.nimbus.dev` in a connected subnet

```sh
curl -v -d "{msg: ping}" https://$API_KEY-http-intake.privatelink.logs.us1.nimbus.dev 
```

> NOTE: Sending the request outside of the connected VPC will result in `403` response

### 3. Update your Nimbus Endpoints

To switch over to private link, update your Nimbus endpoint. to the new schema by adding `privatelink` to your Nimbus endpoint.

See [integrations](/integrations/integrations.datadog.md) specific docs for your integration endpoints.

```diff
- https://$API_KEY-$INTEGRATION-intake.logs.us1.nimbus.dev
+ https://$API_KEY-$INTEGRATION-intake.privatelink.logs.us1.nimbus.dev
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nimbus.dev/additional-features/advanced.private-link.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
