Skip to content

Commit b250c9e

Browse files
[Streams] Add section on managed assets (#3679)
This PR closes #3624 and adds section on managed Streams assets. --------- Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>
1 parent b65dfff commit b250c9e

File tree

2 files changed

+11
-6
lines changed

2 files changed

+11
-6
lines changed

solutions/observability/streams/management/advanced.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,19 +26,19 @@ Features provide useful information for AI processes, such as significant events
2626

2727
## Index configuration [streams-advanced-index-config]
2828

29-
:::{note}
30-
Processing and schema changes should typically be done through the Streams interface, and none of these configuration processes are required. This feature mainly exists to help advanced users maintain familiar workflows.
29+
:::{Important}
30+
Avoid editing components marked as **managed** or any per-data-stream mappings and settings. Processing and schema changes should typically be done through the Streams interface or API, and none of these configuration processes are required. This feature mainly exists to help advanced users maintain familiar workflows.
3131
:::
3232

33-
For classic streams, you can manually configure:
33+
For classic streams, you can access the following components:
3434

3535
- [Index templates](../../../../manage-data/data-store/templates.md#index-templates)
3636
- [Component templates](../../../../manage-data/data-store/templates.md#component-templates)
3737
- [Pipelines](../../../../manage-data/ingest/transform-enrich.md)
38-
- [Data streams](../../../../manage-data/data-store/data-streams.md).
38+
- [Data streams](../../../../manage-data/data-store/data-streams.md)
3939

40-
For both wired ({applies_to}`stack: preview 9.2`) and classic streams, you can manually configure:
40+
For both wired ({applies_to}`stack: preview 9.2` {applies_to}`serverless: preview`) and classic streams, you can manually configure:
4141

4242
- **Shards:** Control how the index is split across nodes. More shards can improve parallelism but may increase overhead.
4343
- **Replicas:** Define how many copies of the data exist. More replicas improve resilience and read performance but increase storage usage.
44-
- **Refresh interval:** Control how frequently new data becomes visible for search. A longer interval reduces resource usage; a short one makes data searchable sooner.
44+
- **Refresh interval:** Control how frequently new data becomes visible for search. A longer interval reduces resource usage; a short one makes data searchable sooner.

solutions/observability/streams/streams.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,11 @@ Wired streams:
3737

3838
For more information, refer to [sending data to wired streams](./wired-streams.md).
3939

40+
## Managed components
41+
When you configure classic or wired streams through the Streams UI or [Streams API](#streams-api), {{es}}-level components like templates and pipelines are created for the stream. These components are considered *managed* and shouldn't be modified using {{es}} APIs. When managing a stream through the Streams UI or API, continue doing so whenever possible.
42+
43+
You can still edit non-managed ingest pipelines, templates, and other components, but avoid those marked as managed or any per-data-stream mappings and settings. This behavior is similar to how Elasticsearch handles components managed by integrations. Refer to the [**Advanced** tab](./management/advanced.md) to review managed components.
44+
4045
## Required permissions
4146

4247
Streams requires the following permissions:

0 commit comments

Comments
 (0)