Skip to content
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

[UX] Log type categories #736

Closed
xeniatup opened this issue Oct 3, 2023 · 0 comments
Closed

[UX] Log type categories #736

xeniatup opened this issue Oct 3, 2023 · 0 comments
Labels
enhancement New feature or request

Comments

@xeniatup
Copy link

xeniatup commented Oct 3, 2023

Security Analytics plugin comes with a flat list of “Standard” log types that include about a dozen items. Starting from 2.10 release users can add Custom log types with unique names in the same list to be able to configure custom detection rules. Out of the box dashboards and detection rules are available for Standard (pre-packaged) log types.

Screenshot 2023-09-27 at 9 53 11 AM

Problem:

  • With introducing new Standard log types (WAF, Crowdstrike) and any number of Custom log types users can define, we’re facing a problem of potentially large numbers of log types.
  • User might not know what to search for in the flat unstructured list. There is no grouping of log types.
  • The names of Custom (user-defined) log types might be not informative. High chances of almost identical names.
  • [Create detector page] It is hard to figure out at a glance what types of application logs are supported.

Proposed solution: Built-in categories for log types

We propose to introduce categorization by grouping log types into logical buckets based on the type of service or application produced the log.
This should help with finding specific log types faster and more confidently in the experiences like “Create detector”. Selecting multiple log types of a similar origin will be simplified as they will be grouped together.
The categories will help to handle potential increase in the number of log types. Custom (user-defined) log types can be added to any of the categories.

The proposed category structure is described in this issue.

User Experience

Detectors pages

Detectors list page:

  • Log type column in “Detectors” list page is updated with combined log type including a respective category:[Category: Log type]
  • A log type filter is updated to allow for searching and selecting both log types and categories. See more below in “Correlations”.
    Screenshot 2023-09-27 at 7 54 26 AM

Create detector page:

  • The log type single select field shows log types grouped into categories.
  • User can search for a log type.
  • The categories headers are searchable to help navigate the list (requires customization)
    OUI: Single selection combo box with groups
Screenshot 2023-09-27 at 2 11 56 PM

Log types pages

Log types list:

  • A new column for “Category” is added to the log types list view.
  • A new filter for Category is added to the table. By default all categories are selected.
Screenshot 2023-09-27 at 2 11 08 PM

Create log type:

  • A new select field is added to “Create log type page” to help identify the right category for a new custom log type. Each category is equipped by description.

OUI: Select field with super select dropdown.

Screenshot 2023-09-27 at 2 10 33 PM

Detection rules pages

Detection rules list:

  • Log type column in “Detection rules” list view is updated with combined log type including a respective category:[Category: Log type]
  • A log type filter is updated to allow for searching and selecting log types and categories. See more below in “Correlations”
Screenshot 2023-09-27 at 7 14 40 AM

Create detection rule:

  • Similar to “Create detector” page, on “Create detection rule” page the “Log type” select field is updated to allow a single selection of a log type with added grouping of the options into categories within the dropdown menu.
  • User can search for a log type.
  • The categories headers are searchable to help navigate the list (requires customization)

OUI: Single selection combo box with groups
Screenshot 2023-09-27 at 7 24 20 AM

Correlations pages

Correlations (graph):
On the Correlations (graph) page the “Log type” search bar filter is updated as follows:

  • Add "clearable" or "dismissible" prop that injects a (x) clear icon to clear out the filters.
  • The drop down menu supports grouped log types.
  • Introduce an option to allow the group label to select/unselect all children in a group
  • Add Select all/Deselect all CTAs in the popover footer.

OUI: Selectable searchable + option.isGroupLabel is true, button group (for select/deselect all).

Note: the same filtering experience is added to the search bar on “Correlation rules” list page, “Findings” list page", and "Detection rules" list page.

Screenshot 2023-09-27 at 7 29 49 AM

Correlation rules:

  • On the “Correlation rules” list page the “Log types” column is updated to show each log type with its respective category: [Category: Log type]
  • The search bar filter for “Log type” is updated similar to “Correlations” [graph] filter experience (see above) to allow selecting log types and log categories.
Screenshot 2023-09-27 at 2 51 47 PM

Create correlation rule:

  • Similar to “Create detector” and “Create detection rule” pages the “Log type” select field is updated for each of the queries on “Create correlation rule” page.
  • User can search for a log type.
  • The categories headers are searchable to help navigate the list (requires customization)

OUI: Single selection combo box with groups
Screenshot 2023-09-27 at 7 26 28 AM

Other pages

For other existing or potential views displaying log type in a table cell (like Overview page, Finding page, Finding details side panel) use the plain text [Category: Log type].

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants