AWS greengrass documentation change
Summary
Updated Stream Manager component version range to include 2.3.1, added new configuration parameter STREAM_MANAGER_EXPORTER_KINESIS_INTER_CALL_DELAY_MS, and documented performance improvements for Kinesis exports.
Security assessment
Changes focus on performance optimization and throttling prevention. No security vulnerability is mentioned. The added configuration parameter helps avoid throttling but doesn't address security weaknesses.
Diff
diff --git a/greengrass/v2/developerguide/stream-manager-component.md b/greengrass/v2/developerguide/stream-manager-component.md index 2c90ee92f..209de1a0c 100644 --- a//greengrass/v2/developerguide/stream-manager-component.md +++ b//greengrass/v2/developerguide/stream-manager-component.md @@ -120 +120 @@ When you deploy a component, AWS IoT Greengrass also deploys compatible versions -2.1.3 – 2.3.0 +2.1.3 – 2.3.1 @@ -123 +123 @@ When you deploy a component, AWS IoT Greengrass also deploys compatible versions -The following table lists the dependencies for versions 2.1.3 to 2.3.0 of this component. +The following table lists the dependencies for versions 2.1.3 to 2.3.1 of this component. @@ -328,0 +329,7 @@ Default: `5242880` (5 MB). This is also the minimum value. +`STREAM_MANAGER_EXPORTER_KINESIS_INTER_CALL_DELAY_MS` + + +(Optional) The delay, in milliseconds, that stream manager waits between consecutive requests when it exports streams to Kinesis Data Streams destinations. This delay applies only when stream manager cannot determine the shard layout of the target data stream. This can happen when the [Greengrass token exchange role](./device-service-role.html) does not include the `kinesis:ListShards` permission. When stream manager can determine the shard layout, it uses shard-aware pacing instead of this delay. To turn off the fallback delay, set this parameter to `0`. + +Default: `1000` (1 second) + @@ -410,0 +418,10 @@ The following table describes the changes in each version of the component. +2.3.1 | + +Bug fixes and improvements + + + * Improves the throughput of stream manager exports to Kinesis Data Streams destinations, especially for small record sizes. + * Adds shard-aware pacing that distributes records across the shards of the target data stream. This pacing keeps requests within the per-shard limits of Kinesis Data Streams to reduce throttling. To use shard-aware pacing, grant the `kinesis:ListShards` permission in the [Greengrass token exchange role](./device-service-role.html). Without this permission, stream manager assigns a random partition key to each record. + * Adds the `STREAM_MANAGER_EXPORTER_KINESIS_INTER_CALL_DELAY_MS` configuration parameter, which sets a fallback delay between export requests when stream manager cannot determine the shard layout of the target data stream. + +