Skip to content

Commit d742dd9

Browse files
committed
feat(aws): add docs for deploying forwarder stack as stackset
1 parent 987f806 commit d742dd9

1 file changed

Lines changed: 37 additions & 3 deletions

File tree

aws/logs_monitoring/README.md

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ For more information about sending AWS services logs with the Datadog Forwarder,
2323

2424
## Installation
2525

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].
2727

2828
**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.
2929

@@ -48,12 +48,46 @@ If you had previously enabled your AWS Integration using the [following CloudFor
4848
[101]: https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#set-up-triggers
4949
[102]: https://github.com/DataDog/cloudformation-template/tree/master/aws
5050

51+
{{% /tab %}}
52+
{{% tab "Multi-Region & Multi-Account" %}}
53+
54+
### Multi-Region & Multi-Account
55+
56+
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.
80+
81+
[151]: https://console.aws.amazon.com/cloudformation/home#/stacksets/create
82+
[153]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html
83+
[155]: https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#set-up-triggers
84+
5185
{{% /tab %}}
5286
{{% tab "Terraform" %}}
5387

5488
### Terraform
5589

56-
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].
5791

5892
#### Sample configuration
5993

@@ -70,7 +104,7 @@ module "datadog_forwarder" {
70104
**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" >}}.
71105
Your [Datadog API key][204] to use for `dd_api_key` can be found under **Organization Settings** > **API Keys**.
72106

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].
74108

75109
[201]: https://registry.terraform.io/modules/DataDog/log-lambda-forwarder-datadog/aws/latest
76110
[202]: https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#set-up-triggers

0 commit comments

Comments
 (0)