import {Fragment} from 'react';
import ExternalLink from 'sentry/components/links/externalLink';
import List from 'sentry/components/list';
import ListItem from 'sentry/components/list/listItem';
import {Layout, LayoutProps} from 'sentry/components/onboarding/gettingStartedDoc/layout';
import {ModuleProps} from 'sentry/components/onboarding/gettingStartedDoc/sdkDocumentation';
import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/step';
import {t, tct} from 'sentry/locale';
// Configuration Start
export const steps = ({
dsn,
}: {
dsn?: string;
} = {}): LayoutProps['steps'] => [
{
type: StepType.INSTALL,
description: (
{tct('Install the [strong:NuGet] package:', {
strong: ,
})}
),
configurations: [
{
language: 'shell',
description: t('Package Manager:'),
code: 'Install-Package Sentry.AspNetCore -Version 3.34.0',
},
{
language: 'shell',
description: t('Or .NET Core CLI:'),
code: 'dotnet add package Sentry.AspNetCore -v 3.34.0',
},
],
},
{
type: StepType.CONFIGURE,
description: (
{tct(
'Add Sentry to [programCode:Program.cs] through the [webHostCode:WebHostBuilder]:',
{
webHostCode:
,
programCode:
,
}
)}
),
configurations: [
{
language: 'csharp',
code: `
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
// Add the following line:
webBuilder.UseSentry(o =>
{
o.Dsn = "${dsn}";
// When configuring for the first time, to see what the SDK is doing:
o.Debug = true;
// Set TracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
// We recommend adjusting this value in production.
o.TracesSampleRate = 1.0;
});
});
`,
},
],
},
{
type: StepType.VERIFY,
description: t('To verify your set up, you can capture a message with the SDK:'),
configurations: [
{
language: 'csharp',
code: 'SentrySdk.CaptureMessage("Hello Sentry");',
},
],
additionalInfo: (
{tct(
"If you don't want to depend on the static class, the SDK registers a client in the DI container. In this case, you can [link:take [code:IHub] as a dependency].",
{
code:
,
link: (
),
}
)}
),
},
{
title: t('Performance Monitoring'),
description: (
{tct(
'You can measure the performance of your endpoints by adding a middleware to [code:Startup.cs]:',
{
code:
,
}
)}
),
configurations: [
{
language: 'csharp',
code: `
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Sentry.AspNetCore;
public class Startup
{
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseRouting();
// Enable automatic tracing integration.
// If running with .NET 5 or below, make sure to put this middleware
// right after "UseRouting()".
app.UseSentryTracing();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
});
}
}
`,
},
{
description: t(
"You'll be able to monitor the performance of your actions automatically. To add additional spans to it, you can use the API:"
),
language: 'csharp',
code: `
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using Sentry;
public class HomeController : Controller
{
private readonly IHub _sentryHub;
public HomeController(IHub sentryHub) => _sentryHub = sentryHub;
[HttpGet("/person/{id}")]
public IActionResult Person(string id)
{
var childSpan = _sentryHub.GetSpan()?.StartChild("additional-work");
try
{
// Do the work that gets measured.
childSpan?.Finish(SpanStatus.Ok);
}
catch (Exception e)
{
childSpan?.Finish(e);
throw;
}
}
}
`,
},
],
},
{
title: t('Samples'),
description: (
{t(
'See the following examples that demonstrate how to integrate Sentry with various frameworks.'
)}
{tct(
'[link:Multiple samples in the [code:dotnet] SDK repository] [strong:(C#)]',
{
link: (
),
code:
,
strong: ,
}
)}
{tct('[link:Basic F# sample] [strong:(F#)]', {
link: ,
strong: ,
})}
{tct('[link:Giraffe F# sample] [strong:(F#)]', {
link: ,
strong: ,
})}
),
},
];
// Configuration End
export function GettingStartedWithAspnetcore({dsn, ...props}: ModuleProps) {
return ;
}
export default GettingStartedWithAspnetcore;