TestRelic for Appium

TestRelic is an AI-driven Testing Observability Platform for engineering teams. The Appium SDK reporter captures rich test analytics from your Android and iOS mobile test runs and sends them to a cloud platform for AI analysis, monitoring, and integrations.

What does @testrelic/appium-analytics capture?

Add TestRelicService and TestRelicReporter to your wdio.conf.ts and they automatically:

• Capture every WebDriver command with timing, arguments, and category.
• Stream Android logcat and iOS syslog device logs per test.
• Intercept HTTP network traffic via CDP (Android), safariNetwork (iOS), or proxy fallback.
• Record device screenshots after every test, only on failure, or never.
• Record full screen video (optional).
• Detect CI environment context (GitHub Actions, GitLab CI, Jenkins, CircleCI).
• Upload structured test run data to the TestRelic cloud platform.
• Generate self-contained interactive HTML reports for offline use.

Requirements:

• Node.js ≥ 18 (Appium 3.x requires ≥ 20.19)
• WebdriverIO ≥ 9.0.0
• Appium 3.x

npm install @testrelic/appium-analytics
npm install --save-dev webdriverio @wdio/reporter

Install @testrelic/appium-analytics in this WebdriverIO project and configure wdio.conf.ts:
- Add TestRelicService (from '@testrelic/appium-analytics/service') to services
  with includeDeviceLogs: true and screenshotOnEvery: 'failure'
- Add TestRelicReporter (from '@testrelic/appium-analytics') to reporters
  with outputPath: './test-results/testrelic-timeline.json' and openReport: true
- Add an onComplete hook: await TestRelicReporter.finalize(process.cwd())
Show me the complete updated wdio.conf.ts.

What the report shows

The overview opens with a verdict band — what broke, in a sentence, with a proportion bar — then tiles for what this run actually captured, then a needs-attention block that leads with the failing step and the device-log line recorded beside it. That correlation comes from timestamps the command log and the log stream both already carried.

• Device strip — the eight fields detected from the W3C capabilities: platform and version, device name, driver, app under test, native or webview mode, UDID. Rows and the detail header carry a device badge. Because the platform is a field of its own, it is no longer appended to your tag list.
• Step kinds — all eleven command categories badged separately, so a swipe, an app launch, a keypress and a screenshot no longer render identically, with a breakdown of the run by kind. The four-bucket category the cloud timeline and Ask AI filters read is unchanged.
• Device logs with provenance — each line keeps its source, tag, pid and stack trace, so a crash-log entry is distinguishable from ordinary logcat chatter.
• Replay — the screen recording with a scrubber marked once per step; clicking a step seeks the video.
• Screenshot strip — every screenshot the test captured, in capture order, not just the first.

Cloud Platform

The TestRelic cloud platform (testrelic.ai) receives data from the SDK reporter and provides:

• Test Runs Dashboard — Run history with CI badges, filters, and session drill-down.
• Session Workspace — Inspect device commands, logs, screenshots, network traffic, and video timeline.
• AI Intelligence — Ask AI in natural language, get automated session insights, and generate test reports and plans.
• Monitoring — Smoke, regression, and nightly observatory dashboards for quality gates.
• Integrations — Native connections to GitHub Actions, Jira, Grafana Loki, and Amplitude.

See the Cloud Platform Overview for the full feature set.

Getting started

Local reporting only

Generate interactive HTML reports locally without the cloud platform:

1. Install: npm install @testrelic/appium-analytics
2. Add TestRelicService + TestRelicReporter to wdio.conf.ts
3. Run your tests — HTML reports are written to ./test-results/

→ Appium Installation guide

With the cloud platform

Get AI insights, monitoring, and the full session workspace:

1. Sign up at testrelic.ai
2. Complete the onboarding wizard
3. Add your API key to the reporter's cloud config
4. Run your tests — data uploads automatically after TestRelicReporter.finalize()

→ Appium Cloud Quickstart

Plans

→ Full plan comparison