Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -926,7 +926,7 @@ single-select hop limit and unlimited option. Without this declaration, a select
control. The schema validates the descriptor structure; Go managed declarations and responses also validate its
option IDs and role relationships. This metadata does not change Function request parsing or implement filtering.

The [topology contract](FUNCTION_TOPOLOGY_DEVELOPER_GUIDE.md#aggregate-first-focus) owns binding resolution,
The [topology contract](https://github.com/netdata/netdata/blob/master/src/plugins.d/FUNCTION_TOPOLOGY_DEVELOPER_GUIDE.md#aggregate-first-focus) owns binding resolution,
aggregate-first ordering and traversal semantics. Direct Agent clients keep sending the existing selectors; cloud
consumers must implement that contract before withholding focus controls from fan-out requests. Data response
metadata may refine the info response's choices and policy for the actual map returned.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -138,15 +138,15 @@ GET /api/v3/function?function=systemd-journal info after:1234567890 before:12345
- Common fields: `help`, `unique_view`, optional `value_separator` for an accepted joined-value encoding
- `options[]`: `id`, `name`, optional `defaultSelected`, `disabled`, `sort`, `aliases`
- Optional `focus` declares topology roots/depth controls; see
[Topology focus controls](FUNCTION_UI_DEVELOPER_GUIDE.md#topology-focus-controls).
[Topology focus controls](/docs/developer-and-contributor-corner/external-plugins/functions-developer-guide#topology-focus-controls).

When normalizing values against selector metadata, option IDs are opaque. Match an exact ID before considering
declared aliases or splitting a joined value; `beta rack,1` can be one ID, and `prod-a` differs from `prod_a`.
An alias advertised by several options is ambiguous and does not identify an option. These declarations describe
accepted producer input; they do not change parsing.
Go structured Function command arguments split commas before resolution regardless of this metadata. Use structured
JSON `selections` to preserve IDs containing commas.
See [Accepted option forms](FUNCTION_UI_DEVELOPER_GUIDE.md#accepted-option-forms).
See [Accepted option forms](/docs/developer-and-contributor-corner/external-plugins/functions-developer-guide#accepted-option-forms).

**Cloud-frontend UI notes (verified):**
- `type: "select"` renders as a **single-select**.
Expand Down
4 changes: 2 additions & 2 deletions ingest/generated_sidebar_order.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"schema_version": 1,
"source": "netdata/docs/.map/map.yaml",
"source_sha256": "46cf280e9a8e44e8f92480bfa2cf3e6e4df8f28ad96335cc16596d5892545555",
"source_corpus_sha256": "4c068712efd3b7e5a7fef212b58ae86be6b5d2ea678f55e6887a460d7769a128",
"source_corpus_sha256": "5bc522c2df71305b2c467980842abc37887d0d5320c0742c83f9ecb16b8cf107",
"order": [
{
"parent_path": "Alerts & Notifications",
Expand Down Expand Up @@ -1820,5 +1820,5 @@
"position": 190
}
],
"full_ingest_identity_sha256": "162bac744f2848f5eeee33fc976811efecb24141320866325690d46c27f34386"
"full_ingest_identity_sha256": "c08b994db2ab7d0eeea6a1cfef8ac65560680976ae97e61908cd49dcd6d6e1ae"
}
2 changes: 1 addition & 1 deletion ingest/generated_sidebar_order.json.sha256
Original file line number Diff line number Diff line change
@@ -1 +1 @@
b516c1e18904105ed8480c289cda50dc7c52c7ec8f65f3c8b18dfb28f68bd57c generated_sidebar_order.json
e8d69ff3fb9ef2a44cca72467667bf5fc455546c3a523da82c64051828d51556 generated_sidebar_order.json
Loading