[Feature]: durable execution event hooks

[zhongkechen]

What would you like?

• onOperationStart, onOperationEnd fire at most once per operation.
• onInvocationStart, onInvocationEnd fire at most once per invocation
• onUserFunctionStart, onUserFunctionEnd fire when a user function is invoked

proposed design doc: https://github.com/aws/aws-durable-execution-sdk-js/blob/otel-instrumentation-design-v2/packages/aws-durable-execution-sdk-js/src/documents/PYTHON_SDK_OTEL_PLUGIN.md

Key Differences

There is a key difference in this implementation from JavaScript implementation

• Python calls onUserFunctionStart before a user function is called , while JS calls it when the user function is completed
• Python calls onOperationStart when an operation is started, while JS calls it when the operation is completed

Possible Implementation

Similar work in TypeScript SDK for reference:

• notes about plugin interface: https://github.com/aws/aws-durable-execution-sdk-js/blob/otel-instrumentation-design-v2/packages/aws-durable-execution-sdk-js/src/documents/PLUGIN_IMPLEMENTATION.md

• plugin interface: https://github.com/aws/aws-durable-execution-sdk-js/blob/otel-instrumentation-design-v2/packages/aws-durable-execution-sdk-js/src/types/plugin.ts

• To see how onOperationStart, onOperationEnd, onOperationAttemptStart, onOperationAttemptEnd are currently wired in the TS SDK, you'll have to check the branch. For example, onOperationStart.

• wiring of onExecutionStart, onInvocationStart, onExecutionEnd, onInvocationEnd: https://github.com/aws/aws-durable-execution-sdk-js/blob/otel-instrumentation-design-v2/packages/aws-durable-execution-sdk-js/src/with-durable-execution.ts

• how TS dash0 plugin (v1) deals with duplicate span creations: aws/aws-durable-execution-sdk-js@d75518f#diff-d172a83e0787d5e5a395b4167323ac0d2e24043acca5355467f50a5b7390b7d0

Is this a breaking change?

No

Does this require an RFC?

Yes

Additional Context

No response

[zhongkechen]

Moved logging interface to another issue: #385