(aws-bedrock-agentcore-alpha): OnlineEvaluationConfig documents executionStatus default of ENABLED but applies none - config is created DISABLED
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 78/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- aws, typescript
- Domain
- cloud, infrastructure
Research direction
Start in the aws-bedrock-agentcore implementation at online-evaluation.js and inspect the executionStatus property alongside the OnlineEvaluationBaseProps JSDoc. Reproduce the issue by synthesizing an OnlineEvaluationConfig without executionStatus, then verify that the generated AWS::BedrockAgentCore::OnlineEvaluationConfig includes the documented ENABLED value. Done means the runtime behavior and @default documentation agree.
Written by the indexing model from the issue text.
Description
Describe the bug
OnlineEvaluationBaseProps.executionStatus is documented as defaulting to ExecutionStatus.ENABLED:
/**
* The execution status of the online evaluation configuration.
* Controls whether the evaluation actively processes agent traces.
* @default ExecutionStatus.ENABLED
*/
readonly executionStatus?: ExecutionStatus;
The implementation applies no default. From online-evaluation.js:
executionStatus: props.executionStatus?.value
Omitting the property therefore emits no ExecutionStatus at all into the synthesised template, and the service's own default applies. Because the JSDoc promises ENABLED but the resource is created disabled, an online evaluation set up with default props silently never processes a trace.
This is the same class of defect as #36376 (Runtime defaults idleRuntimeSessionTimeout to a non-documented value): a construct default that does not match its own documentation.
Regression Issue
- Select this option if this issue appears to be a regression.
Last Known Working CDK Library Version
No response
Expected Behavior
Either behaviour is defensible, but the JSDoc and the runtime behaviour must agree:
-
(Preferred) Apply the documented default in the L2 — emit
ExecutionStatus.ENABLEDwhenexecutionStatusis omitted. Matches the JSDoc and is the safer default for a monitoring feature. -
Or correct the JSDoc to state that the service decides the default and that the effective default is disabled.
Current Behavior
Omitting executionStatus emits no ExecutionStatus property. The configuration is created disabled: CloudFormation reports CREATE_COMPLETE, the resource exists, and the console shows Disabled. No trace is ever evaluated, and the failure is silent — an evaluation that never ran is indistinguishable from one that ran and found nothing.
Synthesised resource properties when executionStatus is omitted:
properties present: ['DataSourceConfig', 'Description',
'EvaluationExecutionRoleArn', 'Evaluators', 'OnlineEvaluationConfigName',
'Rule', 'Tags']
(ExecutionStatus absent.)
Reproduction Steps
Synth-only; no deployment required.
-
Use
aws-cdk-lib2.265.0 (also present on latest — please confirm on current when filing). -
Create an
OnlineEvaluationConfigwithoutexecutionStatus. -
Run
cdk synth. -
Inspect the
AWS::BedrockAgentCore::OnlineEvaluationConfigresource —ExecutionStatusis absent from its properties.
To confirm the resulting service-side state, deploy without the property and call:
aws bedrock-agentcore-control get-online-evaluation-config --online-evaluation-config-id <id>
Possible Solution
In the L2, apply the documented default when the property is omitted:
executionStatus: (props.executionStatus ?? agentcore.ExecutionStatus.ENABLED).value
Failing that, correct the @default JSDoc on executionStatus to reflect that the service default (disabled) applies.
Additional Information/Context
-
AWS's create-online-evaluation documentation describes the parameter controlling whether evaluation begins as required, so the L2 omitting it leaves the outcome to a service default. (Rephrased to avoid quoting docs verbatim.)
-
Related construct-default mismatch: #36376.
AWS CDK Library version (aws-cdk-lib)
2.265.0
AWS CDK CLI version
2.1136.0
Node.js Version
v22.12.0
OS
MacOS 26.6.2
Language
TypeScript
Language Version
TypeScript 5.9.3
Other information
-
Verified from source and synth output: the JSDoc
@default ENABLED, the missing default inonline-evaluation.js, and the absentExecutionStatusCloudFormation property. -
Inferred (from the console, not yet from an API response): that the effective service default is
DISABLED. Theget-online-evaluation-configcall above nails this down.
- Dominant language
- TypeScript
- Stars
- 12.9k
- Forks
- 4.6k
- Avg merge
- 2d 3h
- Merged PRs (30d)
- 71
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from aws/aws-cdk
-
@aws-cdk/aws-rds effort/small feature-request p2
Difficulty 1/5 Under an hour Newbie friendliness 90/100
-
@aws-cdk/aws-cloudwatch effort/medium feature-request p2
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
@aws-cdk/aws-s3-deployment bug p2
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
@aws-cdk/aws-lambda-nodejs effort/medium feature-request p2
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
documentation effort/small feature-request p2
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Similar issues
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 91/100
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100