Skip to content

Commit fe2924d

Browse files
authored
Merge branch 'main' into kibana-fips-140-3
2 parents f015342 + 6c866ec commit fe2924d

8 files changed

Lines changed: 177 additions & 106 deletions

File tree

explore-analyze/cases/control-case-access.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -108,14 +108,16 @@ Users must log in to their deployment at least once before they can be assigned
108108

109109
::::{applies-switch}
110110

111-
:::{applies-item} stack: ga
111+
:::{applies-item} { stack: ga 9.4+, serverless: ga }
112112

113-
* `All` for the **Cases** feature under the appropriate solution (**Security** or **{{observability}}**).
114-
* `Read` for a solution that has alerts (for example, **{{observability}}** or **Security**).
113+
* `All` for the **Cases** feature under the appropriate solution (**Security** or **{{observability}}**).
114+
* To work with alerts in cases:
115+
- **Security**: `Read` or `All` for the **Security > Alerts** feature. For what each level allows, refer to [Detections privileges](/solutions/security/detect-and-alert/detections-privileges.md#manage-alerts).
116+
- **{{observability}}**: `Read` for **{{observability}}**
115117

116118
:::
117119

118-
:::{applies-item} serverless: ga
120+
:::{applies-item} stack: ga 9.0-9.3
119121

120122
* `All` for the **Cases** feature under the appropriate solution (**Security** or **{{observability}}**).
121123
* `Read` for a solution that has alerts (for example, **{{observability}}** or **Security**).

explore-analyze/visualize/legacy-editors.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,20 @@ products:
1212

1313
Legacy editors are still available but have been replaced by better alternatives. Consider using one of the [modern editors](../visualize.md) offered in Elastic such as **Lens**.
1414

15-
:::{note}
16-
Legacy panel types only appear in the **Add panel** dashboard menu if you already have such panels in your dashboards. If you have never used these panel types, use Lens instead.
15+
::::{applies-switch}
16+
17+
:::{applies-item} { stack: ga 9.4+, serverless: ga }
18+
To create a legacy visualization, navigate to the **Dashboards** page, go to **Visualizations** > **Create visualization** > **Legacy**, then select **TSVB** or **Aggregation-based**. Consider using [Lens](../visualize.md) instead if you have never used these panel types.
19+
20+
:::
21+
22+
:::{applies-item} stack: ga 9.0-9.3
23+
To create a legacy visualization, click the {icon}`search` **Search** icon on the menu bar and search for **Visualize library**. Select **Create visualization** > **Legacy**, then select **TSVB** or **Aggregation-based**. Consider using [Lens](../visualize.md) instead if you have never used these panel types.
1724
:::
1825

26+
::::
27+
28+
1929
The legacy editors are:
2030

2131
- [Aggregation-based](legacy-editors/aggregation-based.md)

solutions/observability/apm/infrastructure.md

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ mapped_pages:
33
- https://www.elastic.co/guide/en/observability/current/apm-infrastructure.html
44
- https://www.elastic.co/guide/en/serverless/current/observability-apm-infrastructure.html
55
applies_to:
6-
stack: ga
7-
serverless: ga
6+
stack: beta
7+
serverless: beta
88
products:
99
- id: observability
1010
- id: apm
@@ -13,28 +13,36 @@ products:
1313

1414
# Infrastructure [observability-apm-infrastructure]
1515

16-
::::{important}
16+
The **Infrastructure** tab provides information about the containers, pods, and hosts that the selected service is linked to. The data sources and navigation behavior depend on whether the service is instrumented with [Elastic {{product.apm}}](#observability-apm-infrastructure-elastic-apm) or [OpenTelemetry (OTel)](#observability-apm-infrastructure-otel).
1717

18-
The Applications UI Infrastructure functionality is in beta and is subject to change. The design and code is less mature than official generally available features and is being provided as-is with no warranties.
18+
IT ops and software reliability engineers (SREs) can use this tab to quickly find a service’s underlying infrastructure resources when debugging a problem. Knowing what infrastructure is related to a service allows you to remediate issues by restarting, killing hanging instances, changing configuration, rolling back deployments, scaling up, scaling out, and so on.
19+
20+
::::{tip}
21+
**Why is the infrastructure tab empty?**
1922

23+
If there is no data in the Application UI’s infrastructure tab for a selected service, you can read more about why this happens and how to fix it in the [troubleshooting docs](/troubleshoot/observability/apm/common-problems.md#troubleshooting-apm-infra-data).
2024
::::
2125

22-
The **Infrastructure** tab provides information about the containers, pods, and hosts that the selected service is linked to.
26+
## Elastic {{product.apm}}-instrumented services [observability-apm-infrastructure-elastic-apm]
27+
28+
For services instrumented with Elastic {{product.apm}}, the tab uses the following data sources:
2329

24-
* **Pods**: Uses the `kubernetes.pod.name` from the [APM metrics data streams](/solutions/observability/apm/metrics.md).
25-
* **Containers**: Uses the `container.id` from the [APM metrics data streams](/solutions/observability/apm/metrics.md).
26-
* **Hosts**: If the application is containerized—if the APM metrics documents include `container.id`—the `host.name` is used from the infrastructure data streams (filtered by `container.id`). If not, `host.hostname` is used from the APM metrics data streams.
30+
* **Pods**: Uses the `kubernetes.pod.name` from the [{{product.apm}} metrics data streams](/solutions/observability/apm/metrics.md).
31+
* **Containers**: Uses the `container.id` from the [{{product.apm}} metrics data streams](/solutions/observability/apm/metrics.md).
32+
* **Hosts**: If the application is containerized—if the {{product.apm}} metrics documents include `container.id`—the `host.name` is used from the infrastructure data streams (filtered by `container.id`). If not, `host.hostname` is used from the {{product.apm}} metrics data streams.
2733

2834
:::{image} /solutions/images/serverless-infra.png
2935
:alt: Example view of the Infrastructure tab in the Applications UI
3036
:screenshot:
3137
:::
3238

33-
IT ops and software reliability engineers (SREs) can use this tab to quickly find a service’s underlying infrastructure resources when debugging a problem. Knowing what infrastructure is related to a service allows you to remediate issues by restarting, killing hanging instances, changing configuration, rolling back deployments, scaling up, scaling out, and so on.
39+
## OTel-instrumented services [observability-apm-infrastructure-otel]
40+
```{applies_to}
41+
stack: ga 9.4
42+
serverless: ga
43+
```
3444

35-
::::{tip}
36-
**Why is the infrastructure tab empty?**
37-
38-
If there is no data in the Application UI’s infrastructure tab for a selected service, you can read more about why this happens and how to fix it in the [troubleshooting docs](/troubleshoot/observability/apm/common-problems.md#troubleshooting-apm-infra-data).
45+
For services instrumented with OpenTelemetry, the tab exclusively shows OTel-observed infrastructure. Click-through destinations differ by resource type:
3946

40-
::::
47+
* **Hosts**: Links to the [**Hosts**](/solutions/observability/infra-and-hosts/analyze-compare-hosts.md) UI, which supports OpenTelemetry and its semantic conventions.
48+
* **Containers** and **Pods**: Link to [**Metrics** in Discover](/solutions/observability/infra-and-hosts/discover-metrics.md), as the Containers and Pods UIs do not yet support OTel semantic conventions.

solutions/security/advanced-entity-analytics/entity-risk-scoring-requirements.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ To install or run the risk scoring engine, you need the following:
3535
| --- | --- | --- | --- |
3636
| Install the risk engine | `manage_index_templates`<br> `manage_transform`<br> `manage_ingest_pipelines` | `All` for `risk-score.risk-score-*` | **Read** for the **Security** feature |
3737
| Run the risk engine | `manage_transform` | N/A | **Read** for the **Security** feature |
38+
| {applies_to}`stack: ga 9.4+` {applies_to}`serverless: ga` View alert risk contributions in entity details | N/A | N/A | **Read** for the **Security > Alerts** feature |
3839

3940

4041
### Predefined roles [ers_roles]

solutions/security/advanced-entity-analytics/privileged-user-monitoring-requirements.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,21 +24,31 @@ To use this feature, you need:
2424

2525
## Privileges [privmon_privs]
2626

27+
:::{table}
28+
:widths: 2-6-4
29+
2730
| Action | Index Privileges | Kibana Privileges |
2831
| ------ | ---------------- | ----------------- |
29-
| Enable the privileged user monitoring feature | N/A | **All** for the **Security** feature |
30-
| View the Privileged user monitoring dashboard | `Read` for the following indices:<br> - `.entity_analytics.monitoring.users-<space-id>`<br> - `risk-score.risk-score-*`<br> - `.alerts-security.alerts-<space-id>`<br> - `.ml-anomalies-shared`<br> - Security data view indices | **Read** for the **Security** feature |
32+
| Enable privileged user monitoring | N/A | **All** for the **Security** feature |
33+
| View Privileged user monitoring dashboard | `Read` for the following indices:<br> - `.entity_analytics.monitoring.users-<space-id>`<br> - `risk-score.risk-score-*`<br> - `.alerts-security.alerts-<space-id>`<br> - `.ml-anomalies-shared`<br> - Security data view indices | {applies_to}`stack: ga 9.4+` {applies_to}`serverless: ga` **Read** for the **Security** feature and at least **Read** for the **Alerts** feature to view detection alert data on the dashboard. <br><br>{applies_to}`stack: ga =9.3` **Read** for the **Security** feature |
34+
35+
:::
3136

3237
## Predefined roles [privmon_roles]
3338
```yaml {applies_to}
3439
serverless:
3540
```
3641
42+
:::{table}
43+
:widths: 4-8
44+
3745
| Action | Predefined role |
3846
| --- | --- |
3947
| Enable privileged user monitoring | - Platform engineer<br>- Admin |
4048
| View the Privileged user monitoring dashboard | - Tier 1 analyst<br>- Tier 2 analyst<br>- Tier 3 analyst<br>- Rule author<br>- SOC manager<br>- Platform engineer<br>- Detections admin<br>- Admin |
4149
50+
:::
51+
4252
## Known limitations
4353
4454
* Currently, none of the privileged user monitoring visualizations support [cross-cluster search](/explore-analyze/cross-cluster-search.md) as part of the data that they query from.

solutions/security/ai/attack-discovery.md

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,30 @@ To use Attack Discovery, your role needs specific privileges.
2626

2727
::::{applies-switch}
2828

29-
:::{applies-item} { "stack": "ga 9.3+", "serverless": "ga" }
29+
:::{applies-item} { "stack": "ga 9.4+", "serverless": "ga" }
3030

3131
Ensure your role has:
3232

33-
* `All` [{{kib}} privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md) for the **Security > Attack discovery** {{kib}} feature and at least `Read` privileges for the **Security > Rules** {{kib}} feature.
33+
* Minimum [{{kib}} privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md) for these **Security** features:
34+
35+
- `All` for **Attack discovery**
36+
- At least `Read` for **Rules**
37+
- At least `Read` for **Alerts**
38+
39+
* The appropriate [index privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md#adding_index_privileges), based on what you want to do with Attack Discovery alerts:
40+
41+
| Action | Indices | {{es}} privileges |
42+
|---------|---------|--------------------------|
43+
| Read Attack Discovery alerts | - `.alerts-security.attack.discovery.alerts-<space-id>`<br>- `.internal.alerts-security.attack.discovery.alerts-<space-id>`<br> - `.adhoc.alerts-security.attack.discovery.alerts-<space-id>`<br>- `.internal.adhoc.alerts-security.attack.discovery.alerts-<space-id>`| `read` and `view_index_metadata` |
44+
| Read and modify Attack Discovery alerts. This includes:<br>- Generating discovery alerts manually<br>- Generating discovery alerts using schedules<br>- Sharing manually created alerts with other users<br>- Updating a discovery's status |- `.alerts-security.attack.discovery.alerts-<space-id>`<br>- `.internal.alerts-security.attack.discovery.alerts-<space-id>`<br>- `.adhoc.alerts-security.attack.discovery.alerts-<space-id>`<br>- `.internal.adhoc.alerts-security.attack.discovery.alerts-<space-id>`| `read`, `view_index_metadata`, `write`, and `maintenance`|
45+
46+
:::
47+
48+
:::{applies-item} { "stack": "ga 9.3"}
49+
50+
Ensure your role has:
51+
52+
* `All` [{{kib}} privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md) for the **Security > Attack discovery** {{kib}} feature and at least `Read` privileges for the **Security > Rules, Alerts, and Exceptions** {{kib}} feature.
3453

3554
![attack-discovery-rules-rbac](/solutions/images/attack-discovery-rules-rbac.png "elasticsearch =60%x60%")
3655

@@ -49,7 +68,7 @@ Ensure your role has:
4968

5069
* `All` [{{kib}} privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md) for the **Security > Attack discovery** {{kib}} feature and at least `Read` privileges for the **Security > Rules, Alerts, and Exceptions** {{kib}} feature.
5170

52-
![attack-discovery-rbac](/solutions/images/security-attck-disc-rbac.png)
71+
![attack-discovery-rbac](/solutions/images/security-attck-disc-rbac.png "elasticsearch =60%x60%")
5372

5473
* The appropriate [index privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md#adding_index_privileges), based on what you want to do with Attack Discovery alerts:
5574

@@ -64,7 +83,7 @@ Ensure your role has:
6483

6584
Ensure your role has `All` [{{kib}} privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-role-management.md) for the **Security > Attack discovery** {{kib}} feature.
6685

67-
![attack-discovery-rbac](/solutions/images/security-attck-disc-rbac.png)
86+
![attack-discovery-rbac](/solutions/images/security-attck-disc-rbac.png "elasticsearch =60%x60%")
6887

6988
:::
7089

@@ -82,7 +101,8 @@ In {{stack}} 9.0.0, the **Run** button is called **Generate**.
82101

83102
::::{image} /solutions/images/security-attack-discovery-settings.png
84103
:alt: Attack Discovery's settings menu
85-
:width: 500px
104+
:screenshot:
105+
:width: 60%
86106
::::
87107

88108
You can select which alerts Attack Discovery will process by filtering based on a KQL query, the time and date selector, and the **Number of alerts** slider. Note that sending more alerts than your chosen LLM can handle may result in an error. Under **Alert summary** you can view a summary of the selected alerts grouped by various fields, and under **Alerts preview** you can see more details about the selected alerts.
@@ -115,6 +135,8 @@ You’ll need to select an LLM connector before you can analyze alerts. To get s
115135

116136
:::{image} /solutions/images/security-attck-disc-select-model-empty.png
117137
:alt: attck disc select model empty
138+
:screenshot:
139+
:width: 60%
118140
:::
119141

120142
3. Once you’ve selected a connector, do one of the following to start the analysis:
@@ -138,6 +160,8 @@ Each discovery includes the following information describing the potential threa
138160

139161
:::{image} /solutions/images/security-attck-disc-example-disc.png
140162
:alt: Attack Discovery detail view
163+
:screenshot:
164+
:width: 60%
141165
:::
142166

143167

@@ -153,6 +177,7 @@ There are several ways you can incorporate discoveries into your {{elastic-sec}}
153177

154178
:::{image} /solutions/images/security-add-discovery-to-assistant.gif
155179
:alt: Attack Discovery view in AI Assistant
180+
:width: 60%
156181
:::
157182

158183
## Schedule discoveries

0 commit comments

Comments
 (0)