Self-service search 编辑

What is self-service search?

The self-service search feature enables you to find and filter user events received from your data sources. You can explore the underlying user events and its attributes. These events help you to identify any data issues and troubleshoot them. The search page displays various facets (dimensions) and metrics for a data source. You can define your search query and apply filters to view the events that match your defined criteria. By default, the self-service search page displays user events for the last one day.

Currently, the self-service search feature is available for the following data sources:

• Authentication

• Content Collaboration

• Gateway

• Secure Browser

• Secure Private Access

• Apps and Desktops

• Performance Users, Machines, and Sessions

Also, you can perform self-service search on the events that met your defined policies. For more information, see Self-service search for Policies.

How to access self-service search

You can access the self-service search by using the following options:

• Top bar: Click Search from the top bar to view all user events for the selected data source.

• Risk timeline on a user profile page: Click Event Search to view the events for the respective user.

Self-service search from the top bar

Use this option to go to the self-service search page from any place in the user interface.

1. Click Search to view the self-service page.

   

2. Select the data source and the time period to view the corresponding events.

   

Self-service search from user’s risk timeline

Use this option if you want to view the user events associated with a risk indicator.

When you select a risk indicator from a user’s timeline, the risk indicator information section is displayed on the right pane. Click Event Search to explore the events associated to the user and the data source (for which the risk indicator is triggered) on the self-service search page.

For more information on the user risk timeline, see Risk timeline.

How to use self-service search

Use the following features on the self-service search page:

• Facets to filter your events.

• Search box to enter your query and filter events.

• Time selector to select the time period.

• Timeline details to view the event graphs.

• Event data to view the events.

• Export to CSV format to download your search events as a CSV file.

• Export visual summary to download the visual summary report of your search query.

• Multicolumn sorting to sort the events by multiple columns.

Use facets to filter events

Facets are the summary of data points that constitute an event. Facets vary depending on the data source. For example, the facets for the Secure Private Access data source are reputation, actions, location, and category group. Whereas the facets for Apps and Desktops are event type, domain, and platform.

Select the facets to filter your search results. The selected facets are displayed as chips.

For more information on the facets corresponding to each data source, see the self-service search article for the data source mentioned earlier in this article.

Use search query in the search box to filter events

When you place your cursor in the search box, the search box displays a list of dimensions based on the user events. These dimensions vary according to the data source. Use the dimensions and the valid operators to define your search criteria and search for the required events.

When you select a dimension and a valid operator, the values of the dimension are shown automatically. The list of values suggested for a dimension is either predefined (known values) in the data base or based on the historical events.

For example, the value of the Event-Type dimension is auto suggested. Whereas you need to manually enter the value of your Gateway-FQDN. For example, the values of the dimensions Browser, IP-Address, City, and Country are suggested based on the users’ historical events. Whereas the values suggested for the dimension Clipboard-Operations are predefined such as copy, cut, or paste.

You can choose a value from the suggested values or enter a new value depending on your requirements.

For example, in the self-service search for Apps and Desktops, you get the following values for the dimension Browser. Use the dimension to type your query, select the time period, and then click Search.

Supported operators in search query

Use the following operators in your search queries to refine your search results.

Note

For the NOT EQUAL operator, while entering the values for the dimensions in your query, use the exact values available on the self-service search page for a data source. The dimension values are case-sensitive.

For more information on how to specify your search query for the data source, see the self-service search article for the data source mentioned earlier in this article.

Select time to view event

Select a preset time or enter a custom time range and click Search to view the events.

View the timeline details

The timeline provides a graphical representation of user events for the selected time period. Move the selector bars to choose the time range and view the events corresponding to the selected time range.

The figure shows timeline details for access data.

View the event

You can view the detailed information about the user event. On the DATA table, click the arrow for each column to view the user event details.

The figure shows the details about the user’s access data.

Add or remove columns

You can either add or remove columns from the event table to display or hide the corresponding data points. Do the following:

1. Click Add or Remove Columns.

   

2. Select or deselect the data elements from the list and then click Update.

   

If you deselect a data point from the list, the corresponding column is removed from the event table. However, you can view that data point by expanding the event row for a user. For example, when you deselect the TIME data point from the list, the TIME column is removed from the event table. To view the time record, expand the event row for a user.

Export the events to a CSV file

Export the search results to a CSV file and save it for your reference. Click Export to CSV format to export the events and download the CSV file that is generated. You can export 100K rows using the Export to CSV format feature.

Export visual summary

You can download the visual summary report of your search query and share a copy with other users, administrators, or your executive team.

Click Export Visual Summary to download the visual summary report as a PDF. The report contains the following information:

• The search query that you have specified for the events for the selected time period.

• The facets (filters) that you have applied on the events for the selected time period.

• The visual summary such as the timeline charts, bar charts, or graphs of the search events for the selected time period.

For a data source, you can download the visual summary report only if the data is displayed in visual formats such as bar charts, timeline details. Otherwise, this option is not available. For example, you can download the visual summary report of the data sources such as Apps and Desktops, Sessions, where you see data as timeline details and bar charts. For the data sources such as Users and Machines, you see data only in tabular format. Therefore, you cannot download any visual summary report.

Multi-column sorting

Sorting helps to organize your data and provides better visibility. On the self-service search page, you can sort the user events by one or more columns. The columns represent the values of various data elements such as user name, date and time, and URL. These data elements vary based on the selected data sources.

To perform a multi-column sorting, do the following:

1. Click Sort By.

   

2. Select a column from the Sort By list.

3. Select the sorting order- ascending (up arrow) or descending (down arrow) to sort the events in the column.

4. Click + Add Columns.

5. Select another column from the Then By list.

6. Select the sorting order- ascending (up arrow) or descending (down error) to sort the events in the column.

   Note

   You can add up to six columns to perform the sorting.

7. Click Apply.

8. If you do not want to apply the preceding settings, click Cancel. To remove the values of the selected columns, click Clear All.

The following example shows a multi-column sort on the Secure Private Access events. The events are sorted by time (in latest to oldest order) and then by URL (in alphabetical order).

Alternatively, you can perform multi-column sorting by using the Shift key. Press the Shift key and click the column headers to sort the user events.

How to save the self-service search

As an administrator, you can save a self-service query. This feature saves the time and effort of rewriting the query that you use often for analysis or troubleshooting. The following options are saved with the query:

• Applied search filters
• Selected data source and duration

Do the following to save a self-service query:

1. Select the required data source and duration.

2. Type a query in the search bar.

3. Apply the required filters.

4. Click Save Search.

5. Specify the name to save the custom query.

   Note

   Ensure that the query name is unique. Otherwise, the query does not save.

6. Enable the Schedule email report button if you want to send a copy of the search query report to yourself and other users at a regular interval. For more information, see Schedule an email for a search query.

7. Click Save.

To view the saved searches:

1. Click View Saved Searches.

2. Click the name of the search query.

To remove a saved search:

1. Click View Saved Searches.

2. Select the search query that you have saved.

3. Click Remove saved search.

To modify a saved search:

1. Click View Saved Searches.

2. Click the name of the search query that you have saved.

3. Modify the search query or the facet selection based on your requirement.

4. Click Update Search > Save to update and save the modified search with the same search query name.

5. If you want to save the modified search with a new name, click the down arrow and click Save as new search > Save As.

If you replace the search with a new name, the search is saved as a new entry. If you retain the existing search name while replacing, then the modified search data overrides the existing search data.

Note

• Only a query owner can modify or remove their saved searches.
• You can copy the saved search link address to share with another user.

Schedule an email for a search query

You can send a copy of the search query report to yourself and other users on regular intervals by setting up an email delivery schedule.

This option is available only if your search query report contains data in visual formats such as bar charts, timeline details. Otherwise, you cannot schedule an email delivery. For example, you can schedule an email for the data sources such as Apps and Desktops, Sessions, where you see data as timeline details and bar charts. For the data sources such as Users and Machines, you see data only in tabular format. Therefore, you cannot schedule an email.

Schedule an email while saving a search query

While saving a search query, set up an email delivery schedule as follows:

1. On the Save Search dialog box, enable the Schedule email report button.

   

2. Enter or paste the email addresses of the recipients.

   Note

   Email groups are not supported.

3. Set the date and time for the email delivery.

4. Select the delivery frequency- daily, weekly, or monthly.

5. Click Save.

Schedule an email for an already saved search query

If you want to set up an email delivery schedule for a search query that you previously saved, do the following:

1. Click View Saved Searches.

2. Go to the search query that you have created. Click the Email this query icon.

   Note

   Only a query owner can schedule email delivery of their saved search query.

   

3. Enable the Schedule email report button.

4. Enter or paste the email addresses of the recipients.

   Note

   Email groups are not supported.

5. Set the date and time for the email delivery.

6. Select the delivery frequency- daily, weekly, or monthly.

7. Click Save.

Stop an email delivery schedule for a search query

1. Click View Saved Searches.

2. Go to the search query that you have created. Click the View email delivery schedule icon.

   Note

   Only a query owner can stop the email schedule of their saved search query.

   

3. Disable the Schedule email report button.

4. Click Save.

Email content

The recipients receive an email from “Citrix Cloud - Notifications donotreplynotifications@citrix.com” about the search query report. The report is attached as a PDF document. The email is sent at a regular interval defined by you in the Schedule email report settings.

The search query report contains the following information:

• The search query that you have specified for the events for the selected period.

• The facets (filters) that you have applied on the events.

• The visual summary such as the timeline charts, bar charts, or graphs of the search events.

Permissions for full access and read-only access administrators

• If you are a Citrix Cloud administrator with full access, you can use all the features available on the Search page.

• If you are a Citrix Cloud administrator with read-only access, you can only do the following activities on the Search page:

  • View the search results by selecting a data source and the time period.

  • Enter a search query and view the search results.

  • View the saved search results of other administrators.

  • Export the visual summary and download the search results as a CSV file.

For information about the administrator roles, see Manage administrator roles for Citrix Analytics.