Testing

Monitor and manage live and automated testing.

Overview

Device Farm tracks two types of testing: Live Testing started from the Devices page, and Automated Testing via Appium/WebDriver scripts. Each type has its own dedicated page for monitoring and management.

Test Types

Live Testing

Interactive testing started by clicking "Start Testing" on a device. Full control with video streaming, touch input, and toolbar actions.

• Real-time video streaming
• Touch and gesture control
• App installation & file transfer
• Screenshot & recording capture

Automated Testing

Testing via Appium or WebDriver API. View device screen and track test execution progress.

• Appium/WebDriver compatible
• Live test progress tracking
• Activity timeline logging
• CI/CD integration support

Test Status

Tests go through the following lifecycle states:

Status	Indicator	Description
Active	🟢 Green	Test is running. Device is streaming and accepting commands.
Completed	⚫ Gray	Test ended normally by user or automation script. Artifacts are available.
Failed	🔴 Red	Test terminated due to error, timeout, or device disconnection. Error in logs.

Live Testing Page

The Live Testing page (/devicer/live-testing) shows all live tests with filtering and search.

Statistics Cards

At the top, view quick stats: Total Tests, Active, Completed, and Failed counts.

Filter Tabs

Tab	Description
All	All live tests
Active	Currently running tests
Completed	Successfully ended tests
Failed	Tests that ended in error

Search

Search by test name, device name, user, or ID.

Test Actions

• View Details - Open test detail page
• End Test - Terminate active test
• View Artifacts - Screenshots, recordings, logs

Automated Testing Page

The Automated Testing page (/devicer/automated-testing) shows tests created via Appium/WebDriver API.

Test Progress Tracking

Each test card shows live test execution progress if your test framework is integrated with the Test Event API.

Device Filter

Filter tests by specific device to monitor test runs across your device fleet.

Test Details

Click any test to view device screen, activity timeline, and test results in real-time.

tip

Integrate your test framework with the Test Event API to see live pass/fail results. See Test Event Integration for details.

Test Card Details

Each test card displays:

Field	Description
Test Name	Auto-generated or custom name for the test
Device	Device name with platform badge (iOS/Android)
User	User who started the test
Status	Active, Completed, or Failed badge
Duration	Total test time
Started	Start timestamp (relative or absolute)
Test Progress	Pass/Fail counts (automated tests only)

Starting Tests

Live Test

1. Go to Devices page
2. Find an available device
3. Click "Start Testing"
4. Wait for connection
5. Start interacting!

Automated Test

1. Get your API key from Settings
2. Configure Appium capabilities
3. Point to Device Farm hub URL
4. Run your test script
5. Monitor in Automated Testing page

info

See Appium Config for detailed automation setup instructions with code examples.

Best Practices

End Tests When Done

Always end your test when finished to release the device for others. Idle tests timeout automatically after the configured period.

Use Meaningful Test Names

For automated tests, set a descriptive test name in capabilities to easily identify test runs later.

Monitor Long-Running Tests

Keep the Automated Testing page open during test runs to catch failures early. Use parallel mode to monitor multiple devices simultaneously.

Troubleshooting

Issue	Solution
Test not showing	Check the correct tab (Live/Automated). Try refreshing the page.
No active tests	Start a test from the Devices page or via Appium API.
Test ended unexpectedly	Check device logs in test details. May be timeout or device disconnect.