Inspector Issues View
How to use the Inspector Issues view
The Inspector issues view displays information about anomalies and discrepancies seen in your production data for the past 24 hours. This view allows you to sort and filter issues to uncover those relevant to you and gives you the overview and information needed to prioritize which of them to act on.
Each issue in the table represents an issue on a particular event, or a particular property contained within an event. In the table you will see:
- The issue type – for example unexpected event or inconsistent property types, (see list of issue types in Inspector)
- The name of the event and property impacted
- The source impacted
- Issue timing – when it was first and last seen
- First seen – when the issue was first seen
- Last seen – when the issue was seen most recently
- Event volume – how many instances of the event were seen
- Issue volume – how many instances of the event were seen with this issue
- Impacted releases – which release versions were impacted by the issue, sorted by the most recent release first
- Issue percentage – the proportion of events seen with this issue in relation to the event volume (issue volume / event volume)
The issue table can be sorted by any column. When prioritizing issues it’s helpful to sort by event volume, issue volume or issue percentage to quickly uncover which issues have the most impact on your data and prioritize accordingly.
To narrow down your search to your most relevant issues, you can filter by the following:
- Issue Type
- Event name
Once you have filtered and/or sorted the issues, you can save the filtered view for quick access for you and your team. The saved view persists both the filters you have selected and the sorting.
When the issues view is opened, the default view is an unfiltered "All Issues" view ordered by last seen, such that the latest issues are on top. Until the a filter is added or the sorting is changed, the "Save View" button is disabled.
Once a filter is added or the sorting changed, the "Save View" button is enabled. Click that button to name the view and save it.
Once the "Save filtered view" button is clicked, the view is successfully saved and the new view is displayed.
In each saved view, there are buttons to copy the URL to the view, duplicated it and the disabled "Save View".
To create a new view based on another saved view, you can either click the duplicate button to first duplicate it and then modify it or first modify an existing saved view and then click the "Save View as..." button to save it as a new view.
To duplicate an existing saved view, click the duplicate button in the top right corner, next to the "Save View" button.
Then a modal to name and save the duplicated view is opened.
Once the "Save duplicate view" button is clicked, the view is successfully saved and the new duplicated view is displayed.
From here, the saved duplicated view can be modified by changing the filters or sorting and the changes saved by clicking the save button.
To modify an existing saved view, you can adjust the filtering or sorting to your needs. It's safe to modify any view as the changes are not saved until you click the save button. Editors can only save changes to their own views.
When a saved view has been modified, the following options are presented:
- Save View: if you are the creator of the saved view or a workspace admin, you can save the changes to the modified view
- Save as: anyone can save the changes as a new view by giving it a new name
- Reset saved view: reset the adjusted filters and sorting to latest saved state of the saved view
Below is an example of a saved view that has been modified, but changes unsaved.
To save the changes as a new saved view, click "Save as...", give it a new name and save the changes.
To share a saved view with a colleague, you can click the link button to copy the URL of the saved view. The copy link to view button is on all views, saved or not.
To rename a saved view, click the title of the saved view to open a modal to rename it and save the changes.
To find and access saved views that you or other workspace members have created, click the "All saved views" button in the top right corner of any Inspector Issues view.
There you will find an overview over all saved views with information about how many issues you they contain and who modified the view last and when.
From there, the creator of each saved view and admins can archive saved views by opening the three dot menu on the right and click the Archive View button.
Click any issue in the list to see more details. If you have multiple sources connected with Inspector, you can dig into which sources are impacted by the issue and uncover which sources are most severely affected. In the issue details view you will see:
The event impacted by the issue, its volume and whether it is documented in your Avo tracking plan.
- If the event is present in the tracking plan, you can navigate to it to review and/or update the event definition
- If the event is missing from your tracking plan, you can add it to your tracking plan.
The property impacted by the issue, and whether it is documented to be sent with the event in your tracking plan.
- If the property is present on the event in your tracking plan, you can navigate to it to review and/or update.
- If the property is present in your tracking plan but not set to be sent with your event, you can add it to the event definition.
- If the property is missing from your tracking plan, you can add it to your tracking plan.
At the bottom of your issue details, you will see a list of all sources that are impacted by the issue. For each source you will see: Event volume, issue volume and issue percentage and a link to the issue details on the other sources.
When you find an issue in Inspector, the problem can either be on the implementation or tracking plan side: If the implementation is not what it should be according to the tracking plan, we recommend copying the issue link, creating a task in your task management system and assigning it to the relevant team to look into and fix in code If the tracking plan is not representing how the event should be, and the implementation is correct, we recommend updating the tracking plan accordingly. In the issue details, you can add events and properties with a click of a button and view the tracking plan definition in the context you are in
There can be a few reasons for no issues appearing in your issues view at all or for a specific source.
The most obvious reason is that you have not yet installed Inspector at all, or on the source that you are looking for. To fix that, install Inspector on the source you'd like to see issues for.
The issues view currently only displays issues from the past 24 hours in production. That means that if you don't have Inspector installed on production on any source, you won't see any issues in the issues view. To fix that, install Inspector on production for the source you'd like to see issues for.
The issues view currently only displays issues from the past 24 hours in production. That means that if you don't have any issues in the past 24 hours, then you won't see any issues. Yay!