Getting Started

Orbita Insights is an analytics module that provides engagement analytics for conversational experiences. The goal of Orbita Insights is to provide organizations insight into the metrics that matter for their application.

Using Orbita Insights, you can easily perform advanced data analysis and visualize your data in a variety of charts, tables, and maps. Orbita Insights makes it easy to understand large volumes of data and quickly create and share dynamic dashboards that display changes in real-time.

From the navigation pane, you will be able to choose the below options.

Orbita Insights can be accessed only by the users with the Insights permissions in the Global menu > Permission settings, in the Experience Manager.

Log into Experience Manager.
Select a project.
Select Insights from the left-hand side menu bar.
Enter the login credentials on the Orbita Insights login page.
Note: The session timeout period for Orbita Insights is 30 minutes. Post 30 minutes of inactivity, the user must log in to continue using Orbita Insights.
Upon login, the landing page will be the Voice Agent Dashboard of the project for which the Analytics data is queried for.

You can see the side menu icons Discover, Visualize, Dashboard, Management each elaborated in the below sections.

Discover

You can interactively explore your data from the Discover page. You have access to all documents in every index that matches the selected index pattern. You can submit search queries, filter the search results, and view document data. You can also see the number of documents that match the search query and get field value statistics. If a time field is configured for the selected index pattern, the distribution of documents over time is displayed in a histogram at the top of the page.

Query Search bar

Search bar

You can search for the indices that match the current index pattern by entering your search criteria in the Query bar.

When you submit a search request, the Histogram, Documents table, and Fields list will be updated to reflect the search results. The total number of hits (matching documents) is shown in the toolbar.

The Documents table shows the first 500 hits. By default, the hits are listed in reverse chronological order, with the newest documents shown first. You can reverse the sort order by clicking the Time column header. You can also sort the table by the values in any indexed field.

Options

Options in the search bar will let you create your queries. Just start typing and you’ll see matches related to your data. Please note that this functionality is experimental. Toggle the “Turn on query features” to turn on/off the autocomplete feature.

Filtering by field

You can filter the search results to display only those documents that contain a particular value in a field. You can also create negative filters that exclude documents that contain the specified field value.

You can add field filters from the Fields list, the Documents table, or by manually adding a filter. In addition to creating positive and negative filters, the Documents table enables you to filter whether a field is present or not.

The applied filters are shown below the Query bar.

To add a filter from the Fields list

Click the name of the field you want to filter. Each field displayed in the selected fields section will show the top five values for that field.
To add a positive filter, click Positive Filter. This includes only those documents that contain that value in the field.
To add a negative filter, click Negative Filter. This excludes documents that contain that value in the field.

To add a filter from the Documents table

Expand a document in the Documents table by clicking Expand to the left of the document’s table entry.
To add a positive filter, click Positive Filter to the right of the field name. This includes only documents that contain that value in the field.
To add a negative filter, click Negative Filter to the right of the field name. This excludes documents that contain that value in the field.
Toggle (display/not display) the field column in the document table.
To filter on whether or not documents contain the field, click Exists to the right of the field name. This includes only those documents that contain the field.

To manually add a filter

Click Add a filter. A popup is displayed for you to create the filter.
Select a field to filter from the dropdown. This list of fields includes fields from the index pattern you selected.
Choose an operation for your filter. You will see the Value field if you choose is, is not, is one of, is not one of operators.
Choose the values for your filter.
Toggle the create a custom label for your filter. If you specify a label, it is displayed below the query bar.
Click Save. The filter will be applied to your search and be displayed below the query bar.

Managing a filter

Click on the filter to get the action dropdown menu.

Pin across all apps

Pinned filters persist when you switch contexts in Orbita Insights.
For example, you can pin a filter on the Discover page, and it remains in place when you switch to the Visualize page. Note that a filter is based on a particular index field—if the indices being searched don’t contain the field in a pinned filter, it has no effect.

Edit Filter

This enables you to modify the filter definition.

You can edit a filter by changing the field, operator, or value associated with the filter (see the Add Filter section above), or by directly modifying the filter query (Edit as Query DSL). The Edit Query DSL will let you create more complex filters with multiple fields and conditions.

To edit the filter query, click Edit as Query DSL.
You can then edit the filter query.

Exclude results

From all the documents, the filtered results will be excluded i.e; switching the filter from positive to negative. You will now see an option to Include results that will do just the opposite.

Temporarily disable

Disable the filter without removing it. Click again to re-enable the filter.

Delete

Removes the filter.

Document Table

When you submit a search query, the 500 most recent documents that match the query are listed in the Documents table. You can configure the number of documents shown in the table by setting the discover:sampleSize property in Advanced Settings. By default, the table shows the localized version of the time field configured for the selected index pattern and the document “_source”. You can add fields to the Documents table from the Fields list. You can sort the listed documents by any indexed field that’s included in the table.

To view a document’s field data, click Expand to the left of the document’s table entry.
To view the original JSON document, click the JSON tab.
To view the document data as a separate page, click View single documents. You can bookmark and share this link to provide direct access to a particular document.
To display or hide a field’s column in the Documents table, click the Toggle column in the table button.
To collapse the document details, click Collapse.

Sorting

You can sort the documents in the Documents table by the values in any indexed field. If a time field is configured for the current index pattern, the documents are sorted in reverse chronological order by default.

To change the sort order, hover over the name of the field you want to sort by and click the sort button. Click again to reverse the sort order.

Adding field columns

By default, the Documents table shows the localized version of the time field that’s configured for the selected index pattern and the document “_source”. You can add fields to the table from the Fields list or from a document’s field data.

To add a field column from the Fields list, hover over the field and click add.
To add a field column from a document’s field data, expand the document and click the field’s Toggle column in the table.
Added field columns replace the “_source” column in the Documents table. The added fields are also added to the Selected Fields list.
To rearrange the field columns, hover over the header of the column you want to move and click Move left or Move right.

Removing field columns

To remove a field column from the Documents table, hover over the header of the column you want to remove and click the Remove button.

Time Picker

The time filter restricts the search results to a specific time period. You can set a time filter if your index contains time-based events and a time field is configured for the selected index pattern.

By default, the time filter is set to the “last 15 minutes”. You can use the Time Picker to change the time filter or select a specific time interval or time range in the histogram at the top of the page.

To set a time filter with the Time Picker

Click on the Time Picker in the toolbar.
A menu with Quick, Relative, Absolute, and Recent tabs will appear.
To set a quick filter, click on one of the shortcut links in the Quick tab.
To specify a time filter relative to the current time, click the Relative tab and specify the start time as a number of - seconds, minutes, hours, days, months, or years. You can also specify the end time relative to the current time. Relative times can be in the past or future.
To specify both the start and end times for the time filter, click the Absolute tab and select a start and end date. You can adjust the time by editing the To and From fields.
To select any of the recently used Time Filters, click one of the shortcut links in the Recent tab.

To set a time filter from the histogram

Click on one of the histogram bars to zoom in further.
Click and drag to view a specific time span within the histogram. You must start the selection with the cursor over the background of the chart—the cursor changes to a plus sign when you hover over a valid start point.

Visualize

Visualize enables you to create visualizations of the data in your search indices. You can then build dashboards that display related visualizations.

Orbita Insights visualizations are based on search queries. By using a series of search aggregations to extract and process your data, you can create charts that show you the trends, spikes, and dips you need to know about.

You can create visualizations from a search saved from Discover or start with a new search query.

Creating a Visualization

To create a visualization

Click on Visualize in the side navigation.
Click Create New Visualization or the + button.
Choose the visualization type
Specify a search query to retrieve the data for your visualization:
- To enter new search criteria, select the index pattern for the indices that contain the data you want to visualize. This opens the visualization builder with a wildcard query that matches all the documents in the selected indices.
- To build a visualization from a saved search, click the name of the saved search you want to use. This opens the visualization builder and loads the selected query.
In the visualization builder, choose the metric aggregation for the visualization’s Y-axis.
For the visualizations X-axis, select a bucket aggregation.

Bar, line, or area chart visualizations use metrics for the y-axis and buckets for the x-axis. Buckets are analogous to SQL GROUP BY statements. Pie charts use the metric for the slice size and the bucket for the number of slices.

You can further break down the data by specifying sub aggregations. The first aggregation determines the data set for any subsequent aggregations. Sub aggregations are applied in order, you can drag the aggregations to change the order in which they’re applied.

Enter a string in the Custom Label field to change the display label.

Dashboard

Users can make use of built-in Dashboards provided by Orbita. The users can clone the built-in dashboards and tweak them according to their business requirements.

Select a dashboard.

The Toolbar menu of the Dashboard consists of below items:

Address bar. Location of the current page.
Full Screen. Full-screen mode of the Dashboard. Click the blue icon at the bottom left corner to get the normal view again.
Share. Only admin users will be able to log in and access the dashboard using shared links.
- Share saved Dashboard. You can share this URL with people to let them load the most recent saved version of this dashboard.
- Share snapshot. Snapshot URLs encode the current state of the dashboard in the URL itself. Edits to the saved dashboard won't be visible via this URL.
Clone. Clone this Dashboard.
Edit. Edit the fields or visualizations of this dashboard.
Auto-refresh. You can set the auto-refresh interval for your dashboard using this option.
Time Picker. To go to the section that explains Time Picker, click here.
Search Bar. Below the top menu, there is a search bar where you can search the indices that match the current index pattern by entering your search criteria in the Query bar.

Sample Dashboard

The first visualization shows Browser breakdown in a pie chart.
The inner-circle represents the number of hits from different browsers.

The strip surrounding the circle shows the versions of the browsers that are used.

The second visualization in the dashboard shows a horizontal bar graph with top intents.

The top intents that are triggered in two different projects are displayed in this chart.

The third visualization shows the breakdown of different devices that are used to trigger intents for two different projects.

Management

The management page consists of Index Patterns, Saved Objects, and Advanced Settings.

Index Patterns

Index Patterns tell Orbita Insights which search indices to explore. An index pattern can match the name of a single index or include a wildcard (*) to match multiple indices.

Open Management, and then click Index Patterns.

An index pattern identifies one or more search indices that you want to explore with Orbita Insights. Orbita Insights looks for index names that match the specified pattern. An asterisk (*) in the pattern matches zero or more characters. For example, the pattern myindex-* matches all indices whose names start with myindex-, such as myindex-1 and myindex-2. An index pattern can also simply be the name of a single index.

If this is your first index pattern, the “Create index pattern” page opens automatically. Otherwise, click Create index pattern in the upper left.

Specify an index pattern that matches the name of one or more of your search indices.

Orbita has provided some inbuilt Index patterns. By clicking on any of the index patterns, you can see the list of fields configured in that index pattern with respective datatypes.

Any new fields added to the Index patterns will be reflected in the JSON immediately. However, they will be reflected in the User Interface only after you refresh the page.

Saved Objects

This page is where you can delete saved objects such as saved searches, dashboards, visualizations. Each tab is limited to 100 results. You can use the Search field to find objects that are not in the default list.

It is recommended to modify any objects via their associated applications.

Open Management, and then click Saved Objects.

Advance Settings

CAUTION: DO NOT CHANGE ANYTHING ON THIS PAGE. THIS PAGE IS FOR VERY ADVANCED USERS ONLY.

Getting Started

Discover