datadog-connector

The datadog-connector module provisions a Kinesis Firehose which is configured to pipe logs to Datadog. It uses the kinesis-firehose-connector to create the Firehose's dependencies.

To provide the Sym Runtime with access to the resources created in this Connector, use the aws/kinesis-firehose addon in the runtime-connector module.

For EU Datadog, make sure to set the datadog_intake_url input to https://aws-kinesis-http-intake.logs.datadoghq.eu/v1/input!

SECURITY NOTE: The datadog_access_key variable is sensitive. Be sure to manage this value in an environment variable or a tfvars file that is excluded from version control. For example, export TF_VAR_datadog_access_key="my-access-key".

module "datadog_connector" {
  source  = "symopsio/datadog-connector/aws"
  version = ">= 2.0.0"

  environment = "sandbox"
  datadog_access_key = var.sensitive_access_key
}

Requirements

Name	Version
terraform	>= 0.14.0
aws	>= 5.0.0

Providers

Name	Version
aws	>= 5.0.0

Modules

Name	Source	Version
kinesis_firehose_connector	symopsio/kinesis-firehose-connector/aws	>= 4.0.0, < 5.0.0

Resources

Name	Type
aws_kinesis_firehose_delivery_stream.this	resource
aws_region.current	data source

Inputs

Name	Description	Type	Default	Required
buffering_interval	Buffer incoming data for the specified period of time, in seconds, before delivering it to the destination.	number	300	no
buffering_size	Buffer incoming data to the specified size, in MBs, before delivering it to the destination.	number	5	no
datadog_access_key	Secret used by the Firehose to send logs to Datadog. DO NOT check this into version control.	string	n/a	yes
datadog_intake_url	Intake url for Datadog to consume Kinesis Firehose messages. For EU Datadog, set to 'https://aws-kinesis-http-intake.logs.datadoghq.eu/v1/input'.	string	"https://aws-kinesis-http-intake.logs.datadoghq.com/v1/input"	no
environment	An environment qualifier for the resources this module creates, to support a Terraform SDLC.	string	n/a	yes
name_prefix	A prefix for the Firehose and dependency names	string	""	no
retry_duration	Total amount of seconds Firehose spends on retries. This duration starts after the initial attempt fails, and does not include the time periods during which Firehose waits for acknowledgment from the specified destination after each attempt. Valid values are between 0 and 7200.	number	300	no
tags	Additional tags to apply to resources.	map(string)	{}	no

Outputs

Name	Description
firehose_arn	The ARN of the created Firehose
firehose_name	The name of the created Firehose