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

Adds new page about triaging alerts with AI Assistant #4359

Merged
merged 32 commits into from
Jan 4, 2024
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
ef7ef87
Adds new page about triaging alerts with AI Assistant
benironside Dec 1, 2023
407a27d
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 4, 2023
0fd7625
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 6, 2023
084a1cf
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 8, 2023
cf97a32
troubleshoots ToC
benironside Dec 8, 2023
c5ba5e6
Merge branch '4358-Alert-triage-page' of https://github.com/elastic/s…
benironside Dec 8, 2023
d694f96
troubleshoots build error
benironside Dec 8, 2023
db015b2
updates section title
benironside Dec 8, 2023
e14e938
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
62a6db5
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
b8ae6d1
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
97de8bf
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
bf618c3
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
b787953
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
e4c4d86
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
25eb2d3
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
98eb02f
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 13, 2023
7818049
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 13, 2023
40b2488
Incorporates rest of Nastasha's feedback
benironside Dec 13, 2023
5816d21
Merge branch '4358-Alert-triage-page' of https://github.com/elastic/s…
benironside Dec 13, 2023
bf3986c
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 21, 2023
2208378
save work
benironside Dec 21, 2023
7380eec
updates triage page with RAG for alerts info
benironside Dec 21, 2023
84089f6
fixes anchor tag
benironside Dec 21, 2023
6851f03
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 28, 2023
d18e34b
Update docs/assistant/ai-alert-triage.asciidoc
benironside Dec 28, 2023
35f1ccb
Merge branch 'main' into 4358-Alert-triage-page
benironside Dec 29, 2023
afee6bd
Merge branch 'main' into 4358-Alert-triage-page
benironside Jan 3, 2024
407df3a
Update docs/assistant/ai-alert-triage.asciidoc
benironside Jan 3, 2024
1c3c93a
Update docs/assistant/ai-alert-triage.asciidoc
benironside Jan 3, 2024
7dbf3e4
Merge branch 'main' into 4358-Alert-triage-page
benironside Jan 3, 2024
92db498
Merge branch 'main' into 4358-Alert-triage-page
benironside Jan 4, 2024
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
28 changes: 28 additions & 0 deletions docs/assistant/ai-alert-triage.asciidoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
[[assistant-triage]]
= Triage Alerts with Elastic AI Assistant
benironside marked this conversation as resolved.
Show resolved Hide resolved
Elastic AI Assistant can help you enhance and streamline your alert triage workflows.
benironside marked this conversation as resolved.
Show resolved Hide resolved

AI Assistant can help you interpret an alert and understand its context. When you view an alert in {elastic-sec}, details such as related documents, host, and users appear alongside a synopsis of the events that triggered the alert. This data provides a starting point for understanding a potential threat. AI Assistant can answer questions about this data and offer insights and actionable recommendations to remediate the issue.
benironside marked this conversation as resolved.
Show resolved Hide resolved

[discrete]
benironside marked this conversation as resolved.
Show resolved Hide resolved
== Use AI Assistant to triage an alert
. First, choose an alert to investigate. Click **View details**.
benironside marked this conversation as resolved.
Show resolved Hide resolved
. On the details flyout, click **Chat** to launch the AI assistant.
benironside marked this conversation as resolved.
Show resolved Hide resolved
. Data related to the selected alert is automatically added to the prompt. Click **Alert (from summary)** to view which alert fields will be shared with AI Assistant. (For more information about selecting which fields to send, and to learn about anonymizing your data, refer to <<security-assistant, AI Assistant>>.)
benironside marked this conversation as resolved.
Show resolved Hide resolved
. You can click a quick prompt to use it as a starting point for your query, for example **Alert summarization**. You can improve the quality of AI Assistant's response by customizing the prompt and adding detail.
benironside marked this conversation as resolved.
Show resolved Hide resolved
. Once you’ve submitted your query, the AI Assistant will process the information and provide a detailed response. Depending on your prompt and which alert data you included, its response can include a thorough analysis of the alert that highlights key elements such as the nature of the potential threat, potential impact, and suggested response actions.
benironside marked this conversation as resolved.
Show resolved Hide resolved
. Remember, the response is not a static report; you can ask follow-up questions, provide additional information for further analysis, and request clarification.
benironside marked this conversation as resolved.
Show resolved Hide resolved

[discrete]
[[ai-triage-reportgen]]
== Generate triage reports
Elastic AI Assistant can streamline the process of documentation and report generation, helping you provide stakeholders clear records of security incidents, including their scope and impact, and your remediation efforts. You can use AI Assistant to create summaries or reports that include key event details, findings, and diagrams. Once the AI Assistant has finished analyzing one or more alerts, you can generate reports by using prompts such as:
benironside marked this conversation as resolved.
Show resolved Hide resolved

* “Generate a detailed report about this incident including timeline, impact analysis, and response actions. Also, include a diagram of events.”
* “Generate a summary of this incident/alert and include diagrams of events.”
* “Provide more details on the mitigation strategies used.”

After reviewing the report, you can add it to a case to keep a record and make it available to your team by clicking **Add to existing case** at the top of AI Assistant's response:
benironside marked this conversation as resolved.
Show resolved Hide resolved

[role="screenshot"]
image::images/ai-triage-add-to-case.png[An AI Assistant dialogue with the add to existing case button highlighted]
Binary file added docs/assistant/images/ai-triage-add-to-case.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 3 additions & 1 deletion docs/assistant/security-assistant.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
[[security-assistant]]
[chapter]
= AI Assistant

:frontmatter-description: The Elastic AI Assistant is a generative AI open-code chat assistant.
Expand Down Expand Up @@ -191,3 +190,6 @@ In addition to practical advice, AI Assistant can offer conceptual advice, tips,

* “How do I set up a {ml} job in {elastic-sec} to detect anomalies in network traffic volume over time?”
* “I need to monitor for unusual file creation patterns that could indicate ransomware activity. How would I construct this query using EQL?”


include::ai-alert-triage.asciidoc[leveloffset=+1]