Run Osquery from alerts

Run live queries against an alert's host to investigate potential security threats and system compromises.

Run live queries on hosts associated with alerts to learn more about your infrastructure and operating systems. For example, with Osquery, you can search your system for indicators of compromise that might have contributed to the alert. You can then use this data to inform your investigation and alert triage efforts.

Requirements

To run Osquery from an alert:

  1. Do one of the following from the Alerts table:

    • Click the View details button to open the Alert details flyout, then click Take action → Run Osquery.
    • Select the More actions menu (), then select Run Osquery.
  2. Choose to run a single query or a query pack.

  3. Select one or more Elastic Agents or groups to query. Start typing in the search field to get suggestions for Elastic Agents by name, ID, platform, and policy.

    Note

    The host associated with the alert is automatically selected. You can specify additional hosts to query.

  4. Specify the query or pack to run:

    • Query: Select a saved query or enter a new one in the text box. After you enter the query, you can expand the Advanced section to set a timeout period for the query, and view or set mapped ECS fields included in the results from the live query (optional).

      Note

      Overwriting the query's default timeout period allows you to support queries that take longer to run. The default and minimum supported value for the Timeout field is 60. The maximum supported value is 900.

      Tip

      Use placeholder fields to dynamically add existing 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.

      Tip

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

  5. Click Submit. Query results will display within the flyout.

    Note

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

  6. Click Save for later to save the query for future use (optional).

On this page