|
| 1 | +# terraform-datadog-monitor/synthetics/browser |
| 2 | + |
| 3 | +Configures Synthetic Test for Browser |
| 4 | + |
| 5 | +<!-- BEGIN_TF_DOCS --> |
| 6 | +## Requirements |
| 7 | + |
| 8 | +| Name | Version | |
| 9 | +|------|---------| |
| 10 | +| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | ~> 1.5 | |
| 11 | +| <a name="requirement_datadog"></a> [datadog](#requirement\_datadog) | >= 3.37 | |
| 12 | +| <a name="requirement_null"></a> [null](#requirement\_null) | >= 3.1.0 | |
| 13 | + |
| 14 | +## Providers |
| 15 | + |
| 16 | +| Name | Version | |
| 17 | +|------|---------| |
| 18 | +| <a name="provider_datadog"></a> [datadog](#provider\_datadog) | 3.42.0 | |
| 19 | + |
| 20 | +## Modules |
| 21 | + |
| 22 | +No modules. |
| 23 | + |
| 24 | +## Resources |
| 25 | + |
| 26 | +| Name | Type | |
| 27 | +|------|------| |
| 28 | +| [datadog_synthetics_test.browser](https://registry.terraform.io/providers/datadog/datadog/latest/docs/resources/synthetics_test) | resource | |
| 29 | + |
| 30 | +## Inputs |
| 31 | + |
| 32 | +| Name | Description | Type | Default | Required | |
| 33 | +|------|-------------|------|---------|:--------:| |
| 34 | +| <a name="input_additional_tags"></a> [additional\_tags](#input\_additional\_tags) | Additional tags (key:value format) to add to this type of check (combined with `local.tags` and `var.base_tags`) | `list(string)` | `[]` | no | |
| 35 | +| <a name="input_alert_critical_priority"></a> [alert\_critical\_priority](#input\_alert\_critical\_priority) | Priority for alerts within critical threshold (P1-P5, uses monitor defaults if not specified) | `string` | `null` | no | |
| 36 | +| <a name="input_alert_message"></a> [alert\_message](#input\_alert\_message) | Message to prepend to alert notifications | `string` | `"Alert"` | no | |
| 37 | +| <a name="input_alert_nodata_priority"></a> [alert\_nodata\_priority](#input\_alert\_nodata\_priority) | Priority for alerts within warning threshold (P1-P5, uses monitor defaults if not specified) | `string` | `null` | no | |
| 38 | +| <a name="input_base_tags"></a> [base\_tags](#input\_base\_tags) | Base tags (key:value format) to add to this type of check (combined with `local.tags` and `var.additional_tags`, generally you should not change this) | `list(string)` | <pre>[<br> "resource:apigateway"<br>]</pre> | no | |
| 39 | +| <a name="input_browser_synthetic_device_ids"></a> [browser\_synthetic\_device\_ids](#input\_browser\_synthetic\_device\_ids) | List with the different device IDs used to run the test. Valid values are laptop\_large, tablet, mobile\_small, chrome.laptop\_large, chrome.tablet, chrome.mobile\_small, firefox.laptop\_large, firefox.tablet, firefox.mobile\_small, edge.laptop\_large, edge.tablet, edge.mobile\_small. | `list(string)` | <pre>[<br> "laptop_large"<br>]</pre> | no | |
| 40 | +| <a name="input_browser_synthetic_enabled"></a> [browser\_synthetic\_enabled](#input\_browser\_synthetic\_enabled) | Flag to enable Browser Synthetic Test. | `bool` | `true` | no | |
| 41 | +| <a name="input_browser_synthetic_locations"></a> [browser\_synthetic\_locations](#input\_browser\_synthetic\_locations) | An array of datadog locations used to run Browser Synthetic Test. | `list(string)` | <pre>[<br> "aws:us-east-1"<br>]</pre> | no | |
| 42 | +| <a name="input_browser_synthetic_request_url"></a> [browser\_synthetic\_request\_url](#input\_browser\_synthetic\_request\_url) | URL to send Browser Synthetic Test requests to. | `string` | n/a | yes | |
| 43 | +| <a name="input_browser_synthetic_steps"></a> [browser\_synthetic\_steps](#input\_browser\_synthetic\_steps) | Steps for the Browser Synthetic Test to take. | <pre>list(object({<br> name = string<br> type = string<br> params = object({<br> attribute = optional(string)<br> check = optional(string)<br> click_type = optional(string)<br> code = optional(string)<br> delay = optional(number)<br> element = optional(string)<br> element_user_locator = optional(map(string))<br> email = optional(string)<br> file = optional(string)<br> files = optional(string)<br> modifiers = optional(list(string))<br> playing_tab_id = optional(string)<br> request = optional(string)<br> subtest_public_id = optional(string)<br> value = optional(string)<br> variable = optional(map(string))<br> with_click = optional(bool)<br> x = optional(number)<br> y = optional(number)<br> })<br> }))</pre> | n/a | yes | |
| 44 | +| <a name="input_browser_synthetic_tick_every"></a> [browser\_synthetic\_tick\_every](#input\_browser\_synthetic\_tick\_every) | How often Browser Synthetic Test should run in seconds. | `number` | `900` | no | |
| 45 | +| <a name="input_cost_center"></a> [cost\_center](#input\_cost\_center) | Cost Center of the monitored resource (leave blank to omit tag) | `string` | `null` | no | |
| 46 | +| <a name="input_dashboard_link"></a> [dashboard\_link](#input\_dashboard\_link) | Dashboard link to include in message | `string` | `null` | no | |
| 47 | +| <a name="input_env"></a> [env](#input\_env) | Environment the monitored resource is in (leave blank to omit tag) | `string` | n/a | yes | |
| 48 | +| <a name="input_evaluation_delay"></a> [evaluation\_delay](#input\_evaluation\_delay) | Monitor evaluation delay (see [https://docs.datadoghq.com/monitors/configuration/?tab=thresholdalert#set-alert-conditions](Datadog Docs)) | `number` | `900` | no | |
| 49 | +| <a name="input_monitor_exclude_tags"></a> [monitor\_exclude\_tags](#input\_monitor\_exclude\_tags) | Tags to be excluded in the monitoring query. Specify in key:value format | `list(string)` | `[]` | no | |
| 50 | +| <a name="input_monitor_include_tags"></a> [monitor\_include\_tags](#input\_monitor\_include\_tags) | Tags to be included in the monitoring query. Specify in key:value format | `list(string)` | `[]` | no | |
| 51 | +| <a name="input_new_group_delay"></a> [new\_group\_delay](#input\_new\_group\_delay) | Delay in seconds before generating alerts for a new resource | `number` | `300` | no | |
| 52 | +| <a name="input_notify_alert_override"></a> [notify\_alert\_override](#input\_notify\_alert\_override) | List of notifications for alerts in critical threshold (uses `notify_default` otherwise) | `list(string)` | `[]` | no | |
| 53 | +| <a name="input_notify_default"></a> [notify\_default](#input\_notify\_default) | List of alert notifications (can be overridden based on alert type) | `list(string)` | n/a | yes | |
| 54 | +| <a name="input_notify_no_data"></a> [notify\_no\_data](#input\_notify\_no\_data) | Alert if no matching data is found | `bool` | `false` | no | |
| 55 | +| <a name="input_notify_nodata_override"></a> [notify\_nodata\_override](#input\_notify\_nodata\_override) | List of notifications for no data (uses `notify_default` otherwise) | `list(string)` | `[]` | no | |
| 56 | +| <a name="input_notify_recovery_override"></a> [notify\_recovery\_override](#input\_notify\_recovery\_override) | List of notifications for alert recovery (uses `notify_default` otherwise) | `list(string)` | `[]` | no | |
| 57 | +| <a name="input_notify_warn_override"></a> [notify\_warn\_override](#input\_notify\_warn\_override) | List of notifications for alerts in warning threshold (uses `notify_default` otherwise) | `list(string)` | `[]` | no | |
| 58 | +| <a name="input_renotify_interval"></a> [renotify\_interval](#input\_renotify\_interval) | Interval in minutes to re-send notifications about an alert | `number` | `0` | no | |
| 59 | +| <a name="input_runbook_link"></a> [runbook\_link](#input\_runbook\_link) | Runbook link to include in message | `string` | `null` | no | |
| 60 | +| <a name="input_service"></a> [service](#input\_service) | Service associated with the monitored resource (leave blank to omit tag) | `string` | `null` | no | |
| 61 | +| <a name="input_team"></a> [team](#input\_team) | Team supporting the monitored resource (leave blank to omit tag) | `string` | `null` | no | |
| 62 | +| <a name="input_timeout_h"></a> [timeout\_h](#input\_timeout\_h) | Auto-resolve alert in specified hours if condition no longer matches | `number` | `0` | no | |
| 63 | +| <a name="input_title_prefix"></a> [title\_prefix](#input\_title\_prefix) | Prefix all alerts with specified value in brackets | `string` | `null` | no | |
| 64 | +| <a name="input_title_suffix"></a> [title\_suffix](#input\_title\_suffix) | Suffix all alerts with specified value in parenthesis | `string` | `null` | no | |
| 65 | +| <a name="input_warn_priority"></a> [warn\_priority](#input\_warn\_priority) | Priority for alerts with no data (P1-P5, uses monitor defaults if not specified) | `string` | `null` | no | |
| 66 | + |
| 67 | +## Outputs |
| 68 | + |
| 69 | +No outputs. |
| 70 | +<!-- END_TF_DOCS --> |
0 commit comments