Skip to content

Commit dc277ad

Browse files
kishikawa12kishikawa12
committed
v1.34.0
1 parent ed7e6b4 commit dc277ad

15 files changed

+498
-24
lines changed

‎docs/data-sources/synthetic_nodes.md‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
layout: ""
3+
page_title: "dynatrace_synthetic_nodes Data Source - terraform-provider-dynatrace"
4+
description: |-
5+
The data source `dynatrace_synthetic_nodes` queries for all available Synthetic Nodes
6+
---
7+
8+
# dynatrace_synthetic_nodes (Data Source)
9+
10+
The synthetic locations data source queries for all available Synthetic Nodes. The data source doesn't need to get configured. It always provides the full list of synthetic nodes.
11+
12+
## Example Usage
13+
14+
This example shows how to use the data source `dynatrace_synthetic_nodes` in combination with the resource `dynatrace_synthetic_location`, which requires the IDs of synthetic nodes to execute synthetic tests on.
15+
16+
```terraform
17+
data "dynatrace_synthetic_nodes" "all" {
18+
}
19+
20+
resource "dynatrace_synthetic_location" "Test" {
21+
name = "Test"
22+
auto_update_chromium = true
23+
availability_location_outage = true
24+
availability_node_outage = true
25+
availability_notifications_enabled = true
26+
city = "San Francisco de Asis"
27+
country_code = "VE"
28+
deployment_type = "STANDARD"
29+
latitude = 10.0756
30+
location_node_outage_delay_in_minutes = 3
31+
longitude = -67.5442
32+
nodes = [ data.dynatrace_synthetic_nodes.all.nodes[index(data.dynatrace_synthetic_nodes.all.nodes.*.hostname, "ip-###-##-##-###.ec2.internal")].id ]
33+
region_code = "04"
34+
}
35+
36+
output "synthetic_nodes" {
37+
value = data.dynatrace_synthetic_nodes.all.nodes
38+
}
39+
40+
# Outputs:
41+
42+
# synthetic_nodes = tolist([
43+
# {
44+
# "active_gate_version" = "1.267.43.20230512-112635"
45+
# "auto_update" = true
46+
# "browser_monitors" = true
47+
# "health_check_status" = "Ok"
48+
# "hostname" = "ip-###-##-##-###.ec2.internal"
49+
# "id" = "##########"
50+
# "ips" = toset([
51+
# "###.##.##.###",
52+
# ])
53+
# "one_agent_routing" = false
54+
# "operating_system" = "Platform: Linux, Version: 5.15.0-1019-aws, Architecture: amd64, Processors: 2"
55+
# "player_version" = "1.267.7.20230518-134346"
56+
# "status" = "Running"
57+
# "version" = "1.267.13.20230518-162314"
58+
# },
59+
# ])
60+
61+
```
62+
63+
<!-- schema generated by tfplugindocs -->
64+
## Schema
65+
66+
### Read-Only
67+
68+
- `id` (String) The ID of this resource.
69+
- `nodes` (List of Object) (see [below for nested schema](#nestedatt--nodes))
70+
71+
<a id="nestedatt--nodes"></a>
72+
### Nested Schema for `nodes`
73+
74+
Read-Only:
75+
76+
- `active_gate_version` (String)
77+
- `auto_update` (Boolean)
78+
- `browser_monitors` (Boolean)
79+
- `health_check_status` (String)
80+
- `hostname` (String)
81+
- `id` (String)
82+
- `ips` (Set of String)
83+
- `one_agent_routing` (Boolean)
84+
- `operating_system` (String)
85+
- `player_version` (String)
86+
- `status` (String)
87+
- `version` (String)

‎docs/data-sources/tenant.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
layout: ""
3+
page_title: "dynatrace_tenant Data Source - terraform-provider-dynatrace"
4+
description: |-
5+
The data source `dynatrace_tenant` is a pseudo data source. It evaluates based on the configuration of the provider the Environment ID
6+
---
7+
8+
# dynatrace_tenant (Data Source)
9+
10+
The data source `dynatrace_tenant` evalutes the configured Environment URL (either the environment variable `DYNATRACE_ENV_URL` or the configuration attribute `dt_env_url`) and extracts out the name/id of the environment this provider addresses.
11+
Main purpose is for migrating settings from one environment to another, but it can be used to in general to avoid hard coding the environment ID like in the example below.
12+
13+
## Example Usage
14+
15+
```terraform
16+
data "dynatrace_tenant" "tenant" {
17+
}
18+
19+
resource "dynatrace_iam_group" "some_group" {
20+
name = "#######"
21+
permissions {
22+
permission {
23+
name = "tenant-manage-settings"
24+
type = "tenant"
25+
scope = data.dynarace_tenant.tenant.id
26+
}
27+
}
28+
```
29+
30+
<!-- schema generated by tfplugindocs -->
31+
## Schema
32+
33+
### Read-Only
34+
35+
- `id` (String) The ID of this resource.
36+
- `name` (String)

‎docs/index.md‎

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,20 +18,18 @@ Use the links to the left to learn about the available resources, data sources,
1818
terraform {
1919
required_providers {
2020
dynatrace = {
21-
version = "1.33.0"
21+
version = "1.34.0"
2222
source = "dynatrace-oss/dynatrace"
2323
}
2424
}
2525
}
2626
```
2727
## Configure the Dynatrace provider
28-
```
29-
provider "dynatrace" {
30-
dt_env_url = "https://########.live.dynatrace.com"
31-
dt_api_token = "################"
32-
}
33-
```
34-
where `dt_env_url` represents the URL of your Dynatrace Environment and `dt_api_token` needs to be an API Token with the following permissions:
28+
The recommended way to configure the provider is via environment variables.
29+
The value of `DYNATRACE_ENV_URL` needs to refer to the URL your Dynatrace Environment is reachable with.
30+
* Saas Environments: `https://########.live.dynatrace.com`
31+
* Managed Enviroments: `https://<dynatrace-host>/e/#####################`
32+
The value of `DYNATRACE_API_TOKEN` needs to be an API Token with the following permissions:
3533
* `Read configuration`
3634
* `Capture request data`
3735
* `Read SLO`
@@ -57,7 +55,13 @@ where `dt_env_url` represents the URL of your Dynatrace Environment and `dt_api_
5755
* `Create and read synthetic monitors, locations`
5856
* `Write configuration`
5957

60-
58+
Alternatively - but not recommended for security reasons you can also add configuration options within your Terraform Module.
59+
```
60+
provider "dynatrace" {
61+
dt_env_url = "https://########.live.dynatrace.com"
62+
dt_api_token = "################"
63+
}
64+
```
6165

6266
## Exporting existing configuration from a Dynatrace Environment
6367
In addition to acting as a Terraform Provider Plugin, the executable `terraform-provider-dynatrace` (`terraform-provider-dynatrace.exe` on Windows) can be directly invoked.

‎docs/resources/browser_monitor.md‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -167,13 +167,13 @@ resource "dynatrace_browser_monitor" "#name#" {
167167
- `frequency` (Number) The frequency of the monitor, in minutes.
168168

169169
You can use one of the following values: `5`, `10`, `15`, `30`, and `60`.
170+
- `key_performance_metrics` (Block List, Min: 1, Max: 1) The key performance metrics configuration (see [below for nested schema](#nestedblock--key_performance_metrics))
170171
- `name` (String) The name of the monitor.
171172

172173
### Optional
173174

174175
- `anomaly_detection` (Block List, Max: 1) The anomaly detection configuration. (see [below for nested schema](#nestedblock--anomaly_detection))
175176
- `enabled` (Boolean) The monitor is enabled (`true`) or disabled (`false`).
176-
- `key_performance_metrics` (Block List, Max: 1) The key performance metrics configuration (see [below for nested schema](#nestedblock--key_performance_metrics))
177177
- `locations` (Set of String) A list of locations from which the monitor is executed.
178178

179179
To specify a location, use its entity ID.
@@ -187,6 +187,15 @@ You can specify only the value of the tag here and the `CONTEXTLESS` context and
187187

188188
- `id` (String) The ID of this resource.
189189

190+
<a id="nestedblock--key_performance_metrics"></a>
191+
### Nested Schema for `key_performance_metrics`
192+
193+
Required:
194+
195+
- `load_action_kpm` (String) Defines the key performance metric for load actions. Supported values are `VISUALLY_COMPLETE`, `SPEED_INDEX`, `USER_ACTION_DURATION`, `TIME_TO_FIRST_BYTE`, `HTML_DOWNLOADED`, `DOM_INTERACTIVE`, `LOAD_EVENT_START` and `LOAD_EVENT_END`.
196+
- `xhr_action_kpm` (String) Defines the key performance metric for XHR actions. Supported values are `VISUALLY_COMPLETE`, `USER_ACTION_DURATION`, `TIME_TO_FIRST_BYTE` and `RESPONSE_END`.
197+
198+
190199
<a id="nestedblock--anomaly_detection"></a>
191200
### Nested Schema for `anomaly_detection`
192201

@@ -260,15 +269,6 @@ Required:
260269

261270

262271

263-
<a id="nestedblock--key_performance_metrics"></a>
264-
### Nested Schema for `key_performance_metrics`
265-
266-
Required:
267-
268-
- `load_action_kpm` (String) Defines the key performance metric for load actions. Supported values are `VISUALLY_COMPLETE`, `SPEED_INDEX`, `USER_ACTION_DURATION`, `TIME_TO_FIRST_BYTE`, `HTML_DOWNLOADED`, `DOM_INTERACTIVE`, `LOAD_EVENT_START` and `LOAD_EVENT_END`.
269-
- `xhr_action_kpm` (String) Defines the key performance metric for XHR actions. Supported values are `VISUALLY_COMPLETE`, `USER_ACTION_DURATION`, `TIME_TO_FIRST_BYTE` and `RESPONSE_END`.
270-
271-
272272
<a id="nestedblock--script"></a>
273273
### Nested Schema for `script`
274274

‎docs/resources/ibm_mq_filters.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ resource "dynatrace_ibm_mq_filters" "#name#" {
3737

3838
- `cics_mq_queue_id_excludes` (Set of String) CICS: Excluded MQ queues
3939
- `cics_mq_queue_id_includes` (Set of String) CICS: Included MQ queues
40-
- `ims_cr_trn_id_excludes` (Set of String) IMS bridge: Excluded transaction IDs
41-
- `ims_cr_trn_id_includes` (Set of String) IMS bridge: Included transaction IDs
40+
- `ims_cr_trn_id_excludes` (Set of String) When you add a transaction ID to the exclude list remaining transactions are still monitored.
41+
- `ims_cr_trn_id_includes` (Set of String) When you add a transaction ID to the include list, all the remaining transactions are ignored.
4242
- `ims_mq_queue_id_excludes` (Set of String) IMS: Excluded MQ queues
4343
- `ims_mq_queue_id_includes` (Set of String) IMS: Included MQ queues
4444

‎docs/resources/limit_outbound_connections.md‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
layout: ""
3+
page_title: dynatrace_limit_outbound_connections Resource - terraform-provider-dynatrace"
4+
description: |-
5+
The resource `dynatrace_limit_outbound_connections` covers configuration for limiting outbound connections running in the Dynatrace JavaScript runtime
6+
---
7+
8+
# dynatrace_limit_outbound_connections (Resource)
9+
10+
## Dynatrace Documentation
11+
12+
- Allow outbound connections - https://developer.dynatrace.com/develop/functions/allow-outbound-connections/
13+
14+
- Settings API - https://www.dynatrace.com/support/help/dynatrace-api/environment-api/settings (schemaId: `builtin:dt-javascript-runtime.allowed-outbound-connections`)
15+
16+
## Export Example Usage
17+
18+
- `terraform-provider-dynatrace -export dynatrace_limit_outbound_connections` downloads existing configuration for limiting outbound connections running in the Dynatrace JavaScript runtime
19+
20+
The full documentation of the export feature is available [here](https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/guides/export-v2).
21+
22+
## Resource Example Usage
23+
24+
```terraform
25+
resource "dynatrace_limit_outbound_connections" "#name#" {
26+
allowed_outbound_connections {
27+
enforced = true
28+
host_list = [ "www.dynatrace.com", "www.google.com" ]
29+
}
30+
}
31+
```
32+
33+
<!-- schema generated by tfplugindocs -->
34+
## Schema
35+
36+
### Required
37+
38+
- `allowed_outbound_connections` (Block List, Min: 1, Max: 1) no documentation available (see [below for nested schema](#nestedblock--allowed_outbound_connections))
39+
40+
### Read-Only
41+
42+
- `id` (String) The ID of this resource.
43+
44+
<a id="nestedblock--allowed_outbound_connections"></a>
45+
### Nested Schema for `allowed_outbound_connections`
46+
47+
Required:
48+
49+
- `enforced` (Boolean) If enabled, the Dynatrace JavaScript runtime will only be able to connect to the specified hosts.
50+
51+
Optional:
52+
53+
- `host_list` (Set of String) The Dynatrace JavaScript runtime will only be to connect to these hosts.
54+

‎docs/resources/span_events.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
layout: ""
3+
page_title: dynatrace_span_events Resource - terraform-provider-dynatrace"
4+
description: |-
5+
The resource `dynatrace_span_events` covers configuration for span events
6+
---
7+
8+
# dynatrace_span_events (Resource)
9+
10+
## Dynatrace Documentation
11+
12+
- Span settings - https://www.dynatrace.com/support/help/extend-dynatrace/extend-tracing/span-settings
13+
14+
- Settings API - https://www.dynatrace.com/support/help/dynatrace-api/environment-api/settings (schemaId: `builtin:span-event-attribute`)
15+
16+
## Export Example Usage
17+
18+
- `terraform-provider-dynatrace -export dynatrace_span_events` downloads all existing span event configuration
19+
20+
The full documentation of the export feature is available [here](https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/guides/export-v2).
21+
22+
## Resource Example Usage
23+
24+
```terraform
25+
resource "dynatrace_span_events" "#name#" {
26+
key = "exception.terraform"
27+
masking = "NOT_MASKED"
28+
}
29+
```
30+
31+
<!-- schema generated by tfplugindocs -->
32+
## Schema
33+
34+
### Required
35+
36+
- `key` (String) Key of the span event attribute to store
37+
- `masking` (String) Possible Values: `MASK_ENTIRE_VALUE`, `MASK_ONLY_CONFIDENTIAL_DATA`, `NOT_MASKED`
38+
39+
### Read-Only
40+
41+
- `id` (String) The ID of this resource.
42+

‎docs/resources/synthetic_location.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,9 @@ resource "dynatrace_synthetic_location" "#name#" {
6666
- `location_node_outage_delay_in_minutes` (Number) Alert if the location or node outage lasts longer than *X* minutes.
6767

6868
Only applicable when **availability_location_outage** or **availability_node_outage** is set to `true`
69+
- `max_active_gate_count` (Number) The maximum number of Active Gates required for that location. Not required when `deployment_type` is set to `STANDARD`
70+
- `min_active_gate_count` (Number) The minimum number of Active Gates required for that location. Not required when `deployment_type` is set to `STANDARD`
71+
- `node_size` (String) Possible values: `UNSUPPORTED`, `XS`, `S` and `M`. Not required when `deployment_type` is set to `STANDARD`.
6972
- `nodes` (Set of String) A list of synthetic nodes belonging to the location.
7073

7174
You can retrieve the list of available nodes with the [GET all nodes](https://dt-url.net/miy3rpl) call

‎docs/resources/vmware.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
layout: ""
3+
page_title: dynatrace_vmware Resource - terraform-provider-dynatrace"
4+
description: |-
5+
The resource `dynatrace_vmware` covers configuration for VMware
6+
---
7+
8+
# dynatrace_vmware (Resource)
9+
10+
## Dynatrace Documentation
11+
12+
- VMware vSphere monitoring - https://www.dynatrace.com/support/help/platform-modules/infrastructure-monitoring/vmware-vsphere-monitoring
13+
14+
- Settings API - https://www.dynatrace.com/support/help/dynatrace-api/environment-api/settings (schemaId: `builtin:virtualization.vmware`)
15+
16+
## Export Example Usage
17+
18+
- `terraform-provider-dynatrace -export dynatrace_vmware` downloads all existing VMware configuration
19+
20+
The full documentation of the export feature is available [here](https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/guides/export-v2).
21+
22+
## Resource Example Usage
23+
24+
```terraform
25+
resource "dynatrace_vmware" "#name#" {
26+
enabled = false
27+
ipaddress = "vcenter01"
28+
label = "#name#"
29+
password = "################"
30+
username = "terraform"
31+
}
32+
```
33+
34+
<!-- schema generated by tfplugindocs -->
35+
## Schema
36+
37+
### Required
38+
39+
- `enabled` (Boolean) This setting is enabled (`true`) or disabled (`false`)
40+
- `ipaddress` (String) Specify the IP address or name of the vCenter or standalone ESXi host:
41+
- `label` (String) Name this connection
42+
- `password` (String, Sensitive) no documentation available
43+
- `username` (String) Provide user credentials for the vCenter or standalone ESXi host:
44+
45+
### Read-Only
46+
47+
- `id` (String) The ID of this resource.
48+

0 commit comments

Comments
 (0)