System.Diagnostics 名前空間

システム プロセス、イベント ログ、パフォーマンス カウンターを操作できるクラスを提供します。

クラス

名前 説明
Activity

ログ記録に使用されるコンテキストを使用して、操作を表します。

ActivityListener

アクティビティの開始イベントと停止イベントをリッスンできるようにし、サンプリング シナリオ用のアクティビティの作成を決定する機会を与えます。

ActivitySource

Activity オブジェクトを作成して開始し、ActivityListener イベントをリッスンするオブジェクトActivity登録するための API を提供します。

ActivitySourceOptions

ActivitySourceを作成するためのオプション。

ActivityTagsCollection

ActivityTagsCollection は、トレース タグを格納するために使用するコレクション クラスです。

このコレクションは、 ActivityEventActivityLinkなどのクラスで使用されます。

このコレクションは次のように動作します。

  • コレクション項目は、追加された方法に従って並べ替えられます。
  • 同じキーを持つ項目の重複は許可されません。
  • インデクサーを使用してコレクションに項目を格納する場合:
    • アイテムに以前にコレクションに存在していたキーがあり、その値が nullされている場合、そのキーに一致するコレクション項目はコレクションから削除されます。
    • アイテムに以前にコレクションに存在していたキーがあり、その値が nullされていない場合、新しい項目の値はコレクションに格納されている古い値を置き換えます。
    • それ以外の場合は、項目がコレクションに追加されます。
  • Add メソッドでは、同じキーを持つ項目が既に存在していない場合に、新しい項目がコレクションに追加されます。 それ以外の場合、例外はスローされます。
BooleanSwitch

デバッグとトレースの出力を制御する単純なオン/オフの切り替え機能を提供します。

ConditionalAttribute

指定した条件付きコンパイル シンボルが定義されていない場合、メソッド呼び出しまたは属性を無視するようコンパイラに指示します。

ConsoleTraceListener

トレース出力またはデバッグ出力を、標準出力と標準エラー出力ストリームのいずれかに転送します。

CorrelationManager

論理トランザクションの一部であるトレースを相互に関連付けます。

CounterCreationData

カスタム カウンターのカウンターの種類、名前、およびヘルプ文字列を定義します。

CounterCreationDataCollection

CounterCreationData オブジェクトの厳密に型指定されたコレクションを提供します。

CounterSampleCalculator

パフォーマンス カウンター データを解釈するためのユーティリティ関数のセットを提供します。

DataReceivedEventArgs

OutputDataReceivedイベントとErrorDataReceived イベントのデータを提供します。

Debug

コードのデバッグを支援するメソッドとプロパティのセットを提供します。

DebuggableAttribute

ランタイム Just-In-Time (JIT) デバッグのコード生成を変更します。 このクラスは継承できません。

Debugger

デバッガーとの通信を有効にします。 このクラスは継承できません。

DebuggerBrowsableAttribute

デバッガーの変数ウィンドウにメンバーを表示するかどうかと、表示方法を決定します。 このクラスは継承できません。

DebuggerDisableUserUnhandledExceptionsAttribute

BreakForUserUnhandledException(Exception) API をサポートする .NET デバッガーがアタッチされている場合、BreakForUserUnhandledException(Exception) が呼び出されない限り、この属性を持つメソッドによって例外がキャッチされても、デバッガーはユーザーが処理しない例外で中断されません。

DebuggerDisplayAttribute

デバッガーの変数ウィンドウでクラスやフィールドを表示する方法を決定します。

DebuggerHiddenAttribute

DebuggerHiddenAttributeを指定します。 このクラスは継承できません。

DebuggerNonUserCodeAttribute

型またはメンバーが、アプリケーションのユーザー コードの一部でないことを識別します。

DebuggerStepperBoundaryAttribute

属性の後に続くコードがステップ モードではなく実行モードで実行されることを示します。

DebuggerStepThroughAttribute

デバッガーに、コードへステップ インするのではなく、コードをステップ オーバーさせます。 このクラスは継承できません。

DebuggerTypeProxyAttribute

型の表示プロキシを指定します。

DebuggerVisualizerAttribute

型にビジュアライザーがあることを指定します。 このクラスは継承できません。

DefaultTraceListener

トレースの動作と既定の出力メソッドを提供します。

DelimitedListTraceListener

トレース出力またはデバッグ出力をストリーム ライターなどのテキスト ライターや、ファイル ストリームなどのストリームに転送します。

DiagnosticListener

ソースが情報 (イベント) を送信する名前付き場所を表す抽象 DiagnosticSource クラスの実装を提供します。

DiagnosticListenerExtensions

システム プロセス、イベント ログ、パフォーマンス カウンターを操作できるクラスを提供します。

DiagnosticMethodInfo

メソッドに関する診断情報を表します。 このクラスによって提供される情報は、情報に似ています

MethodBaseによって提供されますが、ログ記録とトレースを目的とします。

DiagnosticsConfigurationHandler

構成ファイルの診断セクションを処理します。

DiagnosticSource

インストルメント化されたプロセス内で利用するための豊富なデータ ペイロードを本番環境でログに記録できるよう、コードをインストルメント化するための抽象クラスです。

DistributedContextPropagator

DistributedContextPropagatorの実装は、分散コンテキスト情報がネットワークを通過するときにエンコードおよびデコードされるかどうかを決定します。 エンコードは、文字列のキーと値のペアをサポートする任意のネットワーク プロトコル経由で転送できます。 たとえば、HTTP を使用する場合、各キーと値のペアは HTTP ヘッダーとなります。 DistributedContextPropagator は、文字列キーと値のペアとしてキャリアに値を挿入し、キャリアから値を抽出します。

EntryWrittenEventArgs

EntryWritten イベントのデータを提供します。

EventInstance

イベント ログ エントリの言語に依存しない情報を表します。

EventLog

Windows イベント ログとの対話を提供します。

EventLogEntry

イベント ログに 1 つのレコードをカプセル化します。 このクラスは継承できません。

EventLogEntryCollection

EventLogEntry インスタンスのコレクションのサイズと列挙子を定義します。

EventLogInstaller

アプリケーションが実行時に読み取りまたは書き込みを行うイベント ログをインストールして構成できます。

EventLogPermission

イベント ログのコード アクセス許可を制御します。

EventLogPermissionAttribute

イベント ログの宣言アクセス許可チェックを許可します。

EventLogPermissionEntry

EventLogに設定されるコード アクセス セキュリティアクセス許可の最小単位を定義します。

EventLogPermissionEntryCollection

厳密に型指定された EventLogPermissionEntry オブジェクトのコレクションを格納します。

EventLogTraceListener

トレースまたはデバッグ出力を EventLogに転送する単純なリスナーを提供します。

EventSchemaTraceListener

エンドツーエンド イベントのトレースまたはデバッグ出力を、XML エンコードされたスキーマ準拠のログ ファイルに転送します。

EventSourceCreationData

ローカル コンピューターまたはリモート コンピューターでイベント ログ ソースを作成するために使用される構成設定を表します。

EventTypeFilter

リスナーがイベントの種類に基づいてトレースする必要があるかどうかを示します。

FileVersionInfo

ディスク上の物理ファイルのバージョン情報を提供します。

InitializingSwitchEventArgs

Switch.Initializing イベントのデータを提供します。

InitializingTraceSourceEventArgs

TraceSource.Initializing イベントのデータを提供します。

InstanceData

パフォーマンス カウンターのサンプルに関連付けられているインスタンス データを保持します。

InstanceDataCollection

InstanceData オブジェクトの厳密に型指定されたコレクションを提供します。

InstanceDataCollectionCollection

InstanceDataCollection オブジェクトの厳密に型指定されたコレクションを提供します。

MonitoringDescriptionAttribute

プロパティまたはイベントの説明文を指定します。

PerformanceCounter

WINDOWS NT パフォーマンス カウンター コンポーネントを表します。

PerformanceCounterCategory

パフォーマンス カウンターのカテゴリを定義するパフォーマンス オブジェクトを表します。

PerformanceCounterInstaller

PerformanceCounter コンポーネントのインストーラーを指定します。

PerformanceCounterManager

パフォーマンス カウンターを操作するときにシステムが読み込む performance.dll のパフォーマンス データを準備します。

PerformanceCounterPermission

PerformanceCounterのコード アクセス許可の制御を許可します。

PerformanceCounterPermissionAttribute

宣言型パフォーマンス カウンターのアクセス許可チェックを許可します。

PerformanceCounterPermissionEntry

PerformanceCounterに設定されるコード アクセス セキュリティアクセス許可の最小単位を定義します。

PerformanceCounterPermissionEntryCollection

厳密に型指定された PerformanceCounterPermissionEntry オブジェクトのコレクションを格納します。

PresentationTraceSources

Windows Presentation Foundation (WPF) アプリケーションを対象とするデバッグ トレースのサポートを提供します。

Process

ローカル プロセスとリモート プロセスへのアクセスを提供し、ローカル システム プロセスを開始および停止できます。

ProcessExitStatus

システム プロセス、イベント ログ、パフォーマンス カウンターを操作できるクラスを提供します。

ProcessModule

特定のプロセスに読み込まれる .dll または .exe ファイルを表します。

ProcessModuleCollection

ProcessModule オブジェクトの厳密に型指定されたコレクションを提供します。

ProcessStartInfo

プロセスを起動するときに使用する値のセットを指定します。

ProcessTextOutput

システム プロセス、イベント ログ、パフォーマンス カウンターを操作できるクラスを提供します。

ProcessThread

オペレーティング システムのプロセス スレッドを表します。

ProcessThreadCollection

ProcessThread オブジェクトの厳密に型指定されたコレクションを提供します。

SourceFilter

トレースのソースに基づいてリスナーでメッセージをトレースする必要があるかどうかを示します。

SourceSwitch

コードの再コンパイルなしでトレース出力およびデバッグ出力を制御するための複数レベルのスイッチを提供します。

StackFrame

現在のスレッドの呼び出し履歴の関数呼び出しを表す StackFrameに関する情報を提供します。

StackFrameExtensions

現在のスレッドの呼び出し履歴の関数呼び出しを表す、 StackFrame クラスの拡張メソッドを提供します。

StackTrace

スタック トレースを表します。スタック トレースは、順番に並べられた 1 つまたは複数のスタック フレームのコレクションです。

StackTraceHiddenAttribute

StackTraceHidden に帰属された型とメソッドは、StackTrace.ToString() および Exception.StackTrace に示されているスタック トレース テキストから省略されます

Stopwatch

経過時間を正確に計測するために使用できる一連のメソッドとプロパティを提供します。

Switch

新しいデバッグ スイッチおよびトレース スイッチを作成するための抽象基本クラスを提供します。

SwitchAttribute

アセンブリ、クラス、またはメンバーで使用されるスイッチを識別します。

SwitchLevelAttribute

スイッチ レベルの型を識別します。

TextWriterTraceListener

トレースまたはデバッグ出力を TextWriter または Stream(FileStreamなど) に転送します。

Trace

コードの実行をトレースするための一連のメソッドとプロパティを提供します。 このクラスは継承できません。

TraceConfiguration

構成ファイルから TraceSource および関連クラスへのトレース設定を登録および構成するメソッドを提供します。

TraceEventCache

スレッドとプロセスに固有のトレース イベント データを提供します。

TraceFilter

トレース フィルター実装の基本クラスを提供します。

TraceListener

トレースとデバッグの出力を監視するリスナーの abstract 基本クラスを提供します。

TraceListenerCollection

TraceListener オブジェクトのスレッド セーフな一覧を提供します。

TraceSource

アプリケーションがコードの実行をトレースし、トレース メッセージをソースに関連付ける一連のメソッドとプロパティを提供します。

TraceSwitch

コードの再コンパイルなしでトレース出力およびデバッグ出力を制御するための複数レベルのスイッチを提供します。

UnescapedXmlDiagnosticData

ユーザー指定のトレース データのログ記録用にエスケープされていない XML データを提供します。

UnreachableException

プログラムが到達不能と思われる命令を実行するときにスローされる例外。

XmlWriterTraceListener

トレース出力またはデバッグ出力を XML エンコードデータとして TextWriter または Stream ( FileStreamなど) に転送します。

構造体

名前 説明
Activity.Enumerator<T>

Activity オブジェクトに格納されているデータを列挙します。

ActivityChangedEventArgs

CurrentChanged イベントのデータを提供します。

ActivityContext

W3C TraceContext 仕様に準拠した表現。 これには、TraceId と SpanId の 2 つの識別子と、一般的な TraceFlags とシステム固有の TraceState 値のセットが含まれています。

ActivityCreationOptions<T>

アクティビティ インスタンスの作成とその状態に関する決定を行うために、アクティビティ リスナーに送信されるすべての情報をカプセル化します。

使用可能なジェネリック型パラメーターは、ActivityContext または Stringです。

ActivityEvent

名前とタイムスタンプ、および省略可能なタグの一覧を含むイベントを表します。

ActivityLink

アクティビティは、因果関係のある 0 個以上のアクティビティ コンテキスト インスタンスにリンクできます。

アクティビティ リンクは、1 つのトレース内または異なるトレース間のアクティビティ コンテキストを指すことができます。

アクティビティ リンクを使用すると、複数の開始アクティビティによってアクティビティが開始されたバッチ処理操作を表すことができます。各アクティビティは、バッチで処理されている 1 つの受信アイテムを表します。

ActivitySpanId

W3C 標準に基づいて書式設定された SpanId を表します。

ActivityTagsCollection.Enumerator

ActivityTagsCollectionの要素を列挙します。

ActivityTraceId

W3C 標準に基づく形式の TraceId を表します。

CounterSample

パフォーマンス カウンターの生データを保持する構造体を定義します。

Debug.AssertInterpolatedStringHandler

アサートが失敗した場合にのみ書式設定を実行する Assert(Boolean) の挿入文字列ハンドラーを提供します。

Debug.WriteIfInterpolatedStringHandler

条件が適用された場合にのみ書式設定を実行する WriteIf(Boolean, String)WriteLineIf(Boolean, Object) の挿入文字列ハンドラーを提供します。

ProcessOutputLine

システム プロセス、イベント ログ、パフォーマンス カウンターを操作できるクラスを提供します。

TagList

インデックスでアクセスできるタグの一覧を表します。 リストの検索、並べ替え、操作を行うメソッドを提供します。

TagList.Enumerator

タグ リスト コレクションを走査するための列挙子。

インターフェイス

名前 説明
ICollectData

パフォーマンス カウンターの操作時にシステムが読み込むパフォーマンス DLL のパフォーマンス データを準備します。

列挙型

名前 説明
ActivityIdFormat

Id プロパティの形式を指定します。

ActivityKind

アクティビティ、その親、およびトレース内の子の関係について説明します。

ActivitySamplingResult

関連する ActivityListenerに対して収集するデータの量を示すために Activity によって使用される列挙値。 より多くのデータを要求すると、パフォーマンスのオーバーヘッドが大きくなります。

ActivityStatusCode

インストルメント化された操作の状態を示すアクティビティの状態コードを定義します。

ActivityTraceFlags

アクティビティに関連付けられている W3C 標準で定義されているフラグを指定します。

DebuggableAttribute.DebuggingModes

Just-In-Time (JIT) コンパイラのデバッグ モードを指定します。

DebuggerBrowsableState

デバッガーの表示手順について説明します。

EventLogEntryType

イベント ログ エントリのイベントの種類を指定します。

EventLogPermissionAccess

EventLog アクセス許可クラスで使用されるアクセス レベルを定義します。

OverflowAction

最大ファイル サイズに達したイベント ログ内のエントリを処理する方法を指定します。

PerformanceCounterCategoryType

パフォーマンス カウンター カテゴリに複数のインスタンスを含めることができるかどうかを示します。

PerformanceCounterInstanceLifetime

パフォーマンス カウンター インスタンスの有効期間を指定します。

PerformanceCounterPermissionAccess

PerformanceCounter アクセス許可クラスで使用されるアクセス レベルを定義します。

PerformanceCounterType

ネイティブ型に直接マップするパフォーマンス カウンターの種類を指定します。

PresentationTraceLevel

特定のオブジェクトについてトレースする詳細レベルについて説明します。

ProcessPriorityClass

システムがプロセスに関連付ける優先順位を示します。 この値は、プロセスの各スレッドの優先度値と共に、各スレッドの基本優先度レベルを決定します。

ProcessWindowStyle

システムがプロセスを開始するときに新しいウィンドウを表示する方法を指定しました。

SourceLevels

ソース スイッチとイベントの種類フィルターでフィルター処理されるトレース メッセージのレベルを指定します。

ThreadPriorityLevel

スレッドの優先度レベルを指定します。

ThreadState

スレッドの現在の実行状態を指定します。

ThreadWaitReason

スレッドが待機している理由を指定します。

TraceEventType

トレースの原因となったイベントの種類を識別します。

TraceLevel

DebugTrace、および TraceSwitch クラスに対して出力するメッセージを指定します。

TraceLogRetentionOption

EventSchemaTraceListener ログに使用するファイル構造を指定します。

TraceOptions

トレース出力に書き込むトレース データ オプションを指定します。

代理人

名前 説明
DataReceivedEventHandler

OutputDataReceivedErrorDataReceived イベントまたはProcess イベントを処理するメソッドを表します。

DistributedContextPropagator.PropagatorGetterCallback

伝達子の抽出メソッドで使用されるコールバック メソッドを表します。 コールバックは、名前付きフィールドの値を検索するために呼び出されます。

DistributedContextPropagator.PropagatorSetterCallback

伝達子の挿入メソッドで使用されるコールバック メソッドを表します。 このコールバックは、名前付きフィールドの値を設定するために呼び出されます。 伝達子は、複数のフィールドを設定するために複数回呼び出すことができます。

EntryWrittenEventHandler

EntryWrittenEventLog イベントを処理するメソッドを表します。

ExceptionRecorder

Activityに例外が追加されたときに通知を受信するためにActivityListenerで使用するコールバックを定義します。

SampleActivity<T>

サンプリング プロセスで使用される ActivityListener コールバックのシグネチャを定義するデリゲート。

注釈

  • EventLog コンポーネントは、イベント ログへの書き込み、イベント ログ エントリの読み取り、ネットワーク上のイベント ログとイベント ソースの作成と削除を行う機能を提供します。 EntryWrittenEventHandlerは、イベント ログを非同期的に操作する方法を提供します。 サポート クラスを使用すると、アクセス許可の制限、イベント ログの種類 (イベント ログ エントリで書き込まれる既定のデータの種類を制御する) を指定する機能、イベント ログ エントリのコレクションを反復処理する機能など、より詳細な制御にアクセスできます。 これらのタスクの詳細については、 EventLogPermissionEventLogEntryType、および EventLogEntryCollection クラスを参照してください。

  • Process クラスは、ネットワーク全体のシステム プロセスを監視し、ローカル システム プロセスを開始および停止する機能を提供します。 実行中のプロセスの一覧 (コンピューター、プロセス名、またはプロセス ID を指定して) を取得したり、プロセッサに現在アクセスできるプロセスに関する情報を表示したりするだけでなく、 Process クラス自体を介して、および ProcessThread クラスと ProcessModule クラスを操作することで、プロセス スレッドとモジュールに関する詳細な知識を得ることができます。 ProcessStartInfo クラスを使用すると、入力、出力、エラー ストリーム、作業ディレクトリ、コマンド ラインの動詞と引数など、新しいプロセスを開始するためのさまざまな要素を指定できます。 これにより、プロセスの動作を細かく制御できるようになります。 その他の関連クラスを使用すると、ウィンドウ スタイル、プロセスとスレッドの優先順位を指定し、スレッドとモジュールのコレクションを操作できます。

  • PerformanceCounter クラスを使用すると、システムのパフォーマンスを監視できますが、PerformanceCounterCategory クラスには新しいカスタム カウンターとカテゴリを作成する方法が用意されています。 ローカル カスタム カウンターへの書き込み、ローカルおよびリモート カウンター (システムおよびカスタム) の両方からの読み取りを実施できます。 PerformanceCounter クラスを使用してカウンターをサンプリングし、CounterSample クラスを使用して連続するパフォーマンス カウンター サンプルの結果を計算できます。 CounterCreationData クラスを使用すると、カテゴリに複数のカウンターを作成し、その種類を指定できます。 パフォーマンス カウンター コンポーネントに関連付けられている他のクラスにより、カウンター、カウンターのアクセス許可、およびカウンターの種類のコレクションにアクセスできます。

System.Diagnostics名前空間には、アプリケーションをデバッグし、コードの実行をトレースできるクラスも用意されています。 詳細については、Trace クラスと Debug クラスを参照してください。