# grafana/faro-web-sdk

The Grafana Faro Web SDK, part of the Grafana Faro project, is a highly configurable web SDK for real user monitoring (RUM) that instruments browser frontend applications to capture observability signals. Frontend telemetry can then be correlated with backend and infrastructure data for full-stack observability.

Repository: https://github.com/grafana/faro-web-sdk
Canonical: https://ross.abutalabs.com/products/faro-web-sdk
Homepage: https://grafana.com/oss/faro/
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2026-08-26T13:02:41+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 1805, "days_push": 7, "days_rel": 7, "gap_med": 8, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1125, forks 124 (observed 2026-08-28T04:03:41.058864+00:00)

## What it is
Grafana Faro Web SDK is a highly configurable JavaScript/TypeScript SDK for real user monitoring (RUM) that instruments browser frontend applications to capture observability signals such as performance metrics, logs, exceptions, events, and traces. Collected frontend telemetry can be forwarded to Grafana Alloy, Grafana Cloud, or a custom receiver and correlated with backend and infrastructure data for full-stack observability.

## Use cases
- monitor real user performance of my web app
- capture frontend errors and exceptions in the browser
- collect client-side traces and correlate them with backend traces
- send browser logs to Loki via Grafana
- track web vitals and user interactions
- instrument a React application with frontend telemetry
- forward RUM data to a custom telemetry receiver

## When to choose
- you want real user monitoring for browser applications
- you use the Grafana LGTM stack or Grafana Cloud and want full-stack observability
- you need configurable automatic and manual frontend instrumentation
- you want a React-friendly SDK with tracing and session replay packages

## When to avoid
- you need server-side or mobile application monitoring only
- you are not using Grafana backends and prefer a standalone RUM vendor
- you want a zero-dependency minimal script without an observability pipeline

## Facets
- artifact type: library
- maturity: active
- function: monitoring, tracing, logging, sdk
- domain: frontend, web-development, monitoring, developer-tools
- platform: browser
- tags: rum, real-user-monitoring, frontend-observability, telemetry, grafana, opentelemetry, web-vitals, error-tracking, session-replay, nodejs, javascript, typescript

## Member repositories
- grafana/faro-web-sdk (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:41.058864+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:39:31.557711+00:00, confidence not recorded.
  - readme: https://github.com/grafana/faro-web-sdk (fetched 2026-08-28T04:03:41.058864+00:00, sha 4cf16b1817d0)
  - homepage: https://grafana.com/oss/faro/ (fetched 2026-08-29T12:44:04.513134+00:00, sha e2adfca8a3ba)
  - site_page: https://grafana.com/docs (fetched 2026-08-29T12:44:04.525235+00:00, sha 882a3fe34bf0)
  - site_page: https://grafana.com/docs/grafana-cloud/faro-web-sdk?pg=oss-faro&plcmt=hero-btn-3 (fetched 2026-08-29T12:44:04.527672+00:00, sha bf76b8a74525)
  - site_page: https://grafana.com/docs/agent/latest/configuration/integrations/integrations-next/app-agent-receiver-config (fetched 2026-08-29T12:44:04.529396+00:00, sha f1ced32d7ef2)
  - site_page: https://grafana.com/docs/grafana-cloud/faro-web-sdk?pg=oss-faro&plcmt=resources (fetched 2026-08-29T12:44:04.532492+00:00, sha 3d6e5a76c19d)
  - site_page: https://grafana.com/pricing (fetched 2026-08-29T12:44:04.522372+00:00, sha 6097ce127c08)
  - site_page: https://grafana.com/integrations (fetched 2026-08-29T12:44:04.534000+00:00, sha 3210cff6224b)
  - site_page: https://grafana.com/integrations/cloud-monitoring-aws (fetched 2026-08-29T12:44:04.535436+00:00, sha 51561815b31e)
- Data as of 2026-08-30T08:39:29.467469+00:00.