Skip to content

docs: design ASAPPlanner-aligned collector plan interface - #558

Merged
zzylol merged 6 commits into
mainfrom
docs/point-query-mapping-to-asapplanner
Aug 27, 2026
Merged

zzylol merged 6 commits into
mainfrom
docs/point-query-mapping-to-asapplanner

Conversation

@zzylol

@zzylol zzylol commented Aug 27, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Redesign the ASAPQuery-backend control-plane → ASAPCollector interface around ASAPPlanner’s current post-ASAP definitions.

  • keep ASAPPlanner responsible for candidate logical DAGs and summary semantics;
  • place candidate selection, stage allocation, source binding, runtime windows, and transmission policy in the ASAPQuery-backend physical-planning layer;
  • compile one selected DAG into matching CollectorPlan and BackendPlan portions;
  • bind both portions with shared plan_id, plan_version, backend_compat, and materialization identities;
  • define a versioned YAML CollectorPlan carried by OpAMP protobuf rather than serializing Planner’s Rust DAG;
  • map SummaryAgg, SummaryFamilyType, typed algorithm parameters, Reduction, GroupingStrategy, and SummaryEstimate to runtime fields;
  • distinguish Reduction::PerEntity from an empty global reduction and preserve shared multi-subpopulation/Hydra grouping choices;
  • define source matchers, windows, placement, raw/full/delta transmission, validation, atomic activation, and fail-closed behavior;
  • define semantic application reports in addition to OpAMP RemoteConfigStatus; and
  • clearly separate the target contract from today’s complete-OTel-YAML/restart implementation.

This is the collector-side companion to ASAPQuery-backend PR #444’s compiled-plan collector/backend split design.

Validation

@zzylol zzylol changed the title docs: align OpAMP delivery with current plan ownership docs: define ASAPQuery-to-collector OpAMP interface Aug 27, 2026
zzylol and others added 4 commits August 27, 2026 14:24
…redesign

ASAPPlanner's post-ASAP IR (crates/types/src/post_asap) selects a
candidate logical DAG (SummaryAgg/summary family+algorithm+params/
Reduction/SummaryEstimate) and, per its own README "Scope" and
asap-aware-mapping/README.md "Non-Goals", explicitly does not choose
collector/backend placement, transport mode, or physical resources. Note
in Purpose that the ASAPQuery-backend control plane compiles that
selection - it does not serialize it directly - into this document's
collector configuration and a companion backend configuration sharing one
plan identity, and link ASAPQuery-backend PR #444's new
design-compiled-plan-collector-backend-split.md for that compile step.

Point the existing "Current contract gap" section (no plan_id/version/
activation/expiry/backend-compat on this wire) at that same design as the
proposed closing mechanism, without claiming any of it is implemented
here yet - the OpAMP envelope encoding for those fields is still an open
question in that design, to be resolved and documented in this file once
it lands.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Add a 'Proposed: align these fields with the post-ASAP DAG's own
vocabulary' subsection after the current field table and example,
linking ASAPQuery-backend's design-compiled-plan-collector-backend-
split.md §5. That design is checked against the real
asapedgeprocessor/config.go (mode is a bare per_series/whole_stream
string, aggregate_by has no GroupKeys.without equivalent, family has no
exact_kind or GroupingStrategy slot) and proposes renaming/extending
metrics[] to name every field directly from post_asap while keeping
Go's flat mapstructure-struct idiom - not a nested tagged union.

The existing field table and example are left as-is: they correctly
document what config.go implements today, and this addition does not
change that.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@zzylol zzylol changed the title docs: define ASAPQuery-to-collector OpAMP interface docs: design ASAPPlanner-aligned collector plan interface Aug 27, 2026
@zzylol
zzylol merged commit fe2bd08 into main Aug 27, 2026
@zzylol
zzylol deleted the docs/point-query-mapping-to-asapplanner branch August 27, 2026 21:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant