pulumi-signalfx 7.2.0a1710160099__py3-none-any.whl → 7.6.0a1736849687__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. pulumi_signalfx/__init__.py +9 -0
  2. pulumi_signalfx/_inputs.py +1976 -339
  3. pulumi_signalfx/_utilities.py +41 -5
  4. pulumi_signalfx/alert_muting_rule.py +126 -72
  5. pulumi_signalfx/aws/_inputs.py +85 -16
  6. pulumi_signalfx/aws/external_integration.py +20 -43
  7. pulumi_signalfx/aws/integration.py +252 -321
  8. pulumi_signalfx/aws/outputs.py +21 -16
  9. pulumi_signalfx/aws/token_integration.py +76 -31
  10. pulumi_signalfx/azure/_inputs.py +41 -4
  11. pulumi_signalfx/azure/integration.py +170 -217
  12. pulumi_signalfx/azure/outputs.py +15 -4
  13. pulumi_signalfx/config/__init__.pyi +22 -0
  14. pulumi_signalfx/config/vars.py +28 -0
  15. pulumi_signalfx/dashboard.py +171 -186
  16. pulumi_signalfx/dashboard_group.py +191 -140
  17. pulumi_signalfx/data_link.py +102 -109
  18. pulumi_signalfx/detector.py +318 -383
  19. pulumi_signalfx/event_feed_chart.py +51 -86
  20. pulumi_signalfx/gcp/_inputs.py +51 -0
  21. pulumi_signalfx/gcp/integration.py +224 -148
  22. pulumi_signalfx/gcp/outputs.py +44 -0
  23. pulumi_signalfx/get_dimension_values.py +47 -8
  24. pulumi_signalfx/heatmap_chart.py +191 -174
  25. pulumi_signalfx/jira/integration.py +86 -103
  26. pulumi_signalfx/list_chart.py +243 -255
  27. pulumi_signalfx/log/_inputs.py +33 -2
  28. pulumi_signalfx/log/outputs.py +7 -2
  29. pulumi_signalfx/log/timeline.py +76 -87
  30. pulumi_signalfx/log/view.py +146 -113
  31. pulumi_signalfx/metric_ruleset.py +213 -70
  32. pulumi_signalfx/opsgenie/integration.py +51 -50
  33. pulumi_signalfx/org_token.py +111 -104
  34. pulumi_signalfx/outputs.py +661 -339
  35. pulumi_signalfx/pagerduty/get_integration.py +22 -25
  36. pulumi_signalfx/pagerduty/integration.py +42 -39
  37. pulumi_signalfx/provider.py +99 -0
  38. pulumi_signalfx/pulumi-plugin.json +2 -1
  39. pulumi_signalfx/servicenow/integration.py +68 -95
  40. pulumi_signalfx/single_value_chart.py +131 -162
  41. pulumi_signalfx/slack/integration.py +42 -41
  42. pulumi_signalfx/slo.py +97 -243
  43. pulumi_signalfx/slo_chart.py +197 -0
  44. pulumi_signalfx/table_chart.py +66 -65
  45. pulumi_signalfx/team.py +100 -107
  46. pulumi_signalfx/text_chart.py +72 -45
  47. pulumi_signalfx/time_chart.py +287 -352
  48. pulumi_signalfx/victorops/integration.py +42 -41
  49. pulumi_signalfx/webhook_integration.py +168 -61
  50. {pulumi_signalfx-7.2.0a1710160099.dist-info → pulumi_signalfx-7.6.0a1736849687.dist-info}/METADATA +7 -6
  51. pulumi_signalfx-7.6.0a1736849687.dist-info/RECORD +65 -0
  52. {pulumi_signalfx-7.2.0a1710160099.dist-info → pulumi_signalfx-7.6.0a1736849687.dist-info}/WHEEL +1 -1
  53. pulumi_signalfx-7.2.0a1710160099.dist-info/RECORD +0 -64
  54. {pulumi_signalfx-7.2.0a1710160099.dist-info → pulumi_signalfx-7.6.0a1736849687.dist-info}/top_level.txt +0 -0
@@ -4,9 +4,14 @@
4
4
 
5
5
  import copy
6
6
  import warnings
7
+ import sys
7
8
  import pulumi
8
9
  import pulumi.runtime
9
10
  from typing import Any, Mapping, Optional, Sequence, Union, overload
11
+ if sys.version_info >= (3, 11):
12
+ from typing import NotRequired, TypedDict, TypeAlias
13
+ else:
14
+ from typing_extensions import NotRequired, TypedDict, TypeAlias
10
15
  from .. import _utilities
11
16
  from . import outputs
12
17
  from ._inputs import *
@@ -38,38 +43,28 @@ class IntegrationArgs:
38
43
  use_metric_streams_sync: Optional[pulumi.Input[bool]] = None):
39
44
  """
40
45
  The set of arguments for constructing a Integration resource.
41
- :param pulumi.Input[bool] enabled: Whether the integration is enabled or not
42
- :param pulumi.Input[str] integration_id: The ID of this integration
43
- :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability should monitor.
44
- :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
45
- Splunk Observability imports the metrics so you can monitor them.
46
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
47
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
48
- :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
49
- Splunk Observability imports the metrics.
50
- :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
51
- Observability monitors the amount of data coming in from the integration.
52
- :param pulumi.Input[bool] enable_logs_sync: Enables AWS logs synchronization.
53
- :param pulumi.Input[str] external_id: Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
54
- :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
55
- Watch metrics from AWS.
56
- :param pulumi.Input[str] key: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
57
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
58
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
59
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
60
- statistics.
61
- :param pulumi.Input[str] named_token: A named token to use for ingest
62
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
63
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
64
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
65
- syncs all data in all AWS namespaces.
66
- :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Between `60` and `600`.
67
- :param pulumi.Input[str] role_arn: Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
68
- :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
69
- :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
70
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
71
- :param pulumi.Input[str] token: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
72
- :param pulumi.Input[bool] use_metric_streams_sync: Enables the use of Cloudwatch Metric Streams for metrics synchronization.
46
+ :param pulumi.Input[bool] enabled: Whether the integration is enabled.
47
+ :param pulumi.Input[str] integration_id: The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
48
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
49
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
50
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
51
+ :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
52
+ :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
53
+ :param pulumi.Input[bool] enable_logs_sync: Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
54
+ :param pulumi.Input[str] external_id: The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
55
+ :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
56
+ :param pulumi.Input[str] key: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
57
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
58
+ :param pulumi.Input[str] named_token: Name of the org token to be used for data ingestion. If not specified then default access token is used.
59
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
60
+ :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
61
+ :param pulumi.Input[str] role_arn: Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
62
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
63
+ :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
64
+ :param pulumi.Input[str] token: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
65
+ :param pulumi.Input[bool] use_metric_streams_sync: Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
66
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
67
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
73
68
  """
74
69
  pulumi.set(__self__, "enabled", enabled)
75
70
  pulumi.set(__self__, "integration_id", integration_id)
@@ -113,7 +108,7 @@ class IntegrationArgs:
113
108
  @pulumi.getter
114
109
  def enabled(self) -> pulumi.Input[bool]:
115
110
  """
116
- Whether the integration is enabled or not
111
+ Whether the integration is enabled.
117
112
  """
118
113
  return pulumi.get(self, "enabled")
119
114
 
@@ -125,7 +120,7 @@ class IntegrationArgs:
125
120
  @pulumi.getter(name="integrationId")
126
121
  def integration_id(self) -> pulumi.Input[str]:
127
122
  """
128
- The ID of this integration
123
+ The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
129
124
  """
130
125
  return pulumi.get(self, "integration_id")
131
126
 
@@ -137,7 +132,7 @@ class IntegrationArgs:
137
132
  @pulumi.getter
138
133
  def regions(self) -> pulumi.Input[Sequence[pulumi.Input[str]]]:
139
134
  """
140
- List of AWS regions that Splunk Observability should monitor.
135
+ List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
141
136
  """
142
137
  return pulumi.get(self, "regions")
143
138
 
@@ -149,8 +144,7 @@ class IntegrationArgs:
149
144
  @pulumi.getter(name="customCloudwatchNamespaces")
150
145
  def custom_cloudwatch_namespaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
151
146
  """
152
- List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
153
- Splunk Observability imports the metrics so you can monitor them.
147
+ List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
154
148
  """
155
149
  return pulumi.get(self, "custom_cloudwatch_namespaces")
156
150
 
@@ -162,8 +156,7 @@ class IntegrationArgs:
162
156
  @pulumi.getter(name="customNamespaceSyncRules")
163
157
  def custom_namespace_sync_rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]]]:
164
158
  """
165
- Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
166
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
159
+ Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
167
160
  """
168
161
  return pulumi.get(self, "custom_namespace_sync_rules")
169
162
 
@@ -175,8 +168,7 @@ class IntegrationArgs:
175
168
  @pulumi.getter(name="enableAwsUsage")
176
169
  def enable_aws_usage(self) -> Optional[pulumi.Input[bool]]:
177
170
  """
178
- Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
179
- Splunk Observability imports the metrics.
171
+ Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
180
172
  """
181
173
  return pulumi.get(self, "enable_aws_usage")
182
174
 
@@ -188,8 +180,7 @@ class IntegrationArgs:
188
180
  @pulumi.getter(name="enableCheckLargeVolume")
189
181
  def enable_check_large_volume(self) -> Optional[pulumi.Input[bool]]:
190
182
  """
191
- Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
192
- Observability monitors the amount of data coming in from the integration.
183
+ Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
193
184
  """
194
185
  return pulumi.get(self, "enable_check_large_volume")
195
186
 
@@ -201,7 +192,7 @@ class IntegrationArgs:
201
192
  @pulumi.getter(name="enableLogsSync")
202
193
  def enable_logs_sync(self) -> Optional[pulumi.Input[bool]]:
203
194
  """
204
- Enables AWS logs synchronization.
195
+ Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
205
196
  """
206
197
  return pulumi.get(self, "enable_logs_sync")
207
198
 
@@ -213,7 +204,7 @@ class IntegrationArgs:
213
204
  @pulumi.getter(name="externalId")
214
205
  def external_id(self) -> Optional[pulumi.Input[str]]:
215
206
  """
216
- Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
207
+ The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
217
208
  """
218
209
  return pulumi.get(self, "external_id")
219
210
 
@@ -225,8 +216,7 @@ class IntegrationArgs:
225
216
  @pulumi.getter(name="importCloudWatch")
226
217
  def import_cloud_watch(self) -> Optional[pulumi.Input[bool]]:
227
218
  """
228
- Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
229
- Watch metrics from AWS.
219
+ Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
230
220
  """
231
221
  return pulumi.get(self, "import_cloud_watch")
232
222
 
@@ -238,7 +228,7 @@ class IntegrationArgs:
238
228
  @pulumi.getter
239
229
  def key(self) -> Optional[pulumi.Input[str]]:
240
230
  """
241
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
231
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
242
232
  """
243
233
  return pulumi.get(self, "key")
244
234
 
@@ -250,10 +240,7 @@ class IntegrationArgs:
250
240
  @pulumi.getter(name="metricStatsToSyncs")
251
241
  def metric_stats_to_syncs(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]]]:
252
242
  """
253
- Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
254
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
255
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
256
- statistics.
243
+ Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
257
244
  """
258
245
  return pulumi.get(self, "metric_stats_to_syncs")
259
246
 
@@ -265,7 +252,7 @@ class IntegrationArgs:
265
252
  @pulumi.getter(name="namedToken")
266
253
  def named_token(self) -> Optional[pulumi.Input[str]]:
267
254
  """
268
- A named token to use for ingest
255
+ Name of the org token to be used for data ingestion. If not specified then default access token is used.
269
256
  """
270
257
  return pulumi.get(self, "named_token")
271
258
 
@@ -277,10 +264,7 @@ class IntegrationArgs:
277
264
  @pulumi.getter(name="namespaceSyncRules")
278
265
  def namespace_sync_rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]]]:
279
266
  """
280
- Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
281
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
282
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
283
- syncs all data in all AWS namespaces.
267
+ Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
284
268
  """
285
269
  return pulumi.get(self, "namespace_sync_rules")
286
270
 
@@ -292,7 +276,7 @@ class IntegrationArgs:
292
276
  @pulumi.getter(name="pollRate")
293
277
  def poll_rate(self) -> Optional[pulumi.Input[int]]:
294
278
  """
295
- AWS poll rate (in seconds). Between `60` and `600`.
279
+ AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
296
280
  """
297
281
  return pulumi.get(self, "poll_rate")
298
282
 
@@ -304,7 +288,7 @@ class IntegrationArgs:
304
288
  @pulumi.getter(name="roleArn")
305
289
  def role_arn(self) -> Optional[pulumi.Input[str]]:
306
290
  """
307
- Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
291
+ Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
308
292
  """
309
293
  return pulumi.get(self, "role_arn")
310
294
 
@@ -316,7 +300,7 @@ class IntegrationArgs:
316
300
  @pulumi.getter
317
301
  def services(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
318
302
  """
319
- List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
303
+ List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
320
304
  """
321
305
  return pulumi.get(self, "services")
322
306
 
@@ -328,8 +312,7 @@ class IntegrationArgs:
328
312
  @pulumi.getter(name="syncCustomNamespacesOnly")
329
313
  def sync_custom_namespaces_only(self) -> Optional[pulumi.Input[bool]]:
330
314
  """
331
- Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
332
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
315
+ Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
333
316
  """
334
317
  return pulumi.get(self, "sync_custom_namespaces_only")
335
318
 
@@ -341,7 +324,7 @@ class IntegrationArgs:
341
324
  @pulumi.getter
342
325
  def token(self) -> Optional[pulumi.Input[str]]:
343
326
  """
344
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
327
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
345
328
  """
346
329
  return pulumi.get(self, "token")
347
330
 
@@ -353,7 +336,9 @@ class IntegrationArgs:
353
336
  @pulumi.getter(name="useMetricStreamsSync")
354
337
  def use_metric_streams_sync(self) -> Optional[pulumi.Input[bool]]:
355
338
  """
356
- Enables the use of Cloudwatch Metric Streams for metrics synchronization.
339
+ Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
340
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
341
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
357
342
  """
358
343
  return pulumi.get(self, "use_metric_streams_sync")
359
344
 
@@ -389,42 +374,31 @@ class _IntegrationState:
389
374
  use_metric_streams_sync: Optional[pulumi.Input[bool]] = None):
390
375
  """
391
376
  Input properties used for looking up and filtering Integration resources.
392
- :param pulumi.Input[str] auth_method: The mechanism used to authenticate with AWS. Use one of `signalfx_aws_external_integration` or
393
- `signalfx_aws_token_integration` to define this
394
- :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
395
- Splunk Observability imports the metrics so you can monitor them.
396
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
397
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
398
- :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
399
- Splunk Observability imports the metrics.
400
- :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
401
- Observability monitors the amount of data coming in from the integration.
402
- :param pulumi.Input[bool] enable_logs_sync: Enables AWS logs synchronization.
403
- :param pulumi.Input[bool] enabled: Whether the integration is enabled or not
404
- :param pulumi.Input[str] external_id: Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
405
- :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
406
- Watch metrics from AWS.
407
- :param pulumi.Input[str] integration_id: The ID of this integration
408
- :param pulumi.Input[str] key: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
409
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
410
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
411
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
412
- statistics.
413
- :param pulumi.Input[str] name: Name of the integration. Please specify the name in `signalfx_aws_external_integration` or
414
- `signalfx_aws_integration_token`
415
- :param pulumi.Input[str] named_token: A named token to use for ingest
416
- :param pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
417
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
418
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
419
- syncs all data in all AWS namespaces.
420
- :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Between `60` and `600`.
421
- :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability should monitor.
422
- :param pulumi.Input[str] role_arn: Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
423
- :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
424
- :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
425
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
426
- :param pulumi.Input[str] token: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
427
- :param pulumi.Input[bool] use_metric_streams_sync: Enables the use of Cloudwatch Metric Streams for metrics synchronization.
377
+ :param pulumi.Input[str] auth_method: The mechanism used to authenticate with AWS. Use one of `aws.ExternalIntegration` or `aws.TokenIntegration` to define
378
+ this
379
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
380
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
381
+ :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
382
+ :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
383
+ :param pulumi.Input[bool] enable_logs_sync: Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
384
+ :param pulumi.Input[bool] enabled: Whether the integration is enabled.
385
+ :param pulumi.Input[str] external_id: The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
386
+ :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
387
+ :param pulumi.Input[str] integration_id: The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
388
+ :param pulumi.Input[str] key: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
389
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
390
+ :param pulumi.Input[str] name: Name of the integration.
391
+ :param pulumi.Input[str] named_token: Name of the org token to be used for data ingestion. If not specified then default access token is used.
392
+ :param pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
393
+ :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
394
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
395
+ :param pulumi.Input[str] role_arn: Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
396
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
397
+ :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
398
+ :param pulumi.Input[str] token: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
399
+ :param pulumi.Input[bool] use_metric_streams_sync: Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
400
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
401
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
428
402
  """
429
403
  if auth_method is not None:
430
404
  pulumi.set(__self__, "auth_method", auth_method)
@@ -475,8 +449,8 @@ class _IntegrationState:
475
449
  @pulumi.getter(name="authMethod")
476
450
  def auth_method(self) -> Optional[pulumi.Input[str]]:
477
451
  """
478
- The mechanism used to authenticate with AWS. Use one of `signalfx_aws_external_integration` or
479
- `signalfx_aws_token_integration` to define this
452
+ The mechanism used to authenticate with AWS. Use one of `aws.ExternalIntegration` or `aws.TokenIntegration` to define
453
+ this
480
454
  """
481
455
  return pulumi.get(self, "auth_method")
482
456
 
@@ -488,8 +462,7 @@ class _IntegrationState:
488
462
  @pulumi.getter(name="customCloudwatchNamespaces")
489
463
  def custom_cloudwatch_namespaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
490
464
  """
491
- List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
492
- Splunk Observability imports the metrics so you can monitor them.
465
+ List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
493
466
  """
494
467
  return pulumi.get(self, "custom_cloudwatch_namespaces")
495
468
 
@@ -501,8 +474,7 @@ class _IntegrationState:
501
474
  @pulumi.getter(name="customNamespaceSyncRules")
502
475
  def custom_namespace_sync_rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationCustomNamespaceSyncRuleArgs']]]]:
503
476
  """
504
- Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
505
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
477
+ Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
506
478
  """
507
479
  return pulumi.get(self, "custom_namespace_sync_rules")
508
480
 
@@ -514,8 +486,7 @@ class _IntegrationState:
514
486
  @pulumi.getter(name="enableAwsUsage")
515
487
  def enable_aws_usage(self) -> Optional[pulumi.Input[bool]]:
516
488
  """
517
- Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
518
- Splunk Observability imports the metrics.
489
+ Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
519
490
  """
520
491
  return pulumi.get(self, "enable_aws_usage")
521
492
 
@@ -527,8 +498,7 @@ class _IntegrationState:
527
498
  @pulumi.getter(name="enableCheckLargeVolume")
528
499
  def enable_check_large_volume(self) -> Optional[pulumi.Input[bool]]:
529
500
  """
530
- Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
531
- Observability monitors the amount of data coming in from the integration.
501
+ Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
532
502
  """
533
503
  return pulumi.get(self, "enable_check_large_volume")
534
504
 
@@ -540,7 +510,7 @@ class _IntegrationState:
540
510
  @pulumi.getter(name="enableLogsSync")
541
511
  def enable_logs_sync(self) -> Optional[pulumi.Input[bool]]:
542
512
  """
543
- Enables AWS logs synchronization.
513
+ Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
544
514
  """
545
515
  return pulumi.get(self, "enable_logs_sync")
546
516
 
@@ -552,7 +522,7 @@ class _IntegrationState:
552
522
  @pulumi.getter
553
523
  def enabled(self) -> Optional[pulumi.Input[bool]]:
554
524
  """
555
- Whether the integration is enabled or not
525
+ Whether the integration is enabled.
556
526
  """
557
527
  return pulumi.get(self, "enabled")
558
528
 
@@ -564,7 +534,7 @@ class _IntegrationState:
564
534
  @pulumi.getter(name="externalId")
565
535
  def external_id(self) -> Optional[pulumi.Input[str]]:
566
536
  """
567
- Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
537
+ The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
568
538
  """
569
539
  return pulumi.get(self, "external_id")
570
540
 
@@ -576,8 +546,7 @@ class _IntegrationState:
576
546
  @pulumi.getter(name="importCloudWatch")
577
547
  def import_cloud_watch(self) -> Optional[pulumi.Input[bool]]:
578
548
  """
579
- Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
580
- Watch metrics from AWS.
549
+ Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
581
550
  """
582
551
  return pulumi.get(self, "import_cloud_watch")
583
552
 
@@ -589,7 +558,7 @@ class _IntegrationState:
589
558
  @pulumi.getter(name="integrationId")
590
559
  def integration_id(self) -> Optional[pulumi.Input[str]]:
591
560
  """
592
- The ID of this integration
561
+ The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
593
562
  """
594
563
  return pulumi.get(self, "integration_id")
595
564
 
@@ -601,7 +570,7 @@ class _IntegrationState:
601
570
  @pulumi.getter
602
571
  def key(self) -> Optional[pulumi.Input[str]]:
603
572
  """
604
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
573
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
605
574
  """
606
575
  return pulumi.get(self, "key")
607
576
 
@@ -613,10 +582,7 @@ class _IntegrationState:
613
582
  @pulumi.getter(name="metricStatsToSyncs")
614
583
  def metric_stats_to_syncs(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationMetricStatsToSyncArgs']]]]:
615
584
  """
616
- Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
617
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
618
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
619
- statistics.
585
+ Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
620
586
  """
621
587
  return pulumi.get(self, "metric_stats_to_syncs")
622
588
 
@@ -628,8 +594,7 @@ class _IntegrationState:
628
594
  @pulumi.getter
629
595
  def name(self) -> Optional[pulumi.Input[str]]:
630
596
  """
631
- Name of the integration. Please specify the name in `signalfx_aws_external_integration` or
632
- `signalfx_aws_integration_token`
597
+ Name of the integration.
633
598
  """
634
599
  return pulumi.get(self, "name")
635
600
 
@@ -641,7 +606,7 @@ class _IntegrationState:
641
606
  @pulumi.getter(name="namedToken")
642
607
  def named_token(self) -> Optional[pulumi.Input[str]]:
643
608
  """
644
- A named token to use for ingest
609
+ Name of the org token to be used for data ingestion. If not specified then default access token is used.
645
610
  """
646
611
  return pulumi.get(self, "named_token")
647
612
 
@@ -653,10 +618,7 @@ class _IntegrationState:
653
618
  @pulumi.getter(name="namespaceSyncRules")
654
619
  def namespace_sync_rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['IntegrationNamespaceSyncRuleArgs']]]]:
655
620
  """
656
- Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
657
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
658
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
659
- syncs all data in all AWS namespaces.
621
+ Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
660
622
  """
661
623
  return pulumi.get(self, "namespace_sync_rules")
662
624
 
@@ -668,7 +630,7 @@ class _IntegrationState:
668
630
  @pulumi.getter(name="pollRate")
669
631
  def poll_rate(self) -> Optional[pulumi.Input[int]]:
670
632
  """
671
- AWS poll rate (in seconds). Between `60` and `600`.
633
+ AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
672
634
  """
673
635
  return pulumi.get(self, "poll_rate")
674
636
 
@@ -680,7 +642,7 @@ class _IntegrationState:
680
642
  @pulumi.getter
681
643
  def regions(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
682
644
  """
683
- List of AWS regions that Splunk Observability should monitor.
645
+ List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
684
646
  """
685
647
  return pulumi.get(self, "regions")
686
648
 
@@ -692,7 +654,7 @@ class _IntegrationState:
692
654
  @pulumi.getter(name="roleArn")
693
655
  def role_arn(self) -> Optional[pulumi.Input[str]]:
694
656
  """
695
- Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
657
+ Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
696
658
  """
697
659
  return pulumi.get(self, "role_arn")
698
660
 
@@ -704,7 +666,7 @@ class _IntegrationState:
704
666
  @pulumi.getter
705
667
  def services(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
706
668
  """
707
- List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
669
+ List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
708
670
  """
709
671
  return pulumi.get(self, "services")
710
672
 
@@ -716,8 +678,7 @@ class _IntegrationState:
716
678
  @pulumi.getter(name="syncCustomNamespacesOnly")
717
679
  def sync_custom_namespaces_only(self) -> Optional[pulumi.Input[bool]]:
718
680
  """
719
- Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
720
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
681
+ Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
721
682
  """
722
683
  return pulumi.get(self, "sync_custom_namespaces_only")
723
684
 
@@ -729,7 +690,7 @@ class _IntegrationState:
729
690
  @pulumi.getter
730
691
  def token(self) -> Optional[pulumi.Input[str]]:
731
692
  """
732
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
693
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
733
694
  """
734
695
  return pulumi.get(self, "token")
735
696
 
@@ -741,7 +702,9 @@ class _IntegrationState:
741
702
  @pulumi.getter(name="useMetricStreamsSync")
742
703
  def use_metric_streams_sync(self) -> Optional[pulumi.Input[bool]]:
743
704
  """
744
- Enables the use of Cloudwatch Metric Streams for metrics synchronization.
705
+ Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
706
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
707
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
745
708
  """
746
709
  return pulumi.get(self, "use_metric_streams_sync")
747
710
 
@@ -756,7 +719,7 @@ class Integration(pulumi.CustomResource):
756
719
  resource_name: str,
757
720
  opts: Optional[pulumi.ResourceOptions] = None,
758
721
  custom_cloudwatch_namespaces: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
759
- custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationCustomNamespaceSyncRuleArgs']]]]] = None,
722
+ custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationCustomNamespaceSyncRuleArgs', 'IntegrationCustomNamespaceSyncRuleArgsDict']]]]] = None,
760
723
  enable_aws_usage: Optional[pulumi.Input[bool]] = None,
761
724
  enable_check_large_volume: Optional[pulumi.Input[bool]] = None,
762
725
  enable_logs_sync: Optional[pulumi.Input[bool]] = None,
@@ -765,9 +728,9 @@ class Integration(pulumi.CustomResource):
765
728
  import_cloud_watch: Optional[pulumi.Input[bool]] = None,
766
729
  integration_id: Optional[pulumi.Input[str]] = None,
767
730
  key: Optional[pulumi.Input[str]] = None,
768
- metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationMetricStatsToSyncArgs']]]]] = None,
731
+ metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationMetricStatsToSyncArgs', 'IntegrationMetricStatsToSyncArgsDict']]]]] = None,
769
732
  named_token: Optional[pulumi.Input[str]] = None,
770
- namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationNamespaceSyncRuleArgs']]]]] = None,
733
+ namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationNamespaceSyncRuleArgs', 'IntegrationNamespaceSyncRuleArgsDict']]]]] = None,
771
734
  poll_rate: Optional[pulumi.Input[int]] = None,
772
735
  regions: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
773
736
  role_arn: Optional[pulumi.Input[str]] = None,
@@ -785,77 +748,67 @@ class Integration(pulumi.CustomResource):
785
748
 
786
749
  ## Example
787
750
 
788
- ## Arguments
789
-
790
- * `enable_aws_usage` - (Optional) Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
791
- * `enable_check_large_volume` - (Optional) Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
792
- * `enable_logs_sync` - (Optional) Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
793
- * `enabled` - (Required) Whether the integration is enabled.
794
- * `external_id` - (Required) The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
795
- * `custom_cloudwatch_namespaces` - (Optional) List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
796
- * `custom_namespace_sync_rule` - (Optional) Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
797
- * `default_action` - (Optional) Controls the Splunk Observability Cloud default behavior for processing data from an AWS namespace. Splunk Observability Cloud ignores this property unless you specify the `filter_action` and `filter_source` properties. If you do specify them, use this property to control how Splunk Observability Cloud treats data that doesn't match the filter. The available actions are one of `"Include"` or `"Exclude"`.
798
- * `filter_action` - (Optional) Controls how Splunk Observability Cloud processes data from a custom AWS namespace. The available actions are one of `"Include"` or `"Exclude"`.
799
- * `filter_source` - (Optional) Expression that selects the data that Splunk Observability Cloud should sync for the custom namespace associated with this sync rule. The expression uses the syntax defined for the SignalFlow `filter()` function; it can be any valid SignalFlow filter expression.
800
- * `namespace` - (Required) An AWS custom namespace having custom AWS metrics that you want to sync with Splunk Observability Cloud. See the AWS documentation on publishing metrics for more information.
801
- * `import_cloud_watch` - (Optional) Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
802
- * `integration_id` - (Required) The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
803
- * `key` - (Optional) If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
804
- * `metric_stats_to_sync` - (Optional) Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
805
- * `metric` - (Required) AWS metric that you want to pick statistics for
806
- * `namespace` - (Required) An AWS namespace having AWS metric that you want to pick statistics for
807
- * `stats` - (Required) AWS statistics you want to collect
808
- * `name` - (Required) Name of the integration.
809
- * `named_token` - (Optional) Name of the org token to be used for data ingestion. If not specified then default access token is used.
810
- * `namespace_sync_rule` - (Optional) Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
811
- * `default_action` - (Optional) Controls the Splunk Observability Cloud default behavior for processing data from an AWS namespace. Splunk Observability Cloud ignores this property unless you specify the `filter_action` and `filter_source` properties. If you do specify them, use this property to control how Splunk Observability Cloud treats data that doesn't match the filter. The available actions are one of `"Include"` or `"Exclude"`.
812
- * `filter_action` - (Optional) Controls how Splunk Observability Cloud processes data from a custom AWS namespace. The available actions are one of `"Include"` or `"Exclude"`.
813
- * `filter_source` - (Optional) Expression that selects the data that Splunk Observability Cloud should sync for the custom namespace associated with this sync rule. The expression uses the syntax defined for the SignalFlow `filter()` function; it can be any valid SignalFlow filter expression.
814
- * `namespace` - (Required) An AWS custom namespace having custom AWS metrics that you want to sync with Splunk Observability Cloud. See `services` field description below for additional information.
815
- * `poll_rate` - (Optional) AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
816
- * `regions` - (Required) List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
817
- * `role_arn` - (Optional) Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
818
- * `services` - (Optional) List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
819
- * `sync_custom_namespaces_only` - (Optional) Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
820
- * `token` - (Optional) If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
821
- * `use_metric_streams_sync` - (Optional) Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
822
- Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
823
- Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
751
+ ```python
752
+ import pulumi
753
+ import pulumi_aws as aws
754
+ import pulumi_signalfx as signalfx
755
+
756
+ # This resource returns an account id in `external_id`…
757
+ aws_myteam_external = signalfx.aws.ExternalIntegration("aws_myteam_external", name="My AWS integration")
758
+ # Make yourself an AWS IAM role here, use `signalfx_aws_external_integration.aws_myteam_external.external_id`
759
+ aws_sfx_role = aws.index.IamRole("aws_sfx_role")
760
+ aws_myteam = signalfx.aws.Integration("aws_myteam",
761
+ enabled=True,
762
+ integration_id=aws_myteam_external.id,
763
+ external_id=aws_myteam_external.external_id,
764
+ role_arn=aws_sfx_role["arn"],
765
+ regions=["us-east-1"],
766
+ poll_rate=300,
767
+ import_cloud_watch=True,
768
+ enable_aws_usage=True,
769
+ custom_namespace_sync_rules=[{
770
+ "default_action": "Exclude",
771
+ "filter_action": "Include",
772
+ "filter_source": "filter('code', '200')",
773
+ "namespace": "my-custom-namespace",
774
+ }],
775
+ namespace_sync_rules=[{
776
+ "default_action": "Exclude",
777
+ "filter_action": "Include",
778
+ "filter_source": "filter('code', '200')",
779
+ "namespace": "AWS/EC2",
780
+ }],
781
+ metric_stats_to_syncs=[{
782
+ "namespace": "AWS/EC2",
783
+ "metric": "NetworkPacketsIn",
784
+ "stats": ["upper"],
785
+ }])
786
+ ```
824
787
 
825
788
  :param str resource_name: The name of the resource.
826
789
  :param pulumi.ResourceOptions opts: Options for the resource.
827
- :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
828
- Splunk Observability imports the metrics so you can monitor them.
829
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationCustomNamespaceSyncRuleArgs']]]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
830
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
831
- :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
832
- Splunk Observability imports the metrics.
833
- :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
834
- Observability monitors the amount of data coming in from the integration.
835
- :param pulumi.Input[bool] enable_logs_sync: Enables AWS logs synchronization.
836
- :param pulumi.Input[bool] enabled: Whether the integration is enabled or not
837
- :param pulumi.Input[str] external_id: Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
838
- :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
839
- Watch metrics from AWS.
840
- :param pulumi.Input[str] integration_id: The ID of this integration
841
- :param pulumi.Input[str] key: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
842
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationMetricStatsToSyncArgs']]]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
843
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
844
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
845
- statistics.
846
- :param pulumi.Input[str] named_token: A named token to use for ingest
847
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationNamespaceSyncRuleArgs']]]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
848
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
849
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
850
- syncs all data in all AWS namespaces.
851
- :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Between `60` and `600`.
852
- :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability should monitor.
853
- :param pulumi.Input[str] role_arn: Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
854
- :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
855
- :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
856
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
857
- :param pulumi.Input[str] token: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
858
- :param pulumi.Input[bool] use_metric_streams_sync: Enables the use of Cloudwatch Metric Streams for metrics synchronization.
790
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
791
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationCustomNamespaceSyncRuleArgs', 'IntegrationCustomNamespaceSyncRuleArgsDict']]]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
792
+ :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
793
+ :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
794
+ :param pulumi.Input[bool] enable_logs_sync: Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
795
+ :param pulumi.Input[bool] enabled: Whether the integration is enabled.
796
+ :param pulumi.Input[str] external_id: The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
797
+ :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
798
+ :param pulumi.Input[str] integration_id: The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
799
+ :param pulumi.Input[str] key: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
800
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationMetricStatsToSyncArgs', 'IntegrationMetricStatsToSyncArgsDict']]]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
801
+ :param pulumi.Input[str] named_token: Name of the org token to be used for data ingestion. If not specified then default access token is used.
802
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationNamespaceSyncRuleArgs', 'IntegrationNamespaceSyncRuleArgsDict']]]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
803
+ :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
804
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
805
+ :param pulumi.Input[str] role_arn: Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
806
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
807
+ :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
808
+ :param pulumi.Input[str] token: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
809
+ :param pulumi.Input[bool] use_metric_streams_sync: Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
810
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
811
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
859
812
  """
860
813
  ...
861
814
  @overload
@@ -872,42 +825,42 @@ class Integration(pulumi.CustomResource):
872
825
 
873
826
  ## Example
874
827
 
875
- ## Arguments
876
-
877
- * `enable_aws_usage` - (Optional) Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
878
- * `enable_check_large_volume` - (Optional) Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
879
- * `enable_logs_sync` - (Optional) Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
880
- * `enabled` - (Required) Whether the integration is enabled.
881
- * `external_id` - (Required) The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
882
- * `custom_cloudwatch_namespaces` - (Optional) List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
883
- * `custom_namespace_sync_rule` - (Optional) Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
884
- * `default_action` - (Optional) Controls the Splunk Observability Cloud default behavior for processing data from an AWS namespace. Splunk Observability Cloud ignores this property unless you specify the `filter_action` and `filter_source` properties. If you do specify them, use this property to control how Splunk Observability Cloud treats data that doesn't match the filter. The available actions are one of `"Include"` or `"Exclude"`.
885
- * `filter_action` - (Optional) Controls how Splunk Observability Cloud processes data from a custom AWS namespace. The available actions are one of `"Include"` or `"Exclude"`.
886
- * `filter_source` - (Optional) Expression that selects the data that Splunk Observability Cloud should sync for the custom namespace associated with this sync rule. The expression uses the syntax defined for the SignalFlow `filter()` function; it can be any valid SignalFlow filter expression.
887
- * `namespace` - (Required) An AWS custom namespace having custom AWS metrics that you want to sync with Splunk Observability Cloud. See the AWS documentation on publishing metrics for more information.
888
- * `import_cloud_watch` - (Optional) Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
889
- * `integration_id` - (Required) The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
890
- * `key` - (Optional) If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
891
- * `metric_stats_to_sync` - (Optional) Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
892
- * `metric` - (Required) AWS metric that you want to pick statistics for
893
- * `namespace` - (Required) An AWS namespace having AWS metric that you want to pick statistics for
894
- * `stats` - (Required) AWS statistics you want to collect
895
- * `name` - (Required) Name of the integration.
896
- * `named_token` - (Optional) Name of the org token to be used for data ingestion. If not specified then default access token is used.
897
- * `namespace_sync_rule` - (Optional) Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
898
- * `default_action` - (Optional) Controls the Splunk Observability Cloud default behavior for processing data from an AWS namespace. Splunk Observability Cloud ignores this property unless you specify the `filter_action` and `filter_source` properties. If you do specify them, use this property to control how Splunk Observability Cloud treats data that doesn't match the filter. The available actions are one of `"Include"` or `"Exclude"`.
899
- * `filter_action` - (Optional) Controls how Splunk Observability Cloud processes data from a custom AWS namespace. The available actions are one of `"Include"` or `"Exclude"`.
900
- * `filter_source` - (Optional) Expression that selects the data that Splunk Observability Cloud should sync for the custom namespace associated with this sync rule. The expression uses the syntax defined for the SignalFlow `filter()` function; it can be any valid SignalFlow filter expression.
901
- * `namespace` - (Required) An AWS custom namespace having custom AWS metrics that you want to sync with Splunk Observability Cloud. See `services` field description below for additional information.
902
- * `poll_rate` - (Optional) AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
903
- * `regions` - (Required) List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
904
- * `role_arn` - (Optional) Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
905
- * `services` - (Optional) List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
906
- * `sync_custom_namespaces_only` - (Optional) Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
907
- * `token` - (Optional) If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
908
- * `use_metric_streams_sync` - (Optional) Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
909
- Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
910
- Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
828
+ ```python
829
+ import pulumi
830
+ import pulumi_aws as aws
831
+ import pulumi_signalfx as signalfx
832
+
833
+ # This resource returns an account id in `external_id`…
834
+ aws_myteam_external = signalfx.aws.ExternalIntegration("aws_myteam_external", name="My AWS integration")
835
+ # Make yourself an AWS IAM role here, use `signalfx_aws_external_integration.aws_myteam_external.external_id`
836
+ aws_sfx_role = aws.index.IamRole("aws_sfx_role")
837
+ aws_myteam = signalfx.aws.Integration("aws_myteam",
838
+ enabled=True,
839
+ integration_id=aws_myteam_external.id,
840
+ external_id=aws_myteam_external.external_id,
841
+ role_arn=aws_sfx_role["arn"],
842
+ regions=["us-east-1"],
843
+ poll_rate=300,
844
+ import_cloud_watch=True,
845
+ enable_aws_usage=True,
846
+ custom_namespace_sync_rules=[{
847
+ "default_action": "Exclude",
848
+ "filter_action": "Include",
849
+ "filter_source": "filter('code', '200')",
850
+ "namespace": "my-custom-namespace",
851
+ }],
852
+ namespace_sync_rules=[{
853
+ "default_action": "Exclude",
854
+ "filter_action": "Include",
855
+ "filter_source": "filter('code', '200')",
856
+ "namespace": "AWS/EC2",
857
+ }],
858
+ metric_stats_to_syncs=[{
859
+ "namespace": "AWS/EC2",
860
+ "metric": "NetworkPacketsIn",
861
+ "stats": ["upper"],
862
+ }])
863
+ ```
911
864
 
912
865
  :param str resource_name: The name of the resource.
913
866
  :param IntegrationArgs args: The arguments to use to populate this resource's properties.
@@ -925,7 +878,7 @@ class Integration(pulumi.CustomResource):
925
878
  resource_name: str,
926
879
  opts: Optional[pulumi.ResourceOptions] = None,
927
880
  custom_cloudwatch_namespaces: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
928
- custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationCustomNamespaceSyncRuleArgs']]]]] = None,
881
+ custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationCustomNamespaceSyncRuleArgs', 'IntegrationCustomNamespaceSyncRuleArgsDict']]]]] = None,
929
882
  enable_aws_usage: Optional[pulumi.Input[bool]] = None,
930
883
  enable_check_large_volume: Optional[pulumi.Input[bool]] = None,
931
884
  enable_logs_sync: Optional[pulumi.Input[bool]] = None,
@@ -934,9 +887,9 @@ class Integration(pulumi.CustomResource):
934
887
  import_cloud_watch: Optional[pulumi.Input[bool]] = None,
935
888
  integration_id: Optional[pulumi.Input[str]] = None,
936
889
  key: Optional[pulumi.Input[str]] = None,
937
- metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationMetricStatsToSyncArgs']]]]] = None,
890
+ metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationMetricStatsToSyncArgs', 'IntegrationMetricStatsToSyncArgsDict']]]]] = None,
938
891
  named_token: Optional[pulumi.Input[str]] = None,
939
- namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationNamespaceSyncRuleArgs']]]]] = None,
892
+ namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationNamespaceSyncRuleArgs', 'IntegrationNamespaceSyncRuleArgsDict']]]]] = None,
940
893
  poll_rate: Optional[pulumi.Input[int]] = None,
941
894
  regions: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
942
895
  role_arn: Optional[pulumi.Input[str]] = None,
@@ -995,7 +948,7 @@ class Integration(pulumi.CustomResource):
995
948
  opts: Optional[pulumi.ResourceOptions] = None,
996
949
  auth_method: Optional[pulumi.Input[str]] = None,
997
950
  custom_cloudwatch_namespaces: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
998
- custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationCustomNamespaceSyncRuleArgs']]]]] = None,
951
+ custom_namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationCustomNamespaceSyncRuleArgs', 'IntegrationCustomNamespaceSyncRuleArgsDict']]]]] = None,
999
952
  enable_aws_usage: Optional[pulumi.Input[bool]] = None,
1000
953
  enable_check_large_volume: Optional[pulumi.Input[bool]] = None,
1001
954
  enable_logs_sync: Optional[pulumi.Input[bool]] = None,
@@ -1004,10 +957,10 @@ class Integration(pulumi.CustomResource):
1004
957
  import_cloud_watch: Optional[pulumi.Input[bool]] = None,
1005
958
  integration_id: Optional[pulumi.Input[str]] = None,
1006
959
  key: Optional[pulumi.Input[str]] = None,
1007
- metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationMetricStatsToSyncArgs']]]]] = None,
960
+ metric_stats_to_syncs: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationMetricStatsToSyncArgs', 'IntegrationMetricStatsToSyncArgsDict']]]]] = None,
1008
961
  name: Optional[pulumi.Input[str]] = None,
1009
962
  named_token: Optional[pulumi.Input[str]] = None,
1010
- namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationNamespaceSyncRuleArgs']]]]] = None,
963
+ namespace_sync_rules: Optional[pulumi.Input[Sequence[pulumi.Input[Union['IntegrationNamespaceSyncRuleArgs', 'IntegrationNamespaceSyncRuleArgsDict']]]]] = None,
1011
964
  poll_rate: Optional[pulumi.Input[int]] = None,
1012
965
  regions: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
1013
966
  role_arn: Optional[pulumi.Input[str]] = None,
@@ -1022,42 +975,31 @@ class Integration(pulumi.CustomResource):
1022
975
  :param str resource_name: The unique name of the resulting resource.
1023
976
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
1024
977
  :param pulumi.ResourceOptions opts: Options for the resource.
1025
- :param pulumi.Input[str] auth_method: The mechanism used to authenticate with AWS. Use one of `signalfx_aws_external_integration` or
1026
- `signalfx_aws_token_integration` to define this
1027
- :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
1028
- Splunk Observability imports the metrics so you can monitor them.
1029
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationCustomNamespaceSyncRuleArgs']]]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
1030
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
1031
- :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
1032
- Splunk Observability imports the metrics.
1033
- :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
1034
- Observability monitors the amount of data coming in from the integration.
1035
- :param pulumi.Input[bool] enable_logs_sync: Enables AWS logs synchronization.
1036
- :param pulumi.Input[bool] enabled: Whether the integration is enabled or not
1037
- :param pulumi.Input[str] external_id: Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
1038
- :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
1039
- Watch metrics from AWS.
1040
- :param pulumi.Input[str] integration_id: The ID of this integration
1041
- :param pulumi.Input[str] key: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
1042
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationMetricStatsToSyncArgs']]]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
1043
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
1044
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
1045
- statistics.
1046
- :param pulumi.Input[str] name: Name of the integration. Please specify the name in `signalfx_aws_external_integration` or
1047
- `signalfx_aws_integration_token`
1048
- :param pulumi.Input[str] named_token: A named token to use for ingest
1049
- :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['IntegrationNamespaceSyncRuleArgs']]]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
1050
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
1051
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
1052
- syncs all data in all AWS namespaces.
1053
- :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Between `60` and `600`.
1054
- :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability should monitor.
1055
- :param pulumi.Input[str] role_arn: Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
1056
- :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
1057
- :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
1058
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
1059
- :param pulumi.Input[str] token: Used with `signalfx_aws_token_integration`. Use this property to specify the token.
1060
- :param pulumi.Input[bool] use_metric_streams_sync: Enables the use of Cloudwatch Metric Streams for metrics synchronization.
978
+ :param pulumi.Input[str] auth_method: The mechanism used to authenticate with AWS. Use one of `aws.ExternalIntegration` or `aws.TokenIntegration` to define
979
+ this
980
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] custom_cloudwatch_namespaces: List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
981
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationCustomNamespaceSyncRuleArgs', 'IntegrationCustomNamespaceSyncRuleArgsDict']]]] custom_namespace_sync_rules: Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
982
+ :param pulumi.Input[bool] enable_aws_usage: Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
983
+ :param pulumi.Input[bool] enable_check_large_volume: Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
984
+ :param pulumi.Input[bool] enable_logs_sync: Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
985
+ :param pulumi.Input[bool] enabled: Whether the integration is enabled.
986
+ :param pulumi.Input[str] external_id: The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
987
+ :param pulumi.Input[bool] import_cloud_watch: Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
988
+ :param pulumi.Input[str] integration_id: The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
989
+ :param pulumi.Input[str] key: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
990
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationMetricStatsToSyncArgs', 'IntegrationMetricStatsToSyncArgsDict']]]] metric_stats_to_syncs: Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
991
+ :param pulumi.Input[str] name: Name of the integration.
992
+ :param pulumi.Input[str] named_token: Name of the org token to be used for data ingestion. If not specified then default access token is used.
993
+ :param pulumi.Input[Sequence[pulumi.Input[Union['IntegrationNamespaceSyncRuleArgs', 'IntegrationNamespaceSyncRuleArgsDict']]]] namespace_sync_rules: Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
994
+ :param pulumi.Input[int] poll_rate: AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
995
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] regions: List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
996
+ :param pulumi.Input[str] role_arn: Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
997
+ :param pulumi.Input[Sequence[pulumi.Input[str]]] services: List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
998
+ :param pulumi.Input[bool] sync_custom_namespaces_only: Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
999
+ :param pulumi.Input[str] token: If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
1000
+ :param pulumi.Input[bool] use_metric_streams_sync: Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
1001
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
1002
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
1061
1003
  """
1062
1004
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
1063
1005
 
@@ -1091,8 +1033,8 @@ class Integration(pulumi.CustomResource):
1091
1033
  @pulumi.getter(name="authMethod")
1092
1034
  def auth_method(self) -> pulumi.Output[str]:
1093
1035
  """
1094
- The mechanism used to authenticate with AWS. Use one of `signalfx_aws_external_integration` or
1095
- `signalfx_aws_token_integration` to define this
1036
+ The mechanism used to authenticate with AWS. Use one of `aws.ExternalIntegration` or `aws.TokenIntegration` to define
1037
+ this
1096
1038
  """
1097
1039
  return pulumi.get(self, "auth_method")
1098
1040
 
@@ -1100,8 +1042,7 @@ class Integration(pulumi.CustomResource):
1100
1042
  @pulumi.getter(name="customCloudwatchNamespaces")
1101
1043
  def custom_cloudwatch_namespaces(self) -> pulumi.Output[Optional[Sequence[str]]]:
1102
1044
  """
1103
- List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS;
1104
- Splunk Observability imports the metrics so you can monitor them.
1045
+ List of custom AWS CloudWatch namespaces to monitor. Custom namespaces contain custom metrics that you define in AWS; Splunk Observability Cloud imports the metrics so you can monitor them.
1105
1046
  """
1106
1047
  return pulumi.get(self, "custom_cloudwatch_namespaces")
1107
1048
 
@@ -1109,8 +1050,7 @@ class Integration(pulumi.CustomResource):
1109
1050
  @pulumi.getter(name="customNamespaceSyncRules")
1110
1051
  def custom_namespace_sync_rules(self) -> pulumi.Output[Optional[Sequence['outputs.IntegrationCustomNamespaceSyncRule']]]:
1111
1052
  """
1112
- Each element controls the data collected by Splunk Observability for the specified namespace. If you specify this
1113
- property, Splunk Observability ignores values in the "custom_cloudwatch_namespaces" property.
1053
+ Each element controls the data collected by Splunk Observability Cloud for the specified namespace. Conflicts with the `custom_cloudwatch_namespaces` property.
1114
1054
  """
1115
1055
  return pulumi.get(self, "custom_namespace_sync_rules")
1116
1056
 
@@ -1118,8 +1058,7 @@ class Integration(pulumi.CustomResource):
1118
1058
  @pulumi.getter(name="enableAwsUsage")
1119
1059
  def enable_aws_usage(self) -> pulumi.Output[Optional[bool]]:
1120
1060
  """
1121
- Flag that controls how Splunk Observability imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`,
1122
- Splunk Observability imports the metrics.
1061
+ Flag that controls how Splunk Observability Cloud imports usage metrics from AWS to use with AWS Cost Optimizer. If `true`, Splunk Observability Cloud imports the metrics.
1123
1062
  """
1124
1063
  return pulumi.get(self, "enable_aws_usage")
1125
1064
 
@@ -1127,8 +1066,7 @@ class Integration(pulumi.CustomResource):
1127
1066
  @pulumi.getter(name="enableCheckLargeVolume")
1128
1067
  def enable_check_large_volume(self) -> pulumi.Output[Optional[bool]]:
1129
1068
  """
1130
- Controls how Splunk Observability checks for large amounts of data for this AWS integration. If true, Splunk
1131
- Observability monitors the amount of data coming in from the integration.
1069
+ Controls how Splunk Observability Cloud checks for large amounts of data for this AWS integration. If `true`, Splunk Observability Cloud monitors the amount of data coming in from the integration.
1132
1070
  """
1133
1071
  return pulumi.get(self, "enable_check_large_volume")
1134
1072
 
@@ -1136,7 +1074,7 @@ class Integration(pulumi.CustomResource):
1136
1074
  @pulumi.getter(name="enableLogsSync")
1137
1075
  def enable_logs_sync(self) -> pulumi.Output[bool]:
1138
1076
  """
1139
- Enables AWS logs synchronization.
1077
+ Enable the AWS logs synchronization. Note that this requires the inclusion of `"logs:DescribeLogGroups"`, `"logs:DeleteSubscriptionFilter"`, `"logs:DescribeSubscriptionFilters"`, `"logs:PutSubscriptionFilter"`, and `"s3:GetBucketLogging"`, `"s3:GetBucketNotification"`, `"s3:PutBucketNotification"` permissions. Additional permissions may be required to capture logs from specific AWS services.
1140
1078
  """
1141
1079
  return pulumi.get(self, "enable_logs_sync")
1142
1080
 
@@ -1144,7 +1082,7 @@ class Integration(pulumi.CustomResource):
1144
1082
  @pulumi.getter
1145
1083
  def enabled(self) -> pulumi.Output[bool]:
1146
1084
  """
1147
- Whether the integration is enabled or not
1085
+ Whether the integration is enabled.
1148
1086
  """
1149
1087
  return pulumi.get(self, "enabled")
1150
1088
 
@@ -1152,7 +1090,7 @@ class Integration(pulumi.CustomResource):
1152
1090
  @pulumi.getter(name="externalId")
1153
1091
  def external_id(self) -> pulumi.Output[Optional[str]]:
1154
1092
  """
1155
- Used with `signalfx_aws_external_integration`. Use this property to specify the external id.
1093
+ The `external_id` property from one of a `aws.ExternalIntegration` or `aws.TokenIntegration`
1156
1094
  """
1157
1095
  return pulumi.get(self, "external_id")
1158
1096
 
@@ -1160,8 +1098,7 @@ class Integration(pulumi.CustomResource):
1160
1098
  @pulumi.getter(name="importCloudWatch")
1161
1099
  def import_cloud_watch(self) -> pulumi.Output[Optional[bool]]:
1162
1100
  """
1163
- Flag that controls how Splunk Observability imports Cloud Watch metrics. If true, Splunk Observability imports Cloud
1164
- Watch metrics from AWS.
1101
+ Flag that controls how Splunk Observability Cloud imports Cloud Watch metrics. If true, Splunk Observability Cloud imports Cloud Watch metrics from AWS.
1165
1102
  """
1166
1103
  return pulumi.get(self, "import_cloud_watch")
1167
1104
 
@@ -1169,7 +1106,7 @@ class Integration(pulumi.CustomResource):
1169
1106
  @pulumi.getter(name="integrationId")
1170
1107
  def integration_id(self) -> pulumi.Output[str]:
1171
1108
  """
1172
- The ID of this integration
1109
+ The id of one of a `aws.ExternalIntegration` or `aws.TokenIntegration`.
1173
1110
  """
1174
1111
  return pulumi.get(self, "integration_id")
1175
1112
 
@@ -1177,7 +1114,7 @@ class Integration(pulumi.CustomResource):
1177
1114
  @pulumi.getter
1178
1115
  def key(self) -> pulumi.Output[Optional[str]]:
1179
1116
  """
1180
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
1117
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the key (this is typically equivalent to the `AWS_SECRET_ACCESS_KEY` environment variable).
1181
1118
  """
1182
1119
  return pulumi.get(self, "key")
1183
1120
 
@@ -1185,10 +1122,7 @@ class Integration(pulumi.CustomResource):
1185
1122
  @pulumi.getter(name="metricStatsToSyncs")
1186
1123
  def metric_stats_to_syncs(self) -> pulumi.Output[Optional[Sequence['outputs.IntegrationMetricStatsToSync']]]:
1187
1124
  """
1188
- Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics
1189
- that Splunk Observability collects for this metric. If you specify this property, Splunk Observability retrieves only
1190
- specified AWS statistics. If you don't specify this property, Splunk Observability retrieves the AWS standard set of
1191
- statistics.
1125
+ Each element in the array is an object that contains an AWS namespace name, AWS metric name and a list of statistics that Splunk Observability Cloud collects for this metric. If you specify this property, Splunk Observability Cloud retrieves only specified AWS statistics when AWS metric streams are not used. When AWS metric streams are used this property specifies additional extended statistics to collect (please note that AWS metric streams API supports percentile stats only; other stats are ignored). If you don't specify this property, Splunk Observability Cloud retrieves the AWS standard set of statistics.
1192
1126
  """
1193
1127
  return pulumi.get(self, "metric_stats_to_syncs")
1194
1128
 
@@ -1196,8 +1130,7 @@ class Integration(pulumi.CustomResource):
1196
1130
  @pulumi.getter
1197
1131
  def name(self) -> pulumi.Output[str]:
1198
1132
  """
1199
- Name of the integration. Please specify the name in `signalfx_aws_external_integration` or
1200
- `signalfx_aws_integration_token`
1133
+ Name of the integration.
1201
1134
  """
1202
1135
  return pulumi.get(self, "name")
1203
1136
 
@@ -1205,7 +1138,7 @@ class Integration(pulumi.CustomResource):
1205
1138
  @pulumi.getter(name="namedToken")
1206
1139
  def named_token(self) -> pulumi.Output[Optional[str]]:
1207
1140
  """
1208
- A named token to use for ingest
1141
+ Name of the org token to be used for data ingestion. If not specified then default access token is used.
1209
1142
  """
1210
1143
  return pulumi.get(self, "named_token")
1211
1144
 
@@ -1213,10 +1146,7 @@ class Integration(pulumi.CustomResource):
1213
1146
  @pulumi.getter(name="namespaceSyncRules")
1214
1147
  def namespace_sync_rules(self) -> pulumi.Output[Optional[Sequence['outputs.IntegrationNamespaceSyncRule']]]:
1215
1148
  """
1216
- Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that
1217
- Splunk Observability collects for the namespace. If you specify this property, Splunk Observability ignores the values
1218
- in the AWS CloudWatch Integration Model "services" property. If you don't specify either property, Splunk Observability
1219
- syncs all data in all AWS namespaces.
1149
+ Each element in the array is an object that contains an AWS namespace name and a filter that controls the data that Splunk Observability Cloud collects for the namespace. Conflicts with the `services` property. If you don't specify either property, Splunk Observability Cloud syncs all data in all AWS namespaces.
1220
1150
  """
1221
1151
  return pulumi.get(self, "namespace_sync_rules")
1222
1152
 
@@ -1224,7 +1154,7 @@ class Integration(pulumi.CustomResource):
1224
1154
  @pulumi.getter(name="pollRate")
1225
1155
  def poll_rate(self) -> pulumi.Output[Optional[int]]:
1226
1156
  """
1227
- AWS poll rate (in seconds). Between `60` and `600`.
1157
+ AWS poll rate (in seconds). Value between `60` and `600`. Default: `300`.
1228
1158
  """
1229
1159
  return pulumi.get(self, "poll_rate")
1230
1160
 
@@ -1232,7 +1162,7 @@ class Integration(pulumi.CustomResource):
1232
1162
  @pulumi.getter
1233
1163
  def regions(self) -> pulumi.Output[Sequence[str]]:
1234
1164
  """
1235
- List of AWS regions that Splunk Observability should monitor.
1165
+ List of AWS regions that Splunk Observability Cloud should monitor. It cannot be empty.
1236
1166
  """
1237
1167
  return pulumi.get(self, "regions")
1238
1168
 
@@ -1240,7 +1170,7 @@ class Integration(pulumi.CustomResource):
1240
1170
  @pulumi.getter(name="roleArn")
1241
1171
  def role_arn(self) -> pulumi.Output[Optional[str]]:
1242
1172
  """
1243
- Used with `signalfx_aws_external_integration`. Use this property to specify the AIM role ARN.
1173
+ Role ARN that you add to an existing AWS integration object. **Note**: Ensure you use the `arn` property of your role, not the id!
1244
1174
  """
1245
1175
  return pulumi.get(self, "role_arn")
1246
1176
 
@@ -1248,7 +1178,7 @@ class Integration(pulumi.CustomResource):
1248
1178
  @pulumi.getter
1249
1179
  def services(self) -> pulumi.Output[Optional[Sequence[str]]]:
1250
1180
  """
1251
- List of AWS services that you want Splunk Observability to monitor. Each element is a string designating an AWS service.
1181
+ List of AWS services that you want Splunk Observability Cloud to monitor. Each element is a string designating an AWS service. Can be an empty list to import data for all supported services. Conflicts with `namespace_sync_rule`. See [Amazon Web Services](https://docs.splunk.com/Observability/gdi/get-data-in/integrations.html#amazon-web-services) for a list of valid values.
1252
1182
  """
1253
1183
  return pulumi.get(self, "services")
1254
1184
 
@@ -1256,8 +1186,7 @@ class Integration(pulumi.CustomResource):
1256
1186
  @pulumi.getter(name="syncCustomNamespacesOnly")
1257
1187
  def sync_custom_namespaces_only(self) -> pulumi.Output[Optional[bool]]:
1258
1188
  """
1259
- Indicates that Splunk Observability should sync metrics and metadata from custom AWS namespaces only (see the
1260
- `custom_namespace_sync_rule` field for details). Defaults to `false`.
1189
+ Indicates that Splunk Observability Cloud should sync metrics and metadata from custom AWS namespaces only (see the `custom_namespace_sync_rule` above). Defaults to `false`.
1261
1190
  """
1262
1191
  return pulumi.get(self, "sync_custom_namespaces_only")
1263
1192
 
@@ -1265,7 +1194,7 @@ class Integration(pulumi.CustomResource):
1265
1194
  @pulumi.getter
1266
1195
  def token(self) -> pulumi.Output[Optional[str]]:
1267
1196
  """
1268
- Used with `signalfx_aws_token_integration`. Use this property to specify the token.
1197
+ If you specify `auth_method = \\"SecurityToken\\"` in your request to create an AWS integration object, use this property to specify the token (this is typically equivalent to the `AWS_ACCESS_KEY_ID` environment variable).
1269
1198
  """
1270
1199
  return pulumi.get(self, "token")
1271
1200
 
@@ -1273,7 +1202,9 @@ class Integration(pulumi.CustomResource):
1273
1202
  @pulumi.getter(name="useMetricStreamsSync")
1274
1203
  def use_metric_streams_sync(self) -> pulumi.Output[bool]:
1275
1204
  """
1276
- Enables the use of Cloudwatch Metric Streams for metrics synchronization.
1205
+ Enable the use of Amazon Cloudwatch Metric Streams for ingesting metrics.<br>
1206
+ Note that this requires the inclusion of `"cloudwatch:ListMetricStreams"`,`"cloudwatch:GetMetricStream"`, `"cloudwatch:PutMetricStream"`, `"cloudwatch:DeleteMetricStream"`, `"cloudwatch:StartMetricStreams"`, `"cloudwatch:StopMetricStreams"` and `"iam:PassRole"` permissions.<br>
1207
+ Note you need to deploy additional resources on your AWS account to enable CloudWatch metrics streaming. Select one of the [CloudFormation templates](https://docs.splunk.com/Observability/gdi/get-data-in/connect/aws/aws-cloudformation.html) to deploy all the required resources.
1277
1208
  """
1278
1209
  return pulumi.get(self, "use_metric_streams_sync")
1279
1210