Sharing Test Data

The ThousandEyes platform provides the Sharing menu for sharing test data. You can share test data with other ThousandEyes users and with people who do not use the platform. Collaborating with the same graphical view of test results allows you to troubleshoot with any colleague, partner, or provider, whether they are a ThousandEyes user or not.

ThousandEyes offers different options for sharing test data, including public snapshots, live shares, and exporting data. Use snapshots to share test data with anyone, even if they are not ThousandEyes users. Live shares only permit sharing of test data with other ThousandEyes users. The export data option extracts data from our API without requiring an API query or additional tools outside the ThousandEyes platform.

The Shared by ThousandEyes screen at Manage > Sharing > Shared by ThousandEyes provides shareable test configurations, as opposed to sharing test result data. These sample configurations are useful for creating new tests without having to configure everything from scratch. To learn more about Shared by ThousandEyes, see Working with Test Settings: Shared by ThousandEyes.

Private Snapshots

The private snapshots feature (previously known as Saved Events) allows you to permanently save a specific time segment of test data, keeping it private to your account group and ensuring it does not expire. This is distinct from other types of snapshots, such as public snapshots or dashboard snapshots, and is particularly useful for retaining critical test data.

Unlike temporary data views, private snapshots are:

• Private: Accessible only to users within the same ThousandEyes account group, requiring a valid ThousandEyes account with appropriate permissions.

• Non-Expiring: Unlike most ThousandEyes test data (retained for 90 days for paid accounts or 14 days for trial accounts), private snapshots are preserved indefinitely unless manually deleted.

• Read-Only: They capture a frozen view of test results, including metrics like latency, packet loss, or HTTP response times, viewable via the ThousandEyes UI.

You can use private snapshots for:

• Incident Documentation: Save test data showing a performance issue for later analysis or reporting.

• Compliance: Retain test results for audits requiring long-term data storage.

• Baseline Comparison: Store a snapshot of normal performance to compare against future anomalies.

For backward compatibility, API endpoints still reference “savedEvent” (e.g., in test metadata), but the UI and newer docs use “Private Snapshots.”

Account Requirements for Private Snapshots

Private snapshots are restricted to users with a ThousandEyes account, specifically:

• Authentication Needed: To create, view, or manage private snapshots, you must log into the ThousandEyes platform (via https://app.thousandeyes.com) with a valid user account tied to an account group.

• Permissions: Creating a private snapshot requires the Edit Tests or Create Snapshot Shares permission, while viewing them requires at least View Tests permission. Account Admin or Organization Admin roles often have these by default.

• Account Group Scope: Private snapshots are scoped to the account group where the test resides, meaning only users in that group can access them. This contrasts with public snapshots, which are shareable via a URL to anyone, even non-ThousandEyes users.

Unlike public snapshots, private snapshots ensure data privacy, making them suitable for sensitive environments.

Creating a Private Snapshot for Cloud and Enterprise Tests

1. Navigate to Network & App Synthetics > Views or Test Settings in the ThousandEyes UI.

2. Select a test. On the test’s results page, choose a specific time range or test round

3. Click the Snapshot button and select Save a Snapshot.

4. You may name the snapshot and select the time range.

5. In the Sharing Settings, select A ThousandEyes account is required to view.

6. Click the Save button. The snapshot is saved as a read-only view of that test’s data at that moment.

Accessing Private Snapshots

To access your private snapshots:

1. Go to Manage > Sharing > Private Snapshots in the ThousandEyes UI.

2. From there, you’ll see a list of Private Snapshots for your account group, filterable by snapshot name.

3. Clicking a snapshot expands the row to show more information about the snapshot. Click the gear icon to go to the test it is tied to.

Managing Private Snapshots

You can manually delete private snapshots via the Manage > Sharing > Private Snapshots screen if no longer needed. Click the garbage icon located at the end of the row, to the right. Private snapshots don’t count toward the 5-snapshot-per-5-minute API limit for public snapshots.

The ThousandEyes API supports the /tests/{testId}/snapshot endpoint to create or manage private snapshots. This requires the “Create snapshot shares” permission.

Public Snapshots

Public snapshots in ThousandEyes allows you to share a specific time segment of test data by generating a shareable URL. Unlike private snapshots, public snapshots can be accessed by anyone with the link, even without a ThousandEyes account, making them ideal for sharing test results with external stakeholders. They capture a read-only view of test data (e.g., network latency, HTTP response times, or DNS resolution) at a chosen point in time.

• Purpose: To share test results externally or with non-ThousandEyes users, such as clients, vendors, or support teams, while preserving a specific view of the data.

• Scope: Tied to a single test (e.g., HTTP server, network, BGP, or DNS test).

• Accessibility: Available to anyone with the shareable URL.

Public snapshots offer the following features:

• Test-Specific: Captures data for one test at a selected time window (up to 48 hours, depending on test type).

• Data Preservation: Saves metrics and visualizations (e.g., path visualizations, timelines, or response codes) as they appeared at the time of capture, accessible via the shared link.

• Public Access: Viewable by anyone with the URL, no ThousandEyes account required, unless link sharing is disabled at the account level.

• Management: Created and managed via the ThousandEyes UI or API.

Account Requirements for Public Snapshots

Public snapshots have the following account dependencies:

• Creating: Requires a ThousandEyes account with appropriate permissions:

• Edit Tests or Create Snapshot Shares permission to generate a Public Snapshot.

• The built-in Account Admin and Organization Admin roles include these permissions.

• Viewing: No ThousandEyes account is needed to view a public snapshot—just the shareable URL. This makes them accessible to external parties, unlike private snapshots, which are restricted to account group users.

• Restrictions: Account settings can disable public link sharing (e.g., for security or compliance), requiring viewers to log in with a ThousandEyes account. This is configurable in Manage > Account Settings.

Creating a Public Snapshot for Cloud and Enterprise Tests

1. Navigate to Network & App Synthetics > Views in the ThousandEyes app.

2. Select a test and choose a specific time range or test round (e.g., a period with notable metrics like latency or packet loss).

3. Click the Snapshot button at the upper right corner of the page and select Save a Snapshot. Name the snapshot and verify the selected time range. Select the option: "Anyone with the link can view".

4. Click the Save button at the bottom right corner of the screen.

5. Copy the generated URL to share with others.

Accessing Public Snapshots

Snapshots are accessible via the ThousandEyes platform’s public-facing interface.

• Share the URL with intended recipients (e.g., via email or chat).

• Recipients visit the URL to view the read-only test data, including metrics and visualizations, without logging in (unless restricted by account settings).

Managing Public Snapshots

You can view or delete public snapshots by navigating to Manage > Sharing > Public Snapshots.

Use the search box at the top of the page to locate your snapshot either by test name or public snapshot url.

The Shared by users In my account group tab has a table with the following columns:

• Test Name: The name of the test from which the Snapshot was taken.

• Public Snapshot Date: The range in time of the Snapshots data, specified by a date and time, followed by a + - or ± depending on which setting of 'starting at", 'ending at" or "around' (respectively) was used at the time the Snapshot was created (see #2 from the "Sharing panel", above).

• Create Date: The date and time of Snapshot creation.

• Visits: The number of times the sharelink has been accessed.

Click any of the column headings to sort by that column. Click a second time to reverse the order of the sort in the chosen column.

Clicking a row to expand it will display the following:

• The Snapshot's sharelink (URL)

• Most recent visits: This section displays the most recent accesses of the Snapshot. The date of the visit is displayed in hours since the visit. If the user is a ThousandEyes user and has recently logged in, the user's ThousandEyes name and login ID (email address) are displayed, along with the IP address of the visitor's client.

• Allow only ThousandEyes users to comment: This box can be checked to prevent sharelink users who do not have ThousandEyes accounts from using the Comments feature. Snapshot recipients can make comments and communicate with the Snapshot creator via the Messenger panel, available on the Snapshot page. Click the Messaging tool icon in the upper right corner of a Snapshot page to display the Messenger panel:

  

When Snapshot recipients leave comments, the Snapshot's creator will receive email notification.

The Shared... tab provides a listing of sharelink that other users of the ThousandEyes platform have shared with you. The columns have the same definitions as above, with the substitution of the Created By column, which shows the ThousandEyes name of the test creator, as determined by the Name field of the user's Profile page.

To delete a snapshot, click the garbage can icon at the far right of the snapshot's row.

Once the deletion is confirmed, people who possess the sharelink will no longer be able to view the data.

Endpoint Agent Test Snapshots

To create a snapshot from Endpoint Agent test results, navigate to the Views tab in the Endpoint Agents menu. On the timeline, click on a test round that begins, ends or is in the middle of the relevant data, then select the Save and Share button on the upper corner of the page.

Clicking on the Save and Share button will display the saving and sharing panel.

Configuration Option	Description
Snapshot Name	The name of the snapshot to be shared.
Data Range	The length of the data window to be share(up to two days), and the location in time of the data window you selected. Possible options are: starting at around ending at
DATA TO SHARE	This section provides you the options to include or exclude data from certain test types. The options include: Automated Session Tests: Check to enable the data from the automated session tests to be included in the snapshot. Scheduled Tests: Check to enable the data from the scheduled tests to be included in the snapshot. Browser Sessions: Check to enable the data from the browser sessions to be included in the snapshot. Local Networks: Check to enable the data from the local networks to be included in the snapshot. By default the snapshot captures the last viewed/visited agent for automated session tests and scheduled tests. However, this can be edited by selecting the desired agents in the corresponding Endpoint Experience > Views section.
PRIVACY	This section provides you the options to customize the privacy. The options include: Anonymize data that identifies users: Check to remove the identification on the users from the data shared in the snapshot. Anonymize data that identifies visited pages: Check to remove the identification of the visited web pages from the data shared in the snapshot. This option is only enabled if you have selected to share the Browser Sessions data.
Link sharing off	Toggle the Link sharing off to display the sharelink, Copy the link to your clipboard and paste into a document, a chat or any other application.

Click the Save button to save your snapshot data to the sharelink. Sharelink creation requires clicking the Save button.

Public Snapshots on Device View

To create a snapshot from the Devices view , go to Views tab in the Devices menu, On the timeline, click on a test round that begins, ends or is in the middle of the data of interest, then select the Save and Share button on the upper corner of the page.

Clicking on the Save and Share button will display the saving and sharing panel.

1. Select the name of the snapshot to be shared.

2. Select the length of the data window to be shared, up to two days.

3. Select the location in time of the data window you selected in the previous step. Options are "starting at", "around", and "ending at".

4. Check to enable the data from the devices to be included in the snapshot.

5. Toggle the Link sharing off to display the sharelink. Copy the link to your clipboard and paste into a document, a chat or any other application.

6. Click the Save button to save your snapshot data to the sharelink. Sharelink creation requires clicking the Save button.

Public Snapshots on Internet Insights

To create a snapshot from the Internet Insights view , go to Views tab in the Internet Insights menu, On the timeline, click on a test round that begins, ends or is in the middle of the data of interest, then select the Save and Share button on the upper corner of the page.

Clicking on the Save and Share button will display the saving and sharing panel.

1. Select the name of the snapshot to be shared.

2. Select the length of the data window to be shared, up to 6 hours.

3. Select the location in time of the data window you selected in the previous step. Options are "starting at", "around", and "ending at".

4. Check to enable the data from the Internet Insights and Network to be included in the snapshot.

5. Check to enable the data from the affected tests to be included in the snapshot.

6. Select the affected tests that you want to include in the snapshot.

7. Toggle the Link sharing off to display the sharelink,

8. Click on Copy to copy the link to your clipboard and paste into a document, a chat or any other application.

9. Click the Save button to save your snapshot data to the sharelink. Sharelink creation requires clicking the Save button.

Live Shares

If the desired recipient of your data is a ThousandEyes customer but not a user in your account group (your current account group's name is found by clicking on the User Menu icon in the upper right corner of the ThousandEyes interface) then you can provide them with a Live Share. A Live Share is a read-only view of a test's results web page, allowing access to current data, and past data starting from the time of the share's creation. The Live Share's test can be displayed on the recipient's Dashboard, can be the source for new reports, and can in other ways (though not all ways, e.g. the test can't be deleted) be treated as a test that belongs to that user's account group. As with a sharelink, you can terminate the Live Share at any time. Live Shares must first be accepted by the desired recipient in order for the shared test to appear in their account.

Creating and Deleting Live Shares

To create a Live Share for other ThousandEyes users, or to accept a Live Share, go to Network & App Synthetics > Test Settings:

1. Click the "Pending Shares" link at the top of the Test Settings page to display a panel listing all Live Shares other ThousandEyes users have sent to you, awaiting your acceptance. You may accept them or decline them.

2. A listing of account groups within your Organization, if your Organization has multiple account groups (the link will not be displayed if your Organization has only one Account Group). Check the box next to an account group you want to grant access to the Live Share. The link will indicate the number of account groups with access to the Live Share, out of the total number of account groups in your Organization.

3. For users outside your Organization, click the "Share with other customers" link to display a panel which will allow you to email your desired recipient. Use the email address which is used by them as their ThousandEyes login. The link will change to "X other customers" where X is the number of Organizations which have received and accepted the Live Share. All account groups within the Organization will have access to the Live Share.

   

To delete Live Shares that you provided to another account group, click the "X of Y account groups" link per step 2 above to display the listing of account groups. Uncheck the box of the account group you no longer wish to have access to the Live Share.

To delete Live Shares that you provided to a different Organization, click the "X other customers" link per step 3 above to display a panel to edit and delete your LIve Share recipients:

Click the Trash icon to delete a recipient. The Live Share will no longer be available to that Organization.

Exporting Data

Another method to provide access to your data is to use the ThousandEyes API. Clicking the Share button on a test results page displays the sharing panel, which contains the Snapshot Sharing tab and the Export Data tab. The latter tab allows you to select a period of data (up to 1 hour) to display, making a query to the ThousandEyes API automatically, and opening a new browser window to display the results. The data is rendered in either JSON or XML format You can copy the results to your clipboard and paste into a document, or saved as a file via your browser's Save menu option.