[CloudWatch] Configurable log stream naming (align with iOS)

[NicolasBrandi]

Before opening, please confirm:

• I have searched for duplicate or closed issues and discussions.

Language and Async Model

Kotlin

Amplify Categories

Not applicable

Gradle script dependencies

Details

// Put output below this line

Environment information

Details

# Put output below this line

Please include any relevant guides or documentation you're referencing

No response

Describe the feature request

Add support for Android CloudWatch log stream naming to match iOS by default (installationId + userId). This would make cross‑platform log retrieval consistent and predictable. As a nice‑to‑have, allow configuring the log stream name (e.g., logStreamName field or provider in AWSCloudWatchLoggingPluginConfiguration).

Why this is needed
Android CloudWatch logging plugin currently generates stream names as:
MM-dd-yyyy.<deviceId>.<userId|guest>.

amplify-android/aws-logging-cloudwatch/src/main/java/com/amplifyframework/logging/cloudwatch/CloudWatchLogManager.kt

Line 120 in 415a767

val streamName = "$todayDate.${uniqueDeviceId()}.${userIdentityId ?: "guest"}"

This creates many log streams per user (one per day) and makes per‑user retrieval across time inefficient unless you already know all dates/stream names.

iOS uses a different convention (installationId + userId), so cross‑platform log retrieval is inconsistent.

Request

1. Align Android default log stream naming with iOS (installationId + userId).
2. Nice‑to‑have: allow a configurable log stream name or provider.

Thanks!

Initialization steps (if applicable)

No response

Code Snippet

// Put your code below this line.

Configuration File

No response

GraphQL Schema

Details

// Put your schema below this line

Additional information and screenshots

No response

[mattcreaser]

Thanks for opening the issue @NicolasBrandi. This is a good feature request and something we will look at.

[cadivus]

Hi @NicolasBrandi !
We released a new version with a change that adds a custom formatter (#3181). You can find the release details here.

The formatter can be used like this:

// Create custom log stream name formatter
val customFormatter = LogStreamNameFormatter { context ->
    val dateFormat = SimpleDateFormat("yyyy-MM-dd", Locale.US)
    val date = dateFormat.format(Date())
    val userId = context.userId ?: "anonymous"
    "cloudwatch-cognito-$date-${context.deviceId}-$userId"
}

// Add CloudWatch Logging plugin with custom formatter
Amplify.addPlugin(AWSCloudWatchLoggingPlugin(logStreamNameFormatter = customFormatter))

Using this, you can format it e.g. to align with iOS.

[github-actions]

This issue is now closed. Comments on closed issues are hard for our team to see.
If you need more assistance, please open a new issue that references this one.