{"id":26576654,"url":"https://github.com/getsentry/sentry-fullstory","last_synced_at":"2025-04-06T05:15:15.775Z","repository":{"id":36141319,"uuid":"219806488","full_name":"getsentry/sentry-fullstory","owner":"getsentry","description":"The Sentry-FullStory integration seamlessly integrates the Sentry and FullStory platforms.","archived":false,"fork":false,"pushed_at":"2025-03-24T17:23:23.000Z","size":189,"stargazers_count":40,"open_issues_count":1,"forks_count":12,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-03-30T04:08:20.875Z","etag":null,"topics":["tag-production"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getsentry.png","metadata":{"funding":{"custom":["https://sentry.io/pricing/","https://sentry.io/"]},"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-05T17:43:55.000Z","updated_at":"2025-03-24T17:23:27.000Z","dependencies_parsed_at":"2023-12-12T18:22:53.418Z","dependency_job_id":"5c923fa9-3060-449b-98e0-56b44ef5d317","html_url":"https://github.com/getsentry/sentry-fullstory","commit_stats":{"total_commits":58,"total_committers":12,"mean_commits":4.833333333333333,"dds":0.5172413793103448,"last_synced_commit":"3de5e77d8d661e44a894100d108307196deaf91b"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsentry-fullstory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsentry-fullstory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsentry-fullstory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsentry-fullstory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getsentry","download_url":"https://codeload.github.com/getsentry/sentry-fullstory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436284,"owners_count":20938533,"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":["tag-production"],"created_at":"2025-03-23T03:24:29.945Z","updated_at":"2025-04-06T05:15:15.733Z","avatar_url":"https://github.com/getsentry.png","language":"TypeScript","readme":"# Sentry FullStory\n\nThe `@sentry/fullstory` integration seamlessly integrates the Sentry and FullStory platforms. When you look at a browser error in Sentry, you will see a link to the FullStory session replay at that exact moment in time. When you are watching a FullStory replay and your user experiences an error, you will see a link that will take you to that error in Sentry.\n\n## Pre-Requisites\n\nFor the Sentry-FullStory integration to work, you must have the [Sentry Browser SDK package](https://www.npmjs.com/package/@sentry/browser) or the [Sentry React Native SDK package](https://www.npmjs.com/package/@sentry/react-native) and the [FullStory Browser SDK package](https://www.npmjs.com/package/@fullstory/browser) or the [FullStory React Native SDK package](https://www.npmjs.com/package/@fullstory/react-native) respectively.\n\n### On-Premise Installations\n\nIf you are using on-premise Sentry (not sentry.io), then you must have Sentry version `20.6.0` or higher.\n\n## Installation\n\nTo install the stable version:\n\nwith npm:\n\n```\nnpm install --save @sentry/fullstory\n```\n\nwith yarn:\n\n```\nyarn add @sentry/fullstory\n```\n\n## Setup\n\nFirst, grab your Sentry organization slug. You can get that value from the URL of your sentry organization. Example: `https://fullstory.sentry.io/` where `fullstory` would be the value of the organization slug.\n\nNext, grab your FullStory organization ID. You can get that value from the FullStory recording snippet on your [FullStory settings page](https://help.fullstory.com/hc/en-us/articles/360020623514).\n\n### Code Changes\n\nTo set up the integration, both FullStory and Sentry need to be initialized. Make sure to replace `__FULLSTORY_ORG_ID__` with your FullStory organization ID and `__SENTRY_ORG_SLUG__` with your Sentry organization slug.\n\n#### Browser\n\n```javascript\nimport * as Sentry from '@sentry/browser';\nimport { fullStoryIntegration } from '@sentry/fullstory';\n\nimport { FullStory, init } from '@fullstory/browser';\n// v1 import:\n// import * as FullStory from '@fullstory/browser';\n\ninit({ orgId: '__FULLSTORY_ORG_ID__' });\n\nSentry.init({\n  dsn: '__DSN__',\n  integrations: [\n    fullStoryIntegration('__SENTRY_ORG_SLUG__', { client: FullStory }),\n  ],\n});\n```\n\n#### React Native\n\n```javascript\nimport * as Sentry from '@sentry/react-native';\nimport { fullStoryIntegration } from '@sentry/fullstory';\n\nimport FullStory from '@fullstory/react-native';\n\nFullStory.init({ orgId: '__FULLSTORY_ORG_ID__' });\n\nSentry.init({\n  dsn: '__DSN__',\n  integrations: [\n    fullStoryIntegration('__SENTRY_ORG_SLUG__', { client: FullStory }),\n  ],\n});\n```\n\n### Sentry Settings Change\n\nIn order for this integration to work properly, you need to whitelist the `fullStoryUrl` field in your Sentry settings. If you don't, the FullStory URL might be scrubbed because the session ID matches a credit card regex. To do this change, go to `Settings` -\u003e `Security \u0026 Privacy` and add `fullStoryUrl` to the `Global Safe Fields` entry.\n\n![Settings](https://i.imgur.com/zk0hShj.png)\n\n## How it works\n\nIn Sentry, you should see additional context of your error that has the `fullStoryUrl` below the breadcrumbs and other information:\n\n![Sentry](https://i.imgur.com/O4r4Wvq.png)\n\nIn FullStory, you should see an event called `Sentry Error` on the right sidebar that has a link to the error in Sentry:\n\n![FullStory](https://i.imgur.com/FutjI0R.png)\n\n## Contributing\n\nWe welcome community contributions to `@sentry/fullstory`! If you have an idea for a feature or a bug fix, don't hesitate to open an issue or a pull request.\n\nSee the [Contributing Guide](CONTRIBUTING.md) for more information.\n\n## Version Compatibility\n\nThe Sentry FullStory integration is compatible with Sentry JavaScript SDK 9.x and above. If you need to support Sentry JavaScript SDK 8.x, please use version 3.x of this integration.\n\n| Sentry FullStory Integration Version | Sentry JavaScript SDK Version |\n| ------------------------------------ | ----------------------------- |\n| 4.x                                  | 9.x                           |\n| 3.x                                  | 8.x                           |\n| 2.x                                  | 7.x                           |\n","funding_links":["https://sentry.io/pricing/","https://sentry.io/"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsentry%2Fsentry-fullstory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetsentry%2Fsentry-fullstory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsentry%2Fsentry-fullstory/lists"}