Включение трассировки SignalR

Статья
07/13/2023

; автор — Том ФитцМакен (Tom FitzMacken)

Предупреждение

Эта документация не подходит для последней версии SignalR. Ознакомьтесь с ASP.NET Core SignalR.

В этом документе описывается, как включить и настроить трассировку для серверов и клиентов SignalR. Трассировка позволяет просматривать диагностические сведения о событиях в приложении SignalR.

Эта тема была первоначально написана Патриком Флетчером.

Версии программного обеспечения, используемые в этом руководстве

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 клиента в пользовательском интерфейсе
- Ведение журнала событий Windows Phone клиента в консоли отладки
Включение трассировки в клиенте JavaScript

Включение трассировки на сервере

Трассировка включается на сервере в файле конфигурации приложения (App.config или Web.config в зависимости от типа проекта). Вы указываете, какие категории событий требуется регистрировать. В файле конфигурации также укажите, следует ли записывать события в текстовый файл, журнал событий Windows или пользовательский журнал с помощью реализации TraceListener.

Категории событий сервера включают следующие типы сообщений:

Источник	Сообщения
SignalR.SqlMessageBus	Настройка поставщика масштабирования шины сообщений SQL, операции с базой данных, события ошибки и времени ожидания
SignalR.ServiceBusMessageBus	Создание раздела поставщика масштабирования служебной шины, а также подписка, ошибка и события обмена сообщениями
SignalR.RedisMessageBus	События подключения, отключения и ошибок поставщика redis scaleout
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>

События регистрируются в журнале приложений и доступны через Просмотр событий, как показано ниже:

Просмотр событий с журналами SignalR

Примечание

При использовании журнала событий задайте для traceLevel значение Ошибка , чтобы количество сообщений было управляемым.

Включение трассировки в клиенте .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

Приложения SignalR для Windows Phone приложений используют тот же клиент .NET, что и классические приложения, но Console.Out и запись в файл с помощью StreamWriter недоступны. Вместо этого необходимо создать пользовательскую реализацию TextWriter для трассировки.

Ведение журнала событий Windows Phone клиента в пользовательском интерфейсе

База кода SignalR включает пример Windows Phone, который записывает выходные данные трассировки в TextBlock с помощью пользовательской реализации TextWriter с именем TextBlockWriter. Этот класс можно найти в проекте samples/Microsoft.AspNet.SignalR.Client.WP8.Samples . При создании экземпляра передайте текущий TextBlockWriterобъект SynchronizationContext и StackPanel, где будет создан Элемент TextBlock для использования для вывода трассировки:

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

Затем выходные данные трассировки будут записаны в новый элемент TextBlock , созданный в переданном вами StackPanel :

Снимок экрана: пример Windows Phone с выходными данными на экране.

Ведение журнала событий Windows Phone клиента в консоли отладки

Чтобы отправить выходные данные в консоль отладки, а не в пользовательский интерфейс, создайте реализацию 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:

Снимок экрана: диалоговое окно вывода. Отладка находится в поле Показать выходные данные из.

Включение трассировки в клиенте JavaScript

Чтобы включить ведение журнала на стороне клиента для подключения, задайте logging свойство объекта соединения перед вызовом start метода для установления соединения.

Клиентский код JavaScript для включения трассировки в консоли браузера (с помощью созданного прокси-сервера)

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

Клиентский код JavaScript для включения трассировки в консоли браузера (без созданного прокси-сервера)

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

Если трассировка включена, клиент JavaScript регистрирует события в консоли браузера. Сведения о доступе к консоли браузера см. в разделе Мониторинг транспорта.

На следующем снимке экрана показан клиент JavaScript SignalR с включенной трассировкой. В нем отображаются события подключения и вызова концентратора в консоли браузера:

События трассировки SignalR в консоли браузера

Поделиться через