-
Notifications
You must be signed in to change notification settings - Fork 206
[DOCS] Alert counts added to Explore pages #2576
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -1,16 +1,37 @@ | ||||||
| [[network-page-overview]] | ||||||
| = Network page | ||||||
|
|
||||||
| The Network view provides key network activity metrics in an interactive map | ||||||
| and provides network event tables that enable interaction with the Timeline. You | ||||||
| can drag and drop items of interest from the Network view to Timeline for | ||||||
| further investigation. | ||||||
| The Network page provides key network activity metrics in an interactive map, and network event tables that enable interaction with the Timeline. You can drag and drop items of interest from the Network view to Timeline for further investigation. | ||||||
|
|
||||||
| [role="screenshot"] | ||||||
| image::images/network-ui.png[] | ||||||
|
|
||||||
|
|
||||||
| [discrete] | ||||||
| [[map-ui]] | ||||||
| == Map | ||||||
|
|
||||||
| The map provides an interactive visual overview of your network traffic. Hover over source and destination points to show more information, such as host names and IP addresses. | ||||||
|
|
||||||
| NOTE: To access the interactive map, you need either `Read` or `All` privileges for `Maps` (*Kibana Privileges* -> *Analytics* -> *Maps*). To learn more about map setup, refer to <<conf-map-ui>>. | ||||||
|
|
||||||
| There are several ways to drill down: | ||||||
|
|
||||||
| * Click a point, hover over the host name or destination IP, then use the filter icon to add a field to the filter bar. | ||||||
| * Drag a field from the map to Timeline. | ||||||
| * Click a host name to go to the Hosts page. | ||||||
| * Click an IP address to open its details page. | ||||||
|
|
||||||
| You can start an investigation using the map, and the map refreshes to show related data when you run a query or update the time range. | ||||||
|
|
||||||
|
|
||||||
| TIP: To add and remove layers, click on the *Options* menu (*...*) in the top right | ||||||
| corner of the map. | ||||||
|
|
||||||
| [[map-widgets-tables]] | ||||||
| [discrete] | ||||||
| == Widgets and data tables* | ||||||
|
|
||||||
| Interactive widgets let you drill down for deeper insights: | ||||||
|
|
||||||
| * Network events | ||||||
|
|
@@ -21,40 +42,37 @@ Interactive widgets let you drill down for deeper insights: | |||||
|
|
||||||
| There are also tabs for viewing and investigating specific types of data: | ||||||
|
|
||||||
| * *Flows*: Source and destination IP addresses and countries | ||||||
| * *DNS*: DNS network queries | ||||||
| * *Flows*: Source and destination IP addresses and countries. | ||||||
| * *DNS*: DNS network queries. | ||||||
| * *HTTP*: Received HTTP requests (HTTP requests for applications using | ||||||
| {apm-app-ref}/apm-getting-started.html[Elastic APM] are monitored by default) | ||||||
| * *TLS*: Handshake details | ||||||
| * *Anomalies*: Anomalies discovered by <<machine-learning, machine learning jobs>> | ||||||
| {apm-app-ref}/apm-getting-started.html[Elastic APM] are monitored by default). | ||||||
| * *TLS*: Handshake details. | ||||||
| * *Anomalies*: Anomalies discovered by <<machine-learning, machine learning jobs>>. | ||||||
| * *Events*: All network events. To display <<det-engine-terminology, alerts>> received from external monitoring tools, scroll down to the Events table and select *Show only external alerts* on the right. | ||||||
|
|
||||||
| The Events table includes inline actions and several customization options. To learn more about what you can do with the data in these tables, refer to <<alerts-ui-manage>>. | ||||||
|
|
||||||
| [[ip-details-page]] | ||||||
| [discrete] | ||||||
| == IP details page | ||||||
|
|
||||||
| *IP detail pages* | ||||||
| An IP's details page shows related network information for the selected IP address. | ||||||
|
|
||||||
| An IP's detail page shows information for the selected IP address, including links | ||||||
| to external sites for verifying the IP address's reputation. By default, | ||||||
| the external sites are https://talosintelligence.com/[TALOS] and | ||||||
| https://www.virustotal.com/[VIRUSTOTAL]. <<ip-reputation-links>> describes how | ||||||
| to configure IP reputation links. | ||||||
| To view an IP's details page, click its IP address link from the Source IPs or Destination IPs table. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| To view an IP's detail page, select an IP address from the Source IPs or Destination IPs table. | ||||||
| The IP's details page includes the following sections: | ||||||
|
|
||||||
| [role="screenshot"] | ||||||
| image::images/IP-detail-pg.png[IP details page] | ||||||
| * *Summary*: General details such as the location, when the IP address was first and last seen, the associated host ID and host name, and links to external sites for verifying the IP address's reputation. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| + | ||||||
| NOTE: By default, the external sites are https://talosintelligence.com/[Talos] and | ||||||
| https://www.virustotal.com/[VirusTotal]. Refer to <<ip-reputation-links>> to learn how to configure IP reputation links. | ||||||
| + | ||||||
| * *Alert metrics*: The total number of alerts by severity, rule, and status (`Open`, `Acknowledged`, or `Closed`). | ||||||
| + | ||||||
| * *Data tables*: The same data tables as on the main Network page, except with values for the selected IP address instead of all IP addresses. | ||||||
|
|
||||||
|
|
||||||
| [discrete] | ||||||
| [[map-ui]] | ||||||
| == Map | ||||||
|
|
||||||
| The map provides a visual overview of your network traffic. It is interactive, so you can start exploring data directly from the map. Hover over source and destination points to observe more information, such as hostnames and IP addresses. | ||||||
| To drill down, click a point and use the filter icon to add a field to the filter bar or drag a field to Timeline. You can also click a hostname to jump to the Hosts page, or click an IP address to open the relevant network details. | ||||||
|
|
||||||
| Just as you can start an investigation using the map, the map refreshes to show relevant data when you run a query or update the time frame. | ||||||
| [role="screenshot"] | ||||||
| image::images/IP-detail-pg.png[IP details page] | ||||||
|
|
||||||
|
|
||||||
| TIP: To add and remove layers, click on the *Options* menu (*...*) in the top right | ||||||
| corner of the map. | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -1,29 +1,46 @@ | ||||||
| [[users-page]] | ||||||
| = Users page | ||||||
|
|
||||||
| The Users page provides a comprehensive overview of user data to help you understand authentication and user behavior within your environment. Key performance indicator (KPI) charts, data tables, and interactive widgets let you view specific data and drill down for deeper insights. Here's some of the information available to you: | ||||||
| The Users page provides a comprehensive overview of user data to help you understand authentication and user behavior within your environment. Key performance indicator (KPI) charts, data tables, and interactive widgets let you view specific data and drill down for deeper insights. | ||||||
|
|
||||||
| [role="screenshot"] | ||||||
| image::images/users/users-page.png[User's page] | ||||||
|
|
||||||
| *User KPI charts* | ||||||
| The Users page has the following sections: | ||||||
|
|
||||||
| [discrete] | ||||||
| == User KPI (key performance indicator) charts* | ||||||
|
|
||||||
| KPI charts show the total number of users and successful and failed user authentications within the time range specified in the date picker. Data in the KPI charts is visualized through linear and bar graphs. | ||||||
|
|
||||||
| TIP: Hover inside a KPI chart to display the actions menu (*...*), where you can perform these actions: inspect, open in Lens, and add to a new or existing case. | ||||||
| [role="screenshot"] | ||||||
| image::images/users/chart-menu.png[Chart menu] | ||||||
|
|
||||||
| *Data tables* | ||||||
| [discrete] | ||||||
| == Data tables | ||||||
|
|
||||||
| Beneath the KPI charts are data tables, which are useful for viewing and investigating specific types of data. Select the relevant tab to view the following details: | ||||||
|
|
||||||
| * *All users*: A chronological list of unique user names, when they were last active, and the associated domains. | ||||||
| * *Authentications*: A chronological list of user authentication events and associated details, such as the number of successes and failures, and the hostname of the last successful destination. | ||||||
| * *Authentications*: A chronological list of user authentication events and associated details, such as the number of successes and failures, and the host name of the last successful destination. | ||||||
| * *Anomalies*: Unusual activity discovered by machine learning jobs that contain user data. | ||||||
| * *Events*: Ingested events that contain the `user.name` field. You can stack by the `event.action`, `event.dataset`, or `event.module` field. To display <<det-engine-terminology, alerts>> received from external monitoring tools, scroll down to the Events table and select *Show only external alerts* on the right. | ||||||
| * *User risk*: Shows the user risk score and user risk classification of each user name. | ||||||
| + | ||||||
| NOTE: User risk score is a technical preview feature that must have the `riskyUsersEnabled` feature flag enabled to display. For more information, refer to <<user-risk-score>>. | ||||||
| * *User risk*: The latest recorded user risk score for each user, and its user risk classification. This feature requires a www.elastic.co/pricing[Platinum subscription] or higher and must be enabled to display the data. Click *Enable* on the *User risk* tab to get started. To learn more, refer to our <<user-risk-score, user risk score documentation>>. | ||||||
|
|
||||||
| The Events table includes inline actions and several customization options. To learn more about what you can do with the data in these tables, refer to <<alerts-ui-manage>>. | ||||||
|
|
||||||
| [discrete] | ||||||
| == User details page | ||||||
|
|
||||||
|
|
||||||
| A user's details page displays all relevant information for the selected user. To view a user's details page, click its *User name* link from the *All users* table. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| The user details page includes the following sections: | ||||||
|
|
||||||
| * *Summary*: Details such as the user ID, when the user was first and last seen, the associated IP address(es), and operating system. If the user risk score feature is enabled, this section also displays user risk score data. | ||||||
|
|
||||||
| * *Alert metrics*: The total number of alerts by severity, rule, and status (`Open`, `Acknowledged`, or `Closed`). | ||||||
|
|
||||||
| * *Data tables*: The same data tables as on the main Users page, except with values for the selected user instead of for all users. | ||||||
|
|
||||||
| [role="screenshot"] | ||||||
| image::images/users/user-details-pg.png[User details page] | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.