Skip to content

Commit d467cfc

Browse files
authored
Use http-intake.logs for logs intake (#521)
* Use http-intake.logs for logs intake * Fix typo
1 parent 24dff24 commit d467cfc

File tree

3 files changed

+18
-14
lines changed

3 files changed

+18
-14
lines changed

aws/logs_monitoring/README.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -214,14 +214,16 @@ If you need to ship logs to multiple Datadog organizations or other destinations
214214

215215
### AWS PrivateLink support
216216

217-
You can run the Forwarder in a VPC by using AWS PrivateLink to connect to Datadog. Note that AWS PrivateLink can only be configured with Datadog organizations using the Datadog US site (i.e. datadoghq.com, not datadoghq.eu).
217+
You can run the Forwarder in a VPC private subnet and send data to Datadog over AWS PrivateLink. Note that AWS PrivateLink can only be configured with [Datadog Sites](https://docs.datadoghq.com/getting_started/site/) hosted on AWS (i.e. datadoghq.com, not datadoghq.eu).
218218

219-
1. Follow the [setup instructions](https://docs.datadoghq.com/agent/guide/private-link/?tab=logs#create-your-vpc-endpoint) to add an endpoint to your VPC for Datadog's **API** service.
220-
2. Follow the [same procedure](https://docs.datadoghq.com/agent/guide/private-link/?tab=logs#create-your-vpc-endpoint) to add a second endpoint to your VPC for Datadog's **Logs** service.
221-
3. Follow the [same procedure](https://docs.datadoghq.com/agent/guide/private-link/?tab=logs#create-your-vpc-endpoint) once more to add a third endpoint to your VPC for Datadog's **Traces** service.
222-
4. Unless the Forwarder is deployed to a public subnet, follow the [instructions](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) to add endpoints for Secrets Manager and S3 to the VPC, so that the Forwarder can access those services.
223-
5. When installing the Forwarder with the CloudFormation template, set `DdUsePrivateLink`, `VPCSecurityGroupIds` and `VPCSubnetIds`.
224-
6. Ensure the `DdFetchLambdaTags` option is disabled, because AWS VPC does not yet offer an endpoint for the Resource Groups Tagging API.
219+
1. Follow the [instructions](https://docs.datadoghq.com/agent/guide/private-link/?tab=logs#create-your-vpc-endpoint) to add the Datadog `api`, `http-logs.intake` and `trace.agent` endpoints to your VPC.
220+
2. Follow the [instructions](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) to add the AWS Secrets Manager and S3 endpoints to your VPC.
221+
3. When installing the Forwarder with the CloudFormation template,
222+
1. set `UseVPC` to `true`
223+
2. set `VPCSecurityGroupIds` and `VPCSubnetIds` based on your VPC settings
224+
3. set `DdFetchLambdaTags` to `false`, because AWS Resource Groups Tagging API doesn't support PrivateLink
225+
226+
NOTE: The `DdUsePrivateLink` option has been deprecated. It was previously used to instruct the Forwarder to use a special set of Datadog endpoints for intake. If you have `DdUsePrivateLink` enabled, keep it that way, unless you follow the instructions above to add the Datadog `api`, `http-logs.intake` and `trace.agent` endpoints to your VPC.
225227

226228
### AWS VPC and proxy support
227229

@@ -362,7 +364,7 @@ To test different patterns against your logs, turn on [debug logs](#troubleshoot
362364
`PermissionBoundaryArn`
363365
: ARN for the Permissions Boundary Policy.
364366

365-
`DdUsePrivateLink`
367+
`DdUsePrivateLink` (DEPRECATED)
366368
: Set to true to enable sending logs and metrics via AWS PrivateLink. See https://dtdg.co/private-link.
367369

368370
`DdHttpProxyURL`

aws/logs_monitoring/settings.py

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,7 @@ def get_env_var(envvar, default, boolean=False):
115115
default="{}://trace.agent.{}".format("http" if DD_NO_SSL else "https", DD_SITE),
116116
)
117117

118+
# The TCP transport has been deprecated, migrate to the HTTP intake.
118119
if DD_USE_TCP:
119120
DD_URL = get_env_var("DD_URL", default="lambda-intake.logs." + DD_SITE)
120121
try:
@@ -125,14 +126,17 @@ def get_env_var(envvar, default, boolean=False):
125126
except Exception:
126127
DD_PORT = 10516
127128
else:
128-
DD_URL = get_env_var("DD_URL", default="lambda-http-intake.logs." + DD_SITE)
129+
DD_URL = get_env_var("DD_URL", default="http-intake.logs." + DD_SITE)
129130
DD_PORT = int(get_env_var("DD_PORT", default="443"))
130131

131132
## @param DD_USE_VPC
132133
DD_USE_VPC = get_env_var("DD_USE_VPC", "false", boolean=True)
133134

134-
## @param DD_USE_PRIVATE_LINK - whether to forward logs via PrivateLink
135-
## Overrides incompatible settings
135+
# DEPRECATED. No longer need to use special endpoints, as you can now expose
136+
# regular Datadog API endpoints `api`, `http-intake.logs` and `trace.agent`
137+
# via PrivateLink. See https://docs.datadoghq.com/agent/guide/private-link/.
138+
# @param DD_USE_PRIVATE_LINK - whether to forward logs via PrivateLink
139+
# Overrides incompatible settings
136140
#
137141
DD_USE_PRIVATE_LINK = get_env_var("DD_USE_PRIVATE_LINK", "false", boolean=True)
138142
if DD_USE_PRIVATE_LINK:

aws/logs_monitoring/template.yaml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ Parameters:
157157
AllowedValues:
158158
- true
159159
- false
160-
Description: Set to true to deploy the Forwarder to a VPC and send logs, metrics, and traces via AWS PrivateLink. When set to true, must also set VPCSecurityGroupIds and VPCSubnetIds. Find more details from https://dtdg.co/private-link.
160+
Description: DEPRECATED, DO NOT CHANGE. See README.md for details. Set to true to deploy the Forwarder to a VPC and send logs, metrics, and traces via AWS PrivateLink. When set to true, must also set VPCSecurityGroupIds and VPCSubnetIds.
161161
DdUseVPC:
162162
Type: String
163163
Default: false
@@ -459,8 +459,6 @@ Resources:
459459
- Ref: AWS::NoValue
460460
DD_SITE:
461461
Ref: DdSite
462-
DD_:
463-
Ref: DdSite
464462
DD_TAGS:
465463
Fn::If:
466464
- SetDdTags

0 commit comments

Comments
 (0)