Terraform module for Datadog Nginx

This module is part of a larger suite of modules that provide alerts in Datadog. Other modules can be found on the Terraform Registry

We have two base modules we use to standardise development of our Monitor Modules:

• generic monitor Used in 90% of our alerts
• service check monitor

Modules are generated with this tool: https://github.com/kabisa/datadog-terraform-generator

Module Variables

Monitors:

Monitor name	Default enabled	Priority	Query
Connection Dropped	True	2	avg(last_5m):max:nginx.net.conn_dropped_per_s{tag:xxx} by {service} >
Requests Rate	True	3	avg(last_30m):sum:nginx.net.request_per_s{tag:xxx} >

Getting started developing

pre-commit was used to do Terraform linting and validating.

Steps:

• Install pre-commit. E.g. brew install pre-commit.
• Run pre-commit install in this repo. (Every time you clone a repo with pre-commit enabled you will need to run the pre-commit install command)
• That’s it! Now every time you commit a code change (.tf file), the hooks in the hooks: config .pre-commit-config.yaml will execute.

Connection Dropped

Dropped connections should be at zero. If your rate of dropped connections per unit time starts to rise, look for possible resource saturation.

Query:

avg(last_5m):max:nginx.net.conn_dropped_per_s{tag:xxx} by {service} > 

variable	default	required	description
connection_dropped_enabled	True	No
connection_dropped_warning	None	No
connection_dropped_critical	0	No
connection_dropped_evaluation_period	last_5m	No
connection_dropped_note	""	No
connection_dropped_docs	Dropped connections should be at zero. If your rate of dropped connections per unit time starts to rise, look for possible resource saturation.	No
connection_dropped_filter_override	""	No
connection_dropped_alerting_enabled	True	No
connection_dropped_priority	2	No	Number from 1 (high) to 5 (low).

Requests Rate

Query:

avg(last_30m):sum:nginx.net.request_per_s{tag:xxx} > 

variable	default	required	description
requests_rate_enabled	True	No
requests_rate_warning	None	No
requests_rate_critical		Yes
requests_rate_evaluation_period	last_30m	No
requests_rate_note	""	No
requests_rate_docs	""	No
requests_rate_filter_override	""	No
requests_rate_alerting_enabled	True	No
requests_rate_priority	3	No	Number from 1 (high) to 5 (low).

Status Check

variable	default	required	description
status_check_enabled	True	No
status_check_alerting_enabled	True	No

Module Variables

variable	default	required	description
filter_str		Yes
env		Yes
service		Yes
service_display_name	None	No
notification_channel		Yes
additional_tags	[]	No
name_prefix	""	No
name_suffix	""	No
restricted_roles	[]	No	A list of unique role identifiers to define which roles are allowed to edit the monitor