aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

feat(orchestration): admission backlog observability

Open
#440 1 comment 0 reactions 0 assignees View on GitHub
enhancement observability orchestration
Dominant language
TypeScript
Stars
143
Forks
46
Avg merge
3d 9h
Merged PRs (30d)
20

Description

**Context:** ROADMAP.md → Admission backlog observability
**Related:** admission-queue-deferred-pickup draft, #331 (closed)

---

## Component

API or orchestration

## Describe the feature

**CloudWatch metric and alarm** when `SUBMITTED` task depth exceeds an operator threshold—surfacing capacity and admission health before users see failures.

## Use case

Operators cannot distinguish healthy queueing from stuck hydration or admission starvation. Proactive metrics reduce incident time.

## Proposed solution

1. Scheduled or stream-derived gauge: count tasks in `SUBMITTED` per user/fleet.
2. Dashboard widget + alarm with configurable threshold.
3. Optional dimension: time-in-SUBMITTED p95.
4. Document runbook: scale concurrency, investigate hydrator, enable admission queue when shipped.

## Other information

- Pair with **admission queue** draft.
- Design context: `docs/design/OBSERVABILITY.md`, `docs/design/ORCHESTRATOR.md`.

- [ ] This might be a breaking change

Contributor guide

Open the contributing guide

Research direction

Start with ROADMAP.md and the design context in docs/design/OBSERVABILITY.md and docs/design/ORCHESTRATOR.md, then review the admission-queue-deferred-pickup draft and issue #331. Define the implementation scope for SUBMITTED-depth and optional time-in-SUBMITTED metrics, the dashboard and configurable alarm, and the operator runbook; completion should cover the agreed observability and documentation pieces.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, typescript
Domain
backend-api-design, cloud, observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.