MetricTransformation

import type { MetricTransformation } from "https://aws-api.deno.dev/v0.3/services/cloudwatchlogs.ts?docs=full";

Indicates how to transform ingested log events to metric data in a CloudWatch metric.

interface MetricTransformation {

defaultValue?: number | null;

dimensions?: {

[key: string]: string | null | undefined;

} | null;

metricName: string;

metricNamespace: string;

metricValue: string;

unit?: StandardUnit | null;

}

§Properties

defaultValue?: number | null

[src]

(Optional) The value to emit when a filter pattern does not match a log event. This value can be null.

dimensions?: {

[key: string]: string | null | undefined;

} | null

[src]

The fields to use as dimensions for the metric. One metric filter can include as many as three dimensions.

! IMPORTANT: ! Metrics extracted from log events are charged as custom metrics. ! To prevent unexpected high charges, do not specify high-cardinality fields such as IPAddress or requestID as dimensions. ! Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric. ! To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time. ! You can also set up a billing alarm to alert you if your charges are higher than expected. ! For more information, see Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges.

metricName: string

[src]

The name of the CloudWatch metric.

metricNamespace: string

[src]

A custom namespace to contain your metric in CloudWatch. Use namespaces to group together metrics that are similar. For more information, see Namespaces.

metricValue: string

[src]

The value to publish to the CloudWatch metric when a filter pattern matches a log event.

unit?: StandardUnit | null

[src]

The unit to assign to the metric. If you omit this, the unit is set as None.