diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index 9256bb8adb1..3a216080b51 100644 --- a/config/_default/menus/api.en.yaml +++ b/config/_default/menus/api.en.yaml @@ -83,32 +83,6 @@ menu: - ListAWSNamespaces unstable: [] order: 1 - - name: Preview AWS metric name filter - url: /api/latest/aws-integration/preview-aws-metric-name-filter/ - identifier: aws-integration-preview-aws-metric-name-filter - parent: aws-integration - generated: true - params: - versions: - - v2 - operationids: - - PreviewAWSMetricNameFilter - unstable: - - v2 - order: 20 - - name: Get AWS metric name filter preview - url: /api/latest/aws-integration/get-aws-metric-name-filter-preview/ - identifier: aws-integration-get-aws-metric-name-filter-preview - parent: aws-integration - generated: true - params: - versions: - - v2 - operationids: - - GetAWSMetricNameFilterPreview - unstable: - - v2 - order: 19 - name: Create AWS CCM config url: /api/latest/aws-integration/create-aws-ccm-config/ identifier: aws-integration-create-aws-ccm-config @@ -10528,6 +10502,19 @@ menu: - ListBudgets unstable: [] order: 33 + - name: Get a budget's custom forecast + url: /api/latest/cloud-cost-management/get-a-budgets-custom-forecast/ + identifier: cloud-cost-management-get-a-budgets-custom-forecast + parent: cloud-cost-management + generated: true + params: + versions: + - v2 + operationids: + - GetCustomForecast + unstable: + - v2 + order: 69 - name: Delete a budget's custom forecast url: /api/latest/cloud-cost-management/delete-a-budgets-custom-forecast/ identifier: cloud-cost-management-delete-a-budgets-custom-forecast diff --git a/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md b/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md new file mode 100644 index 00000000000..9e7e1715535 --- /dev/null +++ b/content/en/api/latest/cloud-cost-management/get-a-budgets-custom-forecast/index.md @@ -0,0 +1,3 @@ +--- +title: Get a budget's custom forecast +--- diff --git a/content/en/api/v2/aws-integration/examples.json b/content/en/api/v2/aws-integration/examples.json index a99b3a59f41..20a83bab20c 100644 --- a/content/en/api/v2/aws-integration/examples.json +++ b/content/en/api/v2/aws-integration/examples.json @@ -44,14 +44,6 @@ "collect_cloudwatch_alarms": false, "collect_custom_metrics": false, "enabled": true, - "metric_name_filters": [ - { - "include_only": [ - "aws.ec2.network_in" - ], - "namespace": "AWS/EC2" - } - ], "namespace_filters": { "exclude_only": [ "AWS/SQS", @@ -84,7 +76,7 @@ } ] }, - "html": "
data [required]
\n[object]
List of AWS Account Integration Configs.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\n[object]
List of AWS Account Integration Configs.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account Create Request data.
attributes [required]
\nobject
The AWS Account Integration Config to be created.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config [required]
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition [required]
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account Create Request data.
attributes [required]
\nobject
The AWS Account Integration Config to be created.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config [required]
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition [required]
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account response data.
attributes
\nobject
AWS Account response attributes.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
created_at
\ndate-time
Timestamp of when the account integration was created.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
modified_at
\ndate-time
Timestamp of when the account integration was updated.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account Update Request data.
attributes [required]
\nobject
The AWS Account Integration Config to be updated.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
metric_name_filters
\n[ <oneOf>]
AWS CloudWatch metric name filters. Each filter applies to a single namespace.\nExactly one of include_only or exclude_only must be set on each filter.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS Account Update Request data.
attributes [required]
\nobject
The AWS Account Integration Config to be updated.
account_tags
\n[string]
Tags to apply to all hosts and metrics reporting for this account. Defaults to [].
auth_config
\n<oneOf>
AWS Authentication config.
Option 1
\nobject
AWS Authentication config to integrate your account using an access key pair.
access_key_id [required]
\nstring
AWS Access Key ID.
secret_access_key
\nstring
AWS Secret Access Key.
Option 2
\nobject
AWS Authentication config to integrate your account using an IAM role.
external_id
\nstring
AWS IAM External ID for associated role.
role_name [required]
\nstring
AWS IAM Role name.
aws_account_id [required]
\nstring
AWS Account ID.
aws_partition
\nenum
AWS partition your AWS account is scoped to. Defaults to aws.\nSee Partitions\nin the AWS documentation for more information. \nAllowed enum values: aws,aws-cn,aws-us-gov
aws_regions
\n<oneOf>
AWS Regions to collect data from. Defaults to include_all.
Option 1
\nobject
Include all regions. Defaults to true.
include_all [required]
\nboolean
Include all regions.
Option 2
\nobject
Include only these regions.
include_only [required]
\n[string]
Include only these regions.
logs_config
\nobject
AWS Logs Collection config.
lambda_forwarder
\nobject
Log Autosubscription configuration for Datadog Forwarder Lambda functions.\nAutomatically set up triggers for existing and new logs for some services,\nensuring no logs from new resources are missed and saving time spent on manual configuration.
lambdas
\n[string]
List of Datadog Lambda Log Forwarder ARNs in your AWS account. Defaults to [].
log_source_config
\nobject
Log source configuration.
tag_filters
\n[object]
List of AWS log source tag filters. Defaults to [].
source
\nstring
The AWS log source to which the tag filters defined in tags are applied.
tags
\n[string]
The AWS resource tags to filter on for the log source specified by source.
sources
\n[string]
List of service IDs set to enable automatic log collection.\nDiscover the list of available services with the\nGet list of AWS log ready\nservices\nendpoint.
metrics_config
\nobject
AWS Metrics Collection config.
automute_enabled
\nboolean
Enable EC2 automute for AWS metrics. Defaults to true.
collect_cloudwatch_alarms
\nboolean
Enable CloudWatch alarms collection. Defaults to false.
collect_custom_metrics
\nboolean
Enable custom metrics collection. Defaults to false.
enabled
\nboolean
Enable AWS metrics collection. Defaults to true.
namespace_filters
\n<oneOf>
AWS Metrics namespace filters. Defaults to exclude_only.
Option 1
\nobject
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
exclude_only [required]
\n[string]
Exclude only these namespaces from metrics collection.\nDefaults to ["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"].\nAWS/SQS, AWS/ElasticMapReduce, and AWS/Usage are excluded by default\nto reduce your AWS CloudWatch costs from GetMetricData API calls.
Option 2
\nobject
Include only these namespaces.
include_only [required]
\n[string]
Include only these namespaces.
tag_filters
\n[object]
AWS Metrics collection tag filters list. Defaults to [].
namespace
\nstring
The AWS service for which the tag filters defined in tags will be applied.
tags
\n[string]
The AWS resource tags to filter on for the service specified by namespace.
resources_config
\nobject
AWS Resources Collection config.
cloud_security_posture_management_collection
\nboolean
Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations,\nidentity risks, and compliance violations. Defaults to false.\nRequires extended_collection to be set to true.
extended_collection
\nboolean
Whether Datadog collects additional attributes and configuration information about the resources\nin your AWS account. Defaults to true. Required for cloud_security_posture_management_collection.
traces_config
\nobject
AWS Traces Collection config.
xray_services
\n<oneOf>
AWS X-Ray services to collect traces from. Defaults to include_only.
Option 1
\nobject
Include all services.
include_all [required]
\nboolean
Include all services.
Option 2
\nobject
Include only these services. Defaults to [].
include_only [required]
\n[string]
Include only these services.
id
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
AWS Account resource type. \nAllowed enum values: account
default: account
data [required]
\nobject
AWS CCM Config Create/Update Request data.
attributes [required]
\nobject
AWS CCM Config attributes for Create/Update requests.
ccm_config [required]
\nobject
AWS Cloud Cost Management config.
data_export_configs [required]
\n[object]
List of data export configurations for Cost and Usage Reports.
bucket_name [required]
\nstring
Name of the S3 bucket where the Cost and Usage Report is stored.
bucket_region [required]
\nstring
AWS region of the S3 bucket.
report_name [required]
\nstring
Name of the Cost and Usage Report.
report_prefix [required]
\nstring
S3 prefix where the Cost and Usage Report is stored.
report_type [required]
\nstring
Type of the Cost and Usage Report. Currently only CUR2.0 is supported.
type [required]
\nenum
AWS CCM Config resource type. \nAllowed enum values: ccm_config
default: ccm_config
data [required]
\nobject
AWS metric name filter preview response data.
attributes [required]
\nobject
AWS metric name filter preview response attributes.
namespaces [required]
\n[object]
The list of namespaces affected by the previewed metric name filters.
filters [required]
\n[object]
The metric name filter patterns evaluated for this namespace and how many metrics they matched.
match_count [required]
\nint64
The number of Datadog metric names matched by this pattern.
pattern [required]
\nstring
The metric name filter pattern.
metrics [required]
\n[object]
The CloudWatch metrics collected for this namespace and whether each resulting\nDatadog metric is filtered.
cw_name [required]
\nstring
The CloudWatch metric name.
dd_names [required]
\n[object]
The Datadog metric names produced from this CloudWatch metric.
filtered [required]
\nboolean
Whether this Datadog metric name is filtered out.
name [required]
\nstring
The Datadog metric name.
namespace [required]
\nstring
The AWS CloudWatch namespace.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview
default: metric_name_filter_preview
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.
data [required]
\nobject
AWS metric name filter preview response data.
attributes [required]
\nobject
AWS metric name filter preview response attributes.
namespaces [required]
\n[object]
The list of namespaces affected by the previewed metric name filters.
filters [required]
\n[object]
The metric name filter patterns evaluated for this namespace and how many metrics they matched.
match_count [required]
\nint64
The number of Datadog metric names matched by this pattern.
pattern [required]
\nstring
The metric name filter pattern.
metrics [required]
\n[object]
The CloudWatch metrics collected for this namespace and whether each resulting\nDatadog metric is filtered.
cw_name [required]
\nstring
The CloudWatch metric name.
dd_names [required]
\n[object]
The Datadog metric names produced from this CloudWatch metric.
filtered [required]
\nboolean
Whether this Datadog metric name is filtered out.
name [required]
\nstring
The Datadog metric name.
namespace [required]
\nstring
The AWS CloudWatch namespace.
id [required]
\nstring
Unique Datadog ID of the AWS Account Integration Config.\nTo get the config ID for an account, use the\nList all AWS integrations\nendpoint and query by AWS Account ID.
type [required]
\nenum
The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview
default: metric_name_filter_preview
errors [required]
\n[object]
A list of errors.
detail
\nstring
A human-readable explanation specific to this occurrence of the error.
meta
\nobject
Non-standard meta-information about the error
source
\nobject
References to the source of the error.
header
\nstring
A string indicating the name of a single request header which caused the error.
parameter
\nstring
A string indicating which URI query parameter caused the error.
pointer
\nstring
A JSON pointer to the value in the request document that caused the error.
status
\nstring
Status code of the response.
title
\nstring
Short human-readable summary of the error.
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.
data [required]
\nobject
AWS metric name filter preview request data.
attributes [required]
\nobject
AWS metric name filter preview request attributes.
metric_name_filters [required]
\n[ <oneOf>]
The metric name filters to preview.
Option 1
\nobject
Include only metric names matching one of these patterns for a single namespace.
include_only [required]
\n[string]
Include only metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
Option 2
\nobject
Exclude metric names matching one of these patterns for a single namespace.
exclude_only [required]
\n[string]
Exclude metric names matching one of these patterns.
namespace [required]
\nstring
The AWS CloudWatch namespace to which this metric name filter applies.
type [required]
\nenum
The AWSMetricNameFilterPreviewResponseData type. \nAllowed enum values: metric_name_filter_preview
default: metric_name_filter_preview
data [required]
\nobject
Custom forecast resource wrapper in a response.
attributes [required]
\nobject
Attributes of a custom forecast.
budget_uid [required]
\nstring
The UUID of the budget that this custom forecast belongs to.
created_at [required]
\nint64
Timestamp the custom forecast was created, in Unix milliseconds.
created_by [required]
\nstring
The id of the user that created the custom forecast.
entries [required]
\n[object]
Monthly custom forecast entries.
amount [required]
\ndouble
Forecast amount for the month.
month [required]
\nint64
Month the custom forecast entry applies to, in YYYYMM format.
tag_filters [required]
\n[object]
Tag filters that scope this custom forecast entry to specific resources.
tag_key [required]
\nstring
The tag key to filter on.
tag_value [required]
\nstring
The tag value to filter on.
updated_at [required]
\nint64
Timestamp the custom forecast was last updated, in Unix milliseconds.
updated_by [required]
\nstring
The id of the user that last updated the custom forecast.
id [required]
\nstring
The unique identifier of the custom forecast.
type [required]
\nenum
The type of the custom forecast resource. Must be custom_forecast. \nAllowed enum values: custom_forecast
default: custom_forecast
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.
errors [required]
\n[string]
A list of errors.