You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: aws/logs_monitoring/README.md
+37-3Lines changed: 37 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,7 +23,7 @@ For more information about sending AWS services logs with the Datadog Forwarder,
23
23
24
24
## Installation
25
25
26
-
Datadog recommends using [CloudFormation](#cloudformation) to automatically install the Forwarder. You can also complete the setup process using [Terraform](#terraform) or [manually](#manual). Once installed, you can subscribe the Forwarder to log sources such as S3 buckets or CloudWatch log groups by [setting up triggers][4].
26
+
Datadog recommends using [CloudFormation](#cloudformation) to automatically install the Forwarder. You can also complete the setup process using [Terraform](#terraform) or [manually](#manual). For multi-region or multi-account deployments, see [Multi-Region & Multi-Account](#multi-region-multi-account) for CloudFormation StackSets or use the [Terraform](#terraform) module. Once installed, you can subscribe the Forwarder to log sources such as S3 buckets or CloudWatch log groups by [setting up triggers][4].
27
27
28
28
**Note**: Forwarder v4.1.0+ does not support x86_64 architecture. If you are using x86_64, you must migrate to ARM64 to use the Datadog Forwarder.
29
29
@@ -48,12 +48,46 @@ If you had previously enabled your AWS Integration using the [following CloudFor
Use CloudFormation StackSets to deploy the Forwarder across multiple AWS regions and/or accounts automatically.
57
+
58
+
#### Single account, multiple regions
59
+
60
+
1. Deploy the Forwarder template using [CloudFormation StackSets][151] in the AWS Console.
61
+
2. In the **Permissions** section, optionally provide an IAM admin role ARN, or leave the default IAM execution role name (`AWSCloudFormationStackSetExecutionRole`).
62
+
3. Select **Amazon S3 URL** and enter the Forwarder template URL: `https://datadog-cloudformation-template.s3.amazonaws.com/aws/forwarder/latest.yaml`. Click **Next**.
63
+
4. Fill in Stack set name, `DdApiKey` and select the appropriate `DdSite`. All other parameters are optional. Click **Next**.
64
+
5. Optionally configure stack set options. Check the box under **Capabilities** and click **Next**.
65
+
6. On the **Set deployment options** page, select **Deploy stacks in accounts** and enter your AWS account ID. Under **Specify regions**, add target regions where you want to deploy the Forwarder. Click **Next**.
66
+
7. Review and click **Submit**.
67
+
68
+
#### Multiple accounts (AWS Organizations)
69
+
70
+
**Prerequisites**: You must be logged into your **AWS Organizations management account** to use this deployment method.
71
+
72
+
1. Enable [trusted access for CloudFormation StackSets][153] in AWS Organizations (one-time setup).
73
+
2. Deploy from the organization management account using [CloudFormation StackSets][151].
74
+
3. In the **Permissions** section, choose **Service-managed permissions**. This option allows CloudFormation StackSets to create the necessary IAM roles in target accounts automatically.
75
+
4. Select **Amazon S3 URL** and enter the Forwarder template URL: `https://datadog-cloudformation-template.s3.amazonaws.com/aws/forwarder/latest.yaml`. Click **Next**.
76
+
5. Fill in Stack set name, `DdApiKey` and select the appropriate `DdSite`. All other parameters are optional. Click **Next**.
77
+
6. Choose **Deploy to organization** and specify target organizational units (OUs) or individual accounts, along with the regions where you want to deploy the Forwarder.
78
+
79
+
**Note**: For both deployment methods, you'll still need to [set up triggers][155] after the Forwarder is deployed.
Install the Forwarder using the public Datadog Terraform module available at [https://registry.terraform.io/modules/DataDog/log-lambda-forwarder-datadog/aws/latest][201]. Once the Lambda function is deployed, [set up triggers on the Forwarder][202].
90
+
Install the Forwarder using the public Datadog Terraform module available at [https://registry.terraform.io/modules/DataDog/log-lambda-forwarder-datadog/aws/latest][201]. The Terraform module supports both multi-region and multi-account deployments. Once the Lambda function is deployed, [set up triggers on the Forwarder][202].
57
91
58
92
#### Sample configuration
59
93
@@ -70,7 +104,7 @@ module "datadog_forwarder" {
70
104
**Note**: Ensure that the `dd_site` parameter matches your [Datadog site][203]. Select your site on the right side of this page. Your Datadog site is {{< region-param key="dd_site" code="true" >}}.
71
105
Your [Datadog API key][204] to use for `dd_api_key` can be found under **Organization Settings** > **API Keys**.
72
106
73
-
For all configuration options and details, including [Multi-Region deployment][205], see the [module documentation][201].
107
+
For all configuration options and details, including [multi-region and multi-account deployments][205], see the [module documentation][201].
0 commit comments