aws: Cloudwatch Forwarder terraform module (#103)

Co-authored-by: Mano Toth <mano@axiom.co>
Co-authored-by: Mano Toth <71388581+tothmano@users.noreply.github.com>

Author: thesollyz

send-data/cloudwatch.mdx

@@ -2,12 +2,13 @@
 title: 'Send data from Amazon CloudWatch to Axiom'
 description: 'This page explains how to send data from Amazon CloudWatch to Axiom.'
 sidebarTitle: Amazon CloudWatch
-tags: 
+tags:
     ['axiom documentation', 'documentation', 'axiom', 'Amazon cloudwatch', 'aws s3', 'aws lambda', 'cloudwatch log groups']
 ---
 
 import Prerequisites from "/snippets/standard-prerequisites.mdx"
 import AwsDisclaimer from "/snippets/aws-disclaimer.mdx"
+import Replacement from "/snippets/standard-replacement.mdx"
 
 Axiom CloudWatch Forwarder is a set of easy-to-use AWS CloudFormation stacks designed to forward logs from Amazon CloudWatch to Axiom. It includes a Lambda function to handle the forwarding and stacks to create Amazon CloudWatch log group subscription filters for both existing and future log groups.
 
@@ -28,12 +29,76 @@ Axiom CloudWatch Forwarder includes templates for the following CloudFormation s
 {/* list separator */}
 - [Create an account on AWS Cloud](https://signin.aws.amazon.com/signup?request_type=register).
 
-## Setup
+## Installation
+
+To install the Axiom CloudWatch Forwarder, choose one of the following:
+
+- [Cloudformation stacks](#install-with-cloudformation-stacks)
+- [Terraform module](#install-with-terraform-module)
+
+### Install with Cloudformation stacks
 
 1. [Launch the Forwarder stack template on AWS](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=axiom-cloudwatch-forwarder&templateURL=https://axiom-cloudformation.s3.amazonaws.com/stacks/axiom-cloudwatch-forwarder-v1.1.1-cloudformation-stack.yaml). Copy the Forwarder Lambda ARN because it’s referenced in the Subscriber stack.
 1. [Launch the Subscriber stack template on AWS](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=axiom-cloudwatch-subscriber&templateURL=https://axiom-cloudformation.s3.amazonaws.com/stacks/axiom-cloudwatch-subscriber-v1.1.1-cloudformation-stack.yaml).
 1. [Launch the Listener stack template on AWS](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=axiom-cloudwatch-listener&templateURL=https://axiom-cloudformation.s3.amazonaws.com/stacks/axiom-cloudwatch-listener-v1.1.1-cloudformation-stack.yaml).
 
+### Install with Terraform module
+
+<Steps>
+<Step>
+
+Create a new Forwarder module in your Terraform file in the following way:
+
+```hcl
+module "forwarder" {
+  source           = "axiomhq/axiom-cloudwatch-forwarder/aws//modules/forwarder"
+  axiom_dataset    = "DATASET_NAME"
+  axiom_token      = "API_TOKEN"
+  prefix           = "axiom-cloudwatch-forwarder"
+}
+```
+
+<Replacement />
+
+Alternatively, create a dataset with the [Axiom Terraform provider](/docs/apps/terraform#create-dataset).
+
+</Step>
+<Step>
+
+Create a new Subscriber module in your Terraform file in the following way:
+
+``` hcl
+module "subscriber" {
+  source               = "axiomhq/axiom-cloudwatch-forwarder/aws//modules/subscriber"
+  prefix               = "axiom-cloudwatch-forwarder"
+  forwarder_lambda_arn = module.forwarder.lambda_arn
+  log_groups_prefix    = "/aws/lambda/"
+}
+```
+
+</Step>
+<Step>
+
+Create a new Listener module in your Terraform file in the following way:
+
+```hcl
+module "listener" {
+  source               = "axiomhq/axiom-cloudwatch-forwarder/aws//modules/listener"
+  prefix               = "axiom-cloudwatch-forwarder"
+  forwarder_lambda_arn = module.forwarder.lambda_arn
+  log_groups_prefix    = "/aws/lambda/"
+}
+```
+
+</Step>
+<Step>
+In your terminal, go to the folder of your main Terraform file, and then run `terraform init`.
+</Step>
+<Step>
+Run `terraform plan` to check the changes, and then run `terraform apply`.
+</Step>
+</Steps>
+
 ## Filter Amazon CloudWatch log groups
 
 The Subscriber and Unsubscriber stacks allow you to filter the log groups by a combination of names, prefix, and regular expression filters. If no filters are specified, the stacks subscribe to or unsubscribe from all log groups. You can also whitelist a specific set of log groups using filters in the CloudFormation stack parameters. The log group names, prefix, and regular expression filters included are additive, meaning the union of all provided inputs is matched.
@@ -69,4 +134,15 @@ The optional Listener stack does the following:
 
 To remove subscription filters for one or more log groups, [launch the Unsubscriber stack template on AWS](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=axiom-cloudwatch-subscriber&templateURL=https://axiom-cloudformation.s3.amazonaws.com/stacks/axiom-cloudwatch-unsubscriber-v1.1.1-cloudformation-stack.yaml).
 
-The log group filtering works the same way as the Subscriber stack. You can filter the log groups by a combination of names, prefix, and regular expression filters.
+The log group filtering works the same way as the Subscriber stack. You can filter the log groups by a combination of names, prefix, and regular expression filters.
+
+Alternatively, to turn off log forwarding to Axiom, create a new Unsubscriber module in your Terraform file in the following way:
+
+```hcl
+module "unsubscriber" {
+  source           = "axiomhq/axiom-cloudwatch-forwarder/aws//modules/unsubscriber"
+  prefix           = "axiom-cloudwatch-forwarder"
+  forwarder_lambda_arn = module.forwarder.lambda_arn
+  log_groups_prefix    = "/aws/lambda/"
+}
+```