Repository navigation
refactor: rename Workflow Insight to Durable Execution Telemetry - #800
Merged
Merged
Conversation
Rename the insight-plugin module to telemetry-exporter, the artifactId to aws-durable-execution-sdk-java-plugin-telemetry-exporter and the Java package to software.amazon.lambda.durable.telemetry. Rename the public API, the recordType discriminator and the default resource names to match the JavaScript SDK (aws/aws-durable-execution-sdk-js#1019). Old names are no longer accepted.
Contributor
Codex AI reviewNo actionable findings in the 73 changed files. Renames and build references are consistent, and existing tests are preserved. Tests and release publishing were not executed under the read-only review constraints. Reviewed commit |
hln33
approved these changes
Oct 19, 2026
This was referenced Oct 19, 2026
2 tasks done
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
Issue Link, if available
Mirrors aws/aws-durable-execution-sdk-js#1019.
Description
Summary
This PR renames the Workflow Insight plugin to Durable Execution Telemetry, to match the JavaScript SDK (aws/aws-durable-execution-sdk-js#1019). The old names are not accepted after this change. There are no aliases and no fallback readers.
insight-plugintelemetry-exporteraws-durable-execution-sdk-java-plugin-insightaws-durable-execution-sdk-java-plugin-telemetry-exportersoftware.amazon.lambda.durablesoftware.amazon.lambda.durable.insightsoftware.amazon.lambda.durable.telemetry<name>)Source directories and files are moved with
git mv, so history follows the files.Breaking changes
WorkflowInsight.workflowInsight(...)is nowDurableExecutionTelemetry.durableExecutionTelemetry(...).WorkflowInsightConfigis nowDurableExecutionTelemetryConfig.WorkflowInsightRecordis nowDurableExecutionTelemetryRecord.InsightExporteris nowTelemetryExporter.WorkflowInsight.InsightPluginis nowDurableExecutionTelemetry.TelemetryPlugin.recordType: "WorkflowInsight"is now"DurableExecutionTelemetry", the same value the JS SDK writes. The explorers and the MCP server do not find records written before this change.workflow_insightis nowdurable_execution_telemetry.workflow-insightis nowdurable-execution-telemetry.workflow-insight/are nowdurable-execution-telemetry/.software.amazon.lambda.durable.insightis nowsoftware.amazon.lambda.durable.telemetry. See the note below.software.amazon.lambda.durable.insightis nowsoftware.amazon.lambda.durable.telemetry.[workflow-insight]is now[durable-execution-telemetry], andworkflow-insight-export-Nis nowdurable-execution-telemetry-export-N.INSIGHT_*orDURABLE_INSIGHT_*environment variables, so none change.Note on the EventBridge source: the JS SDK uses
aws.durable-execution.telemetry. The Java exporter deliberately avoids theaws.prefix, because EventBridge reserves that namespace for AWS services and rejects it inPutEvents. An existing test asserts this. So this PR keeps the Java convention and renames only the suffix.Release wiring
This repo has no per-module tag prefix or release-please component. Releases use a single
v*tag. These references move to the new module path and artifactId:pom.xml<modules>.build.ymlpath filters.maven_publish.sh-pllist.publish_maven.ymlGitHub release asset path.RELEASE.md.Commit scope:
insight(as infix(insight): ...) is nowtelemetry, as in the JS SDK.Not renamed
These names refer to other products or to the plain English word, so they are unchanged:
conformance-tests.ymlstep name anddocs/migration-1.x-to-2.x.md).After the change,
git grep -i insightmatches only the two Logs Insights lines.Testing
I ran these locally on macOS with Amazon Corretto 17 and 21, mirroring
build.ymlandcheck-spotless.yml:mvn -B -q spotless:check --file pom.xml(JDK 17): passes.mvn -B install --file pom.xml(JDK 17): BUILD SUCCESS for all 9 modules.CloudBasedIntegrationTest, which needs AWS credentials).mvn -B install --file pom.xml(JDK 21): BUILD SUCCESS.python3 .github/scripts/verify_otel_api_compatibility.py: passes.mvn -B -pl sdk -am javadoc:javadoc: passes.telemetry-exporter/target/aws-durable-execution-sdk-java-plugin-telemetry-exporter-2.2.2-SNAPSHOT.jar, the path thatpublish_maven.ymlnow uploads.I did not run JDK 25, the cloud conformance suites or the e2e suites locally, because they need the CI accounts.
Unit Tests
Existing tests are renamed and updated. They assert the new
recordType, the new default names and the new EventBridge source.Integration Tests
No new integration tests. This is a rename only.
Examples
No example uses the plugin.
Follow-ups outside this PR
aws-durable-execution-sdk-java-plugin-insightis not on Maven Central. search.maven.org and central.sonatype.com return no versions, and therepo1metadata returns 404. So there is no published artifact to deprecate or relocate. The next release publishes under the new artifactId. Check that the Sonatype Central Portal namespace accepts it and that the deployment is published.v2.2.1GitHub release hasaws-durable-execution-sdk-java-plugin-insight-2.2.1.jarattached. Leave it as is, or add a note to the release text.!and has noBREAKINGlabel, because the plugin is preview and was never published to Maven Central. Maintainers can add the label if they want the release check to require a major version bump.insight-plugin/will need a rebase.aws.durable-execution.telemetryuses the reservedaws.namespace. Confirm thatPutEventsaccepts it, or align both SDKs on a non-aws.source.