Skip to content

alarm: tighten entity filter docs; drop orphan ui-configuration.graphqls#160

Closed
wu-sheng wants to merge 1 commit into
masterfrom
alarm-entity-relation-docs
Closed

alarm: tighten entity filter docs; drop orphan ui-configuration.graphqls#160
wu-sheng wants to merge 1 commit into
masterfrom
alarm-entity-relation-docs

Conversation

@wu-sheng

Copy link
Copy Markdown
Member

Summary

Two doc / cleanup items spotted during apache/skywalking#13877 review:

  • AlarmQueryCondition.entities: schema text said relation entities
    match whether the entity appears as source or dest, but the OAP DAO
    has always implemented an exact-ordered match
    (`id0 = sourceId AND id1 = destId`). Rewrite the entity comment to
    match the implemented semantics and point operators at the
    non-relation widening pattern. Non-relation matching (`id0 OR id1`)
    is unchanged and now documented explicitly.

  • ui-configuration.graphqls: `DashboardConfiguration` /
    `MenuItem` / template + menu Query/Mutation types are no longer
    loaded by `GraphQLQueryProvider` (apache/skywalking 11.0.0 moves UI
    template management to a REST surface on the admin host; menu
    management is removed entirely in favor of Horizon UI client-side
    gating). The file was left in the submodule but is unreachable from
    any resolver. Delete it.

Test plan

  • OAP boot: GraphQL schema validates with the file gone — no resolver references it (confirmed via grep across apache/skywalking).
  • Schema doc-only change for the entity filter — no resolver behavior changes.

🤖 Generated with Claude Code

* AlarmQueryCondition.entities — schema text said relation entities
  match whether the entity appears as source or dest, but the OAP DAO
  has always implemented exact-ordered match (id0=src AND id1=dest).
  Rewrite the entity comment to match the implemented semantics and
  point operators at the non-relation widening pattern. Non-relation
  matching (id0 OR id1) is unchanged and documented explicitly.

* ui-configuration.graphqls — DashboardConfiguration / MenuItem /
  template + menu Query/Mutation types are no longer loaded by
  GraphQLQueryProvider (apache/skywalking 11.0.0 moves UI template
  management to a REST surface on the admin host; menu management is
  removed entirely in favor of Horizon UI client-side gating). The
  file was left in the submodule but is unreachable from any
  resolver. Delete it.
@wu-sheng wu-sheng closed this May 18, 2026
@wu-sheng wu-sheng deleted the alarm-entity-relation-docs branch May 18, 2026 14:12
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