add instruction on node --require

Author: andreiborza

docs/platforms/javascript/guides/node/index.mdx

@@ -37,16 +37,28 @@ Sentry should be initialized as early in your app as possible. It is essential t
 
 Once this is done, Sentry's Node SDK captures unhandled exceptions as well as tracing data for your application.
 
+Therefore, we recommend to create a file named `instrumentation.js` that imports and initializes Sentry.
+
 <PlatformContent includePath="getting-started-config" />
 
 If you set a `tracesSampleRate`, performance instrumentation will automatically be enabled for you. See <PlatformLink to="/performance/instrumentation/automatic-instrumentation">Automatic Instrumentation</PlatformLink> to learn about all the things that the SDK automatically instruments for you.
 
 You can also manually capture performance data - see <PlatformLink to="/performance/instrumentation/custom-instrumentation">Custom Instrumentation</PlatformLink> for details.
 
-<Include  name="node-esm-compatibility" />
+## Run
+
+Adjust the Node.js call for your application to use the [--require](https://nodejs.org/api/cli.html#-r---require-module) parameter and point it at `instrumentation.js`
+
+<PlatformContent includePath="getting-started-run" />
+
+Alternatively, if you cannot use [--require](https://nodejs.org/api/cli.html#-r---require-module), import `instrumentation.js` at the top of your application.
+
+<PlatformContent includePath="getting-started-run-alternative" />
 
 <PlatformContent includePath="getting-started-sourcemaps" />
 
+<Include  name="node-esm-compatibility" />
+
 ## Verify
 
 This snippet includes an intentional error, so you can test that everything is working as soon as you set it up.

platform-includes/getting-started-config/javascript.node.mdx

@@ -11,10 +11,6 @@ Sentry.init({
   // We recommend adjusting this value in production
   tracesSampleRate: 1.0,
 });
-
-// http and other libraries are only instrumented
-// if required _after_ Sentry has been initialized
-const http = require("http");
 ```
 
 ```javascript {tabTitle:ESM}
@@ -28,8 +24,4 @@ Sentry.init({
   // We recommend adjusting this value in production
   tracesSampleRate: 1.0,
 });
-
-// http and other libraries are only instrumented
-// if imported _after_ Sentry has been initialized
-import http from "http";
 ```

platform-includes/getting-started-run-alternative/javascript.node.mdx

@@ -0,0 +1,17 @@
+<SignInNote />
+
+```javascript {tabTitle:CommonJS}
+require('./instrumentation.js')
+
+// http and other libraries are only instrumented
+// if required _after_ Sentry has been initialized
+const http = require("http");
+```
+
+```javascript {tabTitle:ESM}
+import './instrumentation.js'
+
+// http and other libraries are only instrumented
+// if imported _after_ Sentry has been initialized
+import http from "http";
+```

platform-includes/getting-started-run/javascript.node.mdx

@@ -0,0 +1,3 @@
+```bash
+node --require ./instrumentation.js ./your/app.js
+```