grafana-frontend-observability
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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/grafana/faro-web-sdk with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/grafana/faro-web-sdk'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/grafana--faro-web-sdk)HTML
<a href="/listings/grafana--faro-web-sdk"><img src="/api/listings/grafana--faro-web-sdk/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "grafana-frontend-observability",
- "owner": {
- "name": "Grafana Labs",
- "email": "frontend-observability@grafana.com"
- },
- "metadata": {
- "description": "Grafana Cloud observability skills for Claude Code",
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "faro-setup",
- "source": "./ai/grafana-cloud/faro-setup",
- "description": "Auto-instrument any web app with Grafana Faro Web SDK. Detects your framework, generates init code, wires it into your entry point, and opens a PR.",
- "version": "1.0.0",
- "author": {
- "name": "Grafana Labs",
- "email": "frontend-observability@grafana.com"
- }
- }
- ]
- }
README.md · README · 143 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Grafana Faro Web SDK
- <p align="left">
- <img src="docs/faro_logo.png#gh-light-mode-only" alt="Grafana Faro logo" width="400">
- <img src="docs/faro_logo_dark.png#gh-dark-mode-only" alt="Grafana Faro logo" width="400">
- </p>
- The Grafana Faro Web SDK can instrument frontend JavaScript applications to collect telemetry and forward it to the
- [Grafana Alloy][grafana-alloy-docs] (with faro receiver integration enabled), to a Grafana Cloud instance or to a
- custom receiver. Grafana Alloy can then send this data to [Loki][grafana-logs] or [Tempo][grafana-traces].
- The repository consists of multiple packages that can be combined depending on your requirements. For a full reference
- instrumentation of a real-world app, see [grafana/quickpizza][faro-demo] — the canonical Frontend Observability demo,
- deployed live at [quickpizza.grafana-dev.com](https://quickpizza.grafana-dev.com) and instrumented with the current
- Faro Web SDK, Web Tracing, and Session Replay packages.
- ## Get started
- > [!NOTE]
- > For more information, you can find the Faro documentation in the [Grafana Cloud docs for Faro](https://grafana.com/docs/grafana-cloud/monitor-applications/frontend-observability/instrument/).
- See [quick start for web applications][faro-quick-start].
- ## Local development
- Contributing to the SDK? See [local development][faro-local-dev] for the three supported paths:
- the in-repo smoke harness, your own Grafana Cloud free-tier stack, or a local Alloy install.
- [Pull requests][faro-pull-requests] explains how pull requests work here, including the automation
- that labels a pull request `stale` after 60 days without activity, closes it 14 days after that, and
- how to keep one open.
- ## Packages
- ### Core
- [@grafana/faro-core][faro-core] is the main package that provides the core functionality of the SDK. The
- [README.md][faro-core-readme] file provides an overview of the architecture and the API of library.
- ### Web SDK
- [@grafana/faro-web-sdk][faro-web-sdk] provides instrumentations, metas and transports for use in web applications. See
- the [README.md][faro-web-sdk-readme] for more information.
- ### Web Tracing
- [@grafana/faro-web-tracing][faro-web-tracing] provides implementation for tracing web applications. See the
- [README.md][faro-web-tracing-readme] for more information.
- ### React Support
- [@grafana/faro-react][faro-react] is a package that enables easier integration in projects built with React. See the
- [README.md][faro-react-readme] for more information.
- [grafana-alloy-docs]: https://grafana.com/docs/alloy/latest/
- [grafana-logs]: https://grafana.com/logs/
- [grafana-traces]: https://grafana.com/traces/
- [faro-core]: ./packages/core
- [faro-core-readme]: ./packages/core/README.md
- [faro-demo]: https://github.com/grafana/quickpizza
- [faro-local-dev]: ./docs/sources/developer/local-development.md
- [faro-pull-requests]: ./docs/PULL_REQUESTS.md
- [faro-quick-start]: ./docs/sources/tutorials/quick-start-browser.md
- [faro-react]: ./packages/react
- [faro-react-readme]: ./packages/react/README.md
- [faro-supported-environments]: https://grafana.com/docs/grafana-cloud/monitor-applications/frontend-observability/introduction/supported-environments/
- [faro-web-sdk]: ./packages/web-sdk
- [faro-web-sdk-readme]: ./packages/web-sdk/README.md
- [faro-web-tracing]: ./packages/web-tracing
- [faro-web-tracing-readme]: ./packages/web-tracing/README.md
- ## Supported environments
- The Faro Web SDK instruments web pages that run in a browser. During initialization, the SDK and most of its default
- instrumentations read browser APIs such as `window`, `document`, `PerformanceObserver` and `sessionStorage`. JavaScript
- that doesn't run in a typical web page context is outside the supported scope.
- | Environment | Supported |
- | -------------------------------------------------------------------------- | --------- |
- | Web applications that run in a browser | Yes |
- | Client-side of server-rendered applications, such as Next.js and React SSR | Yes |
- | Server runtime of server-rendered applications | No |
- | Browser extensions | No |
- | Web workers and service workers | No |
- | Node.js, React Native, and other non-browser JavaScript environments | No |
- Browser extensions come up often, so to be explicit, they are not supported. Some users have made Faro run inside an
- extension by supplying their own set of instrumentations. That configuration is unsupported and we do not accept
- issues for it.
- For the reasoning behind each row, and for what to use instead when monitoring a server or a backend, see
- [supported environments][faro-supported-environments].
- ## Releases
- Faro releases follow the [Semantic Versioning](https://semver.org/) naming scheme: `MAJOR.MINOR.PATCH`.
- - `MAJOR`: Major releases include large new features which will significantly change how Faro operates
- and possible backwards-compatibility breaking changes.
- - `MINOR`: these releases include _new features which generally do not break_ backwards-compatibility.
- - `PATCH`: patch releases include _bug and security fixes_ which do not break backwards-compatibility.
- > NOTE: Our goal is to provide regular releases that are as stable as possible,
- > and we take backwards-compatibility seriously. As with any software, always read the release notes
- > and the upgrade guide whenever choosing a new version of Faro to install.
- ## Supported Node versions
- This section is about the Node versions used to build, test and publish the SDK. Node.js is not a runtime that the SDK
- itself supports. See [supported environments](#supported-environments).
- Faro supports all active LTS (Long Term Support) and current Node versions. When Node.js versions
- reach end-of-life, we remove them from our test matrix and add new versions as they are released.
- You can find a [release schedule on nodejs.org](https://nodejs.org/en/about/previous-releases#looking-for-the-latest-release-of-a-version-branch)
- ---
- ### 📢 Faro v2 is Live! 🎉
- We’re excited to announce that Faro v2 is now available.
- This version modernizes Faro, simplifies setup, and removes legacy code, to give users a cleaner and better performing experience.
- #### ✨ What’s New
- - Web Vitals v5 – Upgraded to v5 of Web Vitals library to remove FID metric and for improved performance.
- - Cleaner Tracing APIs – Removed redundant/deprecated attributes.
- - Simplified Setup – Simplified the console instrumentation configuration.
- - Leaner Core – Deprecated packages and legacy internals were removed for improved stability.
- ##### Follow the upgrade guides for more information
- [Upgrading Guide](https://grafana.com/docs/grafana-cloud/monitor-applications/frontend-observability/instrument/upgrading/upgrade-guide/)
- [v2 Upgrade Guide](https://grafana.com/docs/grafana-cloud/monitor-applications/frontend-observability/instrument/upgrading/upgrade-v2/)
- #### 🚀 Get Involved
- - Contribute on [GitHub](https://github.com/grafana/faro-web-sdk)
- - Share feedback: Grafana's Community Slack - [#faro](https://grafana.slack.com/archives/C048UH68BM5)
- Thanks to all contributors and early adopters for helping us shape Faro v2! 💙
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.