23.1 Using Search Results to Create a Dashboard or Report

Each completed search has a unique Search Results ID, which represents a link to the temporary table containing the search results. You can copy that ID, then build a report or dashboard around the search results.

  • Build a Report Using Search Results

  • Build a Dashboard Using Search Results

  • Convert the Search Fields to Human-Readable Values

23.1.1 Build a Report Using Search Results

You can build a report around results of a previously run search by leveraging the Search Results ID.

  1. When viewing an Events table, select the Copy icon in the table’s header.

    This icon contains the Search Results ID.

  2. Select Reports > Report Designer.

  3. Select Create > Report.

  4. In the Select a data source field, paste the Search Results ID that you copied.

    The retention period of the temporary table in the database is 30 days.

  5. (Optional) Convert the fields in the temporary table to human-readable values.

  6. Continue creating the report.

23.1.2 Build a Dashboard Using Search Results

You can build a dashboard around results of a previously run search by leveraging the Search Results ID.

  1. When viewing an Events table, select the Copy icon in the table’s header.

    This icon contains the Search Results ID.

  2. Select Reports > Dashboard Designer.

  3. Select Create > New Dashboard.

  4. From the visual composer, select Data Source > Database > TABLE > Default_secops_recon.

  5. Select the ID of the search that you previously copied.

    The retention period of the temporary table in the database is 30 days.

  6. Select Open wizard or OK.

  7. (Optional) Convert the fields in the temporary table to human-readable values.

  8. Continue creating the dashboard where the Search Results ID is the data source.

23.1.3 Convert the Search Fields to Human-Readable Values

The ArcSight Database uses a temporary table to store content associated with a Search Results ID. Because the names of the fields in the table represent the coding-style name, you might want convert the terms to more user-friendly values.

To change the field names, your report or dashboard must use a Data Worksheet.

  1. Select Reports > Dashboard Designer.

  2. Open the dashboard or report that you want to modify.

  3. From the upper-right corner, select the Data icon.

  4. Open the worksheet.

  5. In the lower pane, select the Formula Editor icon.

    The tool-tip for this icon says “Create Expression.”

  6. Select SQL.

  7. In the Expression pane of the Formula Editor, add the following strings:

    Time: to_timestamp(field['normalizedEventTime']/1000)
    IP:  v6_ntoa(field['sourceAddressBin'])
    MAC:  mac_btoa(field['sourceMacAddressBin'])
  8. Select OK.

  9. In the lower pane of the worksheet, select the Change Data Mode icon.

  10. Select Live Event data.

  11. Hide the binary (original) fields.

  12. Export or Save the dashboard or report as needed.