Eve library

PARITY-009 Certification: UI Action Analytics and Audit Events

Guide

Revision 1

On this page

Date: 2026-02-22
Checklist Item: PARITY-009
Ticket: ISIS-0250

Scope#

Certify that Isis web now emits analytics and audit telemetry for UI actions across all route surfaces, including both interaction events and backend action execution events.

Evidence Matrix#

Requirement Evidence Status
UI interactions emit analytics events apps/isis/web/src/telemetry/UiInteractionTelemetry.tsx now emits telemetry for click, submit, and change interactions via UI_INTERACTION_TELEMETRY_EVENT, with route and target metadata for each interaction. Pass
All SDK-backed UI actions emit audit events apps/isis/web/src/telemetry/UiActionAuditTelemetry.ts introduces instrumentIsisClientWithUiAuditTelemetry() and emits UI_ACTION_AUDIT_TELEMETRY_EVENT for every instrumented Isis client call (generation, workflows, outputs, models, checkHealth) with start/success/error phases, action id, route, duration, and error message metadata. Pass
Audit instrumentation is enforced at web client boundary apps/isis/web/src/api/IsisClientProvider.tsx now wraps every constructed IsisClient with instrumentIsisClientWithUiAuditTelemetry, ensuring page-level UI actions automatically produce audit telemetry without per-page manual wiring. Pass
Route fidelity for audit events matches app routing apps/isis/web/src/telemetry/UiInteractionTelemetry.tsx now synchronizes active router route into audit telemetry state (setActiveUiTelemetryRoute), ensuring audit event routes match current React Router location in SPA contexts. Pass
Regression coverage validates analytics + audit signals Added/updated tests: apps/isis/web/src/telemetry/UiInteractionTelemetry.spec.tsx (click/submit/change coverage), apps/isis/web/src/telemetry/UiActionAuditTelemetry.spec.ts (start/success/error for resource and top-level client methods), and apps/isis/web/src/App.e2e.spec.tsx (asserts interaction telemetry + audit telemetry for authenticated submit flow). Pass

Reproduction Commands#

bash
pnpm --filter @isis/web exec vitest run src/telemetry/UiInteractionTelemetry.spec.tsx src/telemetry/UiActionAuditTelemetry.spec.ts src/App.e2e.spec.tsx src/pages/JobSubmissionStudio.spec.tsx
pnpm --filter @isis/web run typecheck