All Skills > SDK Setup > .NET SDK

Sentry .NET SDK

.NET プロジェクトをスキャンして、完全な Sentry セットアップを案内する意見を持ったウィザード：エラー監視、分散トレース、プロファイリング、構造化ロギング、およびすべての主要な .NET フレームワークにおける cron 監視。

このスキルを呼び出す場合

• ユーザーが「.NET に Sentry を追加」「C# で Sentry をセットアップ」「ASP.NET Core に Sentry をインストール」と依頼した場合
• ユーザーが .NET アプリのエラー監視、トレース、プロファイリング、ロギング、または crons を望んでいる場合
• ユーザーが SentrySdk.Init、UseSentry、Sentry.AspNetCore、または Sentry.Maui について言及した場合
• ユーザーが WPF、WinForms、MAUI、または Azure Functions でハンドルされない例外をキャプチャしたい場合
• ユーザーが SentryOptions、BeforeSend、TracesSampleRate、またはシンボルアップロードについて質問した場合

注記： 以下の SDK バージョンおよび API は Sentry NuGet パッケージ ≥6.1.0 を反映しています。 実装する前に必ず docs.sentry.io/platforms/dotnet/ で確認してください。

---

フェーズ 1：検出

推奨を行う前にプロジェクトを理解するために、これらのコマンドを実行します：

# フレームワークタイプを検出 — すべての .csproj ファイルを検索
find . -name "*.csproj" | head -20

# フレームワークターゲットを検出
grep -r "TargetFramework\|Project Sdk" --include="*.csproj" .

# 既存の Sentry パッケージを確認
grep -r "Sentry" --include="*.csproj" . | grep "PackageReference"

# スタートアップファイルを確認
ls Program.cs src/Program.cs App.xaml.cs MauiProgram.cs 2>/dev/null

# appsettings を確認
ls appsettings.json src/appsettings.json 2>/dev/null

# ロギングライブラリを確認
grep -r "Serilog\|NLog\|log4net" --include="*.csproj" .

# コンパニオンフロントエンドを確認
ls ../frontend ../client ../web 2>/dev/null
cat ../package.json 2>/dev/null | grep -E '"next"|"react"|"vue"' | head -3

決定すべきポイント：

質問	影響
フレームワークのタイプ？	正しいパッケージと初期化パターンを決定します
.NET バージョン？	.NET 8+ を推奨；.NET Framework 4.6.2+ がサポートされています
Sentry は既にインストール済み？	インストールをスキップし、機能設定に移動します
ロギングライブラリ（Serilog、NLog）？	対応する Sentry sink/target を推奨します
非同期/ホストされたアプリ（ASP.NET Core）？	WebHost で UseSentry() を使用；IsGlobalModeEnabled は不要
デスクトップアプリ（WPF、WinForms、WinUI）？	IsGlobalModeEnabled = true を設定する必要があります
サーバーレス（Azure Functions、Lambda）？	FlushOnCompletedRequest = true を設定する必要があります
フロントエンドディレクトリが見つかった？	フェーズ 4 のクロスリンクをトリガーします

フレームワーク → パッケージマッピング：

検出	インストールするパッケージ
Sdk="Microsoft.NET.Sdk.Web"（ASP.NET Core）	Sentry.AspNetCore
Application ベースを持つ App.xaml.cs	Sentry（WPF）
Program.cs 内の [STAThread]	Sentry（WinForms）
MauiProgram.cs	Sentry.Maui
WebAssemblyHostBuilder	Sentry.AspNetCore.Blazor.WebAssembly
FunctionsStartup	Sentry.Extensions.Logging + Sentry.OpenTelemetry
HttpApplication / Global.asax	Sentry.AspNet
汎用ホスト / ワーカーサービス	Sentry.Extensions.Logging

---

フェーズ 2：推奨

見つけたものに基づいて具体的な推奨を提示します。提案をリードします — オープンエンドの質問をしないでください。

推奨（コアカバレッジ）：

• ✅ エラー監視 — 常に；ハンドルされない例外、構造化キャプチャ、スコープエンリッチメント |
• ✅ トレース — ASP.NET Core とホストされたアプリの場合は常に；HTTP リクエストと EF Core クエリを自動計測します |
• ✅ ロギング — すべてのアプリで推奨；ILogger / Serilog / NLog エントリを Sentry ブレッドクラムとイベントとしてルーティングします |

オプション（強化された可観測性）：

• ⚡ プロファイリング — CPU プロファイリング；.NET 6+ で実行されるパフォーマンスクリティカルなサービスで推奨します |
• ⚡ メトリクス — トレースにリンクされたカウンター、ゲージ、分布；カスタムビジネスメトリクスが必要なアプリで推奨します |
• ⚡ Crons — スケジュール済みジョブの欠落/失敗を検出；Hangfire、Quartz.NET、またはスケジュール済みエンドポイント検出時に推奨します |

推奨ロジック：

機能	推奨する場合...
エラー監視	常に — 交渉の余地がないベースライン
トレース	ASP.NET Core の場合は常に — リクエストトレース、EF Core スパン、HttpClient スパンは高価値
ロギング	アプリが ILogger<T>、Serilog、NLog、または log4net を使用している場合
プロファイリング	.NET 6+ で実行されるパフォーマンスクリティカルなサービス
メトリクス	アプリがカスタムビジネスメトリクス（リクエスト数、キューの深さ、応答時間）を必要とする場合
Crons	アプリが Hangfire、Quartz.NET、またはスケジュール済み Azure Functions を使用している場合

提案：「エラー監視 + トレース + ロギングのセットアップを推奨します。プロファイリングまたは Crons も追加しますか？」

---

フェーズ 3：ガイド

オプション 1：ウィザード（推奨）

このウィザードは自分自身で実行する必要があります — ウィザードはブラウザーでログインするために開き、エージェントが処理できないインタラクティブな入力が必要です。ターミナルにコピーペーストしてください：

npx @sentry/wizard@latest -i dotnet

ログイン、org/プロジェクト選択、DSN 設定、および MSBuild シンボルアップロード設定を処理し、本番環境で読み取り可能なスタックトレースを実現します。

完了したら戻ってきて、検証にスキップしてください。

ユーザーがウィザードをスキップした場合、以下のオプション 2（マニュアルセットアップ）に進みます。

---

オプション 2：マニュアルセットアップ

適切なパッケージをインストールする

# ASP.NET Core
dotnet add package Sentry.AspNetCore -v 6.1.0

# WPF または WinForms または コンソール
dotnet add package Sentry -v 6.1.0

# .NET MAUI
dotnet add package Sentry.Maui -v 6.1.0

# Blazor WebAssembly
dotnet add package Sentry.AspNetCore.Blazor.WebAssembly -v 6.1.0

# Azure Functions（分離ワーカー）
dotnet add package Sentry.Extensions.Logging -v 6.1.0
dotnet add package Sentry.OpenTelemetry -v 6.1.0

# クラシック ASP.NET（System.Web / .NET Framework）
dotnet add package Sentry.AspNet -v 6.1.0

---

ASP.NET Core — Program.cs

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.UseSentry(options =>
{
    options.Dsn = Environment.GetEnvironmentVariable("SENTRY_DSN")
                  ?? "___YOUR_DSN___";
    options.Debug = true;                         // 本番環境では無効化
    options.SendDefaultPii = true;                // ユーザー IP、名前、メールをキャプチャ
    options.MaxRequestBodySize = RequestSize.Always;
    options.MinimumBreadcrumbLevel = LogLevel.Debug;
    options.MinimumEventLevel = LogLevel.Warning;
    options.TracesSampleRate = 1.0;               // 本番環境では 0.1–0.2 に調整
    options.SetBeforeSend((@event, hint) =>
    {
        @event.ServerName = null;                 // イベントからホスト名を削除
        return @event;
    });
});

var app = builder.Build();
app.Run();

appsettings.json（代替設定）：

{
  "Sentry": {
    "Dsn": "___YOUR_DSN___",
    "SendDefaultPii": true,
    "MaxRequestBodySize": "Always",
    "MinimumBreadcrumbLevel": "Debug",
    "MinimumEventLevel": "Warning",
    "AttachStacktrace": true,
    "Debug": true,
    "TracesSampleRate": 1.0,
    "Environment": "production",
    "Release": "my-app@1.0.0"
  }
}

環境変数（セパレーターとしてダブルアンダースコア）：

export Sentry__Dsn="https://examplePublicKey@o0.ingest.sentry.io/0"
export Sentry__TracesSampleRate="0.1"
export Sentry__Environment="staging"

---

WPF — App.xaml.cs

⚠️ 重要： OnStartup() ではなくコンストラクターで初期化してください。コンストラクターはより早く実行され、より多くの失敗モードをキャッチします。

using System.Windows;
using Sentry;

public partial class App : Application
{
    public App()
    {
        SentrySdk.Init(options =>
        {
            options.Dsn = "___YOUR_DSN___";
            options.Debug = true;
            options.SendDefaultPii = true;
            options.TracesSampleRate = 1.0;
            options.IsGlobalModeEnabled = true;   // すべてのデスクトップアプリで必須
        });

        // WPF UI スレッド例外をキャプチャ（WPF のクラッシュダイアログの前）
        DispatcherUnhandledException += App_DispatcherUnhandledException;
    }

    private void App_DispatcherUnhandledException(
        object sender,
        System.Windows.Threading.DispatcherUnhandledExceptionEventArgs e)
    {
        SentrySdk.CaptureException(e.Exception);
        // クラッシュダイアログを防ぎ、アプリを実行し続けるには e.Handled = true を設定
    }
}

---

WinForms — Program.cs

using System;
using System.Windows.Forms;
using Sentry;

static class Program
{
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);

        // 必須：Sentry がハンドルされない WinForms 例外を見ることができます
        Application.SetUnhandledExceptionMode(UnhandledExceptionMode.ThrowException);

        using (SentrySdk.Init(new SentryOptions
        {
            Dsn = "___YOUR_DSN___",
            Debug = true,
            TracesSampleRate = 1.0,
            IsGlobalModeEnabled = true,           // デスクトップアプリで必須
        }))
        {
            Application.Run(new MainForm());
        } // Disposing で保留中のすべてのイベントをフラッシュ
    }
}

---

.NET MAUI — MauiProgram.cs

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseSentry(options =>
            {
                options.Dsn = "___YOUR_DSN___";
                options.Debug = true;
                options.SendDefaultPii = true;
                options.TracesSampleRate = 1.0;
                // MAUI 固有：ブレッドクラムのオプトイン（デフォルトではオフ — PII リスク）
                options.IncludeTextInBreadcrumbs = false;
                options.IncludeTitleInBreadcrumbs = false;
                options.IncludeBackgroundingStateInBreadcrumbs = false;
            });

        return builder.Build();
    }
}

---

Blazor WebAssembly — Program.cs

var builder = WebAssemblyHostBuilder.CreateDefault(args);

builder.UseSentry(options =>
{
    options.Dsn = "___YOUR_DSN___";
    options.Debug = true;
    options.SendDefaultPii = true;
    options.TracesSampleRate = 0.1;
});

// SDK を再初期化せずにロギングパイプラインをフック
builder.Logging.AddSentry(o => o.InitializeSdk = false);

await builder.Build().RunAsync();

---

Azure Functions（分離ワーカー） — Program.cs

using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using OpenTelemetry.Trace;
using Sentry.OpenTelemetry;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.AddOpenTelemetry().WithTracing(builder =>
        {
            builder
                .AddSentry()                        // OTel スパンを Sentry にルート
                .AddHttpClientInstrumentation();    // 送信 HTTP をキャプチャ
        });
    })
    .ConfigureLogging(logging =>
    {
        logging.AddSentry(options =>
        {
            options.Dsn = "___YOUR_DSN___";
            options.Debug = true;
            options.TracesSampleRate = 1.0;
            options.UseOpenTelemetry();                     // OTel でトレースを駆動
            options.DisableSentryHttpMessageHandler = true; // 重複 HTTP スパンを防止
        });
    })
    .Build();

await host.RunAsync();

---

AWS Lambda — LambdaEntryPoint.cs

public class LambdaEntryPoint : APIGatewayProxyFunction
{
    protected override void Init(IWebHostBuilder builder)
    {
        builder
            .UseSentry(options =>
            {
                options.Dsn = "___YOUR_DSN___";
                options.TracesSampleRate = 1.0;
                options.FlushOnCompletedRequest = true; // Lambda で必須
            })
            .UseStartup<Startup>();
    }
}

---

クラシック ASP.NET — Global.asax.cs

public class MvcApplication : HttpApplication
{
    private IDisposable _sentry;

    protected void Application_Start()
    {
        _sentry = SentrySdk.Init(options =>
        {
            options.Dsn = "___YOUR_DSN___";
            options.TracesSampleRate = 1.0;
            options.AddEntityFramework(); // EF6 クエリブレッドクラム
            options.AddAspNet();          // クラシック ASP.NET 統合
        });
    }

    protected void Application_Error() => Server.CaptureLastError();

    protected void Application_BeginRequest() => Context.StartSentryTransaction();
    protected void Application_EndRequest() => Context.FinishSentryTransaction();

    protected void Application_End() => _sentry?.Dispose();
}

---

シンボルアップロード（読み取り可能なスタックトレース）

デバッグシンボルなしでは、スタックトレースはメソッド名のみを表示します — ファイル名と行番号はありません。PDB ファイルをアップロードして、完全なソースコンテキストを解除します。

ステップ 1：Sentry 認証トークンを作成します

sentry.io/settings/auth-tokens/ に移動し、project:releases と org:read スコープを持つトークンを作成します。

ステップ 2：MSBuild プロパティを .csproj または Directory.Build.props に追加します：

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
  <SentryOrg>___ORG_SLUG___</SentryOrg>
  <SentryProject>___PROJECT_SLUG___</SentryProject>
  <SentryUploadSymbols>true</SentryUploadSymbols>
  <SentryUploadSources>true</SentryUploadSources>
  <SentryCreateRelease>true</SentryCreateRelease>
  <SentrySetCommits>true</SentrySetCommits>
</PropertyGroup>

ステップ 3：CI で SENTRY_AUTH_TOKEN を設定します：

# GitHub Actions
- name: Build & upload symbols
  run: dotnet build -c Release
  env:
    SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}

---

合意したそれぞれの機能について

対応する参照ファイルを読み込み、その手順に従います：

機能	参照ファイル	読み込む場合...
エラー監視	references/error-monitoring.md	常に — CaptureException、スコープ、エンリッチメント、フィルタリング
トレース	references/tracing.md	サーバーアプリ、分散トレース、EF Core スパン、カスタム計測
プロファイリング	references/profiling.md	.NET 6+ で実行されるパフォーマンスクリティカルなアプリ
ロギング	references/logging.md	ILogger<T>、Serilog、NLog、log4net 統合
メトリクス	references/metrics.md	カスタムカウンター、ゲージ、分布；EmitCounter、EmitGauge、EmitDistribution
Crons	references/crons.md	Hangfire、Quartz.NET、またはスケジュール済み関数監視

各機能について：参照ファイルを読み、その手順を正確に実行し、先に進む前に検証します。

---

検証

ウィザードまたはマニュアルセットアップの後、テストスロー追加し、検証後に削除します：

// ASP.NET Core：一時的なエンドポイントを追加
app.MapGet("/sentry-test", () =>
{
    throw new Exception("Sentry test error — delete me");
});

// または明示的にどこかでキャプチャ
SentrySdk.CaptureException(new Exception("Sentry test error — delete me"));

次に Sentry Issues ダッシュボードをチェックします — エラーは約 30 秒以内に表示されるはずです。

検証チェックリスト：

チェック	方法
例外がキャプチャされる	テスト例外をスロー、Sentry Issues で検証
スタックトレースが読み取り可能	ファイル名と行番号が表示されることを確認
トレースが有効	Performance タブでトランザクションを確認
ロギングが接続	ILogger 経由でエラーをログ、Sentry ブレッドクラムとして表示されることを確認
シンボルアップロードが機能	スタックトレースが Controllers/HomeController.cs:42 を表示し、<unknown> ではないことを確認

---

設定リファレンス

コア SentryOptions

オプション	型	デフォルト	環境変数	注記
Dsn	string	—	SENTRY_DSN	必須。未設定の場合 SDK は無効です。
Debug	bool	false	—	SDK 診断出力。本番環境では無効化。
DiagnosticLevel	SentryLevel	Debug	—	Debug、Info、Warning、Error、Fatal
Release	string	自動	SENTRY_RELEASE	アセンブリバージョン + git SHA から自動検出
Environment	string	"production"	SENTRY_ENVIRONMENT	デバッガーがアタッチされている場合は "debug"
Dist	string	—	—	ビルドバリアント。最大 64 文字。
SampleRate	float	1.0	—	エラーイベントサンプリングレート 0.0–1.0
TracesSampleRate	double	0.0	—	トランザクションサンプリング。有効化するには > 0 である必要があります。
TracesSampler	Func<SamplingContext, double>	—	—	トランザクション単位の動的サンプラー；TracesSampleRate をオーバーライド
ProfilesSampleRate	double	0.0	—	トレースされたトランザクションのプロファイリング分数。Sentry.Profiling が必要です。
SendDefaultPii	bool	false	—	ユーザー IP、名前、メールを含める
AttachStacktrace	bool	true	—	すべてのメッセージにスタックトレースをアタッチ
MaxBreadcrumbs	int	100	—	イベントごとに保存されるブレッドクラムの最大数
IsGlobalModeEnabled	bool	false*	—	*MAUI、Blazor WASM の場合自動 true。WPF、WinForms、コンソールの場合は true である必須。
AutoSessionTracking	bool	false*	—	*MAUI の場合自動 true。Release Health の場合有効化。
CaptureFailedRequests	bool	true	—	HTTP クライアントエラーを自動キャプチャ
CacheDirectoryPath	string	—	—	オフラインイベントキャッシングディレクトリ
ShutdownTimeout	TimeSpan	—	—	シャットダウン時のイベントフラッシュの最大待機時間
HttpProxy	string	—	—	Sentry リクエストのプロキシ URL
EnableBackpressureHandling	bool	true	—	配信失敗時にサンプルレートを自動削減
TraceIgnoreStatusCodes	IList<HttpStatusCodeRange>	[]	—	HTTP レスポンスステータスが任意の範囲に一致するトランザクションをドロップ；例：[404] または [(500, 599)]

ASP.NET Core 拡張オプション（SentryAspNetCoreOptions）

オプション	型	デフォルト	注記
MaxRequestBodySize	RequestSize	None	None、Small（~4 KB）、Medium（~10 KB）、Always
MinimumBreadcrumbLevel	LogLevel	Information	ブレッドクラムの最小ログレベル
MinimumEventLevel	LogLevel	Error	Sentry イベントとして送信する最小ログレベル
CaptureBlockingCalls	bool	false	.Wait() / .Result スレッドプール枯渇を検出
FlushOnCompletedRequest	bool	false	Lambda / サーバーレスで必須
IncludeActivityData	bool	false	System.Diagnostics.Activity 値をキャプチャ

MAUI 拡張オプション（SentryMauiOptions）

オプション	型	デフォルト	注記
IncludeTextInBreadcrumbs	bool	false	Button、Label、Entry 要素からのテキスト。⚠️ PII リスク。
IncludeTitleInBreadcrumbs	bool	false	Window、Page 要素からのタイトル。⚠️ PII リスク。
IncludeBackgroundingStateInBreadcrumbs	bool	false	Window.Backgrounding イベント状態。⚠️ PII リスク。

環境変数

変数	目的
SENTRY_DSN	プロジェクト DSN
SENTRY_RELEASE	アプリバージョン（例：my-app@1.2.3）
SENTRY_ENVIRONMENT	デプロイメント環境名
SENTRY_AUTH_TOKEN	MSBuild / sentry-cli シンボルアップロード認証トークン

ASP.NET Core： ダブルアンダースコア __ を階層セパレーターとして使用します：

export Sentry__Dsn="https://..."
export Sentry__TracesSampleRate="0.1"

MSBuild シンボルアップロードプロパティ

プロパティ	型	デフォルト	説明
SentryOrg	string	—	Sentry 組織スラッグ
SentryProject	string	—	Sentry プロジェクトスラッグ
SentryUploadSymbols	bool	false	スタックトレース内の行番号用 PDB ファイルをアップロード
SentryUploadSources	bool	false	ソースコンテキスト用ソースファイルをアップロード
SentryCreateRelease	bool	false	ビルド中に自動 Sentry リリース作成
SentrySetCommits	bool	false	git コミットをリリースに関連付け
SentryUrl	string	—	セルフホスト Sentry URL

---

フェーズ 4：クロスリンク

.NET セットアップを完了した後、コンパニオンフロントエンドプロジェクトをチェックします：

# 隣接ディレクトリ内のフロントエンドをチェック
ls ../frontend ../client ../web ../app 2>/dev/null

# JavaScript フレームワーク指標をチェック
cat ../package.json 2>/dev/null | grep -E '"next"|"react"|"vue"|"nuxt"' | head -3

フロントエンドが見つかった場合、対応する SDK スキルを提案します：

フロントエンド検出	スキルを提案
Next.js（package.json 内の "next"）	sentry-nextjs-sdk
React SPA（"next" なしの "react"）	@sentry/react — docs.sentry.io/platforms/javascript/guides/react/ を参照
Vue.js	@sentry/vue — docs.sentry.io/platforms/javascript/guides/vue/ を参照
Nuxt	@sentry/nuxt — docs.sentry.io/platforms/javascript/guides/nuxt/ を参照

フロントエンドとバックエンドを同じ Sentry プロジェクトで接続すると、分散トレース — ブラウザ、.NET サーバー、およびダウンストリーム API にまたがる単一トレースビューが有効になります。

---

トラブルシューティング

問題	原因	解決策
イベントが表示されない	DSN が誤設定	Debug = true を設定し、SDK 診断メッセージについてコンソール出力をチェック
スタックトレースにファイル/行がない	PDB ファイルがアップロードされていない	.csproj に SentryUploadSymbols=true を追加；CI で SENTRY_AUTH_TOKEN を設定
WPF/WinForms 例外が欠落	IsGlobalModeEnabled が設定されていない	SentrySdk.Init() で options.IsGlobalModeEnabled = true を設定
Lambda/サーバーレスイベントが失われる	フラッシュの前にコンテナがフリーズ	options.FlushOnCompletedRequest = true を設定
WPF UI スレッド例外が欠落	DispatcherUnhandledException が接続されていない	コンストラクターで App.DispatcherUnhandledException を登録（OnStartup ではなく）
Azure Functions で重複 HTTP スパン	Sentry と OTel の両方が HTTP を計測	options.DisableSentryHttpMessageHandler = true を設定
TracesSampleRate が効果なし	レートが 0.0（デフォルト）	TracesSampleRate > 0 を設定してトレースを有効化
appsettings.json 値が無視される	設定キーフォーマットが間違っている	フラットキー "Sentry:Dsn" または環境変数 Sentry__Dsn（ダブルアンダースコア）を使用
BeforeSend がすべてのイベントをドロップ	フックが無条件に null を返す	フィルターロジックを確認；ドロップしたいイベントのみ null を返す
MAUI ネイティブクラッシュがキャプチャされない	パッケージが間違っている	Sentry.Maui がインストール（単なる Sentry ではなく）されていることを確認