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, sourcePackageRegistries, }: Partial< Pick > = {}): LayoutProps['steps'] => [ { type: StepType.INSTALL, description: (

{tct('Install the [strong:NuGet] package:', { strong: , })}

), configurations: [ { language: 'shell', partialLoading: sourcePackageRegistries?.isLoading, description: t('Package Manager:'), code: `Install-Package Sentry.AspNetCore -Version ${ sourcePackageRegistries?.isLoading ? t('\u2026loading') : sourcePackageRegistries?.data?.['sentry.dotnet.aspnetcore']?.version ?? '3.34.0' }`, }, { language: 'shell', partialLoading: sourcePackageRegistries?.isLoading, description: t('Or .NET Core CLI:'), code: `dotnet add package Sentry.AspNetCore -v ${ sourcePackageRegistries?.isLoading ? t('\u2026loading') : sourcePackageRegistries?.data?.['sentry.dotnet.aspnetcore']?.version ?? '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, sourcePackageRegistries, ...props }: ModuleProps) { return ; } export default GettingStartedWithAspnetcore;