feat(ddm-onboarding): Add dotnet instructions (#63194)

Add custom metrics onboarding instructions for `dotnet`,
`dotnet-aspnetcore`, `dotnet-awslambda`, `dotnet-gcpfunctions`,
`dotnet-maui`, `dotnet-uwp`, `dotnet-winforms` and `dotnet-wpf`.

- closes #63180

Author: ArthurKnaus

static/app/components/onboarding/gettingStartedDoc/utils/metricsOnboarding.tsx

@@ -118,7 +118,7 @@ export const getJSServerMetricsOnboarding = (): OnboardingConfig => ({
     {
       type: StepType.INSTALL,
       description: tct(
-        'You need a minimum version [codeVersion:4.17.0] of [codeNode:@sentry/node], [codeDeno:@sentry/deno] or [codeBun:@sentry/bun].',
+        'You need a minimum version [codeVersion:7.91.0] of [codeNode:@sentry/node], [codeDeno:@sentry/deno] or [codeBun:@sentry/bun].',
         {
           codeVersion: <code />,
           codeNode: <code />,
@@ -300,3 +300,92 @@ export const getPythonMetricsOnboarding = ({
     },
   ],
 });
+
+const getDotnetConfigureSnippet = (params: DocsParams) => `
+SentrySdk.Init(options =>
+  {
+    options.Dsn = "${params.dsn}";
+    options.ExperimentalMetrics = new ExperimentalMetricsOptions
+    {
+      EnableCodeLocations = true
+    };
+  });`;
+
+const getDotnetVerifySnippet = () => `
+SentrySdk.Metrics.Increment(
+  "drank-drinks",
+  tags:new Dictionary<string, string> {{"kind", "coffee"}}
+);`;
+
+export const getDotnetMetricsOnboarding = ({
+  packageName,
+}: {
+  packageName: string;
+}): OnboardingConfig => ({
+  install: () => [
+    {
+      type: StepType.INSTALL,
+      description: tct(
+        'You need a minimum version [codeVersion:4.0.0-beta.8] of the .NET SDK installed',
+        {
+          codeVersion: <code />,
+        }
+      ),
+      configurations: [
+        {
+          language: 'powershell',
+          code: `dotnet add package ${packageName} -v 4.0.0-beta.8`,
+        },
+      ],
+    },
+  ],
+  configure: params => [
+    {
+      type: StepType.CONFIGURE,
+      description: t(
+        'Once the SDK is installed or updated, you can enable the experimental metrics feature and code locations being emitted in your SDK init.'
+      ),
+      configurations: [
+        {
+          language: 'csharp',
+          code: getDotnetConfigureSnippet(params),
+        },
+      ],
+    },
+  ],
+  verify: () => [
+    {
+      type: StepType.VERIFY,
+      description: tct(
+        "Then you'll be able to add metrics as [codeCounters:counters], [codeSets:sets], [codeDistribution:distributions], and [codeGauge:gauges]. Try out this example:",
+        {
+          codeCounters: <code />,
+          codeSets: <code />,
+          codeDistribution: <code />,
+          codeGauge: <code />,
+        }
+      ),
+      configurations: [
+        {
+          language: 'csharp',
+          code: getDotnetVerifySnippet(),
+        },
+        {
+          description: t(
+            'With a bit of delay you can see the data appear in the Sentry UI.'
+          ),
+        },
+        {
+          description: tct(
+            'Learn more about metrics and how to configure them, by reading the [docsLink:docs].',
+            {
+              docsLink: (
+                <ExternalLink href="https://github.com/getsentry/sentry-laravel/discussions/823" />
+              ),
+            }
+          ),
+        },
+      ],
+    },
+  ],
+});

static/app/data/platformCategories.tsx

@@ -379,6 +379,14 @@ export const replayJsLoaderInstructionsPlatformList: readonly PlatformKey[] = [
 
 const customMetricBackendPlatforms: readonly PlatformKey[] = [
   'bun',
+  'dotnet',
+  'dotnet-aspnetcore',
+  'dotnet-awslambda',
+  'dotnet-gcpfunctions',
+  'dotnet-maui',
+  'dotnet-uwp',
+  'dotnet-winforms',
+  'dotnet-wpf',
   'php',
   'php-laravel',
   // TODO: Enable once metrics are available for Symfony

static/app/gettingStartedDocs/bun/bun.tsx

@@ -107,7 +107,7 @@ const customMetricsOnboarding: OnboardingConfig = {
     {
       type: StepType.INSTALL,
       description: tct(
-        'You need a minimum version [codeVersion:4.17.0] of [codePackage:@sentry/bun].',
+        'You need a minimum version [codeVersion:7.91.0] of [codePackage:@sentry/bun].',
         {
           codeVersion: <code />,
           codePackage: <code />,

static/app/gettingStartedDocs/dotnet/aspnetcore.tsx

@@ -9,6 +9,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import replayOnboardingJsLoader from 'sentry/gettingStartedDocs/javascript/jsLoader/jsLoader';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
@@ -233,6 +234,7 @@ const onboarding: OnboardingConfig = {
 const docs: Docs = {
   onboarding,
   replayOnboardingJsLoader,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry.AspNetCore'}),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/awslambda.tsx

@@ -7,6 +7,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -155,6 +156,7 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry.AspNetCore'}),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/dotnet.tsx

@@ -9,6 +9,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -200,6 +201,7 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry'}),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/gcpfunctions.tsx

@@ -9,6 +9,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -195,6 +196,9 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({
+    packageName: 'Sentry.Google.Cloud.Functions',
+  }),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/maui.tsx

@@ -7,6 +7,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -204,6 +205,7 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry.Maui'}),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/uwp.tsx

@@ -11,6 +11,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -227,6 +228,7 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry'}),
 };
 
 export default docs;

static/app/gettingStartedDocs/dotnet/winforms.tsx

@@ -11,6 +11,7 @@ import type {
   DocsParams,
   OnboardingConfig,
 } from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {getDotnetMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
 import {t, tct} from 'sentry/locale';
 import {getPackageVersion} from 'sentry/utils/gettingStartedDocs/getPackageVersion';
 
@@ -199,6 +200,7 @@ const onboarding: OnboardingConfig = {
 
 const docs: Docs = {
   onboarding,
+  customMetricsOnboarding: getDotnetMetricsOnboarding({packageName: 'Sentry'}),
 };
 
 export default docs;