Андрій Луконькін

Технологічний журнал «1С: Підприємство 8.1»

Система «1С: Підприємство 8.1» забезпечує можливість ведення технологічного журналу, в якому міститься інформація від всіх додатків, що відносяться до «1С: Підприємство».

Технологічний журнал являє собою сукупність каталогів і текстових файлів, в які система записує інформацію про роботу деяких внутрішніх механізмів платформи «1С: Підприємство». Технологічний журнал може використовуватися розробниками прикладних рішень для аналізу різних режимів роботи системи, наприклад для отримання інформації про помилкові і виняткових ситуаціях в конфігурації і технологічній платформі, інформації про запуск і завершення додатків, установці і розриві з'єднань, діях користувачів і адміністраторів.

Файли журналу мають текстовий формат, кожен файл містить події за 1 годину.

Технологічний журнал може вестись на будь-якому комп'ютері, на якому інстальована система «1С: Підприємство 8.1».

За параметри ведення технологічного журналу відповідає конфігураційний файл logcfg.xml, в якому описуються:

• каталог, в якому будуть розташовуватися файли технологічного журналу;
• склад інформації, яка буде міститися в технологічний журнал;
• час, протягом якого зберігаються файли технологічного журналу;
• параметри дампа, створюваного при аварійному завершенні програми.

Файл logcfg.xml повинен бути поміщений в підкаталог conf каталогу завантажувальних модулів «1С: Підприємство» (зазвичай це каталог C: \\ Program Files \\ 1cv81 \\ bin).

Якщо файл logcfg.xml відсутня або містить помилки, то технологічний журнал вважається виключеним і не створюється. Слід уникати використання коментарів (конструкції типу).

Важливо!   При створенні записів технологічного журналу робота системи сповільнюється. Це потрібно враховувати у випадках, коли зниження продуктивності може бути критичним.

Склад конфігураційного файлу logcfg.xml

У міру виходу нових версій платформи «1С: Підприємство» відслідковують події можуть змінюватися і доповнюватися, але загальний принцип   структури залишається єдиним.

…

…

елемент   визначає налаштування технологічного журналу. Він може містити кілька елементів   і один елемент .

елемент визначає каталог технологічного журналу. Його атрибут location - це ім'я каталогу, в якому розміщуватиметься технологічний журнал. Атрибут history - це кількість годин, через яке інформація буде віддалятися з технологічного журналу.

наприклад:

Це означає, що файли будуть зберігатися 12 годин на каталозі c: \\ 1c8logs.

елемент   визначає каталог для запису дампів аварійного завершення програми. Щоб відключити запис дампов, потрібно в елементі   встановити значення параметра «create \u003d" 0 "» або «create \u003d" false "».

В елемент   можуть бути вкладені елементи   і Склад яких визначає умова записи в журнал кожної події і умови запису кожного властивості події.

Подія включається в журнал, якщо воно задовольняє всім умовам всередині хоча б одного з елементів . Умови задаються елементами:

• eq   - одно;
• ne   - не дорівнює;
• gt   - більше;
• ge   - більше чи рівно;
• lt   - менше;
• le   - менше або дорівнює;
• like   - відповідність масці.

наприклад:

Це означає, що в технологічному журналі будуть створюватися записи про події з ім'ям PROC.

Можливі імена груп подій дивіться в таблиці.

Можливі імена груп подій

PROC	Події, що відносяться до процесу цілком і впливають на подальшу працездатність процесу. Наприклад: старт, завершення, аварійне завершення і т.п.
SCOM	Події створення або видалення серверного контексту, звичайно пов'язаного з інформаційною базою
EXCP	Виняткові ситуації додатків системи «1С: Підприємство 8.1», які штатно не обробляються і можуть послужити причиною аварійного завершення серверного процесу або приєднаного до нього клієнтського процесу
EXCPCNTX	Події, які почалися, але не закінчилися в момент виникнення нештатної ситуації
SDBL	Події, пов'язані з виконанням запитів до моделі бази даних «1С: Підприємство 8.1»
QERR	Події, пов'язані з виявленням помилок компіляції запиту або обмеження на рівні записів і полів бази даних
PERR	Події, пов'язані з виявленням помилок роботи з настройками користувача
CONN	Установка або розрив клієнтського з'єднання з сервером
ADMIN	Керуючі впливи адміністратора кластера серверів «1С: Підприємства 8.1»
DBV8DBEng	Виконання операторів SQL файлової СУБД
DBMSSQL	Виконання операторів SQL СУБД Microsoft SQL Server
DBPOSTGRS	Виконання операторів SQL СУБД PostgreSQL
	Виконання операторів SQL СУБД DB2
CALL	віддалений виклик
TLOCK	Управління транзакційними блокуваннями в керованому режимі

елемент Визначає умови потрапляння в журнал значення ключової властивості події, ім'я якого є значенням атрибута name.

елемент   включає записи в журнал всіх властивостей подій.

Використовуючи властивості елемента У технологічний журнал можна записувати контекст виконання двох видів: контекст вбудованої мови і інтерфейсний контекст. Щоб почати запис контексту, потрібно серед фільтрів властивостей записати елемент або елемент

Розглянемо кілька прикладів використання технологічного журналу.

Такий конфігураційний файл визначає висновок в технологічний журнал всіх подій разом з усіма властивостями. Журнал буде зберігатися протягом 8 годин.

Наступний конфігураційний файл реєструватимуть всі виключні ситуації, пов'язані з блокуваннями і очікування, що перевищили 10 секунд (тривалість подій виражається в сотнях мікросекунд).

Цей конфігураційний файл визначає, що технологічний журнал буде містити тільки звернення «1С: Підприємство» до СУБД і інформацію про помилкові ситуаціях.

Файл logcfg.xml легко створюється в будь-якому текстовому редакторі, але також можна скористатися зовнішньої обробкою   «Налаштування технологічного журналу» з диска ІТС (лютий 2008 г.).

Використовуючи візуальний редактор, можна додавати записуються події, властивості і умови відображення властивостей.

Після редагування з'являється готовий текст   конфігураційного файлу, який можна зберегти або скопіювати.

висновок

Таким чином, використання технологічного журналу дозволяє зафіксувати широкий спектр дій і подій, а також дає можливість проаналізувати виниклі проблеми при роботі з «1С: Підприємство». На базі технологічного журналу побудована вся робота спеціалізованої конфігурації «1С: Центр управління продуктивністю» (див. Випуск журналу №3 (64) за березень 2008 року).

Також можливе створення власних систем, що використовують структуровані файли журналу для проведення аналізу даних.

- виконуваний код 1С: Підприємство 8;
  - код Transact-SQL для СУБД;
  - інтерактивні дії користувачів;
  - повідомлення про помилки;
  - витоку пам'яті.

У випадки аварійного завершення журнал дозволяє зробити дамп пам'яті і копію екрану для передачі розробникам.

Для включення технологічного журналу необхідно:
  Створити файл logcfg.xml в папці C: \\ Program Files (x86) \\ 1cv82 \\ 8.2.15.301 \\ bin \\ conf (шлях - каталог 1С підприємства) на сервері 1С Підприємства.
Після цього необхідно прописати в файлі logcfg.xml шляху до створених папок (де Зазначений шлях 1 - шлях до логам, а Зазначений шлях 2 - шлях до дампи):

Ось приклад налаштувань з мого сервера:

Після виконання даних дій додаток 1cv8 автоматично почне зберігати системної інформації про всі помилки, які сталися в системі в даних каталогах.
  Після виконання аналізу, технологічний журнал можна відключити, видаливши або перейменувавши файл logcfg.xml.
  Передбачається, що на комп'ютерах, де цей журнал буде включаться, файли можуть займати досить великий обсяг місця на диску (відносно, звичайно). Тому рекомендую вказувати шляхи на диски з великим об'ємом вільного місця.
  1) Для успішного створення   логів, потрібно створити каталоги для логів (наприклад «D: \\ 1Clog») і дапмов (наприклад «D: \\ 1Cdumps»), краще створювати не на системному диску.
  2) До цих каталогів ТЖ повинні бути обов'язково налаштовані права:
  - повні права на каталог технологічного журналу;
  - права на читання власника каталогу технологічного журналу.
  Примітка. Якщо все одно не пишеться ТЖ, то дати права всім на цю папку (тимчасово, щоб переконатися що справи в правах).
  3) У каталозі технологічного журналу не повинно бути сторонніх файлів. Каталог, в якому є сторонні файли не дозволить створювати журнал (логи).
  4) Місце зберігання dumps і logs не зберігати разом, тому що через вказаний інтервал (за умовчанням 1 година) вміст польностью перетирається і ви втратите дампи
  ТЖ краще налаштовувати (за допомогою фільтрів - тегів logcfg.xml) тільки на досліджувані події, решта не збирати, інакше словите «відсутність місця на диску» і гальма в швидкодії сервера.
  1) Легше виконувати настройку фільтрів за допомогою обробки з ІТС НастройкаТехнологіческогоЖурнала.epf, але при цьому пам'ятати, що нові фічі останніх релізів в обратке можуть отстутствавать (кожна нова версія   додає нові можливості, в обробки вони не відображені). У цьому випадки коригувати файл logcfg.xml руками.
  2) Щоб логи перестали збиратися досить перейменувати файл, перезапускати сервер не треба, настройки перераховуються кожну хвилину «на льоту»
  3) налаштувати logcfg.xml для фільтрації подій за певною ІБ потрібно використовувати «p: processName \u003d»

За допомогою цих налаштувань я збираю інформацію про:

виняткові ситуації, додатків системи 1С: Підприємство 8.2, які штатно не обробляються і можуть послужити причиною аварійного завершення серверного процесу або приєднаного до нього клієнтського процесу.

події, які почалися, але не закінчилися в момент виникнення нештатної ситуації.

події, що відносяться до процесу цілком, і впливають на подальшу працездатність процесу. Наприклад: старт, завершення, аварійне завершення і т.п.

керуючі впливу адміністратора кластера серверів 1С: Підприємства 8.2

події, пов'язані зі збільшенням обсягу пам'яті, зайнятої серверними процесами (ragent, rmngr, rphost).

події, пов'язані з витоком пам'яті, які можуть бути викликані помилками в коді конфігурації.

28.12.2016

Налаштування технологічного журналу 1С

Для початку скажемо про те, що за замовчуванням технологічний журнал включений. Він працює і фіксує події всього в двох випадках:
  Аварійне завершення роботи процесів кластера 1С (ragent, rmngr або rphost) Дамп фіксується в каталозі% LOCALAPPDATA% \\ 1C \\ 1Cv82 \\ dumps - для 1С 8.2% LOCALAPPDATA% \\ 1C \\ 1Cv8 \\ dumps - для 1С 8.3 Якщо використовується платформа 8.3 і виникає подія SYSTEM з рівнем Error Список таких подій зберігаються 24 години, потім платформі видалить файли логів% LOCALAPPDATA% \\ 1C \\ 1Cv8 \\ logs - для 1С 8.3

Інструкція по налаштуванню технологічного журналу

   Порядок дій під час налаштування технологічного журналу:

• Завести спеціальну папку для технологічного журналу (наприклад C: \\ LOG), і для дампов (наприклад C: \\ dumps)
• Налаштувати файл logcfg.xml для збору повідомлень про помилки (нижче приклади настройки)
• Помістити файл logcfg.xml в необхідний каталог (нижче приклад)
• Перевірити права на запис в каталоги логів і дампов
• Переконатися через хвилину що створюються файли логів (якщо не створюються, значить настройки не коректні)
• Можлива помилка - різний регістр букв в іменах каталогів (повинен співпадати)
• Можлива помилка - в файлі настройки в кінці імені каталогу слеш "\\" не потрібен

Налаштування технологічного журналу (файл logcfg.xml)

   Відзначимо, що найбільш часто використовуваних каталогом розташування конфігураційного файлу, є C: \\ Program Files \\ 1Cv82 \\ conf - для платформи 8.2 C: \\ Program Files \\ 1Cv8 \\ conf - для платформи 8.3 У цьому випадку настройки будуть діяти у всіх версіях платформи встановлених на сервері. Також варто сказати, що саме цей варіант є рекомендованим.
Кожні 60 секунд, настройки зчитуються робочими процесами кластера. Читання налаштувань кожним процесом, відбувається незалежно від інших процесів.

Приклад налаштування повного технологічного журналу

   Ці настройки означають, що в технологічний журнал будуть виводитися всі події, з усіма властивостями, і журнал буде зберігається 168 годин.
   Використовувати дану настройку для повсякденної роботи не рекомендується, тому що обсяг інформації буде дуже великим. Однак при тестуванні і пошуку помилок, така надмірна інформація буде вкрай корисною.

Приклад настройки "на кожен день"

   У більшості випадків, буде достатньо наступної настройки: Обсяг даних буде невеликим. При цьому буде інформація про запуск і завершення додатків, установці і розриві з'єднань з кластером серверів "1С: Підприємства", діях адміністратора кластера і про помилкові ситуаціях в роботі "1С: Підприємства"

  (Або частина, використовуючи фільтр), наприклад:
  - виконуваний код 1С: Підприємство 8;
  - код Transact-SQL для СУБД;
  - інтерактивні дії користувачів,

- повідомлення про помилки,

Примітка. Якщо все одно не пишеться ТЖ, то дати права всім на цю папку (тимчасово, щоб переконатися що справи в правах).

3) У каталозі технологічного журналу не повинно бути сторонніх файлів. Каталог, в якому є сторонні файли не дозволить створювати журнал (логи).

4) Місце зберігання dumps і logs не зберігати разом, тому що через вказаний інтервал (за умовчанням 1 година) вміст польностью перетирається і ви втратите дампи

Налаштування

ТЖ краще налаштовувати (за допомогою фільтрів - тегів logcfg.xml) тільки на досліджувані події, решта не збирати, інакше словите «відсутність місця на диску» і гальма в швидкодії сервера.

1) Легше виконувати настройку фільтрів за допомогою обробки з ІТС НастройкаТехнологіческогоЖурнала.epf, але при цьому пам'ятати, що нові фічі останніх релізів в обратке можуть отстутствавать (кожна нова версія додає нові можливості, в обробки вони не відображені). У цьому випадки коригувати файл logcfg.xml руками.

2) Щоб логи перестали збиратися досить перейменувати файл, перезапускати сервер не треба, настройки перераховуються кожну хвилину «на льоту»

3) налаштувати logcfg.xml для фільтрації подій за певною ІБ потрібно використовувати «p: processName \u003d»

4) http://users.v8.1c.ru/Adm1936.aspx - приклади налаштувань

подробиці

Зрозуміло, що зібрати логи мало, їх ще потрібно обробити для вирішення конкретного завдання.

1) Складнощі читання ТЖ:

- Вимагає гарного розуміння архітектури роботи системи

- Тексти запитів реєструються на внутрішньому мові 1С: Підприємства і на мові DBMS

2) Файли технологічного журналу зберігаються в підкаталогах. Ім'я кожного підкаталогу технологічного журналу одного процесу матиме вигляд:<ИмяПроцесса>_<ИдентификаторПроцесса>, Наприклад: rphost_4076. Файл журналу задається шаблоном ГГММДДЧЧ.log. Наприклад, в журналі 07051819.log ім'я файлу утворено від 2007 травня 18, 19 годин)

3) Журнал для аналізу можна вивантажити в Ексель, використовуючи роздільником кому наприклад

Якщо Ви хочете скористатися журналом для аналізу повідомлень про помилки, скористайтеся безкоштовним сервісом.

якщо ви не знайшли відповідь на ваше запитання, давайте розширимо матеріал

Технологічний журнал і його налаштування

Технологічний журнал являє собою сукупність каталогів і текстових файлів, в які різні додатки 1С: Підприємства можуть записувати інформацію про роботу деяких внутрішніх механізмів платформи. Склад виведеної інформації визначається конфігураційних файлів технологічного журналу, який має назву logcfg.xmlі повинен бути поміщений в підкаталог confкаталогу завантажувальних модулів 1С: Підприємства. У цьому файлі засобами XML визначаються умови виведення в технологічний журнал подій і їх властивостей. якщо файл logcfg.xmlвідсутня, не містить жодного елемента log, Або містить помилки, то технологічний журнал вважається виключеним і не створюється. При вимкненому технологічному журналі продуктивність 1С: Підприємства трохи вище, ніж при включеному.

У наведених нижче прикладах передбачається, що 1С: Підприємство встановлено стандартним способом і його завантажувальні модулі розташовані в каталозі C: \\ Program Files \\ 1cv82 \\ bin.

важливо   мати на увазі, що в каталог технологічного журналу при деяких його налаштуваннях можуть виводиться дані дуже великого обсягу. Тому на диску, де будуть зберігатися дані журналу реєстрації, має бути достатньо місця. Для роботи технологічного журналу необхідно, щоб користувачі, від імені яких запускаються додатки 1С: Підприємства (як клієнтські, так і серверні), мали повні права на каталог технологічного журналу ( D: \ 1cv82 \\ logs), І право на читання вище лежачого каталогу ( D: \ 1cv82).

УВАГА! Необхідно мати на увазі, що каталог технологічного журналу не призначений для зберігання в ньому файлів, які не належать до технологічного журналу. Тому не слід розміщувати в ньому дампи або використовувати каталог, який може містити файли, що не належать до технологічного журналу «1С: Підприємства». Якщо в каталозі, який вказаний як каталогу
  технологічного журналу, є сторонні файли, то вказівка \u200b\u200bкаталогу вважається неправильним, і технологічний журнал не створюється.

Система «1С: Підприємство» автоматично, з періодичністю 60 секунд, опитує каталоги конфігураційних файлів на предмет наявності файлу logcfg.xml   і аналізує його склад. Таким чином, зміна параметрів технологічного журналу може бути виконано на ходу, без перезапуску працюючих додатків системи «1С: Підприємство».

Технологічний журнал вимкнений

якщо файл logcfg.xmlвідсутня або ім'я файлу не дорівнює « logcfg.xml»(Наприклад logcfg_1 .xml)в каталозі C: \\ Program Files \\ 1cv82 \\ bin \\ conf, То технологічний журнал не створюється. якщо файл logcfg.xmlнеобхідний для правильної настоянки дампов, то він не повинен містити жодного елемента log.

Наступний приклад визначає необхідність побудови повного дампа додатки при його аварійному завершенні. Дампи поміщаються в каталог: D: \\ 1cv82 \\ dumps.

Повний технологічний журнал

Наведений нижче конфігураційний файл визначає висновок в технологічний журнал всіх подій разом з усіма властивостями. Журнал буде зберігатися протягом 2 діб (48 годин). Обсяг виведеної інформації при цьому буде дуже великим, проте, вона може бути корисна при аналізі складних нештатних ситуацій. Дану конфігурацію рекомендується використовувати на етапі тестування і при розслідуванні помилок.

Звернення до СУБД

Наступний конфігураційний файл визначає, що технологічний журнал буде містити тільки звернення 1С: Підприємства до СУБД, а так само інформацію про помилкові ситуаціях. Обсяг виведеної інформації менше, ніж при повному технологічному журналі, але теж може бути дуже великим.

Дії адміністратора і помилки

Цей конфігураційний файл створює технологічний журнал невеликого обсягу, в якому міститься інформація про запуск і завершення додатків, установці і розриві з'єднань з кластером серверів 1С: Підприємства, діях адміністратора кластера і про помилкові ситуаціях в роботі 1С: Підприємства. Такий журнал в більшості випадків достатній, для розслідування помилкових ситуацій як в конфігурації, так і в технологічній платформі 1С: Підприємства.

Помилки і довгі операції

У порівнянні з попереднім, даний конфігураційний файл додає всі операції, тривалість яких перевищує 10 секунд. Це може виявитися корисним для виявлення дій користувачів, які виконувалися тривалий час, з метою, наприклад, їх подальшої оптимізації. Тривалість подій виражається в сотнях мікросекунд.

  ) .Lt; / eventlogcfg