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.

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