@composurecdk/lambda 0.8.4 → 0.8.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -16
- package/dist/commonjs/alarm-config.d.ts +22 -0
- package/dist/commonjs/alarm-config.d.ts.map +1 -1
- package/dist/commonjs/alarm-defaults.d.ts +1 -0
- package/dist/commonjs/alarm-defaults.d.ts.map +1 -1
- package/dist/commonjs/alarm-defaults.js +15 -0
- package/dist/commonjs/alarm-defaults.js.map +1 -1
- package/dist/commonjs/event-sources/composure-event-source.d.ts +4 -4
- package/dist/commonjs/event-sources/composure-event-source.d.ts.map +1 -1
- package/dist/commonjs/event-sources/composure-event-source.js +7 -3
- package/dist/commonjs/event-sources/composure-event-source.js.map +1 -1
- package/dist/commonjs/event-sources/dynamodb-event-source.d.ts +55 -0
- package/dist/commonjs/event-sources/dynamodb-event-source.d.ts.map +1 -0
- package/dist/commonjs/event-sources/dynamodb-event-source.js +88 -0
- package/dist/commonjs/event-sources/dynamodb-event-source.js.map +1 -0
- package/dist/commonjs/event-sources/event-source-relationship-guards.d.ts +28 -0
- package/dist/commonjs/event-sources/event-source-relationship-guards.d.ts.map +1 -0
- package/dist/commonjs/event-sources/event-source-relationship-guards.js +105 -0
- package/dist/commonjs/event-sources/event-source-relationship-guards.js.map +1 -0
- package/dist/commonjs/event-sources/sqs-event-source.d.ts +7 -4
- package/dist/commonjs/event-sources/sqs-event-source.d.ts.map +1 -1
- package/dist/commonjs/event-sources/sqs-event-source.js +7 -4
- package/dist/commonjs/event-sources/sqs-event-source.js.map +1 -1
- package/dist/commonjs/function-alarms.d.ts.map +1 -1
- package/dist/commonjs/function-alarms.js +111 -47
- package/dist/commonjs/function-alarms.js.map +1 -1
- package/dist/commonjs/function-builder.d.ts.map +1 -1
- package/dist/commonjs/function-builder.js +7 -0
- package/dist/commonjs/function-builder.js.map +1 -1
- package/dist/commonjs/index.d.ts +2 -0
- package/dist/commonjs/index.d.ts.map +1 -1
- package/dist/commonjs/index.js +6 -1
- package/dist/commonjs/index.js.map +1 -1
- package/dist/esm/alarm-config.d.ts +22 -0
- package/dist/esm/alarm-config.d.ts.map +1 -1
- package/dist/esm/alarm-defaults.d.ts +1 -0
- package/dist/esm/alarm-defaults.d.ts.map +1 -1
- package/dist/esm/alarm-defaults.js +15 -0
- package/dist/esm/alarm-defaults.js.map +1 -1
- package/dist/esm/event-sources/composure-event-source.d.ts +4 -4
- package/dist/esm/event-sources/composure-event-source.d.ts.map +1 -1
- package/dist/esm/event-sources/composure-event-source.js +7 -3
- package/dist/esm/event-sources/composure-event-source.js.map +1 -1
- package/dist/esm/event-sources/dynamodb-event-source.d.ts +55 -0
- package/dist/esm/event-sources/dynamodb-event-source.d.ts.map +1 -0
- package/dist/esm/event-sources/dynamodb-event-source.js +84 -0
- package/dist/esm/event-sources/dynamodb-event-source.js.map +1 -0
- package/dist/esm/event-sources/event-source-relationship-guards.d.ts +28 -0
- package/dist/esm/event-sources/event-source-relationship-guards.d.ts.map +1 -0
- package/dist/esm/event-sources/event-source-relationship-guards.js +102 -0
- package/dist/esm/event-sources/event-source-relationship-guards.js.map +1 -0
- package/dist/esm/event-sources/sqs-event-source.d.ts +7 -4
- package/dist/esm/event-sources/sqs-event-source.d.ts.map +1 -1
- package/dist/esm/event-sources/sqs-event-source.js +7 -4
- package/dist/esm/event-sources/sqs-event-source.js.map +1 -1
- package/dist/esm/function-alarms.d.ts.map +1 -1
- package/dist/esm/function-alarms.js +112 -48
- package/dist/esm/function-alarms.js.map +1 -1
- package/dist/esm/function-builder.d.ts.map +1 -1
- package/dist/esm/function-builder.js +7 -0
- package/dist/esm/function-builder.js.map +1 -1
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/package.json +15 -5
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"function-alarms.d.ts","sourceRoot":"","sources":["../../src/function-alarms.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,KAAK,EAKX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,0BAA0B,CAAC;AAC3E,OAAO,
|
|
1
|
+
{"version":3,"file":"function-alarms.d.ts","sourceRoot":"","sources":["../../src/function-alarms.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,KAAK,EAKX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EACL,sBAAsB,EAIvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAyDrF;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,8BAA8B,CAAC,EACtE,YAAY,GAAE,mBAAmB,EAAO,GACvC,eAAe,EAAE,CAgKnB;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,mBAAmB,GAAG,KAAK,GAAG,SAAS,EAC/C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,8BAA8B,CAAC,EACtE,YAAY,GAAE,mBAAmB,EAAO,EACxC,YAAY,GAAE,sBAAsB,CAAC,cAAc,CAAC,EAAO,GAC1D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAUvB"}
|
|
@@ -14,25 +14,37 @@ const METRIC_PERIOD_LABEL = `${String(METRIC_PERIOD.toMinutes())} minute`;
|
|
|
14
14
|
*
|
|
15
15
|
* @see https://aws.amazon.com/blogs/compute/introducing-new-event-source-mapping-esm-metrics-for-aws-lambda/
|
|
16
16
|
*/
|
|
17
|
+
/**
|
|
18
|
+
* Per-mapping ESM alarms shared by every kind that emits the `EventCount`
|
|
19
|
+
* metrics — both SQS and DynamoDB streams report `FailedInvokeEventCount` and
|
|
20
|
+
* `DroppedEventCount` when the mapping opts into `MetricType.EVENT_COUNT`.
|
|
21
|
+
*/
|
|
22
|
+
const ESM_EVENT_COUNT_SPECS = [
|
|
23
|
+
{
|
|
24
|
+
keySuffix: "FailedInvocations",
|
|
25
|
+
configKey: "eventSourceFailedInvocations",
|
|
26
|
+
metricName: "FailedInvokeEventCount",
|
|
27
|
+
describe: (key, threshold) => `Lambda event source "${key}" is failing to invoke the function. ` +
|
|
28
|
+
`Threshold: > ${String(threshold)} failed invocations in ${METRIC_PERIOD_LABEL}.`,
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
keySuffix: "DroppedEvents",
|
|
32
|
+
configKey: "eventSourceDroppedEvents",
|
|
33
|
+
metricName: "DroppedEventCount",
|
|
34
|
+
describe: (key, threshold) => `Lambda event source "${key}" is dropping events after exhausting retries or TTL. ` +
|
|
35
|
+
`Threshold: > ${String(threshold)} dropped events in ${METRIC_PERIOD_LABEL}.`,
|
|
36
|
+
},
|
|
37
|
+
];
|
|
17
38
|
const EVENT_SOURCE_ALARM_SPECS = {
|
|
18
|
-
sqs:
|
|
19
|
-
|
|
20
|
-
keySuffix: "FailedInvocations",
|
|
21
|
-
configKey: "eventSourceFailedInvocations",
|
|
22
|
-
metricName: "FailedInvokeEventCount",
|
|
23
|
-
describe: (key, threshold) => `Lambda event source "${key}" is failing to invoke the function. ` +
|
|
24
|
-
`Threshold: > ${String(threshold)} failed invocations in ${METRIC_PERIOD_LABEL}.`,
|
|
25
|
-
},
|
|
26
|
-
{
|
|
27
|
-
keySuffix: "DroppedEvents",
|
|
28
|
-
configKey: "eventSourceDroppedEvents",
|
|
29
|
-
metricName: "DroppedEventCount",
|
|
30
|
-
describe: (key, threshold) => `Lambda event source "${key}" is dropping events after exhausting retries or TTL. ` +
|
|
31
|
-
`Threshold: > ${String(threshold)} dropped events in ${METRIC_PERIOD_LABEL}.`,
|
|
32
|
-
},
|
|
33
|
-
],
|
|
39
|
+
sqs: ESM_EVENT_COUNT_SPECS,
|
|
40
|
+
dynamodb: ESM_EVENT_COUNT_SPECS,
|
|
34
41
|
unknown: [],
|
|
35
42
|
};
|
|
43
|
+
/**
|
|
44
|
+
* Source kinds backed by a stream, for which the function-level `IteratorAge`
|
|
45
|
+
* alarm is created. Extensible to `"kinesis"` when that source lands.
|
|
46
|
+
*/
|
|
47
|
+
const STREAM_EVENT_SOURCE_KINDS = new Set(["dynamodb"]);
|
|
36
48
|
/**
|
|
37
49
|
* Resolves the recommended alarm configuration into fully-resolved
|
|
38
50
|
* {@link AlarmDefinition}s, applying contextual logic for timeout-based
|
|
@@ -70,40 +82,67 @@ function resolveFunctionAlarmDefinitions(fn, config, props, eventSources = []) {
|
|
|
70
82
|
description: `Lambda function invocations are being throttled. Threshold: > ${String(cfg.threshold)} throttles in ${METRIC_PERIOD_LABEL}.`,
|
|
71
83
|
});
|
|
72
84
|
}
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
85
|
+
// Threshold is a percentage of the timeout, so it needs a concrete `Duration`.
|
|
86
|
+
// Check the `duration !== false` escape hatch *before* touching the timeout, so
|
|
87
|
+
// disabling always works even when the conversion below would throw. The shared
|
|
88
|
+
// helper then omits the alarm (and warns) for a token-valued timeout, which has
|
|
89
|
+
// no millisecond threshold at synth time.
|
|
90
|
+
if (config?.duration !== false) {
|
|
91
|
+
const timeoutMs = (0, cloudwatch_1.resolveAlarmThresholdBasis)({
|
|
92
|
+
scope: fn,
|
|
93
|
+
value: props.timeout,
|
|
94
|
+
isUnresolved: (timeout) => timeout.isUnresolved(),
|
|
95
|
+
resolve: (timeout) => timeout.toMilliseconds(),
|
|
96
|
+
warningId: "@composurecdk/lambda:token-timeout-duration-alarm",
|
|
97
|
+
alarmLabel: "Lambda duration",
|
|
98
|
+
suppressHint: "recommendedAlarms({ duration: false })",
|
|
87
99
|
});
|
|
100
|
+
if (timeoutMs !== undefined) {
|
|
101
|
+
const cfg = resolvePercentageAlarmConfig(config?.duration, alarm_defaults_js_1.FUNCTION_ALARM_DEFAULTS.duration);
|
|
102
|
+
const threshold = Math.round(timeoutMs * cfg.thresholdPercent);
|
|
103
|
+
definitions.push({
|
|
104
|
+
key: "duration",
|
|
105
|
+
alarmName: cfg.alarmName,
|
|
106
|
+
metric: fn.metricDuration({ period: METRIC_PERIOD, statistic: aws_cloudwatch_1.Stats.percentile(99) }),
|
|
107
|
+
threshold,
|
|
108
|
+
comparisonOperator: aws_cloudwatch_1.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
109
|
+
evaluationPeriods: cfg.evaluationPeriods,
|
|
110
|
+
datapointsToAlarm: cfg.datapointsToAlarm,
|
|
111
|
+
treatMissingData: cfg.treatMissingData,
|
|
112
|
+
description: `Lambda function p99 duration is approaching the configured timeout. Threshold: > ${String(threshold)}ms (${String(cfg.thresholdPercent * 100)}% of ${String(timeoutMs)}ms timeout).`,
|
|
113
|
+
});
|
|
114
|
+
}
|
|
88
115
|
}
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
}),
|
|
100
|
-
threshold,
|
|
101
|
-
comparisonOperator: aws_cloudwatch_1.ComparisonOperator.GREATER_THAN_OR_EQUAL_TO_THRESHOLD,
|
|
102
|
-
evaluationPeriods: cfg.evaluationPeriods,
|
|
103
|
-
datapointsToAlarm: cfg.datapointsToAlarm,
|
|
104
|
-
treatMissingData: cfg.treatMissingData,
|
|
105
|
-
description: `Lambda function concurrent executions approaching reserved concurrency limit. Threshold: >= ${String(threshold)} (${String(cfg.thresholdPercent * 100)}% of ${String(reservedConcurrency)} reserved).`,
|
|
116
|
+
// Same shape, against a raw number. A token-valued `reservedConcurrentExecutions`
|
|
117
|
+
// wouldn't throw but would yield a meaningless threshold, so the helper skips it
|
|
118
|
+
// (default `Token.isUnresolved` guard).
|
|
119
|
+
if (config?.concurrentExecutions !== false) {
|
|
120
|
+
const reservedConcurrency = (0, cloudwatch_1.resolveAlarmThresholdBasis)({
|
|
121
|
+
scope: fn,
|
|
122
|
+
value: props.reservedConcurrentExecutions,
|
|
123
|
+
resolve: (reserved) => reserved,
|
|
124
|
+
warningId: "@composurecdk/lambda:token-reserved-concurrency-alarm",
|
|
125
|
+
alarmLabel: "Lambda concurrent-executions",
|
|
126
|
+
suppressHint: "recommendedAlarms({ concurrentExecutions: false })",
|
|
106
127
|
});
|
|
128
|
+
if (reservedConcurrency !== undefined) {
|
|
129
|
+
const cfg = resolvePercentageAlarmConfig(config?.concurrentExecutions, alarm_defaults_js_1.FUNCTION_ALARM_DEFAULTS.concurrentExecutions);
|
|
130
|
+
const threshold = Math.round(reservedConcurrency * cfg.thresholdPercent);
|
|
131
|
+
definitions.push({
|
|
132
|
+
key: "concurrentExecutions",
|
|
133
|
+
alarmName: cfg.alarmName,
|
|
134
|
+
metric: fn.metric("ConcurrentExecutions", {
|
|
135
|
+
period: METRIC_PERIOD,
|
|
136
|
+
statistic: aws_cloudwatch_1.Stats.MAXIMUM,
|
|
137
|
+
}),
|
|
138
|
+
threshold,
|
|
139
|
+
comparisonOperator: aws_cloudwatch_1.ComparisonOperator.GREATER_THAN_OR_EQUAL_TO_THRESHOLD,
|
|
140
|
+
evaluationPeriods: cfg.evaluationPeriods,
|
|
141
|
+
datapointsToAlarm: cfg.datapointsToAlarm,
|
|
142
|
+
treatMissingData: cfg.treatMissingData,
|
|
143
|
+
description: `Lambda function concurrent executions approaching reserved concurrency limit. Threshold: >= ${String(threshold)} (${String(cfg.thresholdPercent * 100)}% of ${String(reservedConcurrency)} reserved).`,
|
|
144
|
+
});
|
|
145
|
+
}
|
|
107
146
|
}
|
|
108
147
|
for (const eventSource of eventSources) {
|
|
109
148
|
// The ESM metrics that back these alarms are dimensioned on the mapping
|
|
@@ -129,6 +168,31 @@ function resolveFunctionAlarmDefinitions(fn, config, props, eventSources = []) {
|
|
|
129
168
|
});
|
|
130
169
|
}
|
|
131
170
|
}
|
|
171
|
+
// `IteratorAge` is a function-level metric (dimensioned on `FunctionName`,
|
|
172
|
+
// not the mapping UUID), so it cannot ride the per-mapping loop above: one
|
|
173
|
+
// alarm covers the function whenever any stream source is attached.
|
|
174
|
+
if (config?.eventSourceIteratorAge !== false &&
|
|
175
|
+
eventSources.some((es) => STREAM_EVENT_SOURCE_KINDS.has(es.kind))) {
|
|
176
|
+
const cfg = (0, cloudwatch_1.resolveAlarmConfig)(config?.eventSourceIteratorAge, alarm_defaults_js_1.FUNCTION_ALARM_DEFAULTS.eventSourceIteratorAge);
|
|
177
|
+
definitions.push({
|
|
178
|
+
key: "iteratorAge",
|
|
179
|
+
alarmName: cfg.alarmName,
|
|
180
|
+
metric: new aws_cloudwatch_1.Metric({
|
|
181
|
+
namespace: "AWS/Lambda",
|
|
182
|
+
metricName: "IteratorAge",
|
|
183
|
+
dimensionsMap: { FunctionName: fn.functionName },
|
|
184
|
+
statistic: aws_cloudwatch_1.Stats.MAXIMUM,
|
|
185
|
+
period: METRIC_PERIOD,
|
|
186
|
+
}),
|
|
187
|
+
threshold: cfg.threshold,
|
|
188
|
+
comparisonOperator: aws_cloudwatch_1.ComparisonOperator.GREATER_THAN_THRESHOLD,
|
|
189
|
+
evaluationPeriods: cfg.evaluationPeriods,
|
|
190
|
+
datapointsToAlarm: cfg.datapointsToAlarm,
|
|
191
|
+
treatMissingData: cfg.treatMissingData,
|
|
192
|
+
description: `Lambda function is falling behind its stream event source (IteratorAge). ` +
|
|
193
|
+
`Threshold: > ${String(cfg.threshold)}ms for ${String(cfg.evaluationPeriods)} consecutive ${METRIC_PERIOD_LABEL} periods.`,
|
|
194
|
+
});
|
|
195
|
+
}
|
|
132
196
|
return definitions;
|
|
133
197
|
}
|
|
134
198
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"function-alarms.js","sourceRoot":"","sources":["../../src/function-alarms.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"function-alarms.js","sourceRoot":"","sources":["../../src/function-alarms.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"function-builder.d.ts","sourceRoot":"","sources":["../../src/function-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,QAAQ,IAAI,cAAc,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAW,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,2CAA2C,CAAC;
|
|
1
|
+
{"version":3,"file":"function-builder.d.ts","sourceRoot":"","sources":["../../src/function-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,QAAQ,IAAI,cAAc,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAW,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,2CAA2C,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;IACvE;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,QAAQ,EAAE,cAAc,CAAC;IAEzB;;;;;;;;;OASG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE9B;;;;;;;;;OASG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;AAOrF,cAAM,eAAgB,YAAW,SAAS,CAAC,qBAAqB,CAAC;;IAC/D,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAM;IAM1C,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,CACT,KAAK,EAAE,sBAAsB,CAAC,cAAc,CAAC,KAC1C,sBAAsB,CAAC,cAAc,CAAC,GAC1C,IAAI;IAKP;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,oBAAoB,GAAG,YAAY,CAAC,GAAG,IAAI;IAU1F;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI;IAKtD;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,IAAI;IAKtB,gCAAgC;IAChC,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAO3C,KAAK,CACH,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,qBAAqB;CAgIzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD"}
|
|
@@ -11,6 +11,7 @@ const logs_1 = require("@composurecdk/logs");
|
|
|
11
11
|
const function_alarms_js_1 = require("./function-alarms.js");
|
|
12
12
|
const defaults_js_1 = require("./defaults.js");
|
|
13
13
|
const composure_event_source_js_1 = require("./event-sources/composure-event-source.js");
|
|
14
|
+
const event_source_relationship_guards_js_1 = require("./event-sources/event-source-relationship-guards.js");
|
|
14
15
|
const LOGS_WRITER_POLICY_NAME = "LogsWriter";
|
|
15
16
|
class FunctionBuilder {
|
|
16
17
|
props = {};
|
|
@@ -140,6 +141,12 @@ class FunctionBuilder {
|
|
|
140
141
|
kind,
|
|
141
142
|
eventSourceMappingId: composure_event_source_js_1.EVENT_SOURCE_MAPPING_ID_READERS[kind]?.(eventSource),
|
|
142
143
|
});
|
|
144
|
+
// Guard any cross-component relationship that spans this source and the
|
|
145
|
+
// function (e.g. the SQS visibilityTimeout >= 6x function-timeout rule),
|
|
146
|
+
// dispatched on kind so no CDK internals are inspected. See ADR-0011.
|
|
147
|
+
for (const guard of event_source_relationship_guards_js_1.EVENT_SOURCE_RELATIONSHIP_GUARDS[kind]) {
|
|
148
|
+
guard(fn, id, entry.key, eventSource, mergedProps.timeout);
|
|
149
|
+
}
|
|
143
150
|
}
|
|
144
151
|
const alarms = (0, function_alarms_js_1.createFunctionAlarms)(scope, id, fn, alarmConfig, mergedProps, attachedEventSources, this.#customAlarms);
|
|
145
152
|
const resolvedRole = role ?? fn.role;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"function-builder.js","sourceRoot":"","sources":["../../src/function-builder.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"function-builder.js","sourceRoot":"","sources":["../../src/function-builder.ts"],"names":[],"mappings":"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"}
|
package/dist/commonjs/index.d.ts
CHANGED
|
@@ -4,4 +4,6 @@ export { type FunctionAlarmConfig, type PercentageAlarmConfig } from "./alarm-co
|
|
|
4
4
|
export { FUNCTION_ALARM_DEFAULTS } from "./alarm-defaults.js";
|
|
5
5
|
export { type ComposureEventSource, type EventSourceKind, } from "./event-sources/composure-event-source.js";
|
|
6
6
|
export { sqsEventSource, DEFAULT_SQS_EVENT_SOURCE_PROPS, } from "./event-sources/sqs-event-source.js";
|
|
7
|
+
export { SQS_VISIBILITY_TIMEOUT_WARNING_ID } from "./event-sources/event-source-relationship-guards.js";
|
|
8
|
+
export { dynamoEventSource, DEFAULT_DYNAMO_EVENT_SOURCE_PROPS, } from "./event-sources/dynamodb-event-source.js";
|
|
7
9
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,cAAc,EACd,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,cAAc,EACd,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,iCAAiC,EAAE,MAAM,qDAAqD,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iCAAiC,GAClC,MAAM,0CAA0C,CAAC"}
|
package/dist/commonjs/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.DEFAULT_SQS_EVENT_SOURCE_PROPS = exports.sqsEventSource = exports.FUNCTION_ALARM_DEFAULTS = exports.FUNCTION_DEFAULTS = exports.createFunctionBuilder = void 0;
|
|
3
|
+
exports.DEFAULT_DYNAMO_EVENT_SOURCE_PROPS = exports.dynamoEventSource = exports.SQS_VISIBILITY_TIMEOUT_WARNING_ID = exports.DEFAULT_SQS_EVENT_SOURCE_PROPS = exports.sqsEventSource = exports.FUNCTION_ALARM_DEFAULTS = exports.FUNCTION_DEFAULTS = exports.createFunctionBuilder = void 0;
|
|
4
4
|
var function_builder_js_1 = require("./function-builder.js");
|
|
5
5
|
Object.defineProperty(exports, "createFunctionBuilder", { enumerable: true, get: function () { return function_builder_js_1.createFunctionBuilder; } });
|
|
6
6
|
var defaults_js_1 = require("./defaults.js");
|
|
@@ -10,4 +10,9 @@ Object.defineProperty(exports, "FUNCTION_ALARM_DEFAULTS", { enumerable: true, ge
|
|
|
10
10
|
var sqs_event_source_js_1 = require("./event-sources/sqs-event-source.js");
|
|
11
11
|
Object.defineProperty(exports, "sqsEventSource", { enumerable: true, get: function () { return sqs_event_source_js_1.sqsEventSource; } });
|
|
12
12
|
Object.defineProperty(exports, "DEFAULT_SQS_EVENT_SOURCE_PROPS", { enumerable: true, get: function () { return sqs_event_source_js_1.DEFAULT_SQS_EVENT_SOURCE_PROPS; } });
|
|
13
|
+
var event_source_relationship_guards_js_1 = require("./event-sources/event-source-relationship-guards.js");
|
|
14
|
+
Object.defineProperty(exports, "SQS_VISIBILITY_TIMEOUT_WARNING_ID", { enumerable: true, get: function () { return event_source_relationship_guards_js_1.SQS_VISIBILITY_TIMEOUT_WARNING_ID; } });
|
|
15
|
+
var dynamodb_event_source_js_1 = require("./event-sources/dynamodb-event-source.js");
|
|
16
|
+
Object.defineProperty(exports, "dynamoEventSource", { enumerable: true, get: function () { return dynamodb_event_source_js_1.dynamoEventSource; } });
|
|
17
|
+
Object.defineProperty(exports, "DEFAULT_DYNAMO_EVENT_SOURCE_PROPS", { enumerable: true, get: function () { return dynamodb_event_source_js_1.DEFAULT_DYNAMO_EVENT_SOURCE_PROPS; } });
|
|
13
18
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAK+B;AAJ7B,4HAAA,qBAAqB,OAAA;AAKvB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAE1B,yDAA8D;AAArD,4HAAA,uBAAuB,OAAA;AAKhC,2EAG6C;AAF3C,qHAAA,cAAc,OAAA;AACd,qIAAA,8BAA8B,OAAA"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAK+B;AAJ7B,4HAAA,qBAAqB,OAAA;AAKvB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAE1B,yDAA8D;AAArD,4HAAA,uBAAuB,OAAA;AAKhC,2EAG6C;AAF3C,qHAAA,cAAc,OAAA;AACd,qIAAA,8BAA8B,OAAA;AAEhC,2GAAwG;AAA/F,wJAAA,iCAAiC,OAAA;AAC1C,qFAGkD;AAFhD,6HAAA,iBAAiB,OAAA;AACjB,6IAAA,iCAAiC,OAAA"}
|
|
@@ -110,5 +110,27 @@ export interface FunctionAlarmConfig {
|
|
|
110
110
|
* @see https://aws.amazon.com/blogs/compute/introducing-new-event-source-mapping-esm-metrics-for-aws-lambda/
|
|
111
111
|
*/
|
|
112
112
|
eventSourceDroppedEvents?: AlarmConfig | false;
|
|
113
|
+
/**
|
|
114
|
+
* Alarm when the function is falling behind a stream event source.
|
|
115
|
+
*
|
|
116
|
+
* Contextual: a single alarm is created when at least one stream event
|
|
117
|
+
* source (currently DynamoDB streams) is attached via
|
|
118
|
+
* {@link IFunctionBuilder.addEventSource}. Unlike the per-mapping
|
|
119
|
+
* {@link FunctionAlarmConfig.eventSourceFailedInvocations} /
|
|
120
|
+
* {@link FunctionAlarmConfig.eventSourceDroppedEvents} alarms, `IteratorAge`
|
|
121
|
+
* is a function-level metric, so there is one alarm per function (keyed
|
|
122
|
+
* `iteratorAge`) regardless of how many stream sources are attached.
|
|
123
|
+
*
|
|
124
|
+
* The threshold is an absolute age in milliseconds (not a percentage).
|
|
125
|
+
*
|
|
126
|
+
* Metric: `AWS/Lambda IteratorAge`, statistic Maximum, period 1 minute,
|
|
127
|
+
* dimensioned on `FunctionName`. AWS recommends alarming on this metric for
|
|
128
|
+
* stream consumers but does not prescribe a threshold (it is workload
|
|
129
|
+
* dependent); the default is a deliberately conservative > 60000 ms (60s) for
|
|
130
|
+
* 3 consecutive minutes.
|
|
131
|
+
*
|
|
132
|
+
* @see https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics.html
|
|
133
|
+
*/
|
|
134
|
+
eventSourceIteratorAge?: AlarmConfig | false;
|
|
113
135
|
}
|
|
114
136
|
//# sourceMappingURL=alarm-config.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"alarm-config.d.ts","sourceRoot":"","sources":["../../src/alarm-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;IACnE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC,CAAC;AAE/F;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAE7B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;IAErD;;;;;;;;;;;;;OAaG;IACH,4BAA4B,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAEnD;;;;;;;;;;;;;OAaG;IACH,wBAAwB,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"alarm-config.d.ts","sourceRoot":"","sources":["../../src/alarm-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;IACnE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC,CAAC;AAE/F;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAE7B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;IAErD;;;;;;;;;;;;;OAaG;IACH,4BAA4B,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAEnD;;;;;;;;;;;;;OAaG;IACH,wBAAwB,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAE/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,sBAAsB,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;CAC9C"}
|
|
@@ -8,6 +8,7 @@ interface FunctionAlarmDefaults {
|
|
|
8
8
|
concurrentExecutions: PercentageAlarmConfigDefaults;
|
|
9
9
|
eventSourceFailedInvocations: AlarmConfigDefaults;
|
|
10
10
|
eventSourceDroppedEvents: AlarmConfigDefaults;
|
|
11
|
+
eventSourceIteratorAge: AlarmConfigDefaults;
|
|
11
12
|
}
|
|
12
13
|
/**
|
|
13
14
|
* AWS-recommended default alarm configuration for Lambda functions.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"alarm-defaults.d.ts","sourceRoot":"","sources":["../../src/alarm-defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvE,UAAU,qBAAqB;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,6BAA6B,CAAC;IACxC,oBAAoB,EAAE,6BAA6B,CAAC;IACpD,4BAA4B,EAAE,mBAAmB,CAAC;IAClD,wBAAwB,EAAE,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"alarm-defaults.d.ts","sourceRoot":"","sources":["../../src/alarm-defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvE,UAAU,qBAAqB;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,6BAA6B,CAAC;IACxC,oBAAoB,EAAE,6BAA6B,CAAC;IACpD,4BAA4B,EAAE,mBAAmB,CAAC;IAClD,wBAAwB,EAAE,mBAAmB,CAAC;IAC9C,sBAAsB,EAAE,mBAAmB,CAAC;CAC7C;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,qBAwErC,CAAC"}
|
|
@@ -54,5 +54,20 @@ export const FUNCTION_ALARM_DEFAULTS = {
|
|
|
54
54
|
datapointsToAlarm: 1,
|
|
55
55
|
treatMissingData: TreatMissingData.NOT_BREACHING,
|
|
56
56
|
},
|
|
57
|
+
/**
|
|
58
|
+
* The consumer falling behind the stream risks data loss once records age
|
|
59
|
+
* past the stream's 24h retention. AWS recommends alarming on `IteratorAge`
|
|
60
|
+
* for stream consumers but publishes no fixed threshold — the right value is
|
|
61
|
+
* workload dependent. 60s of sustained lag for 3 consecutive minutes is a
|
|
62
|
+
* deliberately conservative default; tune via `eventSourceIteratorAge`. Idle
|
|
63
|
+
* functions emit no datapoints and stay OK (`NOT_BREACHING`).
|
|
64
|
+
* @see https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics.html
|
|
65
|
+
*/
|
|
66
|
+
eventSourceIteratorAge: {
|
|
67
|
+
threshold: 60_000,
|
|
68
|
+
evaluationPeriods: 3,
|
|
69
|
+
datapointsToAlarm: 3,
|
|
70
|
+
treatMissingData: TreatMissingData.NOT_BREACHING,
|
|
71
|
+
},
|
|
57
72
|
};
|
|
58
73
|
//# sourceMappingURL=alarm-defaults.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"alarm-defaults.js","sourceRoot":"","sources":["../../src/alarm-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;
|
|
1
|
+
{"version":3,"file":"alarm-defaults.js","sourceRoot":"","sources":["../../src/alarm-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAe9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA0B;IAC5D,OAAO,EAAE,IAAI;IAEb,qDAAqD;IACrD,MAAM,EAAE;QACN,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED,6DAA6D;IAC7D,SAAS,EAAE;QACT,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED;;;OAGG;IACH,QAAQ,EAAE;QACR,gBAAgB,EAAE,GAAG;QACrB,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED;;;OAGG;IACH,oBAAoB,EAAE;QACpB,gBAAgB,EAAE,GAAG;QACrB,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED,sFAAsF;IACtF,4BAA4B,EAAE;QAC5B,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED,mDAAmD;IACnD,wBAAwB,EAAE;QACxB,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;IAED;;;;;;;;OAQG;IACH,sBAAsB,EAAE;QACtB,SAAS,EAAE,MAAM;QACjB,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;KACjD;CACF,CAAC"}
|
|
@@ -9,7 +9,7 @@ import type { Resolvable } from "@composurecdk/core";
|
|
|
9
9
|
* straight to {@link IFunctionBuilder.addEventSource} as an escape hatch —
|
|
10
10
|
* the builder still attaches it, but cannot reason about it.
|
|
11
11
|
*/
|
|
12
|
-
export type EventSourceKind = "sqs" | "unknown";
|
|
12
|
+
export type EventSourceKind = "sqs" | "dynamodb" | "unknown";
|
|
13
13
|
/** @internal — brands {@link ComposureEventSource} so the guard is unambiguous. */
|
|
14
14
|
declare const COMPOSURE_EVENT_SOURCE: unique symbol;
|
|
15
15
|
/**
|
|
@@ -40,9 +40,9 @@ export declare function composureEventSource(kind: EventSourceKind, source: Reso
|
|
|
40
40
|
/**
|
|
41
41
|
* Reads the event source mapping UUID off a bound CDK source, keyed by
|
|
42
42
|
* {@link EventSourceKind}. Defined only for kinds whose per-mapping ESM
|
|
43
|
-
* metrics back contextual alarms (
|
|
44
|
-
* the reader after `addEventSource` so the binding exists. Keying off
|
|
45
|
-
* — like {@link EVENT_SOURCE_ALARM_SPECS} — keeps the builder from
|
|
43
|
+
* metrics back contextual alarms (SQS and DynamoDB streams); `FunctionBuilder`
|
|
44
|
+
* invokes the reader after `addEventSource` so the binding exists. Keying off
|
|
45
|
+
* `kind` — like {@link EVENT_SOURCE_ALARM_SPECS} — keeps the builder from
|
|
46
46
|
* `instanceof`-ing CDK source classes.
|
|
47
47
|
*
|
|
48
48
|
* @internal
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"composure-event-source.d.ts","sourceRoot":"","sources":["../../../src/event-sources/composure-event-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"composure-event-source.d.ts","sourceRoot":"","sources":["../../../src/event-sources/composure-event-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,mFAAmF;AACnF,QAAA,MAAM,sBAAsB,eAAgD,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;IAExC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,GAC/B,oBAAoB,CAEtB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAClD,eAAe,EACf,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC,GAAG,SAAS,CAW9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,GAAG,YAAY,GACzC,KAAK,IAAI,oBAAoB,CAE/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IAEZ,8DAA8D;IAC9D,IAAI,EAAE,eAAe,CAAC;IAEtB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}
|
|
@@ -7,9 +7,9 @@ export function composureEventSource(kind, source) {
|
|
|
7
7
|
/**
|
|
8
8
|
* Reads the event source mapping UUID off a bound CDK source, keyed by
|
|
9
9
|
* {@link EventSourceKind}. Defined only for kinds whose per-mapping ESM
|
|
10
|
-
* metrics back contextual alarms (
|
|
11
|
-
* the reader after `addEventSource` so the binding exists. Keying off
|
|
12
|
-
* — like {@link EVENT_SOURCE_ALARM_SPECS} — keeps the builder from
|
|
10
|
+
* metrics back contextual alarms (SQS and DynamoDB streams); `FunctionBuilder`
|
|
11
|
+
* invokes the reader after `addEventSource` so the binding exists. Keying off
|
|
12
|
+
* `kind` — like {@link EVENT_SOURCE_ALARM_SPECS} — keeps the builder from
|
|
13
13
|
* `instanceof`-ing CDK source classes.
|
|
14
14
|
*
|
|
15
15
|
* @internal
|
|
@@ -19,6 +19,10 @@ export const EVENT_SOURCE_MAPPING_ID_READERS = {
|
|
|
19
19
|
// constructs the `SqsEventSource` in the same call — kind and concrete class
|
|
20
20
|
// move in lockstep.
|
|
21
21
|
sqs: (bound) => bound.eventSourceMappingId,
|
|
22
|
+
// Safe: the `"dynamodb"` kind is only ever assigned by `dynamoEventSource()`,
|
|
23
|
+
// which constructs the `DynamoEventSource` in the same call — kind and
|
|
24
|
+
// concrete class move in lockstep.
|
|
25
|
+
dynamodb: (bound) => bound.eventSourceMappingId,
|
|
22
26
|
unknown: undefined,
|
|
23
27
|
};
|
|
24
28
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"composure-event-source.js","sourceRoot":"","sources":["../../../src/event-sources/composure-event-source.ts"],"names":[],"mappings":"AAeA,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AA4B7E,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAClC,IAAqB,EACrB,MAAgC;IAEhC,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAGxC;IACF,4EAA4E;IAC5E,6EAA6E;IAC7E,oBAAoB;IACpB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAE,KAAwB,CAAC,oBAAoB;IAC9D,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA0C;IAE1C,OAAO,sBAAsB,IAAI,KAAK,CAAC;AACzC,CAAC"}
|
|
1
|
+
{"version":3,"file":"composure-event-source.js","sourceRoot":"","sources":["../../../src/event-sources/composure-event-source.ts"],"names":[],"mappings":"AAeA,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AA4B7E,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAClC,IAAqB,EACrB,MAAgC;IAEhC,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAGxC;IACF,4EAA4E;IAC5E,6EAA6E;IAC7E,oBAAoB;IACpB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAE,KAAwB,CAAC,oBAAoB;IAC9D,8EAA8E;IAC9E,uEAAuE;IACvE,mCAAmC;IACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAE,KAA2B,CAAC,oBAAoB;IACtE,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA0C;IAE1C,OAAO,sBAAsB,IAAI,KAAK,CAAC;AACzC,CAAC"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { ITable } from "aws-cdk-lib/aws-dynamodb";
|
|
2
|
+
import { type DynamoEventSourceProps } from "aws-cdk-lib/aws-lambda-event-sources";
|
|
3
|
+
import { type Resolvable } from "@composurecdk/core";
|
|
4
|
+
import { type ComposureEventSource } from "./composure-event-source.js";
|
|
5
|
+
/**
|
|
6
|
+
* Secure, AWS-recommended defaults applied to every DynamoDB stream event
|
|
7
|
+
* source built with {@link dynamoEventSource}. Each property can be overridden
|
|
8
|
+
* via the factory's `props` argument.
|
|
9
|
+
*/
|
|
10
|
+
export declare const DEFAULT_DYNAMO_EVENT_SOURCE_PROPS: Pick<DynamoEventSourceProps, "startingPosition" | "reportBatchItemFailures" | "metricsConfig">;
|
|
11
|
+
/**
|
|
12
|
+
* Wraps a DynamoDB table's change stream as a Lambda {@link IEventSource},
|
|
13
|
+
* deferring resolution when the table is a `ref()` to a sibling component's
|
|
14
|
+
* output.
|
|
15
|
+
*
|
|
16
|
+
* Follows the `events/targets` factory shape: register the result with
|
|
17
|
+
* {@link IFunctionBuilder.addEventSource} and the builder resolves the
|
|
18
|
+
* `ref()`, attaches the source, and (because `addEventSource` calls
|
|
19
|
+
* `source.bind(fn)`) grants the function's least-privilege execution role
|
|
20
|
+
* permission to read the stream via `grantStreamRead`.
|
|
21
|
+
*
|
|
22
|
+
* Applies {@link DEFAULT_DYNAMO_EVENT_SOURCE_PROPS}; pass `props` to override.
|
|
23
|
+
*
|
|
24
|
+
* ## Cross-component invariant (enforced by CDK at bind time)
|
|
25
|
+
*
|
|
26
|
+
* The table must have a stream enabled (via the table builder's
|
|
27
|
+
* `.dynamoStream(...)` / `.stream(...)`, or `TableProps.stream`). If it does
|
|
28
|
+
* not, CDK's `DynamoEventSource.bind()` throws `DynamoDB Streams must be
|
|
29
|
+
* enabled on the table` when the function is built — the table often arrives
|
|
30
|
+
* as a `ref()` that is not resolvable at configuration time, so this is not
|
|
31
|
+
* validated earlier.
|
|
32
|
+
*
|
|
33
|
+
* @param table - The source table, concrete or a `ref()` to a sibling.
|
|
34
|
+
* @param props - Overrides for {@link DEFAULT_DYNAMO_EVENT_SOURCE_PROPS} and
|
|
35
|
+
* any other {@link DynamoEventSourceProps}.
|
|
36
|
+
*
|
|
37
|
+
* @example
|
|
38
|
+
* ```ts
|
|
39
|
+
* compose(
|
|
40
|
+
* {
|
|
41
|
+
* orders: createTableV2Builder()
|
|
42
|
+
* .partitionKey({ name: "pk", type: AttributeType.STRING })
|
|
43
|
+
* .dynamoStream(StreamViewType.NEW_AND_OLD_IMAGES),
|
|
44
|
+
* processor: createFunctionBuilder()
|
|
45
|
+
* .runtime(Runtime.NODEJS_22_X)
|
|
46
|
+
* .handler("index.handler")
|
|
47
|
+
* .code(Code.fromAsset("lambda"))
|
|
48
|
+
* .addEventSource("orders", dynamoEventSource(ref("orders", (r) => r.table))),
|
|
49
|
+
* },
|
|
50
|
+
* { orders: [], processor: ["orders"] },
|
|
51
|
+
* );
|
|
52
|
+
* ```
|
|
53
|
+
*/
|
|
54
|
+
export declare function dynamoEventSource(table: Resolvable<ITable>, props?: DynamoEventSourceProps): ComposureEventSource;
|
|
55
|
+
//# sourceMappingURL=dynamodb-event-source.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dynamodb-event-source.d.ts","sourceRoot":"","sources":["../../../src/event-sources/dynamodb-event-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,KAAK,oBAAoB,EAAwB,MAAM,6BAA6B,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAE,IAAI,CAClD,sBAAsB,EACtB,kBAAkB,GAAG,yBAAyB,GAAG,eAAe,CA0BjE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EACzB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,oBAAoB,CAMtB"}
|