terraconstructs 0.0.8

package/lib/aws/cloudwatch/log-stream.d.ts

@@ -0,0 +1,57 @@
+import { cloudwatchLogStream } from "@cdktf/provider-aws";
+import { Construct } from "constructs";
+import { IAwsConstruct, AwsConstructBase, AwsConstructProps } from "../aws-construct";
+import { ILogGroup } from "./log-group";
+/**
+ * Outputs which may be registered for output via the Grid.
+ */
+export interface LogStreamOutputs {
+    /**
+     * The name of this log stream
+     * @attribute
+     */
+    readonly logStreamName: string;
+}
+export interface ILogStream extends IAwsConstruct {
+    /** Strongly typed outputs */
+    readonly logStreamOutputs: LogStreamOutputs;
+    /**
+     * The name of this log stream
+     * @attribute
+     */
+    readonly logStreamName: string;
+}
+/**
+ * Properties for a LogStream
+ */
+export interface LogStreamProps extends AwsConstructProps {
+    /**
+     * The log group to create a log stream for.
+     */
+    readonly logGroup: ILogGroup;
+    /**
+     * The name of the log stream to create.
+     *
+     * The name must be unique within the log group.
+     *
+     * @default Automatically generated
+     */
+    readonly logStreamName?: string;
+}
+/**
+ * Define a Log Stream in a Log Group
+ */
+export declare class LogStream extends AwsConstructBase implements ILogStream {
+    /**
+     * Import an existing LogGroup
+     */
+    static fromLogStreamName(scope: Construct, id: string, logStreamName: string): ILogStream;
+    readonly resource: cloudwatchLogStream.CloudwatchLogStream;
+    /**
+     * The name of this log stream
+     */
+    readonly logStreamName: string;
+    get logStreamOutputs(): LogStreamOutputs;
+    get outputs(): Record<string, any>;
+    constructor(scope: Construct, id: string, props: LogStreamProps);
+}

package/lib/aws/cloudwatch/log-stream.js

@@ -0,0 +1,57 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStream = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+// https://github.com/aws/aws-cdk/blob/v2.170.0/packages/aws-cdk-lib/aws-logs/lib/log-stream.ts
+const provider_aws_1 = require("@cdktf/provider-aws");
+const aws_construct_1 = require("../aws-construct");
+/**
+ * Define a Log Stream in a Log Group
+ */
+class LogStream extends aws_construct_1.AwsConstructBase {
+    /**
+     * Import an existing LogGroup
+     */
+    static fromLogStreamName(scope, id, logStreamName) {
+        class Import extends aws_construct_1.AwsConstructBase {
+            constructor() {
+                super(...arguments);
+                this.logStreamName = logStreamName;
+            }
+            get logStreamOutputs() {
+                return {
+                    logStreamName: this.logStreamName,
+                };
+            }
+            get outputs() {
+                return this.logStreamOutputs;
+            }
+        }
+        return new Import(scope, id);
+    }
+    get logStreamOutputs() {
+        return {
+            logStreamName: this.logStreamName,
+        };
+    }
+    get outputs() {
+        return this.logStreamOutputs;
+    }
+    constructor(scope, id, props) {
+        super(scope, id, props);
+        const name = props.logStreamName ||
+            this.stack.uniqueResourceName(this, {
+                prefix: this.gridUUID,
+            });
+        this.resource = new provider_aws_1.cloudwatchLogStream.CloudwatchLogStream(this, "Resource", {
+            logGroupName: props.logGroup.logGroupName,
+            name,
+        });
+        this.logStreamName = this.resource.name;
+    }
+}
+exports.LogStream = LogStream;
+_a = JSII_RTTI_SYMBOL_1;
+LogStream[_a] = { fqn: "terraconstructs.aws.cloudwatch.LogStream", version: "0.0.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nLXN0cmVhbS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hd3MvY2xvdWR3YXRjaC9sb2ctc3RyZWFtLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsK0ZBQStGO0FBRS9GLHNEQUEwRDtBQUUxRCxvREFJMEI7QUE0QzFCOztHQUVHO0FBQ0gsTUFBYSxTQUFVLFNBQVEsZ0NBQWdCO0lBQzdDOztPQUVHO0lBQ0ksTUFBTSxDQUFDLGlCQUFpQixDQUM3QixLQUFnQixFQUNoQixFQUFVLEVBQ1YsYUFBcUI7UUFFckIsTUFBTSxNQUFPLFNBQVEsZ0NBQWdCO1lBQXJDOztnQkFTa0Isa0JBQWEsR0FBRyxhQUFhLENBQUM7WUFDaEQsQ0FBQztZQVRDLElBQVcsZ0JBQWdCO2dCQUN6QixPQUFPO29CQUNMLGFBQWEsRUFBRSxJQUFJLENBQUMsYUFBYTtpQkFDbEMsQ0FBQztZQUNKLENBQUM7WUFDRCxJQUFXLE9BQU87Z0JBQ2hCLE9BQU8sSUFBSSxDQUFDLGdCQUFnQixDQUFDO1lBQy9CLENBQUM7U0FFRjtRQUVELE9BQU8sSUFBSSxNQUFNLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQy9CLENBQUM7SUFPRCxJQUFXLGdCQUFnQjtRQUN6QixPQUFPO1lBQ0wsYUFBYSxFQUFFLElBQUksQ0FBQyxhQUFhO1NBQ2xDLENBQUM7SUFDSixDQUFDO0lBQ0QsSUFBVyxPQUFPO1FBQ2hCLE9BQU8sSUFBSSxDQUFDLGdCQUFnQixDQUFDO0lBQy9CLENBQUM7SUFFRCxZQUFZLEtBQWdCLEVBQUUsRUFBVSxFQUFFLEtBQXFCO1FBQzdELEtBQUssQ0FBQyxLQUFLLEVBQUUsRUFBRSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ3hCLE1BQU0sSUFBSSxHQUNSLEtBQUssQ0FBQyxhQUFhO1lBQ25CLElBQUksQ0FBQyxLQUFLLENBQUMsa0JBQWtCLENBQUMsSUFBSSxFQUFFO2dCQUNsQyxNQUFNLEVBQUUsSUFBSSxDQUFDLFFBQVE7YUFDdEIsQ0FBQyxDQUFDO1FBRUwsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLGtDQUFtQixDQUFDLG1CQUFtQixDQUN6RCxJQUFJLEVBQ0osVUFBVSxFQUNWO1lBQ0UsWUFBWSxFQUFFLEtBQUssQ0FBQyxRQUFRLENBQUMsWUFBWTtZQUN6QyxJQUFJO1NBQ0wsQ0FDRixDQUFDO1FBRUYsSUFBSSxDQUFDLGFBQWEsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQztJQUMxQyxDQUFDOztBQXhESCw4QkF5REMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi92Mi4xNzAuMC9wYWNrYWdlcy9hd3MtY2RrLWxpYi9hd3MtbG9ncy9saWIvbG9nLXN0cmVhbS50c1xuXG5pbXBvcnQgeyBjbG91ZHdhdGNoTG9nU3RyZWFtIH0gZnJvbSBcIkBjZGt0Zi9wcm92aWRlci1hd3NcIjtcbmltcG9ydCB7IENvbnN0cnVjdCB9IGZyb20gXCJjb25zdHJ1Y3RzXCI7XG5pbXBvcnQge1xuICBJQXdzQ29uc3RydWN0LFxuICBBd3NDb25zdHJ1Y3RCYXNlLFxuICBBd3NDb25zdHJ1Y3RQcm9wcyxcbn0gZnJvbSBcIi4uL2F3cy1jb25zdHJ1Y3RcIjtcbmltcG9ydCB7IElMb2dHcm91cCB9IGZyb20gXCIuL2xvZy1ncm91cFwiO1xuXG4vKipcbiAqIE91dHB1dHMgd2hpY2ggbWF5IGJlIHJlZ2lzdGVyZWQgZm9yIG91dHB1dCB2aWEgdGhlIEdyaWQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTG9nU3RyZWFtT3V0cHV0cyB7XG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGlzIGxvZyBzdHJlYW1cbiAgICogQGF0dHJpYnV0ZVxuICAgKi9cbiAgcmVhZG9ubHkgbG9nU3RyZWFtTmFtZTogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIElMb2dTdHJlYW0gZXh0ZW5kcyBJQXdzQ29uc3RydWN0IHtcbiAgLyoqIFN0cm9uZ2x5IHR5cGVkIG91dHB1dHMgKi9cbiAgcmVhZG9ubHkgbG9nU3RyZWFtT3V0cHV0czogTG9nU3RyZWFtT3V0cHV0cztcblxuICAvKipcbiAgICogVGhlIG5hbWUgb2YgdGhpcyBsb2cgc3RyZWFtXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHJlYWRvbmx5IGxvZ1N0cmVhbU5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBQcm9wZXJ0aWVzIGZvciBhIExvZ1N0cmVhbVxuICovXG5leHBvcnQgaW50ZXJmYWNlIExvZ1N0cmVhbVByb3BzIGV4dGVuZHMgQXdzQ29uc3RydWN0UHJvcHMge1xuICAvKipcbiAgICogVGhlIGxvZyBncm91cCB0byBjcmVhdGUgYSBsb2cgc3RyZWFtIGZvci5cbiAgICovXG4gIHJlYWRvbmx5IGxvZ0dyb3VwOiBJTG9nR3JvdXA7XG5cbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoZSBsb2cgc3RyZWFtIHRvIGNyZWF0ZS5cbiAgICpcbiAgICogVGhlIG5hbWUgbXVzdCBiZSB1bmlxdWUgd2l0aGluIHRoZSBsb2cgZ3JvdXAuXG4gICAqXG4gICAqIEBkZWZhdWx0IEF1dG9tYXRpY2FsbHkgZ2VuZXJhdGVkXG4gICAqL1xuICByZWFkb25seSBsb2dTdHJlYW1OYW1lPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIERlZmluZSBhIExvZyBTdHJlYW0gaW4gYSBMb2cgR3JvdXBcbiAqL1xuZXhwb3J0IGNsYXNzIExvZ1N0cmVhbSBleHRlbmRzIEF3c0NvbnN0cnVjdEJhc2UgaW1wbGVtZW50cyBJTG9nU3RyZWFtIHtcbiAgLyoqXG4gICAqIEltcG9ydCBhbiBleGlzdGluZyBMb2dHcm91cFxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBmcm9tTG9nU3RyZWFtTmFtZShcbiAgICBzY29wZTogQ29uc3RydWN0LFxuICAgIGlkOiBzdHJpbmcsXG4gICAgbG9nU3RyZWFtTmFtZTogc3RyaW5nLFxuICApOiBJTG9nU3RyZWFtIHtcbiAgICBjbGFzcyBJbXBvcnQgZXh0ZW5kcyBBd3NDb25zdHJ1Y3RCYXNlIGltcGxlbWVudHMgSUxvZ1N0cmVhbSB7XG4gICAgICBwdWJsaWMgZ2V0IGxvZ1N0cmVhbU91dHB1dHMoKTogTG9nU3RyZWFtT3V0cHV0cyB7XG4gICAgICAgIHJldHVybiB7XG4gICAgICAgICAgbG9nU3RyZWFtTmFtZTogdGhpcy5sb2dTdHJlYW1OYW1lLFxuICAgICAgICB9O1xuICAgICAgfVxuICAgICAgcHVibGljIGdldCBvdXRwdXRzKCk6IFJlY29yZDxzdHJpbmcsIGFueT4ge1xuICAgICAgICByZXR1cm4gdGhpcy5sb2dTdHJlYW1PdXRwdXRzO1xuICAgICAgfVxuICAgICAgcHVibGljIHJlYWRvbmx5IGxvZ1N0cmVhbU5hbWUgPSBsb2dTdHJlYW1OYW1lO1xuICAgIH1cblxuICAgIHJldHVybiBuZXcgSW1wb3J0KHNjb3BlLCBpZCk7XG4gIH1cblxuICBwdWJsaWMgcmVhZG9ubHkgcmVzb3VyY2U6IGNsb3Vkd2F0Y2hMb2dTdHJlYW0uQ2xvdWR3YXRjaExvZ1N0cmVhbTtcbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoaXMgbG9nIHN0cmVhbVxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGxvZ1N0cmVhbU5hbWU6IHN0cmluZztcbiAgcHVibGljIGdldCBsb2dTdHJlYW1PdXRwdXRzKCk6IExvZ1N0cmVhbU91dHB1dHMge1xuICAgIHJldHVybiB7XG4gICAgICBsb2dTdHJlYW1OYW1lOiB0aGlzLmxvZ1N0cmVhbU5hbWUsXG4gICAgfTtcbiAgfVxuICBwdWJsaWMgZ2V0IG91dHB1dHMoKTogUmVjb3JkPHN0cmluZywgYW55PiB7XG4gICAgcmV0dXJuIHRoaXMubG9nU3RyZWFtT3V0cHV0cztcbiAgfVxuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBMb2dTdHJlYW1Qcm9wcykge1xuICAgIHN1cGVyKHNjb3BlLCBpZCwgcHJvcHMpO1xuICAgIGNvbnN0IG5hbWUgPVxuICAgICAgcHJvcHMubG9nU3RyZWFtTmFtZSB8fFxuICAgICAgdGhpcy5zdGFjay51bmlxdWVSZXNvdXJjZU5hbWUodGhpcywge1xuICAgICAgICBwcmVmaXg6IHRoaXMuZ3JpZFVVSUQsXG4gICAgICB9KTtcblxuICAgIHRoaXMucmVzb3VyY2UgPSBuZXcgY2xvdWR3YXRjaExvZ1N0cmVhbS5DbG91ZHdhdGNoTG9nU3RyZWFtKFxuICAgICAgdGhpcyxcbiAgICAgIFwiUmVzb3VyY2VcIixcbiAgICAgIHtcbiAgICAgICAgbG9nR3JvdXBOYW1lOiBwcm9wcy5sb2dHcm91cC5sb2dHcm91cE5hbWUsXG4gICAgICAgIG5hbWUsXG4gICAgICB9LFxuICAgICk7XG5cbiAgICB0aGlzLmxvZ1N0cmVhbU5hbWUgPSB0aGlzLnJlc291cmNlLm5hbWU7XG4gIH1cbn1cbiJdfQ==

package/lib/aws/cloudwatch/metric-filter.d.ts

@@ -0,0 +1,30 @@
+import { cloudwatchLogMetricFilter } from "@cdktf/provider-aws";
+import { Construct } from "constructs";
+import { ILogGroup, MetricFilterOptions } from "./log-group";
+import { Metric, MetricOptions } from "./metric";
+import { AwsConstructBase, AwsConstructProps } from "../";
+/**
+ * Properties for a MetricFilter
+ */
+export interface MetricFilterProps extends MetricFilterOptions, AwsConstructProps {
+    /**
+     * The log group to create the filter on.
+     */
+    readonly logGroup: ILogGroup;
+}
+/**
+ * A filter that extracts information from CloudWatch Logs and emits to CloudWatch Metrics
+ */
+export declare class MetricFilter extends AwsConstructBase {
+    readonly resource: cloudwatchLogMetricFilter.CloudwatchLogMetricFilter;
+    get outputs(): Record<string, any>;
+    private readonly metricName;
+    private readonly metricNamespace;
+    constructor(scope: Construct, id: string, props: MetricFilterProps);
+    /**
+     * Return the given named metric for this Metric Filter
+     *
+     * @default avg over 5 minutes
+     */
+    metric(props?: MetricOptions): Metric;
+}

package/lib/aws/cloudwatch/metric-filter.js

@@ -0,0 +1,69 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricFilter = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+// https://github.com/aws/aws-cdk/blob/v2.170.0/packages/aws-cdk-lib/aws-logs/lib/metric-filter.ts
+const provider_aws_1 = require("@cdktf/provider-aws");
+const metric_1 = require("./metric");
+const __1 = require("../");
+/**
+ * A filter that extracts information from CloudWatch Logs and emits to CloudWatch Metrics
+ */
+class MetricFilter extends __1.AwsConstructBase {
+    get outputs() {
+        return {
+            id: this.resource.id,
+        };
+    }
+    constructor(scope, id, props) {
+        super(scope, id, props);
+        const name = props.filterName ||
+            this.stack.uniqueResourceName(this, {
+                prefix: this.gridUUID,
+            });
+        this.metricName = props.metricName;
+        this.metricNamespace = props.metricNamespace;
+        const numberOfDimensions = Object.keys(props.dimensions ?? {}).length;
+        if (numberOfDimensions > 3) {
+            throw new Error(`MetricFilter only supports a maximum of 3 dimensions but received ${numberOfDimensions}.`);
+        }
+        // > Currently, you can specify only one metric transformation for
+        // > each metric filter. If you want to specify multiple metric
+        // > transformations, you must specify multiple metric filters.
+        //
+        // https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-metricfilter.html
+        this.resource = new provider_aws_1.cloudwatchLogMetricFilter.CloudwatchLogMetricFilter(this, "Resource", {
+            name,
+            logGroupName: props.logGroup.logGroupName,
+            pattern: props.filterPattern.logPatternString,
+            metricTransformation: {
+                namespace: props.metricNamespace,
+                name: props.metricName,
+                value: props.metricValue ?? "1",
+                defaultValue: props.defaultValue
+                    ? String(props.defaultValue)
+                    : undefined,
+                dimensions: props.dimensions,
+                unit: props.unit,
+            },
+        });
+    }
+    /**
+     * Return the given named metric for this Metric Filter
+     *
+     * @default avg over 5 minutes
+     */
+    metric(props) {
+        return new metric_1.Metric({
+            metricName: this.metricName,
+            namespace: this.metricNamespace,
+            statistic: "avg",
+            ...props,
+        }).attachTo(this);
+    }
+}
+exports.MetricFilter = MetricFilter;
+_a = JSII_RTTI_SYMBOL_1;
+MetricFilter[_a] = { fqn: "terraconstructs.aws.cloudwatch.MetricFilter", version: "0.0.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0cmljLWZpbHRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hd3MvY2xvdWR3YXRjaC9tZXRyaWMtZmlsdGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsa0dBQWtHO0FBRWxHLHNEQUFnRTtBQUdoRSxxQ0FBaUQ7QUFDakQsMkJBQTBEO0FBYzFEOztHQUVHO0FBQ0gsTUFBYSxZQUFhLFNBQVEsb0JBQWdCO0lBR2hELElBQVcsT0FBTztRQUNoQixPQUFPO1lBQ0wsRUFBRSxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsRUFBRTtTQUNyQixDQUFDO0lBQ0osQ0FBQztJQUlELFlBQVksS0FBZ0IsRUFBRSxFQUFVLEVBQUUsS0FBd0I7UUFDaEUsS0FBSyxDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDeEIsTUFBTSxJQUFJLEdBQ1IsS0FBSyxDQUFDLFVBQVU7WUFDaEIsSUFBSSxDQUFDLEtBQUssQ0FBQyxrQkFBa0IsQ0FBQyxJQUFJLEVBQUU7Z0JBQ2xDLE1BQU0sRUFBRSxJQUFJLENBQUMsUUFBUTthQUN0QixDQUFDLENBQUM7UUFFTCxJQUFJLENBQUMsVUFBVSxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUM7UUFDbkMsSUFBSSxDQUFDLGVBQWUsR0FBRyxLQUFLLENBQUMsZUFBZSxDQUFDO1FBRTdDLE1BQU0sa0JBQWtCLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FBQztRQUN0RSxJQUFJLGtCQUFrQixHQUFHLENBQUMsRUFBRSxDQUFDO1lBQzNCLE1BQU0sSUFBSSxLQUFLLENBQ2IscUVBQXFFLGtCQUFrQixHQUFHLENBQzNGLENBQUM7UUFDSixDQUFDO1FBRUQsa0VBQWtFO1FBQ2xFLCtEQUErRDtRQUMvRCwrREFBK0Q7UUFDL0QsRUFBRTtRQUNGLHFHQUFxRztRQUNyRyxJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksd0NBQXlCLENBQUMseUJBQXlCLENBQ3JFLElBQUksRUFDSixVQUFVLEVBQ1Y7WUFDRSxJQUFJO1lBQ0osWUFBWSxFQUFFLEtBQUssQ0FBQyxRQUFRLENBQUMsWUFBWTtZQUN6QyxPQUFPLEVBQUUsS0FBSyxDQUFDLGFBQWEsQ0FBQyxnQkFBZ0I7WUFDN0Msb0JBQW9CLEVBQUU7Z0JBQ3BCLFNBQVMsRUFBRSxLQUFLLENBQUMsZUFBZTtnQkFDaEMsSUFBSSxFQUFFLEtBQUssQ0FBQyxVQUFVO2dCQUN0QixLQUFLLEVBQUUsS0FBSyxDQUFDLFdBQVcsSUFBSSxHQUFHO2dCQUMvQixZQUFZLEVBQUUsS0FBSyxDQUFDLFlBQVk7b0JBQzlCLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLFlBQVksQ0FBQztvQkFDNUIsQ0FBQyxDQUFDLFNBQVM7Z0JBQ2IsVUFBVSxFQUFFLEtBQUssQ0FBQyxVQUFVO2dCQUM1QixJQUFJLEVBQUUsS0FBSyxDQUFDLElBQUk7YUFDakI7U0FDRixDQUNGLENBQUM7SUFDSixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxLQUFxQjtRQUNqQyxPQUFPLElBQUksZUFBTSxDQUFDO1lBQ2hCLFVBQVUsRUFBRSxJQUFJLENBQUMsVUFBVTtZQUMzQixTQUFTLEVBQUUsSUFBSSxDQUFDLGVBQWU7WUFDL0IsU0FBUyxFQUFFLEtBQUs7WUFDaEIsR0FBRyxLQUFLO1NBQ1QsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNwQixDQUFDOztBQW5FSCxvQ0FvRUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi92Mi4xNzAuMC9wYWNrYWdlcy9hd3MtY2RrLWxpYi9hd3MtbG9ncy9saWIvbWV0cmljLWZpbHRlci50c1xuXG5pbXBvcnQgeyBjbG91ZHdhdGNoTG9nTWV0cmljRmlsdGVyIH0gZnJvbSBcIkBjZGt0Zi9wcm92aWRlci1hd3NcIjtcbmltcG9ydCB7IENvbnN0cnVjdCB9IGZyb20gXCJjb25zdHJ1Y3RzXCI7XG5pbXBvcnQgeyBJTG9nR3JvdXAsIE1ldHJpY0ZpbHRlck9wdGlvbnMgfSBmcm9tIFwiLi9sb2ctZ3JvdXBcIjtcbmltcG9ydCB7IE1ldHJpYywgTWV0cmljT3B0aW9ucyB9IGZyb20gXCIuL21ldHJpY1wiO1xuaW1wb3J0IHsgQXdzQ29uc3RydWN0QmFzZSwgQXdzQ29uc3RydWN0UHJvcHMgfSBmcm9tIFwiLi4vXCI7XG5cbi8qKlxuICogUHJvcGVydGllcyBmb3IgYSBNZXRyaWNGaWx0ZXJcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNZXRyaWNGaWx0ZXJQcm9wc1xuICBleHRlbmRzIE1ldHJpY0ZpbHRlck9wdGlvbnMsXG4gICAgQXdzQ29uc3RydWN0UHJvcHMge1xuICAvKipcbiAgICogVGhlIGxvZyBncm91cCB0byBjcmVhdGUgdGhlIGZpbHRlciBvbi5cbiAgICovXG4gIHJlYWRvbmx5IGxvZ0dyb3VwOiBJTG9nR3JvdXA7XG59XG5cbi8qKlxuICogQSBmaWx0ZXIgdGhhdCBleHRyYWN0cyBpbmZvcm1hdGlvbiBmcm9tIENsb3VkV2F0Y2ggTG9ncyBhbmQgZW1pdHMgdG8gQ2xvdWRXYXRjaCBNZXRyaWNzXG4gKi9cbmV4cG9ydCBjbGFzcyBNZXRyaWNGaWx0ZXIgZXh0ZW5kcyBBd3NDb25zdHJ1Y3RCYXNlIHtcbiAgcHVibGljIHJlYWRvbmx5IHJlc291cmNlOiBjbG91ZHdhdGNoTG9nTWV0cmljRmlsdGVyLkNsb3Vkd2F0Y2hMb2dNZXRyaWNGaWx0ZXI7XG5cbiAgcHVibGljIGdldCBvdXRwdXRzKCk6IFJlY29yZDxzdHJpbmcsIGFueT4ge1xuICAgIHJldHVybiB7XG4gICAgICBpZDogdGhpcy5yZXNvdXJjZS5pZCxcbiAgICB9O1xuICB9XG4gIHByaXZhdGUgcmVhZG9ubHkgbWV0cmljTmFtZTogc3RyaW5nO1xuICBwcml2YXRlIHJlYWRvbmx5IG1ldHJpY05hbWVzcGFjZTogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBNZXRyaWNGaWx0ZXJQcm9wcykge1xuICAgIHN1cGVyKHNjb3BlLCBpZCwgcHJvcHMpO1xuICAgIGNvbnN0IG5hbWUgPVxuICAgICAgcHJvcHMuZmlsdGVyTmFtZSB8fFxuICAgICAgdGhpcy5zdGFjay51bmlxdWVSZXNvdXJjZU5hbWUodGhpcywge1xuICAgICAgICBwcmVmaXg6IHRoaXMuZ3JpZFVVSUQsXG4gICAgICB9KTtcblxuICAgIHRoaXMubWV0cmljTmFtZSA9IHByb3BzLm1ldHJpY05hbWU7XG4gICAgdGhpcy5tZXRyaWNOYW1lc3BhY2UgPSBwcm9wcy5tZXRyaWNOYW1lc3BhY2U7XG5cbiAgICBjb25zdCBudW1iZXJPZkRpbWVuc2lvbnMgPSBPYmplY3Qua2V5cyhwcm9wcy5kaW1lbnNpb25zID8/IHt9KS5sZW5ndGg7XG4gICAgaWYgKG51bWJlck9mRGltZW5zaW9ucyA+IDMpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgYE1ldHJpY0ZpbHRlciBvbmx5IHN1cHBvcnRzIGEgbWF4aW11bSBvZiAzIGRpbWVuc2lvbnMgYnV0IHJlY2VpdmVkICR7bnVtYmVyT2ZEaW1lbnNpb25zfS5gLFxuICAgICAgKTtcbiAgICB9XG5cbiAgICAvLyA+IEN1cnJlbnRseSwgeW91IGNhbiBzcGVjaWZ5IG9ubHkgb25lIG1ldHJpYyB0cmFuc2Zvcm1hdGlvbiBmb3JcbiAgICAvLyA+IGVhY2ggbWV0cmljIGZpbHRlci4gSWYgeW91IHdhbnQgdG8gc3BlY2lmeSBtdWx0aXBsZSBtZXRyaWNcbiAgICAvLyA+IHRyYW5zZm9ybWF0aW9ucywgeW91IG11c3Qgc3BlY2lmeSBtdWx0aXBsZSBtZXRyaWMgZmlsdGVycy5cbiAgICAvL1xuICAgIC8vIGh0dHBzOi8vZG9jcy5hd3MuYW1hem9uLmNvbS9BV1NDbG91ZEZvcm1hdGlvbi9sYXRlc3QvVXNlckd1aWRlL2F3cy1yZXNvdXJjZS1sb2dzLW1ldHJpY2ZpbHRlci5odG1sXG4gICAgdGhpcy5yZXNvdXJjZSA9IG5ldyBjbG91ZHdhdGNoTG9nTWV0cmljRmlsdGVyLkNsb3Vkd2F0Y2hMb2dNZXRyaWNGaWx0ZXIoXG4gICAgICB0aGlzLFxuICAgICAgXCJSZXNvdXJjZVwiLFxuICAgICAge1xuICAgICAgICBuYW1lLFxuICAgICAgICBsb2dHcm91cE5hbWU6IHByb3BzLmxvZ0dyb3VwLmxvZ0dyb3VwTmFtZSxcbiAgICAgICAgcGF0dGVybjogcHJvcHMuZmlsdGVyUGF0dGVybi5sb2dQYXR0ZXJuU3RyaW5nLFxuICAgICAgICBtZXRyaWNUcmFuc2Zvcm1hdGlvbjoge1xuICAgICAgICAgIG5hbWVzcGFjZTogcHJvcHMubWV0cmljTmFtZXNwYWNlLFxuICAgICAgICAgIG5hbWU6IHByb3BzLm1ldHJpY05hbWUsXG4gICAgICAgICAgdmFsdWU6IHByb3BzLm1ldHJpY1ZhbHVlID8/IFwiMVwiLFxuICAgICAgICAgIGRlZmF1bHRWYWx1ZTogcHJvcHMuZGVmYXVsdFZhbHVlXG4gICAgICAgICAgICA/IFN0cmluZyhwcm9wcy5kZWZhdWx0VmFsdWUpXG4gICAgICAgICAgICA6IHVuZGVmaW5lZCxcbiAgICAgICAgICBkaW1lbnNpb25zOiBwcm9wcy5kaW1lbnNpb25zLFxuICAgICAgICAgIHVuaXQ6IHByb3BzLnVuaXQsXG4gICAgICAgIH0sXG4gICAgICB9LFxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJuIHRoZSBnaXZlbiBuYW1lZCBtZXRyaWMgZm9yIHRoaXMgTWV0cmljIEZpbHRlclxuICAgKlxuICAgKiBAZGVmYXVsdCBhdmcgb3ZlciA1IG1pbnV0ZXNcbiAgICovXG4gIHB1YmxpYyBtZXRyaWMocHJvcHM/OiBNZXRyaWNPcHRpb25zKTogTWV0cmljIHtcbiAgICByZXR1cm4gbmV3IE1ldHJpYyh7XG4gICAgICBtZXRyaWNOYW1lOiB0aGlzLm1ldHJpY05hbWUsXG4gICAgICBuYW1lc3BhY2U6IHRoaXMubWV0cmljTmFtZXNwYWNlLFxuICAgICAgc3RhdGlzdGljOiBcImF2Z1wiLFxuICAgICAgLi4ucHJvcHMsXG4gICAgfSkuYXR0YWNoVG8odGhpcyk7XG4gIH1cbn1cbiJdfQ==

package/lib/aws/cloudwatch/metric-types.d.ts

@@ -0,0 +1,407 @@
+import { Duration } from "../../duration";
+/**
+ * Interface for metrics
+ */
+export interface IMetric {
+    /**
+     * Any warnings related to this metric
+     *
+     * Should be attached to the consuming construct.
+     *
+     * @default - None
+     * @deprecated - use warningsV2
+     */
+    readonly warnings?: string[];
+    /**
+     * Any warnings related to this metric
+     *
+     * Should be attached to the consuming construct.
+     *
+     * @default - None
+     */
+    readonly warningsV2?: {
+        [id: string]: string;
+    };
+    /**
+     * Inspect the details of the metric object
+     */
+    toMetricConfig(): MetricConfig;
+    /**
+     * Turn this metric object into an alarm configuration
+     *
+     * @deprecated Use `toMetricConfig()` instead.
+     */
+    toAlarmConfig(): MetricAlarmConfig;
+    /**
+     * Turn this metric object into a graph configuration
+     *
+     * @deprecated Use `toMetricConfig()` instead.
+     */
+    toGraphConfig(): MetricGraphConfig;
+}
+/**
+ * Statistic to use over the aggregation period
+ *
+ * @see https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
+ * @deprecated Use one of the factory methods on `Stats` to produce statistics strings
+ */
+export declare enum Statistic {
+    /**
+     * The count (number) of data points used for the statistical calculation.
+     */
+    SAMPLE_COUNT = "SampleCount",
+    /**
+     * The value of Sum / SampleCount during the specified period.
+     */
+    AVERAGE = "Average",
+    /**
+     * All values submitted for the matching metric added together.
+     * This statistic can be useful for determining the total volume of a metric.
+     */
+    SUM = "Sum",
+    /**
+     * The lowest value observed during the specified period.
+     * You can use this value to determine low volumes of activity for your application.
+     */
+    MINIMUM = "Minimum",
+    /**
+     * The highest value observed during the specified period.
+     * You can use this value to determine high volumes of activity for your application.
+     */
+    MAXIMUM = "Maximum"
+}
+/**
+ * Unit for metric
+ */
+export declare enum Unit {
+    /**
+     * Seconds
+     */
+    SECONDS = "Seconds",
+    /**
+     * Microseconds
+     */
+    MICROSECONDS = "Microseconds",
+    /**
+     * Milliseconds
+     */
+    MILLISECONDS = "Milliseconds",
+    /**
+     * Bytes
+     */
+    BYTES = "Bytes",
+    /**
+     * Kilobytes
+     */
+    KILOBYTES = "Kilobytes",
+    /**
+     * Megabytes
+     */
+    MEGABYTES = "Megabytes",
+    /**
+     * Gigabytes
+     */
+    GIGABYTES = "Gigabytes",
+    /**
+     * Terabytes
+     */
+    TERABYTES = "Terabytes",
+    /**
+     * Bits
+     */
+    BITS = "Bits",
+    /**
+     * Kilobits
+     */
+    KILOBITS = "Kilobits",
+    /**
+     * Megabits
+     */
+    MEGABITS = "Megabits",
+    /**
+     * Gigabits
+     */
+    GIGABITS = "Gigabits",
+    /**
+     * Terabits
+     */
+    TERABITS = "Terabits",
+    /**
+     * Percent
+     */
+    PERCENT = "Percent",
+    /**
+     * Count
+     */
+    COUNT = "Count",
+    /**
+     * Bytes/second (B/s)
+     */
+    BYTES_PER_SECOND = "Bytes/Second",
+    /**
+     * Kilobytes/second (kB/s)
+     */
+    KILOBYTES_PER_SECOND = "Kilobytes/Second",
+    /**
+     * Megabytes/second (MB/s)
+     */
+    MEGABYTES_PER_SECOND = "Megabytes/Second",
+    /**
+     * Gigabytes/second (GB/s)
+     */
+    GIGABYTES_PER_SECOND = "Gigabytes/Second",
+    /**
+     * Terabytes/second (TB/s)
+     */
+    TERABYTES_PER_SECOND = "Terabytes/Second",
+    /**
+     * Bits/second (b/s)
+     */
+    BITS_PER_SECOND = "Bits/Second",
+    /**
+     * Kilobits/second (kb/s)
+     */
+    KILOBITS_PER_SECOND = "Kilobits/Second",
+    /**
+     * Megabits/second (Mb/s)
+     */
+    MEGABITS_PER_SECOND = "Megabits/Second",
+    /**
+     * Gigabits/second (Gb/s)
+     */
+    GIGABITS_PER_SECOND = "Gigabits/Second",
+    /**
+     * Terabits/second (Tb/s)
+     */
+    TERABITS_PER_SECOND = "Terabits/Second",
+    /**
+     * Count/second
+     */
+    COUNT_PER_SECOND = "Count/Second",
+    /**
+     * None
+     */
+    NONE = "None"
+}
+/**
+ * Properties of a rendered metric
+ */
+export interface MetricConfig {
+    /**
+     * In case the metric represents a query, the details of the query
+     *
+     * @default - None
+     */
+    readonly metricStat?: MetricStatConfig;
+    /**
+     * In case the metric is a math expression, the details of the math expression
+     *
+     * @default - None
+     */
+    readonly mathExpression?: MetricExpressionConfig;
+    /**
+     * Additional properties which will be rendered if the metric is used in a dashboard
+     *
+     * Examples are 'label' and 'color', but any key in here will be
+     * added to dashboard graphs.
+     *
+     * @default - None
+     */
+    readonly renderingProperties?: Record<string, unknown>;
+}
+/**
+ * Properties for a concrete metric
+ *
+ * NOTE: `unit` is no longer on this object since it is only used for `Alarms`, and doesn't mean what one
+ * would expect it to mean there anyway. It is most likely to be misused.
+ */
+export interface MetricStatConfig {
+    /**
+     * The dimensions to apply to the alarm
+     *
+     * @default {}
+     */
+    readonly dimensions?: Record<string, string>;
+    /**
+     * Namespace of the metric
+     */
+    readonly namespace: string;
+    /**
+     * Name of the metric
+     */
+    readonly metricName: string;
+    /**
+     * How many seconds to aggregate over
+     */
+    readonly period: Duration;
+    /**
+     * Aggregation function to use (can be either simple or a percentile)
+     */
+    readonly statistic: string;
+    /**
+     * Unit used to filter the metric stream
+     *
+     * Only refer to datums emitted to the metric stream with the given unit and
+     * ignore all others. Only useful when datums are being emitted to the same
+     * metric stream under different units.
+     *
+     * This field has been renamed from plain `unit` to clearly communicate
+     * its purpose.
+     *
+     * @default - Refer to all metric datums
+     */
+    readonly unitFilter?: Unit;
+    /**
+     * Region which this metric comes from.
+     *
+     * @default Deployment region.
+     */
+    readonly region?: string;
+    /**
+     * Account which this metric comes from.
+     *
+     * @default Deployment account.
+     */
+    readonly account?: string;
+}
+/**
+ * Properties for a concrete metric
+ */
+export interface MetricExpressionConfig {
+    /**
+     * Math expression for the metric.
+     */
+    readonly expression: string;
+    /**
+     * Metrics used in the math expression
+     */
+    readonly usingMetrics: Record<string, IMetric>;
+    /**
+     * How many seconds to aggregate over
+     */
+    readonly period: number;
+    /**
+     * Account to evaluate search expressions within.
+     *
+     * @default - Deployment account.
+     */
+    readonly searchAccount?: string;
+    /**
+     * Region to evaluate search expressions within.
+     *
+     * @default - Deployment region.
+     */
+    readonly searchRegion?: string;
+}
+/**
+ * Properties used to construct the Metric identifying part of an Alarm
+ *
+ * @deprecated Replaced by MetricConfig
+ */
+export interface MetricAlarmConfig {
+    /**
+     * The dimensions to apply to the alarm
+     */
+    readonly dimensions?: Record<string, string>;
+    /**
+     * Namespace of the metric
+     */
+    readonly namespace: string;
+    /**
+     * Name of the metric
+     */
+    readonly metricName: string;
+    /**
+     * How many seconds to aggregate over
+     */
+    readonly period: number;
+    /**
+     * Simple aggregation function to use
+     */
+    readonly statistic?: Statistic;
+    /**
+     * Percentile aggregation function to use
+     */
+    readonly extendedStatistic?: string;
+    /**
+     * The unit of the alarm
+     */
+    readonly unit?: Unit;
+}
+/**
+ * Properties used to construct the Metric identifying part of a Graph
+ *
+ * @deprecated Replaced by MetricConfig
+ */
+export interface MetricGraphConfig {
+    /**
+     * The dimensions to apply to the alarm
+     */
+    readonly dimensions?: Record<string, unknown>;
+    /**
+     * Namespace of the metric
+     */
+    readonly namespace: string;
+    /**
+     * Name of the metric
+     */
+    readonly metricName: string;
+    /**
+     * Rendering properties override yAxis parameter of the widget object
+     */
+    readonly renderingProperties: MetricRenderingProperties;
+    /**
+     * How many seconds to aggregate over
+     *
+     * @deprecated Use `period` in `renderingProperties`
+     */
+    readonly period: number;
+    /**
+     * Label for the metric
+     *
+     * @deprecated Use `label` in `renderingProperties`
+     */
+    readonly label?: string;
+    /**
+     * Color for the graph line
+     *
+     * @deprecated Use `color` in `renderingProperties`
+     */
+    readonly color?: string;
+    /**
+     * Aggregation function to use (can be either simple or a percentile)
+     *
+     * @deprecated Use `stat` in `renderingProperties`
+     */
+    readonly statistic?: string;
+    /**
+     * The unit of the alarm
+     *
+     * @deprecated not used in dashboard widgets
+     */
+    readonly unit?: Unit;
+}
+/**
+ * Custom rendering properties that override the default rendering properties specified in the yAxis parameter of the widget object.
+ *
+ * @deprecated Replaced by MetricConfig.
+ */
+export interface MetricRenderingProperties {
+    /**
+     * How many seconds to aggregate over
+     */
+    readonly period: number;
+    /**
+     * Label for the metric
+     */
+    readonly label?: string;
+    /**
+     * The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph.
+     * The `Color` class has a set of standard colors that can be used here.
+     */
+    readonly color?: string;
+    /**
+     * Aggregation function to use (can be either simple or a percentile)
+     */
+    readonly stat?: string;
+}