IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Osquery Run Osquery from investigation guides »
Elastic Docs ›Elastic Security Solution [8.11] ›Osquery

Add Osquery Response Actions

edit

Add Osquery Response Actions

edit

This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.

Osquery Response Actions allow you to add live queries to custom query rules so you can automatically collect data on systems the rule is monitoring. Use this data to support your alert triage and investigation efforts.

Requirements

The Osquery response action

Add Osquery Response Actions to rules

edit

You can add Osquery Response Actions to new or existing custom query rules. Queries run every time the rule executes.

  1. Choose one of the following:

    • New rule: When you are on the last step of custom query rule creation, go to the Response Actions section and click the Osquery icon.

    • Existing rule: Edit the rule’s settings, then go to the Actions tab. In the tab, click the Osquery icon under the Response Actions section.

      If the rule’s investigation guide is using an Osquery query, you’ll be asked if you want to add the query as an Osquery Response Action. Click Add to add the investigation guide’s query to the rule’s Osquery Response Action.

  2. Specify whether you want to set up a single live query or a pack:

    • Query: Select a saved query or enter a new one. After you enter the query, you can expand the Advanced section to view or set mapped ECS fields included in the results from the live query. Mapping ECS fields is optional.

      You can use placeholder fields to dynamically add alert data to your query.

    • Pack: Select from available query packs. After you select a pack, all of the queries in the pack are displayed.

      Refer to prebuilt packs to learn about using and managing Elastic prebuilt packs.

      Shows how to set up a single query
  3. Click the Osquery icon to add more live queries (optional).
  4. Click Create & enable rule (for a new rule) or Save changes (for existing rules) to finish adding the queries.

Edit Osquery Response Actions

edit

If you want to choose a different query or query pack for the Osquery Response Action to use, edit the rule to update the Response Action.

If you edited a saved query or query pack that an Osquery Response Action is using, you must reselect the saved query or query pack on the related Osquery Response Action. Query changes are not automatically applied to Osquery Response Actions.

  1. Edit the rule’s settings, then go to the Actions tab.
  2. Modify the settings for Osquery Response Actions you’ve added.
  3. Click Save changes.

Find query results

edit

When a rule generates an alert, Osquery automatically collects data on the host. Query results are displayed within the Response tab in the left panel of the alert details flyout. The number next to the Response Results tab represents the number of queries attached to the rule, in addition to endpoint response actions run by the rule.

Refer to Examine Osquery results for more information about query results.

osquery results tab
« Osquery Run Osquery from investigation guides »