Visualize Query Results - Administrator Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM Administrator Guide

Product
Cortex XSIAM
Creation date
2024-05-06
Last date published
2024-07-17
Category
Administrator Guide
Abstract

Cortex XSIAM enables you to generate helpful visualizations of your XQL query results.

To help you better understand your Cortex Query Language (XQL) query results and share your insights with others, Cortex XSIAM enables you to generate visualizations of your query data directly from the XQL Search page.

  1. Select Incident ResponseInvestigationQuery BuilderXQL.

  2. Run an XQL query.

    For example, enter dataset = xdr_data | fields action_total_upload, _time | limit 10. The query returns the action_total_upload, a number field, and _time, a string field, for up to 10 results.

  3. In the Query Results section, to visualize the results either:

    1. Navigate to Query ResultsChart Editor (visualizing-query-results-chart-editor.png) to manually build and view the graph using the selected visualization parameters.

      • Main

        • Graph Type—Type of visualization; Area, Bubble, Column, Funnel, Gauge, Line, Map, Pie, Scatter, Single Value, or Word Cloud.

        • Subtype and Layout—Depending on the selected type of graph, choose from the available display options.

        • Header—Title your graph.

        • Show Callouts—Display numeric values on graph.

      • Data

        • X-axis—Select a field with a string value.

        • Y-axis—Select a field with a numeric value.

      • Depending on the selected type of graph, customize the Color, Font, and Legend.

    2. Enter the visualization parameters in the XQL query section.

      You can express any chart preferences in XQL. This is helpful when you want to save your chart preferences in a query and generate a chart every time that you run it. To define the parameters, either:

      • Manually enter the parameters, for example, view graph type = column subtype = grouped header = “Test 1” xaxis = _time yaxis = _product,action_total_upload.

      • Select ADD TO QUERY to insert your chart preferences into the query itself.

  4. (Optional) Create a custom widget.

    To easily track your query results, you can create custom widgets based on the query results in the Manage Your Widget Library. The custom widgets you create can be used in your custom dashboards and reports.

    Select Save to Widget Library to pivot to the Widget Library and generate a custom widget based on the query results.