AWS greengrass documentation change
Summary
Updated Kinesis Data Streams export documentation: added details about shard-aware pacing in stream manager v2.3.1 and clarified partition key assignment logic.
Security assessment
Changes describe performance optimizations (shard distribution, throughput) and IAM permission requirements. No security vulnerabilities or security feature enhancements are mentioned.
Diff
diff --git a/greengrass/v2/developerguide/stream-export-configurations.md b/greengrass/v2/developerguide/stream-export-configurations.md index 35c3d551b..dc99177a0 100644 --- a//greengrass/v2/developerguide/stream-export-configurations.md +++ b//greengrass/v2/developerguide/stream-export-configurations.md @@ -118 +118 @@ This export destination has the following requirements: - * (Recommended) Stream manager v2.2.1 improves the performance of exporting streams to Kinesis Data Streams destinations. To use the improvements in this latest version, upgrade your [stream manager component](./stream-manager-component.html) to v2.2.1 and use the `kinesis:ListShards` policy in the [Greengrass token exchange role](./device-service-role.html). + * (Recommended) Starting in version 2.2.1, stream manager improves the performance of exporting streams to Kinesis Data Streams destinations. Version 2.3.1 adds adaptive, shard-aware pacing that further increases export throughput. To use these improvements, upgrade your [stream manager component](./stream-manager-component.html) to the latest version. Then, grant the `kinesis:ListShards` permission in the [Greengrass token exchange role](./device-service-role.html). With this permission, stream manager distributes records across the shards of the target data stream and paces requests to stay within the per-shard limits of Kinesis Data Streams. @@ -156 +156 @@ When your Greengrass components receive data from devices, they [append messages -Stream manager generates a unique, random UUID as a partition key for each record uploaded to Amazon Kinesis. +When stream manager can determine the shard layout of the target data stream, it distributes records across the available shards. Stream manager also paces requests to stay within the per-shard limits of Kinesis Data Streams. If stream manager cannot determine the shard layout, it assigns a unique, random UUID as the partition key for each record that it uploads to Amazon Kinesis.