Skip to main content

HelloID

Explore available audit log data

Audit logs support a variety of data fields collected from HelloID. Follow these instructions to explore the available data fields, which you can use to Create a custom report or troubleshoot an issue.

Open audit logs in Discover mode
  1. Go to Insights > Elastic Reports.

  2. Click Report Management.

    2022-08-19_14-42-16.jpg
  3. You are redirected to Elastic.

  4. Select a custom report space that you created previously.

    For this example, Marketing.

    2022-11-28_14-53-19.jpg
  5. Expand the left-hand menu and click Discover.

    2022-08-22_13-34-15.jpg
    2022-08-22_14-46-04.jpg
  6. Click the calendar icon in the top-right corner. Increase the data range.

    We'll change it to Last 1 year.

    2022-08-22_14-48-39.jpg

    The date range chart at the top visualizes the number of logs per month/week/day/etc.

  7. Optional: Click the Change Index Pattern dropdown to change the HelloID module (Access Management ("authentication"), Provisioning, Service Automation, or General).

    2022-08-22_14-57-29.jpg

    The Available Fields list is updated accordingly.

    2022-08-22_14-51-00.jpg

    Tip

    You can switch spaces using the menu at the top left. However, you can only create reports in a custom space.

    Elastic_Menu_Spaces_small.png
  8. You can now Filter data, Organize the data overview and use any of this data when you Create a custom report or troubleshoot an issue.

Tip

For an explanation of all options in Discover mode, see Explore fields and data with Discover on Elastic's website.

Filter data

The following are some ways to narrow a data selection.

Zoom in on a date range/time slot

Click and drag the mouse over a part of the date range chart to zoom in on it.

Elastic_ZoomDateRange.png
Search by index name

An Elasticsearch index is like a container that stores related documents, where each document is a collection of fields containing your data. Every index has its own name, which you can use use when running searches.

For a list of index names used in HelloID data, see Audit log data reference.

  1. Click the + icon to add a filter.

    Elastic_Filter.png
  2. From the field dropdown, select _index. For the operator, select is. In the value field, paste the index name, and press Enter. Then click the Add Filter button.

    Elastic_Details_AddFilter.png
  3. Many main indexes are organized into sub-indexes to provide more granular access to specific event types.

    To find the sub-index of an entry:

    1. Click the toggle button to the left of an entry.

      Elastic_Document_ExpandButton.png
    2. In the details, look for the _index field.

      Elastic_SubIndex_Higlight.png

You can use the sub-index to Filter by value.

Filter by value

To find entries in which a field has a certain value you could add a filter as demonstrated in Search by index name, or use one of the following, quicker ways.

  • Click the toggle button to the left of an entry to open its details in a dialog at the right.

    Elastic_Document_ExpandButton.png

    In the details dialog, find a field and hover over its value. Click the + icon to filter documents in which the field has that value. Or, click the - icon to filter documents in which the field does not have that value.

    Elastic_Details_Value.png
  • Click one of the Available fields at the left. In the list of values, click the + icon to show entries with that value or - to show entries without it.

    Elastic_Filter_fromfield.png

    Tip

    Some useful fields for filtering user action logs in the Provisioning module are context, action and area. For a list of possible values, see Audit log data reference.

Enter a query
  • Enter a simple string in the query bar to search across all fields in the current data set. Use an asterisk (*) as a wildcard.

    Elastic_Search.png
  • Click the Search field to expand it.

    2022-08-22_15-00-48.jpg

    Use the Kibana Query Language (KQL) syntax to create a query, and then select the Refresh button. For example, the query userName.keyword : * returns the following:

    2022-08-22_15-01-30.jpg
Organize the data overview

For a better overview, you can add and reorder columns in the data overview.

Add columns

Hover over one of the Available fields and click the + icon to add it as a column.

Elastic_Fields_AddAsColumn.png

Alternatively:

  1. Open the details dialog for any of the documents.

    Elastic_Document_ExpandButton.png
  2. Hover over the field in the details dialog and click the + icon.

    Elastic_Details_AddColumn.png
Reorder columns

Click Columns and drag the items to change the order of columns in the overview.

Elastic_ManageColumns.png