Restructure Node SDK docs. (#5710)

Summary:

- Removed references to client-side usage / snippets.
- Restructured the sidebar to match the flow of other JavaScript docs.
- Moved parts to `platform-includes` when possible.
- Removed outdated remarks / warnings about old versions.

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
Co-authored-by: Francesco Novy <francesco.novy@sentry.io>

Author: 3 people

src/platform-includes/capture-error/node.mdx

@@ -1,8 +1,10 @@
-You can pass an error object to `captureException()` to get it captured as event. It's possible to throw strings as errors in which case no stacktrace can be recorded.
+You can pass an `Error` object to `captureException()` to have it captured as event. It's also possible to pass non-`Error` objects and strings, but be aware that the resulting events in Sentry may be missing a stack trace.
 
 ```javascript
+import * as Sentry from '@sentry/node';
+
 try {
-  // ...
+  aFunctionThatMightFail()
 } catch (e) {
   Sentry.captureException(e);
 }

src/platform-includes/configuration/breadcrumb-hints/_default.mdx

@@ -0,0 +1,19 @@
+`event`
+
+: For breadcrumbs created from browser events, the Sentry SDK often supplies the event to the breadcrumb as a hint. This can be used to extract data from the target DOM element into a breadcrumb, for example.
+
+`level` / `input`
+
+: For breadcrumbs created from console log interceptions. This holds the original console log level and the original input data to the log function.
+
+`response` / `input`
+
+: For breadcrumbs created from HTTP requests. This holds the response object (from the fetch API) and the input parameters to the fetch function.
+
+`request` / `response` / `event`
+
+: For breadcrumbs created from HTTP requests. This holds the request and response object (from the node HTTP API) as well as the node event (`response` or `error`).
+
+`xhr`
+
+: For breadcrumbs created from HTTP requests made using the legacy `XMLHttpRequest` API. This holds the original `xhr` object.

src/platform-includes/configuration/breadcrumb-hints/node.mdx

@@ -0,0 +1,7 @@
+`level` / `input`
+
+: For breadcrumbs created from console log interceptions. This holds the original console log level and the original input data to the log function.
+
+`request` / `response` / `event`
+
+: For breadcrumbs created from HTTP requests. This holds the request and response object (from the node HTTP API) as well as the node event (`response` or `error`).

src/platform-includes/configuration/capture-console/node.mdx

@@ -0,0 +1,15 @@
+```javascript {tabTitle: JavaScript}
+import * as Sentry from "@sentry/node";
+import { CaptureConsole as CaptureConsoleIntegration } from "@sentry/integrations";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [new CaptureConsoleIntegration(
+    {
+      // array of methods that should be captured
+      // defaults to ['log', 'info', 'warn', 'error', 'debug', 'assert']
+      levels: string[];
+    }
+  )],
+});
+```

src/platform-includes/configuration/decluttering/javascript.mdx

@@ -12,7 +12,7 @@ You can also use `denyUrls` if you want to block specific URLs forever.
 
 <Alert level="warning" title="Note">
 
-Prior to version 5.17.0, `allowUrls` and `denyUrls` were called `whitelistUrls` and `blacklistUrls` respectively. These options are still supported for backwards compatibility reasons, but they will be removed in version 7.0. For more information, please see our [Inclusive Language Policy](https://develop.sentry.dev/inclusion/).
+Previously, `allowUrls` and `denyUrls` were called `whitelistUrls` and `blacklistUrls` respectively. These options are removed in version 7.0. For more information, please see our [Inclusive Language Policy](https://develop.sentry.dev/inclusion/).
 
 </Alert>
 

src/platform-includes/configuration/enable-pluggable-integrations/node.mdx

@@ -0,0 +1,28 @@
+```javascript {tabTitle: JavaScript}
+import * as Sentry from "@sentry/browser";
+import { ReportingObserver as ReportingObserverIntegration } from "@sentry/integrations";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [new ReportingObserverIntegration()],
+});
+```
+
+```javascript {tabTitle: CDN}
+<script
+  src="https://browser.sentry-cdn.com/{{ packages.version('sentry.javascript.browser') }}/bundle.min.js"
+  integrity="sha384-{{ packages.checksum('sentry.javascript.browser', 'bundle.min.js', 'sha384-base64') }}"
+  crossorigin="anonymous"
+></script>
+
+<script
+  src="https://browser.sentry-cdn.com/{{ packages.version('sentry.javascript.browser') }}/reportingobserver.min.js"
+  integrity="sha384-{{ packages.checksum('sentry.javascript.browser', 'reportingobserver.min.js', 'sha384-base64') }}"
+  crossorigin="anonymous"
+></script>
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [new Sentry.Integrations.ReportingObserver()],
+});
+```

src/platform-includes/configuration/rewrite-frames/node.mdx

@@ -0,0 +1,30 @@
+```javascript {tabTitle: JavaScript}
+import * as Sentry from "@sentry/node";
+import { RewriteFrames as RewriteFramesIntegration } from "@sentry/integrations";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [new RewriteFramesIntegration(
+    {
+      // root path that will be stripped from the current frame's filename by the default iteratee if the filename is an absolute path
+      root: string;
+
+      // a custom prefix that will be used by the default iteratee (default: `app://`)
+      prefix: string;
+
+      // function that takes the frame, applies a transformation, and returns it
+      iteratee: (frame) => frame;
+    }
+  )],
+});
+```
+
+#### Usage Examples
+
+For example, if the full path to your file is `/www/src/app/file.js`:
+
+| Usage                             | Path in Stack Trace      | Description                                                                                                                   |
+| --------------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
+| `RewriteFrames()`                 | `app:///file.js`         | The default behavior is to replace the absolute path, except the filename, and prefix it with the default prefix (`app:///`). |
+| `RewriteFrames({prefix: 'foo/'})` | `foo/file.js`            | Prefix `foo/` is used instead of the default prefix `app:///`.                                                                |
+| `RewriteFrames({root: '/www'})`   | `app:///src/app/file.js` | `root` is defined as `/www`, so only that part is trimmed from beginning of the path.                                         |

src/platform-includes/performance/configure-sample-rate/node.mdx

@@ -0,0 +1,15 @@
+```javascript {tabTitle: JavaScript}
+import * as Sentry from "@sentry/node";
+import * as _ from "@sentry/tracing"
+// Note: You MUST import the package in some way for tracing to work
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+
+  // To set a uniform sample rate
+  tracesSampleRate: 0.2
+
+  // Alternatively, to control sampling dynamically
+  tracesSampler: samplingContext => { ... }
+});
+```

src/platform-includes/performance/connect-services/node.mdx

@@ -24,4 +24,4 @@ const transaction = Sentry.startTransaction({
   name: 'transaction_name',
   ...traceparentData,
 });
-```
+```

src/platform-includes/sourcemaps/best-practices/javascript.mdx

@@ -29,7 +29,7 @@ plugins: [
     authToken: process.env.SENTRY_AUTH_TOKEN,
     org: "___ORG_SLUG___",
     project: "___PROJECT_SLUG___",
-      include: "build",
+    include: "build",
     configFile: "sentry.properties",
     release: process.env.SENTRY_RELEASE,
   }),