SignalR トレースを有効にする

[アーティクル]
2024/05/30

警告

このドキュメントは、最新版の SignalR を対象としていません。 ASP.NET Core SignalR に関する記事を参照してください。

このドキュメントでは、SignalR サーバーとクライアントのトレースを有効にして構成する方法について説明します。トレースを使うと、SignalR アプリケーションのイベントに関する診断情報を表示できます。

このトピックは、もともと Patrick Fletcher によって書かれました。

チュートリアルで使用するソフトウェアのバージョン

Visual Studio 2013

.NET Framework 4.5

SignalR バージョン 2

質問とコメント

このチュートリアルの感想、改善に関するフィードバックをページの下部にあるコメント欄にお寄せください。チュートリアルに直接関連しない質問がある場合は、ASP.NET SignalR フォーラムまたは StackOverflow.com に投稿できます。

トレースが有効な場合、SignalR アプリケーションはイベントのログエントリを作成します。クライアントとサーバーの両方からイベントをログできます。サーバーでのトレースでは、接続、スケールアウトプロバイダー、メッセージバスのイベントがログされます。クライアントでのトレースでは、接続のイベントがログされます。 SignalR 2.1 以降では、クライアントでのトレースにより、ハブ呼び出しメッセージの完全な内容がログされます。

内容

サーバーでのトレースの有効化
- サーバーのイベントをテキストファイルにログする
- サーバーのイベントをイベントログにログする
.NET クライアント (Windows デスクトップアプリ) でのトレースの有効化
- デスクトップクライアントイベントをコンソールにログする
- デスクトップクライアントのイベントをテキストファイルにログする
Windows Phone 8 クライアントでのトレースの有効化
- Windows Phone クライアントのイベントを UI にログする
- Windows Phone クライアントのイベントをデバッグコンソールにログする
JavaScript クライアントでのトレースの有効化

サーバーでのトレースの有効化

アプリケーションの構成ファイル (プロジェクトの種類に応じて App.config か Web.config のいずれか) 内でサーバーでのトレースを有効にします。ログするイベントのカテゴリを指定します。構成ファイルでは、イベントをテキストファイル、Windows イベントログ、または TraceListener の実装を使ったカスタムログのいずれにログするかについても指定します。

サーバーイベントのカテゴリには次の種類のメッセージが含まれます。

ソース	[メッセージ]
SignalR.SqlMessageBus	SQL メッセージバススケールアウトプロバイダーのセットアップ、データベース操作、エラー、タイムアウトイベント
SignalR.ServiceBusMessageBus	サービスバススケールアウトプロバイダーのトピックの作成とサブスクリプション、エラー、メッセージングイベント
SignalR.RedisMessageBus	Redis スケールアウトプロバイダーの接続、切断、エラーイベント
SignalR.ScaleoutMessageBus	スケールアウトメッセージングイベント
SignalR.Transports.WebSocketTransport	WebSocket トランスポートの接続、切断、メッセージング、エラーイベント
SignalR.Transports.ServerSentEventsTransport	ServerSentEvents トランスポートの接続、切断、メッセージング、エラーイベント
SignalR.Transports.ForeverFrameTransport	ForeverFrame トランスポートの接続、切断、メッセージング、エラーイベント
SignalR.Transports.LongPollingTransport	LongPolling トランスポートの接続、切断、メッセージング、エラーイベント
SignalR.Transports.TransportHeartBeat	トランスポートの接続、切断、キープアライブイベント
SignalR.ReflectedHubDescriptorProvider	ハブ検出イベント

サーバーのイベントをテキストファイルにログする

次のコードは、イベントの各カテゴリのトレースを有効にする方法を示しています。このサンプルでは、イベントをテキストファイルにログするようにアプリケーションを構成します。

トレースを有効にする XML サーバーコード

<system.diagnostics>
    <sources> 
      <source name="SignalR.SqlMessageBus">
        <listeners>
          <add name="SignalR-Bus" />
        </listeners>
      </source>
      <source name="SignalR.ServiceBusMessageBus">
        <listeners>
          <add name="SignalR-Bus" />
        </listeners>
      </source>
      <source name="SignalR.RedisMessageBus">
        <listeners>
          <add name="SignalR-Bus" />
        </listeners>
      </source>
      <source name="SignalR.ScaleoutMessageBus">
        <listeners>
          <add name="SignalR-Bus" />
        </listeners>
      </source>
      <source name="SignalR.Transports.WebSocketTransport">
        <listeners>
          <add name="SignalR-Transports" />
        </listeners>
      </source>     
      <source name="SignalR.Transports.ServerSentEventsTransport">
        <listeners>
          <add name="SignalR-Transports" />
        </listeners>
      </source>
      <source name="SignalR.Transports.ForeverFrameTransport">
        <listeners>
          <add name="SignalR-Transports" />
        </listeners>
      </source>
      <source name="SignalR.Transports.LongPollingTransport">
        <listeners>
          <add name="SignalR-Transports" />
        </listeners>
      </source>
      <source name="SignalR.Transports.TransportHeartBeat">
        <listeners>
          <add name="SignalR-Transports" />
        </listeners>
      </source>
      <source name="SignalR.ReflectedHubDescriptorProvider">
        <listeners>
          <add name="SignalR-Init" />
        </listeners>
      </source>
    </sources>
    <!-- Sets the trace verbosity level -->
    <switches>
      <add name="SignalRSwitch" value="Verbose" />
    </switches>
    <!-- Specifies the trace writer for output -->
    <sharedListeners>
      <!-- Listener for transport events -->
      <add name="SignalR-Transports" type="System.Diagnostics.TextWriterTraceListener" initializeData="transports.log.txt" />
      <!-- Listener for scaleout provider events -->
      <add name="SignalR-Bus" type="System.Diagnostics.TextWriterTraceListener" initializeData="bus.log.txt" />
      <!-- Listener for hub discovery events -->
      <add name="SignalR-Init" type="System.Diagnostics.TextWriterTraceListener" initializeData="init.log.txt" />
    </sharedListeners>
    <trace autoflush="true" />
  </system.diagnostics>

上記のコードでは、SignalRSwitch エントリは、指定のログに送信するイベントで使われる TraceLevel を指定します。この場合は、Verbose に設定されています。これは、すべてのデバッグメッセージとトレースメッセージがログされることを意味します。

次の出力は、上記の構成ファイルを使うアプリケーションの transports.log.txt ファイルからのエントリを示しています。新しい接続、削除された接続、トランスポートハートビートのイベントが表示されます。

SignalR.Transports.TransportHeartBeat Information: 0 : Connection 9aa62c9b-09b3-416c-b367-06520e24f780 is New.
SignalR.Transports.TransportHeartBeat Verbose: 0 : KeepAlive(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.TransportHeartBeat Verbose: 0 : KeepAlive(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.TransportHeartBeat Verbose: 0 : KeepAlive(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.WebSocketTransport Information: 0 : CloseSocket(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.WebSocketTransport Information: 0 : Abort(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.TransportHeartBeat Information: 0 : Removing connection 9aa62c9b-09b3-416c-b367-06520e24f780
SignalR.Transports.WebSocketTransport Information: 0 : End(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.WebSocketTransport Verbose: 0 : DrainWrites(9aa62c9b-09b3-416c-b367-06520e24f780)
SignalR.Transports.WebSocketTransport Information: 0 : CompleteRequest (9aa62c9b-09b3-416c-b367-06520e24f780)

サーバーのイベントをイベントログにログする

イベントをテキストファイルではなくイベントログにログするには、sharedListeners ノードのエントリの値を変更します。次のコードは、サーバーのイベントをイベントログにログする方法を示しています。

イベントをイベントログにログするための XML サーバーコード

<sharedListeners>
  <!-- Listener for transport events -->
  <add name="SignalR-Transports" type="System.Diagnostics.EventLogTraceListener" initializeData="SignalRTransportLog" />
  <!-- Listener for scaleout provider events -->
  <add name="SignalR-Bus" type="System.Diagnostics.EventLogTraceListener" initializeData="SignalRScaleoutLog" />
  <!-- Listener for hub discovery events -->
  <add name="SignalR-Init" type="System.Diagnostics.EventLogTraceListener" initializeData="SignalRInitLog" />
</sharedListeners>

イベントはアプリケーションログにログされ、以下に示すようにイベントビューアーを介して使用できます。

Event Viewer showing SignalR logs

注意

イベントログを使う場合は、メッセージ数を管理しやすい状態に保つために、TraceLevel を Error に設定します。

.NET クライアント (Windows デスクトップアプリ) でのトレースの有効化

.NET クライアントは、TextWriter の実装を使って、コンソール、テキストファイル、またはカスタムログにイベントをログできます。

.NET クライアントでのログを有効にするには、接続の TraceLevel プロパティを TraceLevels 値に設定し、TraceWriter プロパティを有効な TextWriter インスタンスに設定します。

デスクトップクライアントイベントをコンソールにログする

次の C# コードは、.NET クライアントのイベントをコンソールにログする方法を示しています。

var hubConnection = new HubConnection("http://www.contoso.com/");
hubConnection.TraceLevel = TraceLevels.All;
hubConnection.TraceWriter = Console.Out;
IHubProxy stockTickerHubProxy = hubConnection.CreateHubProxy("StockTickerHub");
stockTickerHubProxy.On<Stock>("UpdateStockPrice", stock => Console.WriteLine("Stock update for {0} new price {1}", stock.Symbol, stock.Price));
await hubConnection.Start();

デスクトップクライアントのイベントをテキストファイルにログする

次の C# コードは、.NET クライアントのイベントをテキストファイルにログする方法を示しています。

var hubConnection = new HubConnection("http://www.contoso.com/");
var writer = new StreamWriter("ClientLog.txt");
writer.AutoFlush = true;
hubConnection.TraceLevel = TraceLevels.All;
hubConnection.TraceWriter = writer;
IHubProxy stockTickerHubProxy = hubConnection.CreateHubProxy("StockTickerHub");
stockTickerHubProxy.On<Stock>("UpdateStockPrice", stock => Console.WriteLine("Stock update for {0} new price {1}", stock.Symbol, stock.Price));
await hubConnection.Start();

次の出力は、上記の構成ファイルを使うアプリケーションの ClientLog.txt ファイルからのエントリを示しています。これは、サーバーに接続するクライアントと、addMessage というクライアントメソッドを呼び出すハブを示しています。

19:41:39.9103763 - null - ChangeState(Disconnected, Connecting)
19:41:40.3750726 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS Connecting to: ws://localhost:8080/signalr/signalr/connect?transport=webSockets&clientProtocol=1.4&connectionToken=AQAAANCMnd8BFdERjHoAwE%2FCl%2BsBAAAAh8Lp 
KH5%2FDkCQeR4ALAwR%2BAAAAAACAAAAAAADZgAAwAAAABAAAADHpCa7wm%2FbOhjluf%2Fm9GA9AAAAAASAAACgAAAAEA 
AAAEqRfJihLExRI6tZy7lWRwYoAAAApotSsJXW0OiwEgiUUi0pzhK6oKbz%2BkMeVbezuEDQLnJecM9otFe9PRQAAAAuHK
BlOnPmXt%2FhXV%2Felr1QvC156Q%3D%3D&connectionData=[{"Name":"MyHub"}]
19:41:40.4442923 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS: OnMessage({"C":"d-5196BF5C-A,0|B,0|C,1|D,0","S":1,"M":[]})
19:41:40.4874324 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - ChangeState(Connecting, Connected)
19:41:47.4511770 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS: OnMessage({"C":"d-5196BF5C-A,1|B,0|C,1|D,0","M":[{"H":"MyHub","M":"addMessage","A":["User One","Hello!"]}]})
19:41:47.4576968 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS: OnMessage({"I":"0"})
19:41:50.3959119 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS: OnMessage({})
19:41:50.8928084 - dd61fd48-d796-4518-b36b-ec1dcb970d72 - WS: OnMessage({"C":"d-5196BF5C-A,2|B,0|C,1|D,0","M":[{"H":"MyHub","M":"addMessage","A":["User Two","Hello!"]}]})

Windows Phone 8 クライアントでのトレースの有効化

Windows Phone アプリ用の SignalR アプリケーションはデスクトップアプリと同じ .NET クライアントを使いますが、Console.Out や StreamWriter を使ったファイルへの書き込みは使用できません。代わりに、トレース用の TextWriter のカスタム実装を作成する必要があります。

Windows Phone クライアントのイベントを UI にログする

SignalR コードベースには、TextBlockWriter というカスタムの TextWriter 実装を使ってトレース出力を TextBlock に書き込む Windows Phone サンプルが含まれています。このクラスは、samples/Microsoft.AspNet.SignalR.Client.WP8.Samples プロジェクトにあります。 TextBlockWriter のインスタンスを作成するときは、現在の SynchronizationContext と、トレース出力に使う TextBlock を作成する StackPanel を渡します。

Connection = new HubConnection(ServerURI);
var writer = new TextBlockWriter(SynchronizationContext.Current, StackPanelConsole);
Connection.TraceWriter = writer;
Connection.TraceLevel = TraceLevels.All;

トレース出力は、渡した StackPanel 内に作成された新しい TextBlock に書き込まれます。

Screenshot that shows a Windows Phone sample with output in the display.

Windows Phone クライアントのイベントをデバッグコンソールにログする

出力を UI ではなくデバッグコンソールに送信するには、デバッグウィンドウに書き込む TextWriter の実装を作成し、それを接続の TraceWriter プロパティに割り当てます。

Connection = new HubConnection(ServerURI);
var writer = new DebugTextWriter();
Connection.TraceWriter = writer;
Connection.TraceLevel = TraceLevels.All;

...

private class DebugTextWriter : TextWriter
{
    private StringBuilder buffer;

    public DebugTextWriter()
    {
        buffer = new StringBuilder();
    }

    public override void Write(char value)
    {
        switch (value)
        {
            case '\n':
                return;
            case '\r':
                Debug.WriteLine(buffer.ToString());
                buffer.Clear();
                return;
            default:
                buffer.Append(value);
                break;
        }
    }
            
    public override void Write(string value)
    {
        Debug.WriteLine(value);
                
    }
    #region implemented abstract members of TextWriter
    public override Encoding Encoding
    {
        get { throw new NotImplementedException(); }
    }
    #endregion
}

その後、トレース情報は、Visual Studio のデバッグウィンドウに書き込まれます。

Screenshot that shows the Output dialog box. Debug is in the Show output from field.

JavaScript クライアントでのトレースの有効化

接続でクライアント側のログを有効にするには、start メソッドを呼び出して接続を確立する前に、接続オブジェクトで logging プロパティを設定します。

ブラウザーコンソールへのトレースを有効にするためのクライアント JavaScript コード (生成されたプロキシを使用)

$.connection.hub.logging = true;
$.connection.hub.start();

ブラウザーコンソールへのトレースを有効にするためのクライアント JavaScript コード (生成されたプロキシを使用しない)

var connection = $.hubConnection();
connection.logging = true;
connection.start();

トレースが有効になっている場合、JavaScript クライアントはブラウザーコンソールにイベントをログします。ブラウザーコンソールにアクセスするには、「トランスポートの監視」を参照してください。

次のスクリーンショットは、トレースが有効になっている SignalR JavaScript クライアントを示しています。ブラウザーコンソールに接続とハブ呼び出しのイベントが表示されます。

SignalR tracing events in the browser console

その他のリソース

ドキュメント

SignalR のトラブルシューティング

この記事では、SignalR アプリケーションの開発に関する一般的な問題について説明します。
SignalR アプリケーションの単体テスト

この記事では、SignalR 2.0 の単体テスト機能を使用する方法について説明します。
SignalR のテストとデバッグ

SignalR アプリケーションをテストしてデバッグする方法。
SignalR の接続の有効期間イベントについて理解し、処理する

この記事では、Hubs API によって公開されるイベントを使用する方法について説明します。
Crank を使用した SignalR の接続密度テスト

Crank による SignalR 接続密度テスト
SignalR での依存関係の挿入

SignalR の依存関係の挿入の概要について説明し、依存関係の挿入について説明します。
SignalR のパフォーマンス

SignalR アプリケーションのパフォーマンスを設計、測定、改善する方法について説明します。
ASP.NET SignalR Hubs API ガイド - JavaScript クライアント

このドキュメントでは、ブラウザーや Windows ストア (WinJS) アプリケーションなどの JavaScript クライアントで SignalR バージョン 2 用の Hubs API を使用する方法の概要について説明します。

トレーニング

ラーニングパス

Use advance techniques in canvas apps to perform custom updates and optimization - Training

Use advance techniques in canvas apps to perform custom updates and optimization

AI Skills Fest

次の方法で共有

チュートリアルで使用するソフトウェアのバージョン

質問とコメント

内容

サーバーでのトレースの有効化

サーバーのイベントをテキストファイルにログする

サーバーのイベントをイベントログにログする

.NET クライアント (Windows デスクトップアプリ) でのトレースの有効化

デスクトップクライアントイベントをコンソールにログする

デスクトップクライアントのイベントをテキストファイルにログする

Windows Phone 8 クライアントでのトレースの有効化

Windows Phone クライアントのイベントを UI にログする

Windows Phone クライアントのイベントをデバッグコンソールにログする

JavaScript クライアントでのトレースの有効化

次の方法で共有

SignalR トレースを有効にする

チュートリアルで使用するソフトウェアのバージョン

質問とコメント

内容

サーバーでのトレースの有効化

サーバーのイベントをテキスト ファイルにログする

サーバーのイベントをイベント ログにログする

.NET クライアント (Windows デスクトップ アプリ) でのトレースの有効化

デスクトップ クライアント イベントをコンソールにログする

デスクトップ クライアントのイベントをテキスト ファイルにログする

Windows Phone 8 クライアントでのトレースの有効化

Windows Phone クライアントのイベントを UI にログする

Windows Phone クライアントのイベントをデバッグ コンソールにログする

JavaScript クライアントでのトレースの有効化

フィードバック

その他のリソース

サーバーのイベントをテキストファイルにログする

サーバーのイベントをイベントログにログする

.NET クライアント (Windows デスクトップアプリ) でのトレースの有効化

デスクトップクライアントイベントをコンソールにログする

デスクトップクライアントのイベントをテキストファイルにログする

Windows Phone クライアントのイベントをデバッグコンソールにログする