Look up event data for individual users

This article helps you:

  • Search for event data tied to specific users of your product

  • Troubleshoot your Amplitude instrumentation

Amplitude's User & Account Look-Up gives you a centralized and intuitive way to dive deeper into data generated by individual users and accounts within your product. You can easily switch between different projects and portfolios, search for specific or generic lists, and monitor individual event streams.

Before you begin

In the User & Account Look-Up tab, the section below the search bar is a real-time feed of the most recent 100 events Amplitude has received from your product during the last day (based on upload time), along with their corresponding time, ID, event, platform, and country. To see a live stream of all events coming into Amplitude, set the Live event updates toggle in the top right corner to On.

user_lookup.png

Note

Identify events aren't visible in user lookup.

Search for specific users

This feature lets you find a specific item (like a user ID or name) or generates a list of users (for example, a list of users in London). You can search for a user by user property values. 

To search for a specific user, follow these steps:

  1. Click User Look-Up, then switch the toggle to User.
  2. Click the Search users field. The Search Users fly-out panel appears.
  3. Enter the user ID, device ID, or Amplitude ID in the search box, or click Advanced to search by user property values. You can also search on any user property directly, using the [property] = [value] syntax. For example: email=bob@xyz.com

Searching by user property values displays a list of users who match the criteria you specified, and who triggered at least one active event in the last six months.

_24c7336c3049271e6a2ffaadf9b68ab2__userIDsearch.gif

To search for users who have a user property value containing a specific string, click the Search users field (in the Search Users fly-out panel shown above) and type in your custom user property type, prefixed with gp: . Be sure to include a ~ between your user property type and user property value. For example: gp:email~amplitude.

View a user's details and event stream

When you find the user you're looking for, click their ID to view their user profile. The profile is split into two sections: the user details section—where the user's most-recent properties are visible—and the event stream section, which contains the user's entire event history and displays all events received from them for a given day, which you can specify using the date picker.

user_lookup_2.png

user_lookup_3.png

The first five rows of the user details section show user properties Amplitude tracks by default if your product sends data client-side, as well as other usage metrics calculated for each user.

Note

Values for the Total Spent and # Purchases metrics are aggregated from events in the user's stream that contain the $revenue property. 

Any user properties at the bottom of this section are custom user properties you're tracking for your users in this project or portfolio.

You can activate a live stream of all events as they're ingested into Amplitude by setting the Live event updates toggle to On.

Amplitude groups the event stream by session, and orders it in reverse chronological order, placing the session property with the most recent activity at the top of the list. Blue events in a session are all connected by a line; green, out-of-session events stand alone. Customize the events you want to see in the event stream by choosing to show all events, highlight specific events, or only show specific events. You can also filter on a particular device ID.

There are two available views: the Info view, which gives a digestible view of the event data, and the Raw view, which displays the raw JSON file Amplitude received, along with any user properties that persisted from previous events or Identify requests. This is useful for debugging the data your product sends to Amplitude.

user_lookup_4.png

Note

Group properties are only visible in the raw event view.

You can link to a specific event in a user's event stream by clicking Get Link and copying the corresponding URL. This is useful for sharing potential bugs in instrumentation.

Chart a user's event stream

You can choose up to ten events from a user's event stream to view in a funnel or segmentation chart. Follow these steps from the user's event stream in User Look-Up:

  1. Check the boxes next to the events you'd like to visualize in a chart.
  2. Click Create Chart and choose Segmentation or Funnel to visualize the user's event stream data.

event_stream_to_chart.png

Raw data fields

Amplitude uses different timestamps to ensure it reports your data accurately:

  • client_event_time: Local timestamp (UTC) when the device logged the event.
  • client_upload_time: Local timestamp (UTC) when the device uploaded the event.
  • server_received_time: Amplitude timestamp (UTC) when Amplitude's servers receive the event.
  • server_upload_time: Amplitude timestamp (UTC) when the event is ingested into Amplitude's ingestion system. This timestamp isn't used to calculate event_time, but it's available to reference in the raw data.
  • event_time: Amplitude timestamp (UTC) which is the client_event_time adjusted by the difference between server_received_time and client_upload_time, specifically:
1event_time = client_event_time + (server_received_time - client_upload_time)

Note

If the difference between server_received_time and client_upload_time is less than 60 seconds, the event_time isn't adjusted and is set equal to the client_event_time. This occurs automatically for projects with a project ID of 243704 or higher. To apply this 60-second cutoff time to an older project, contact Amplitude Support.

Daily exported files use server_upload_time and all dashboards use event_time. Queries on raw data should use event_time.

UUID

UUID is a unique event identifier intended for internal usage at Amplitude only.

Portfolios

User event streams are supported in both projects and portfolios. To find a user stream in a portfolio, navigate to the User & Account Look-Up tab and select the portfolio from the dropdown.

Note

Only portfolios consisting of five or fewer projects are supported.

User properties can only be viewed at a project (not portfolio) level. This is because properties may be different for the same user in different projects.

Was this page helpful?

Thanks for your feedback!

July 1st, 2024

Need help? Contact Support

Visit Amplitude.com

Have a look at the Amplitude Blog

Learn more at Amplitude Academy

© 2024 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.