{"id":13461824,"url":"https://github.com/grafana/faro-web-sdk","last_synced_at":"2025-04-23T20:58:29.794Z","repository":{"id":37089225,"uuid":"409529132","full_name":"grafana/faro-web-sdk","owner":"grafana","description":"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.","archived":false,"fork":false,"pushed_at":"2025-04-23T00:52:54.000Z","size":12878,"stargazers_count":876,"open_issues_count":100,"forks_count":77,"subscribers_count":142,"default_branch":"main","last_synced_at":"2025-04-23T20:58:22.878Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://grafana.com/oss/faro/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grafana.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-09-23T09:30:45.000Z","updated_at":"2025-04-23T00:52:57.000Z","dependencies_parsed_at":"2024-01-02T10:44:04.816Z","dependency_job_id":"ea1174b1-30c0-4942-aeba-93290f10c60a","html_url":"https://github.com/grafana/faro-web-sdk","commit_stats":{"total_commits":614,"total_committers":40,"mean_commits":15.35,"dds":0.6140065146579805,"last_synced_commit":"c9f3798ea43e0ca3c1bc8f6595e9fa8a2607d0e0"},"previous_names":["grafana/grafana-javascript-agent"],"tags_count":99,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Ffaro-web-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Ffaro-web-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Ffaro-web-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Ffaro-web-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grafana","download_url":"https://codeload.github.com/grafana/faro-web-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514767,"owners_count":21443208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T11:00:58.732Z","updated_at":"2025-04-23T20:58:29.775Z","avatar_url":"https://github.com/grafana.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","others","Observability"],"sub_categories":["Real User Monitoring (RUM) \u0026 Frontend Observability"],"readme":"# Grafana Faro Web SDK\n\n[![Build Status][faro-drone-status]][faro-drone]\n\n\u003cp align=\"left\"\u003e\u003cimg src=\"docs/faro_logo.png\" alt=\"Grafana Faro logo\" width=\"400\"\u003e\u003c/p\u003e\n\nThe Grafana Faro Web SDK can instrument frontend JavaScript applications to collect telemetry and forward it to the\n[Grafana Alloy][grafana-alloy-docs] (with faro receiver integration enabled), to a Grafana Cloud instance or to a\ncustom receiver. Grafana Alloy can then send this data to [Loki][grafana-logs] or [Tempo][grafana-traces].\n\nThe repository consists of multiple packages that can be combined depending on your requirements, as well as a\n[demo][faro-demo], which can be run by following the [README.md file][faro-demo-readme].\n\n## Get started\n\n\u003e [!NOTE]\n\u003e 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/).\n\nSee [quick start for web applications][faro-quick-start].\n\n## Packages\n\n### Core\n\n[@grafana/faro-core][faro-core] is the main package that provides the core functionality of the SDK. The\n[README.md][faro-core-readme] file provides an overview of the architecture and the API of library.\n\n### Web SDK\n\n[@grafana/faro-web-sdk][faro-web-sdk] provides instrumentations, metas and transports for use in web applications. See\nthe [README.md][faro-web-sdk-readme] for more information.\n\n### Web Tracing\n\n[@grafana/faro-web-tracing][faro-web-tracing] provides implementation for tracing web applications. See the\n[README.md][faro-web-tracing-readme] for more information.\n\n### React Support\n\n[@grafana/faro-react][faro-react] is a package that enables easier integration in projects built with React. See the\n[README.md][faro-react-readme] for more information.\n\n[faro-drone]: https://drone.grafana.net/grafana/faro-web-sdk\n[faro-drone-status]: https://drone.grafana.net/api/badges/grafana/faro-web-sdk/status.svg\n[grafana-alloy-docs]: https://grafana.com/docs/alloy/latest/\n[grafana-logs]: https://grafana.com/logs/\n[grafana-traces]: https://grafana.com/traces/\n[faro-core]: ./packages/core\n[faro-core-readme]: ./packages/core/README.md\n[faro-demo]: ./demo\n[faro-demo-readme]: ./demo/README.md\n[faro-quick-start]: ./docs/sources/tutorials/quick-start-browser.md\n[faro-react]: ./packages/react\n[faro-react-readme]: ./packages/react/README.md\n[faro-web-sdk]: ./packages/web-sdk\n[faro-web-sdk-readme]: ./packages/web-sdk/README.md\n[faro-web-tracing]: ./packages/web-tracing\n[faro-web-tracing-readme]: ./packages/web-tracing/README.md\n\n## Releases\n\nFaro releases follow the [Semantic Versioning](https://semver.org/) naming scheme: `MAJOR.MINOR.PATCH`.\n\n- `MAJOR`: Major releases include large new features which will significantly change how Faro operates\n  and possible backwards-compatibility breaking changes.\n- `MINOR`: these releases include _new features which generally do not break_ backwards-compatibility.\n- `PATCH`: patch releases include _bug and security fixes_ which do not break backwards-compatibility.\n\n  \u003e NOTE: Our goal is to provide regular releases that are as stable as possible,\n  \u003e and we take backwards-compatibility seriously. As with any software, always read the release notes\n  \u003e and the upgrade guide whenever choosing a new version of Faro to install.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrafana%2Ffaro-web-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrafana%2Ffaro-web-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrafana%2Ffaro-web-sdk/lists"}