Различия

Показаны различия между двумя версиями страницы.

--- product:settings:logs:advanced [04.06.2019 12:57] – mayn
+++ product:settings:logs:advanced [04.09.2023 11:23] (текущий) – [Логи создания LINQ-контекста] Сердцев Сергей
@@ Строка 1: / Строка 1: @@
 ====== Логи системы ======
-Advanta умеет записывать **детальные технические логи** о:
+===== Типы логов =====
-  * событиях;
-  * ошибках;
-  * производительности системы.
+ADVANTA умеет записывать **детальные технические логи** о:
+  * событиях
+  * ошибках
+  * производительности системы
+  * процессе создания LINQ-контекста (с версии 3.27)
 Все настройки детальных системных логов расположены здесь: **Администрирование → Общие настройки → Общие настройки → Система сбора информации об ошибках**.
-<grid>
-<col sm="8">
-<callout type="warning" icon="true">
-По умолчанию логирование в Advanta не настроено и не включено.
-</callout>
 <callout type="info" icon="true">
 Этот инструмент пригодится вам, чтобы зафиксировать дефект и передать его в поддержку продукта.
 </callout>
-</col>
-</grid>
-===== Интерфейс =====
+<callout type="warning" icon="true">
+По умолчанию логирование в Advanta не настроено и не включено.
+</callout>
+===== Настройка логирования =====
   * ''Включить логирование производительности системных процессов'' -- поставить чек-бокс можно только после того, как заполнено поле "Путь к логу производительности системных процессов"
@@ Строка 29: / Строка 31: @@
   * ''Url адрес системы обработки логов Seq'' -- Url адрес системы обработки логов Seq, развёрнутый на вашем сервере.  \\  Например: <code> http://192.168.0.78:8888 </code> <callout type="info">**Seq** -- система сбора и анализа логов. Подробно о том, [[https://datalust.co/seq|что такое Seq]].  \\  Инструмент позволяет собирать логи в более человечном представлении, преобразовывать их для визуализации в и аналитики (например, библиотека Serilog через Logstash в ElasticSearch; визуализация возможна через grafana).</callout>
   * ''Выгрузить логи производительности системных процессов'' -- экспорт архива файлов с логами производительности системных процессов с вашего сервера (по пути, который указан в поле "Путь к логу производительности системных процессов").
-  * ''Выгрузить системные логи'' -- НЕ ОТНОСИТСЯ к логированию производительности. Экспорт системного лога. Лог настраивается отдельно в ходе первоначальной установки и настройки системы Advanta.
+  * ''Выгрузить системные логи'' -- НЕ ОТНОСИТСЯ к логированию производительности. Экспорт системного лога log4net. Лог настраивается отдельно в ходе первоначальной установки и настройки системы Advanta (см. следующий раздел на этой странице).
   * ''Исключения для логов производительности системных процессов'' -- фильтр по URL. Укажите здесь все те фразы, которые содержатся в URL тех страниц, которые не должны логироваться. Это может относиться как ко всем однотипным объектам, так и к конкретным (если будет указаны их GUID).
 <image shape="thumbnail">{{ :product:settings:system_log_1.png?nolink |}}</image>
 <TEXT align="center">**Рисунок 1** -- Система логирования производительности системных процессов</text>
 ===== Ошибки и события =====
@@ Строка 46: / Строка 50: @@
     <appendToFile value="true" />
     <rollingStyle value="Size" />
-    <maxSizeRollBackups value="10" />
+    <maxSizeRollBackups value="50" />
-    <maximumFileSize value="50MB" />
+    <maximumFileSize value="100MB" />
     <staticLogFileName value="true" />
     <immediateFlush value="false" />
@@ Строка 58: / Строка 62: @@
     <appendToFile value="true" />
     <rollingStyle value="Size" />
-    <maxSizeRollBackups value="10" />
+    <maxSizeRollBackups value="50" />
-    <maximumFileSize value="50MB" />
+    <maximumFileSize value="100MB" />
     <staticLogFileName value="true" />
     <immediateFlush value="false" />
@@ Строка 78: / Строка 82: @@
   </root>
 </log4net></code>
-  - Поместите файл log4net.config в корень папки с веб-контентом системы.  \\  Корневая директория приложения по умолчанию имеет путь <code> C:\inetpub\wwwroot\streamline </code> Путь по умолчанию, если вы устанавливали систему строго [[product:settings:install|по инструкции]].
+  - Поместите файл log4net.config в корень папки с веб-контентом системы.  \\  Корневая директория приложения по умолчанию имеет путь <code> C:\inetpub\wwwroot\streamline </code> Путь по умолчанию, если вы устанавливали систему строго [[product:settings:system:install|по инструкции]].
+  - Перезапустите пул приложения системы, после перезапуска выполните несколько действий в системе и проверьте что в файлах лого начали появляться записи.
 <callout type="success" icon="true">
@@ Строка 87: / Строка 92: @@
   - Cохраните файл ''log4net.config'' в корневой директории Advanta.
   - Воспроизведите ошибку.
-  - Выгрузите файл с логом и передайте его в поддержку.
+  - Выгрузите файл с логом и передайте его в поддержку вместе с данными о времени воспроизведения и ссылками на страницы системы, где выполнялось воспроизведение ошибки.
 ==== Как выгрузить лог событий ====
@@ Строка 157: / Строка 162: @@
   - Администрирование → Общие настройки → Общие настройки → Система сбора информации об ошибках
   - "Выгрузить логи производительности системных процессов" → ''Выгрузить''
+===== Логи создания LINQ-контекста =====
+Данная опция используется в целях отладки.
+Чтобы включить логирование операций создания LINQ-контекста, необходимо сперва включить [[https://wiki.a2nta.ru/doku.php/product/settings/logs/advanced#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%B8_%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F|логи ошибок log4net]], затем добавить настройку в файле ''client.config'':\\
+**LinqToAdvantaLogGeneratedCode** со значением **'true'**
+<code xml>
+  <appSettings>
+    ...
+    <add key="LinqToAdvantaLogGeneratedCode" value="true" />
+  </appSettings>
+</code>
+Запись сгенерированного при перестроении LINQ-контекста C#-кода будет осуществляться в общий лог ошибок log4net.\\
+В записях лога такие сообщения начинаются со строки "Building LINQ-context ".
+Большинство записей статистического характера: отображают каких и сколько объектов обработано.
+Запись, сообщение в которой начинается с "Building LINQ-context generatad C#-code" - содержит сгенерированный код. Это может быть огромная по размеру запись. Именно для неё введён параметр настройки **LinqToAdvantaLogGeneratedCode** в ''client.config''.
+\\
+Так как объём C#-кода при формировании LINQ-контекста может составлять несколько мегабайт, после использования и завершении отладки эту настройку следует выключить - установить в значение 'false'. Если **LinqToAdvantaLogGeneratedCode** имеет значение **'false'** или отсутствует, то запись сгенерированного кода в лог не будет производиться.\\
+По умолчанию значение этой опции в файле ''client.config'' установлено в значение **'false'**.