Interface CfnMetricStreamProps
- All Superinterfaces:
software.amazon.jsii.JsiiSerializable
- All Known Implementing Classes:
CfnMetricStreamProps.Jsii$Proxy
CfnMetricStream
.
Example:
// The code below shows an example of how to instantiate this type. // The values are placeholders you should change. import software.amazon.awscdk.services.cloudwatch.*; CfnMetricStreamProps cfnMetricStreamProps = CfnMetricStreamProps.builder() .firehoseArn("firehoseArn") .outputFormat("outputFormat") .roleArn("roleArn") // the properties below are optional .excludeFilters(List.of(MetricStreamFilterProperty.builder() .namespace("namespace") // the properties below are optional .metricNames(List.of("metricNames")) .build())) .includeFilters(List.of(MetricStreamFilterProperty.builder() .namespace("namespace") // the properties below are optional .metricNames(List.of("metricNames")) .build())) .includeLinkedAccountsMetrics(false) .name("name") .statisticsConfigurations(List.of(MetricStreamStatisticsConfigurationProperty.builder() .additionalStatistics(List.of("additionalStatistics")) .includeMetrics(List.of(MetricStreamStatisticsMetricProperty.builder() .metricName("metricName") .namespace("namespace") .build())) .build())) .tags(List.of(CfnTag.builder() .key("key") .value("value") .build())) .build();
- See Also:
-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic final class
A builder forCfnMetricStreamProps
static final class
An implementation forCfnMetricStreamProps
-
Method Summary
Modifier and TypeMethodDescriptionstatic CfnMetricStreamProps.Builder
builder()
default Object
If you specify this parameter, the stream sends metrics from all metric namespaces except for the namespaces that you specify here.The ARN of the Amazon Kinesis Firehose delivery stream to use for this metric stream.default Object
If you specify this parameter, the stream sends only the metrics from the metric namespaces that you specify here.default Object
If you are creating a metric stream in a monitoring account, specifytrue
to include metrics from source accounts that are linked to this monitoring account, in the metric stream.default String
getName()
If you are creating a new metric stream, this is the name for the new stream.The output format for the stream.The ARN of an IAM role that this metric stream will use to access Amazon Kinesis Firehose resources.default Object
By default, a metric stream always sends the MAX, MIN, SUM, and SAMPLECOUNT statistics for each metric that is streamed.getTags()
An array of key-value pairs to apply to the metric stream.Methods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Method Details
-
getFirehoseArn
The ARN of the Amazon Kinesis Firehose delivery stream to use for this metric stream.This Amazon Kinesis Firehose delivery stream must already exist and must be in the same account as the metric stream.
- See Also:
-
getOutputFormat
The output format for the stream.Valid values are
json
,opentelemetry1.0
andopentelemetry0.7
For more information about metric stream output formats, see Metric streams output formats .This parameter is required.
- See Also:
-
getRoleArn
The ARN of an IAM role that this metric stream will use to access Amazon Kinesis Firehose resources.This IAM role must already exist and must be in the same account as the metric stream. This IAM role must include the
firehose:PutRecord
andfirehose:PutRecordBatch
permissions.- See Also:
-
getExcludeFilters
If you specify this parameter, the stream sends metrics from all metric namespaces except for the namespaces that you specify here.You cannot specify both
IncludeFilters
andExcludeFilters
in the same metric stream.When you modify the
IncludeFilters
orExcludeFilters
of an existing metric stream in any way, the metric stream is effectively restarted, so after such a change you will get only the datapoints that have a timestamp after the time of the update.- See Also:
-
getIncludeFilters
If you specify this parameter, the stream sends only the metrics from the metric namespaces that you specify here.You cannot specify both
IncludeFilters
andExcludeFilters
in the same metric stream.When you modify the
IncludeFilters
orExcludeFilters
of an existing metric stream in any way, the metric stream is effectively restarted, so after such a change you will get only the datapoints that have a timestamp after the time of the update.- See Also:
-
getIncludeLinkedAccountsMetrics
If you are creating a metric stream in a monitoring account, specifytrue
to include metrics from source accounts that are linked to this monitoring account, in the metric stream.The default is
false
.For more information about linking accounts, see CloudWatch cross-account observability
- See Also:
-
getName
If you are creating a new metric stream, this is the name for the new stream.The name must be different than the names of other metric streams in this account and Region.
If you are updating a metric stream, specify the name of that stream here.
- See Also:
-
getStatisticsConfigurations
By default, a metric stream always sends the MAX, MIN, SUM, and SAMPLECOUNT statistics for each metric that is streamed.You can use this parameter to have the metric stream also send additional statistics in the stream. This array can have up to 100 members.
For each entry in this array, you specify one or more metrics and the list of additional statistics to stream for those metrics. The additional statistics that you can stream depend on the stream's
OutputFormat
. If theOutputFormat
isjson
, you can stream any additional statistic that is supported by CloudWatch , listed in CloudWatch statistics definitions . If theOutputFormat
is OpenTelemetry, you can stream percentile statistics.- See Also:
-
getTags
An array of key-value pairs to apply to the metric stream.For more information, see Tag .
- See Also:
-
builder
- Returns:
- a
CfnMetricStreamProps.Builder
ofCfnMetricStreamProps
-