5.12.2 Using the Connector/NET Trace Source Object — MySQL Connectors 1.0

5.12.2 Использование объекта источника отслеживания Connector/NET

Архитектура отслеживания .NET состоит из четырёх основных частей:

Источник - Это источник информации об отслеживании. Источник используется для отправки сообщений отслеживания. Название источника, предоставляемое Connector/NET, — mysql.
Переключатель - Определяет уровень информации об отслеживании для вывода. Как правило, это указывается в файле app.config, чтобы не было необходимости повторно компилировать приложение для изменения уровня отслеживания.
Слушатель - Слушатели отслеживания определяют, куда будет записана информация об отслеживании. Поддерживаемые слушатели включают, например, окно вывода Visual Studio, журнал событий Windows и консоль.
Фильтр - Фильтры могут быть подключены к слушателям. Фильтры определяют уровень информации об отслеживании, который будет записан. В то время как переключатель определяет уровень информации, который будет записан во все слушатели, фильтр может быть применён к каждому слушателю индивидуально, обеспечивая более точный контроль информации об отслеживании.

Для использования отслеживания можно использовать MySql.Data.MySqlClient.MySqlTrace в качестве TraceSource для Connector/NET, а строка подключения должна содержать "Logging=True".

Для включения сообщений отслеживания необходимо настроить переключатель отслеживания. Переключатели отслеживания имеют связанные с ними перечисления уровня отслеживания, такие как Выкл., Ошибка, Предупреждение, Информация и Подробно.

MySqlTrace.Switch.Level = SourceLevels.Verbose;

Это устанавливает уровень отслеживания на Подробно, что означает, что будут записаны все сообщения отслеживания.

Удобно иметь возможность изменять уровень отслеживания без необходимости повторной компиляции кода. Это достигается путём указания уровня отслеживания в файле конфигурации приложения, app.config. Затем вам просто нужно указать нужный уровень отслеживания в файле конфигурации и перезапустить приложение. Источник отслеживания настраивается в разделе system.diagnostics файла. Следующий фрагмент XML иллюстрирует это:

<configuration>
  ...
  <system.diagnostics>
    <sources>
      <source name="mysql" switchName="MySwitch"
              switchType="System.Diagnostics.SourceSwitch" />
      ...
    </sources>
    <switches>
      <add name="MySwitch" value="Verbose"/>
      ...
    </switches>
  </system.diagnostics>
  ...
</configuration>

По умолчанию информация об отслеживании записывается в окно вывода Microsoft Visual Studio. Существует множество слушателей, которые можно подключить к источнику отслеживания, чтобы сообщения отслеживания можно было записывать в различные места назначения. Также можно создавать пользовательские слушатели, чтобы записывать сообщения отслеживания в другие места назначения, такие как мобильные устройства и веб-службы. Часто используемый пример слушателя — ConsoleTraceListener, который записывает сообщения отслеживания в консоль.

Для добавления слушателя во время выполнения используйте код, подобный следующему:

ts.Listeners.Add(new ConsoleTraceListener());

Затем вызовите методы объекта источника отслеживания для генерации информации об отслеживании. Например, можно использовать методы TraceInformation(), TraceEvent() или TraceData().