> ## Documentation Index
> Fetch the complete documentation index at: https://docs.authsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Viewing user activity

> Learn how a customer support agent can use the Authsignal Portal to understand user activity

## Prerequisites

* Access to the [Authsignal Portal](https://portal.authsignal.com).
* Correct permissions to allow managing authenticators (`Support analyst` or `Admin`).

## Finding user activity data

There are two ways to find user activity data, either:

* searching for the user first
* searching within the activity for a given Action

### Finding user activity data by email address or User ID

<Steps>
  <Step title="Navigate to user search">
    In the Authsignal Portal, click on the **Users** tab.
  </Step>

  <Step title="Search for user">
    Using the search box, enter the user's **Email address** or **User ID** and click **Search**.
    The user list will be filtered to show all users with the address or ID you entered.

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/find-user-by-email.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=e7226ded4e45eb5e999327f85d3621c1" alt="Searching for a user by email address" width="1109" height="593" data-path="images/docs/knowledge-base/administration/find-user-by-email.png" />
  </Step>

  <Step title="View user details">
    Click on the relevant user.

    You will be presented with an overview of key details of the user, including their **Authenticators** and **Latest activity**.

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/user-details-page.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=77404b4c3480779c27d92c0a7045863a" alt="Viewing a user's details" width="1449" height="993" data-path="images/docs/knowledge-base/administration/user-details-page.png" />
  </Step>
</Steps>

After you have navigated to the user's latest activity, select an action from the list to see more details.

### Finding activity for a given action

<Steps>
  <Step title="Navigate to action">
    In the Authsignal Portal, click on the **Actions** tab.

    From the list, select an Action.
  </Step>

  <Step title="Filter activity">
    From the **Latest activity** tab you are presented a list of recent actions.

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/latest-activity.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=9892a22898d08bfea945f2729fe7d62f" alt="Latest activity search" width="837" height="444" data-path="images/docs/knowledge-base/administration/latest-activity.png" />

    Use the **Group by** selector to alter the graph's grouping.

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/group-by.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=014a028c434f9778d1956caaa560c6db" alt="Group by, allowing toggling between aggregating daily or monthly" width="239" height="68" data-path="images/docs/knowledge-base/administration/group-by.png" />

    Select the time period you want to search.

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/latest-activity-time-selector.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=e89e66099df88e7e0b0659a52fe202fa" alt="Time selector" width="1018" height="549" data-path="images/docs/knowledge-base/administration/latest-activity-time-selector.png" />

    <Info>
      The Authsignal Portal will surface the previous 3 months of action data.
    </Info>

    Use the **search box** to filter the list.

    For example, filter the list to only include actions which have not been completed:

    <img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/latest-activity-uncompleted.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=c8dcbc5c019a0c928bf59a8bc38eb68e" alt="Search query that only shows uncompleted actions" width="832" height="241" data-path="images/docs/knowledge-base/administration/latest-activity-uncompleted.png" />
  </Step>

  <Step title="Search">
    Click the **Search** button.

    Select the action from the result list.
  </Step>
</Steps>

## User action details

### Overview

The overview provides a quick snapshot of key details about the action, including device information (if available), authentication methods, and timestamp.

<img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/action-overview.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=5a15a24d97d23bc6ae7cfd07ce05f69d" alt="TODO" width="456" height="679" data-path="images/docs/knowledge-base/administration/action-overview.png" />

Click the **User ID** to see other events for this same user.

### Triggered rules

This will show any rules that were triggered, helping provide understanding on why a user was challenged or not.

### Event timeline

Use the event timeline to understand the steps the user took to complete any challenges.

<img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/action-event-timeline.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=80d8dfa03bea7d0de8243400ed3874c0" alt="Event timeline" width="839" height="850" data-path="images/docs/knowledge-base/administration/action-event-timeline.png" />

**Explaining action decisions**

Next to the action response click the **Explain** button to get an AI-generated response explaining why the action state is set to where it is.

<Warning>AI-generated content for guidance only</Warning>

<img src="https://mintcdn.com/authsignal-23/zw6HGr7AhISYuY-F/images/docs/knowledge-base/administration/action-event-timeline-explanation.png?fit=max&auto=format&n=zw6HGr7AhISYuY-F&q=85&s=4e5d66197ad39b00eb7b96a0f1fbeaa7" alt="AI-generated rules analysis" width="818" height="172" data-path="images/docs/knowledge-base/administration/action-event-timeline-explanation.png" />

**Failure cases**

The event timeline is useful for understanding where a user may have had an issue.

Common failure reasons include:

* entering an incorrect code
* rate limits being hit
* the session expiring
* third party SMS/Email provider rejecting the request

### Action response

This provides a behind-the-scenes view at the context the Rules engine uses to make a determination.
Expand sections to identify more information about the user's device, IP Address, etc.
