Inspector

4 minute read

The first step to better analytics governance is knowing what's wrong with your data today.

We built the Inspector to help you understand how your current tracking is performing. The Inspector both identifies common issues in your existing tracking, such as inconsistent properties and types, and provides implementation status in the Avo Tracking Plan, so you always know the state of your tracking implementation in your app.

In this doc we'll be covering how to configure and use the Inspector in your workspace. You can learn about how to install the Inspector SDKs in your sources here.

Configuring Sources

The first step to start using the Inspector, is installing it on your sources. The Inspector source configuration can be found in the workspace sidebar under Inspect > Sources.

Inspector shares sources with the Connections tab.

In the Sources screen you'll see a grid of all sources you've already configured in the Connections tab.

You can create new Inspector sources here, they will also appear in the Connections tab.

Each Inspector source has 3 states:

  1. Receiving events - this source already received at least one event from the client SDK.
  2. Waiting for events - the source is available for Inspection, but have not received any events yet. Press the Source card to see the implementations details and the API key for this source.
  3. Not available - this source is not supported, there is no client SDK yet. Please contact us to learn current status and planned release date.
Opening a branch

Connect to Slack

On the Sources screen you can connect Inspector to your Slack to receive alerts when new issues appear in your production environments.

Press the Connect to Slack button and follow the instructions.

Avo Inspector will post new issues it finds in production hourly to the specified slack channel.

The Inspector Slack integration currently alerts on the following issues:

  • Property is sometimes not provided
  • Property is sent with inconsistent types
  • New event seen that is not in the Tracking Plan
  • New property seen that is not in the Tracking Plan
  • Property type does not match the Tracking Plan
Inspector Slack Integration

Inspector Dashboard

The Inspector dashboard provides a report on all tracking the Inspector has seen in your development, staging and production environment. You can use the dashboard to evaluate the health of your tracking implementation and prioritize issues.

Filters

Here you can choose which environment to examine, the time window and search for event name.

Environments

Currently Inspector supports 3 types of environments:

  • Development
  • Staging
  • Production

The events are streamed to the Environment specified in the client, based on the environment constant provided when initializing the Avo Inspector SDK.

Development and Staging events appear in the dashboard in a few minutes after they are fired and Production events can take up to 2 hours to show up.

Time window

Currently Inspector supports 4 types of time windows:

  • 1 hour
  • 24 hours
  • 7 days
  • 30 days

All the time windows are updated hourly on Production and are close to real time in Development and Staging.

Search for event name

Type the event name in the input field and only events with similar name will be shown.

If you want an exact match put the event name in quotes, e.g. "App Opened".

Share current view of Inspector

Notice that after you change the header filters the URL also changes. You can share this URL with a colleague and they would see exactly the same slice of inspector data as you filtered.

Events list

The main part of the Inspector dashboard screen is the list of all events seen.

You can expand the events to see the event properties.

If Inspector sees an event that is not yet in your tracking plan there is a shortcut to add it to your Tracking plan.

If Inspector detects an issue it will indicate that in the list.

If you select an event or property row a panel with detailed information will appear on the right. There you would be able to see extended information about the issues and edit the event or property in your tracking plan.

Inspector issues

You can learn more about the issue types the Inspector can detect in your tracking here.

Inspector Implementation Status

You can learn more about how the Inspector works with your Tracking Plan implementation status here.