Елемент <property>
Описано елемент <property> у файлі logcfg.xml: умови запису властивостей подій до технологічного журналу, перелік властивостей і налаштування запису контексту виконання.. Загальна інформація. Перелік властивостей
Загальна інформація
Елемент <property> визначає умови потрапляння до журналу значення властивості події, ім’я якої є значенням атрибута name, за умови, що сама подія потрапляє до технологічного журналу. Умови задаються вкладеними елементами <event> за такими самими правилами, що й для подій.
Якщо елемент <property> із певним ім’ям відсутній, відповідна властивість не записується. Якщо елемент <property> не містить вкладених елементів <event>, визначена ним властивість записується для всіх подій, що потрапляють до журналу та містять цю властивість. Якщо елемент <property> містить вкладені елементи <event>, властивість буде записано лише для подій, що задовольняють умову, якщо сама подія записується до журналу та має цю властивість.
Елемент <property name="all"> </property> вмикає запис до журналу всіх властивостей подій.
Наведений нижче елемент <log> визначає запис до журналу подій процесу, серверного контексту, з’єднання, виключних ситуацій і виконання операторів SQL за умови запису до журналу тексту оператора SQL, що виконувався понад одну секунду. Журнал розміщується в каталозі c:\logs і зберігається 1 годину.
Приклад:
<log location="c:\logs" history="1">
<event>
<eq property="name" value="proc"/>
</event>
<event>
<eq property="name" value="scom"/>
</event>
<event>
<eq property="name" value="conn"/>
</event>
<event>
<eq property="name" value="excp"/>
</event>
<event>
<eq property="name" value="dbmssql"/>
</event>
<property name="sql">
<event>
<eq property="name" value="mssql"/>
<gt property="duration" value="10000"/>
</event>
</property>
</log>
Кожна подія має набір властивостей, а кожна властивість — ім’я. У події може бути кілька властивостей з однаковими іменами. Імена властивостей можна використовувати для фільтрації подій і властивостей. Під час порівняння імен великі та малі літери не розрізняються. Пуста умова в елементі <property> означає, що властивість буде виводитися за будь-якої умови.
Примітка
Властивість події виводиться лише за наявності для неї елемента <property>.
Перелік властивостей
Нижче наведено основні властивості подій, які можуть знадобитися для налаштування конфігураційного файлу або перегляду технологічного журналу:
Ім’я події | Опис |
|---|---|
Action | Текстовий опис операції під час завантаження конфігурації з файлів (для події CONFLOADFROMFILES). |
Admin | Ім’я адміністратора кластера або центрального сервера. |
agentURL | Адреса поточного процесу агента сервера системи. |
All | Вмикає запис усіх подій журналу. |
ApplicationExt | Уточнення вимоги призначення функціональності (для події CLSTR). |
Attempts | Кількість спроб встановлення з’єднання з процесом, що завершилися помилкою (для події ATTN). |
AvgExceptions | Середня кількість виключних ситуацій за останні 5 хвилин в інших процесах (для події ATTN). |
AvMem | Значення показника Доступна пам’ять на момент виведення до технологічного журналу (для події FTEXTUpd). |
BackgroundJobCreated | Формування індексу повнотекстового пошуку виконувалося у фоновому процесі (true) чи ні (false) (для події FTEXTUpd). |
Body | Розмір у байтах тіла запиту або відповіді (для подій VRSREQUEST, VRSRESPONSE). |
Calls | Кількість звернень клієнтської прикладної програми до серверної прикладної програми через TCP. |
certificate | Опис сертифіката, що перевіряється (для події WINCERT). Включає такі поля сертифіката: суб’єкт (subject), видавець (issuer), серійний номер (sn). |
Class | Ім’я класу, у якому згенеровано подію (лише для події SYSTEM). |
Cluster | Номер основного порту кластера серверів. |
Component | Ім’я компоненти системи, у якій згенеровано подію (лише для події SYSTEM). |
Connection | Номер з’єднання з інформаційною базою. |
Connections | Кількість з’єднань, яким не вистачило робочих процесів (для події CLSTR). |
ConnLimit | Установлена максимальна кількість з’єднань на один робочий процес (для події CLSTR). |
Context | Контекст виконання. |
CopyBytes | Загальний розмір скопійованих значень під час збирання сміття (для події SDGC). |
CpuTime | Процесорний час у мікросекундах, витрачений на індексування порції файлу журналу реєстрації (для події EVENTLOG). |
CurExceptions | Кількість виключних ситуацій у процесі за останні 5 хвилин (для події ATTN). |
Database | Шлях до бази даних, що використовується (для подій DB2, DBMSSQL, DBORACLE, DBPOSTGRS, DBDA, EXCP, SDBL). Для клієнт-серверного варіанта ім’я бази даних формується як Ім'яСерверу\Ім'яБази, для файлового варіанта виводиться повний шлях до файлу 1Cv8.1CD. |
DBConnID | Ідентифікатор з’єднання із СУБД зовнішнього джерела даних (лише для події EDS). |
DBConnStr | Рядок з’єднання із зовнішнім джерелом даних (лише для події EDS). |
DBCopy | Ім’я копії бази даних, що використовується (для подій DB2, DBMSSQL, DBORACLE, DBPOSTGRS, DBDA, EXCP, SDBL). Якщо звернення до копії не відбувається, ця властивість не записується. |
Dbms | Ім’я СУБД, що використовується для виконання операції, яка спричинила формування цієї події технологічного журналу (для подій EDS, DB2, DBMSSQL, DBORACLE, DBPOSTGRS, DBDA, EXCP, SDBL). Може набувати значень:
|
Dbpid | Рядкове подання ідентифікатора з’єднання сервера системи із сервером баз даних у термінах сервера баз даних для подій DBMSSQL, DBPOSTGRS, DB2, DBORACLE. |
DBUsr | Ім’я користувача СУБД зовнішнього джерела даних (лише для події EDS). |
DeadlockConnectionIntersections | Список пар транзакцій, що утворюють взаємне блокування (для події TDEADLOCK). |
Descr | Пояснення до програмного виключення. |
description | Текст, який пояснює виконувану дію (для події DHIST). |
DstAddr | Призначена адреса робочого процесу (для події CLSTR). |
DstId | Унікальний ідентифікатор призначеного робочого процесу (для CLSTR). |
DstPid | Системний ідентифікатор призначеного робочого процесу (для CLSTR). |
DstSrv | Призначена назва робочого сервера (для події CLSTR). |
dumpError | Опис помилки, що виникла під час побудови дампу. |
DumpFile | Ім’я файлу з дампом. |
Duration | Тривалість події у сотнях мікросекунд. |
Durationus | Тривалість події у мікросекундах. |
Err | Консольне повідомлення: 0 – інформаційне; 1 – про помилку. |
errorCode | Код помилки, який повернув метод роботи із сертифікатами Windows API (для події WINCERT). |
Event | Містить найменування дії, яку виконує кластер серверів (для події CLSTR), і визначає наявність інших властивостей у цій події. |
Exception | Найменування програмної виключної ситуації. |
ExtSrvcUrl | Адреса зовнішнього сервісу інтеграції (для події SINTEG). |
ExtSrvcUsr | Ім’я користувача зовнішнього сервісу інтеграції (для події SINTEG). |
FailedJobsCount | Кількість фонових процесів індексації, які завершилися з помилками (для події FTEXTUpd). |
File | Ім’я файлу, у якому згенеровано подію (для події SYSTEM) або у якому виявлено проблему під час перевірки індексу повнотекстового пошуку (для події FTEXTCHECK). |
FileName | Ім’я файлу зі сформованим індексом журналу реєстрації (для події EVENTLOG). |
Files | Список файлів у форматі «ім’я файлу … розмір файлу» в каталозі виконання дії (для події FTEXTUpd). Властивість формується лише в разі встановлення для атрибута logfiles елемента ftextupd значення True. |
FilesCount | Кількість файлів у каталозі виконання дії (для події FTEXTUpd). Властивість формується лише в разі встановлення для атрибута logfiles елемента ftextupd значення True. |
FilesSize | Загальний розмір сховища в байтах (для події SDGC). |
FilesTotalSize | Розмір файлів у каталозі виконання дії (для події FTEXTUpd). Властивість формується лише в разі встановлення для атрибута logfiles елемента ftextupd значення True. |
FillRefsPresent | За наявності властивості використовується кеш посилань зі списку значень, а не повнотекстовий пошук даних (для події INPUTBYSTRING). |
FindByString | Ім’я об’єкта конфігурації, для якого виконується введення за рядком. |
findTicks | Час, витрачений на пошук у базі даних, у мсек (для події INPUTBYSTRING). |
Finish | Причина завершення процесу. |
Folder | Каталог, у якому виконується дія (для події FTEXTUpd). Може бути тимчасовим каталогом або каталогом розташування файлів з індексом повнотекстового пошуку. Властивість формується лише в разі встановлення для атрибута logfiles елемента ftextupd значення True. |
ftextResultCount | Кількість посилань, знайдених повнотекстовим пошуком (для події INPUTBYSTRING). |
ftextSearchCount | Кількість викликів повнотекстового пошуку (для події INPUTBYSTRING). |
ftextTicks | Час, витрачений на повнотекстовий пошук, у мсек (для події INPUTBYSTRING). |
Func | Найменування виконуваної дії. |
Headers | HTTP-заголовки запиту або відповіді (для подій VRSREQUEST, VRSRESPONSE). |
Host | Ім’я комп’ютера. |
hResultOLEDB, hResultNC2005, hResultNC2008, hResult2012 | Містить 16-значний код повернення спроби з’єднання через відповідного провайдера: OLE DB, SQL Server Native Client версій 2005, 2008, 2012. Якщо спроба з’єднання через провайдера не виконувалася, властивість буде відсутня. Спроба з’єднання починається з провайдера, що відповідає найактуальнішій версії Microsoft SQL Server, після чого перебираються всі провайдери від найбільшої до найменшої версії. Після успішного з’єднання наступні спроби встановлення з’єднання з іншими провайдерами не здійснюються. |
IB | Ім’я інформаційної бази в клієнт-серверному варіанті. |
IBLimit | Установлена максимальна кількість інформаційних баз на один робочий процес (для події CLSTR). |
IName | Ім’я переданого інтерфейсу, з якого віддалено викликано метод (для подій SCALL і CALL). |
InBytes | Кількість даних, прочитаних із диска за час виклику, у байтах. |
Info | Інформація про збій (для події FTEXTCheck). |
Infobases | Кількість інформаційних баз, яким не вистачило робочих процесів (для події CLSTR). |
InstanceID | Унікальний ідентифікатор сховища (для SDGC). Ціле число. |
JobCanceledByLoadLimit | Ознака того, що фоновий процес індексації було скасовано через досягнення межі завантаження робочого процесу (для події FTEXTUpd). |
Level | Рівень важливості події (лише для подій SYSTEM та CONFLOADFROMFILES). Можливі значення події наведено в описі елемента <system> файлу параметрів технологічного журналу logcfg.xml. |
Line | Номер рядка у файлі, у якому згенеровано подію SYSTEM. |
LockDuration | Тривалість блокування сховища за період роботи збирання сміття в мілісекундах (для події SDGC). |
Locks | Список керованих транзакційних блокувань (для події TLOCK). |
MaxMemSize | Максимальний обсяг пам’яті, який може займати процес, указаний у налаштуваннях кластера, у байтах (для події ATTN). |
MDX | Текст MDX-запиту до системи OLAP. |
MDX | Текст виконуваного запиту до OLAP-системи (лише для події EDS). |
Memory | Обсяг пам’яті в байтах, зайнятий, але не звільнений за серверний виклик. |
MemoryPeak | Пікове значення за виклик пам’яті в байтах, зайнятої, але не звільненої. |
MemoryUsed | Максимальний розмір динамічної пам’яті, використаний під час виклику (для події FTEXTUpd). |
MemSize | Обсяг пам’яті, який займає процес, у байтах (для події ATTN). |
MessageUid | Унікальний ідентифікатор поштового повідомлення, під час розбору якого виникла помилка. Значення дорівнює властивості UID об’єкта InternetMailMessage. |
Method | HTTP-метод звернення до ресурсу (для подій VRSREQUEST, VRSRESPONSE), метод об’єкта InternetMail, під час якого сталася помилка розбору поштового повідомлення (для події MAILPARSEERR), ім’я викликаного методу, що відрізняється від методу call (для події CALL), або поточна дія збирача сміття (для події SDGC). Для події MAILPARSEERR може набувати значень:
Для події CALL ця властивість містить номер викликаного методу інтерфейсу, а ідентифікатор викликаного інтерфейсу зазначено у властивості Interface. Для події SDGC може набувати значень:
|
MinDataId | Мінімальний ідентифікатор індексованих даних у порції, яка пройшла від менеджера кластера до робочого процесу та назад (для події FTEXTUpd). |
MName | Ім’я віддалено викликаного методу (для подій SCALL і CALL). |
MyVer | Поточна версія стану сервера (для події CLSTR). |
Name | Ім’я події. |
NeedResync | Потрібна синхронізація даних сервера (лише для події CLSTR, у якій властивість Event дорівнює значенню current version older). |
Nmb | Номер сеансу (для події SESN). |
NParams | Кількість параметрів оператора SQL для файлового варіанта інформаційної бази (подія DBV8DBENG). Параметри, кількість яких зазначена в цій властивості, використовуються для передавання довгих бінарних даних. |
Obsolete | Кількість та унікальні ідентифікатори застарілих робочих процесів (для події CLSTR). |
OSException | Опис виключних ситуацій операційної системи. |
OSThread | Номер потоку, що виконує індексацію файлу журналу реєстрації (для події EVENTLOG). |
OutBytes | Кількість даних, записаних на диск за час виклику, у байтах. |
p:processName | Ім’я серверного контексту, яке зазвичай збігається з ім’ям інформаційної бази. |
PacketCount | Фактична кількість пакетів, записаних у файл індексу під час оброблення поточного файлу (для події EVENTLOG). |
Phrase | Текстова фраза, що відповідає коду стану (для події VRSRESPONSE). |
PID | Ідентифікатор процесу операційної системи. |
planSQLText | План запиту, що міститься у властивості Sql (для подій DBV8DBENG, DBMSSQL, DBPOSTGRS, DB2, DBORACLE, EDS). |
Port | Номер основного мережевого порту процесу. |
Process | Найменування прикладної програми, як його подає операційна система: ім’я файлу програмного модуля прикладної програми. |
ProcessName | Найменування процесу. |
procURL | Адреса процесу сервера системи, якому належить подія. |
Query | Текст запиту вбудованою мовою, під час якого виявлено значення NULL у полі, для якого таке значення неможливе (для події QERR). |
QueryFileds | Перелік полів запиту, у яких виявлено значення NULL (для події QERR). |
Reason | Причина недоступності робочого процесу (для події CLSTR). |
Ref | Ім’я інформаційної бази. |
Regions | Імена просторів керованих транзакційних блокувань (для події TLOCK). |
Registered | Кількість та унікальні ідентифікатори нових робочих процесів (для події CLSTR). |
Released | Кількість та унікальні ідентифікатори резервних робочих процесів, що стали основними (для події CLSTR). |
Report | Ім’я об’єкта метаданих звіту, що виконується у фоновому завданні. |
Request | Ідентифікатор запиту на з’єднання (для події CLSTR). |
res | Описує дію, виконану системою ліцензування (для події LIC). |
Result | Результат перевірки файлів індексу повнотекстового пошуку: 1 – помилок немає, 0 – є помилки (для події FTEXTCheck). |
RetExcp | Виключення, що виникло під час виконання серверного виклику та передано клієнту як результат виклику (для подій CALL). |
Rows | Кількість отриманих записів бази даних. |
RowsAffected | Кількість змінених записів бази даних. |
RunAs | Режим запуску процесу: прикладна програма або сервіс. |
Sdbl | Текст запиту вбудованою мовою моделі бази даних. |
SearchByMask | Якщо встановлено значення TRUE або "1", використовується пошук у базі даних без результатів повнотекстового пошуку (для події INPUTBYSTRING). |
Separation | Увімкнено поділ чи ні (для події FTEXTCheck). |
SepId | Індекс області поділу, якщо поділ увімкнено (для події FTEXTCheck). |
ServerComputerName | Ім’я робочого сервера. |
ServiceName | Ім’я сервісу кластера серверів (для події CLSTR). |
SessionID | Номер сеансу, призначений поточному потоку. Якщо поточному потоку не призначено жодного сеансу, властивість не додається. |
Sql | Текст оператора SQL. |
SrcAddr | Пріоритетна адреса робочого процесу (для події CLSTR). |
SrcId | Унікальний ідентифікатор пріоритетного робочого процесу (для події CLSTR). |
SrcPid | Системний ідентифікатор пріоритетного робочого процесу (для події CLSTR). |
srcProcessName | Записується під час звільнення загальних даних інформаційної бази робочим процесом. Значенням властивості ProcessName є ім’я загальних даних на момент звільнення. Значенням властивості srcProcessName є ім’я загальних даних інформаційної бази на момент їх створення. |
SrcURL | Пріоритетна адреса робочого сервера (для події CLSTR). |
SrcVer | Отримана версія стану кластера серверів (для події CLSTR). |
SrvcName | Ім’я об’єкта метаданих сервісу інтеграції, для якого виконується підключення до зовнішнього сервісу інтеграції (для події SINTEG). |
State | Фіксує початок або завершення операції оновлення індексу повнотекстового пошуку (для події FTEXTUPD). |
Status | Код стану HTTP (для події VRSRESPONSE). |
SyncPort | Номер допоміжного мережевого порту процесу. |
Sz | Обсяг динамічної пам’яті, зайнятої процесом на момент виведення події MEM, у байтах. |
Szd | Зміна обсягу динамічної пам’яті, зайнятої процесом, з моменту виведення попередньої події MEM, у байтах. |
t:applicationName | Ідентифікатор клієнтської програми. |
t:clientID | Ідентифікатор з’єднання з клієнтом через TCP. |
t:computerName | Ім’я клієнтського комп’ютера. |
t:connectID | Ідентифікатор з’єднання з інформаційною базою. |
Text | Текст, введений під час введення за рядком (для події INPUTBYSTRING). |
Time | Час виведення запису до технологічного журналу (для події FTEXTUpd). Для події ATTN містить ім’я серверного процесу: rmngr або rphost. |
Timeout | Залежно від призначення події ATTN (властивість Descr) може описувати:
|
tooManyResults | Якщо встановлено значення TRUE або "1" і в індексі надто багато посилань, що задовольняють запит, повнотекстовий пошук не використовується (для події INPUTBYSTRING). |
TotalJobsCount | Кількість фонових процесів, створених під час індексації (для події FTEXTUpd). |
Trans | Ідентифікатор активності транзакції на момент початку події:
|
Txt | Текст інформаційного повідомлення. |
URI | Ресурс, до якого виконується звернення (для подій VRSREQUEST, VRSRESPONSE). |
UsedSize | Розмір використовуваного місця у сховищі, у байтах (для події SDGC). |
Usr | Ім’я користувача інформаційної бази. Якщо в інформаційній базі не визначено користувачів, ця властивість матиме значення DefUser. Значення властивості береться з призначеного сеансу. |
Val | Значення, зміст якого залежить від значення параметра Func. |
WaitConnections | Список з’єднань, з якими відбувається зіткнення за керованими транзакційними блокуваннями (для подій TLOCK і TTIMEOUT). |
Word | Слово, якщо визначено (для події FTEXTCheck). |
сn | Кількість зайнятих процесом фрагментів динамічної пам’яті на момент виведення події MEM. |
сnd | Зміна кількості зайнятих процесом фрагментів динамічної пам’яті з моменту виведення попередньої події MEM. |
За допомогою властивостей елемента <property> до технологічного журналу можна записувати контекст виконання. Контекст виконання може бути двох видів: контекст вбудованої мови та інтерфейсний контекст. Контекст вбудованої мови є списком операторів вбудованої мови й містить:
- назву модуля;
- номер рядка модуля;
- текстове подання елемента списку виклику вбудованої мови відповідного рядка модуля.
Інтерфейсний контекст містить:
- повне ім’я форми;
- тип активного елемента форми;
- ім’я активного елемента форми;
- ім’я кнопки командної панелі, якщо її було натиснуто;
- дію, яку виконує елемент форми.
Наприклад, контекст вбудованої мови у файлі технологічного журналу може мати такий вигляд:
Документ.ПриходнаяНакладная:23:Движения.УчетНоменклатуры.Записать(); МодульПриложения:18:ПроверитьПодключениеОбработчикаОжидания(Истина); МодульПриложения:230:ЕслинпПолучитьЗначениеПоУмолчанию(глТекущийПользователь,«ИспользоватьНапоминания") ОбщийМодуль.нпНастройкиПользователей:481:Выборка=Запрос.Выполнить().Выбрать();
Інтерфейсний контекст у файлі технологічного журналу може мати такий вигляд:
{Документ.Документ1.ФормаСписка}/{ТабличноеПоле:
ДокументСписок}/{ОбновлениеОтображения}
{Документ.Документ1.Форма.ФормаДокумента}/{КоманднаяПанель:
ОсновныеДействияФормы}/{ОсновныеДействияФормыОК}
{Документ.Документ1.Форма.ФормаДокумента}/{Кнопка:
Кнопка1}/{Нажатие}
Щоб увімкнути запис контексту, потрібно серед фільтрів властивостей записати елемент <property name="Сontext"> або елемент <property name="all">.
Якщо потрібно записувати події SDBL (SDBL-запити) і DBMSSQL (оператори SQL до СУБД MS SQL Server) з контекстом виконання, вміст файлу параметрів технологічного журналу має виглядати так:
<config xmlns="http://bas-soft.eu/v8/tech-log">
<log location="c:\bas\logs" history="1">
<event>
<eq property="name" value="sdbl"/>
</event>
<event>
<eq property="name" value="dbmssql"/>
</event>
<property name="context">
</property>
</log>
</config>
Якщо потрібно записувати події SDBL (SDBL-запити) і DBMSSQL (оператори SQL до СУБД MS SQL Server) без контексту виконання, файл налаштування технологічного журналу треба заповнити так:
<config xmlns="http://bas-soft.eu/v8/tech-log">
<log location="c:\bas\logs" history="1">
<event>
<eq property="name" value="sdbl"/>
</event>
<event>
<eq property="name" value="dbmssql"/>
</event>
</log>
</config>
Щоб записувати події SDBL (SDBL-запити) і DBMSSQL (оператори SQL до СУБД MS SQL Server) без контексту виконання, але з усіма іншими властивостями, файл налаштувань має містити:
<config xmlns="http://bas-soft.eu/v8/tech-log">
<log location="c:\bas\logs" history="1">
<event>
<eq property="name" value="sdbl"/>
</event>
<event>
<eq property="name" value="dbmssql"/>
</event>
<property name="all">
</property>
<property name="context">
<eq property="name" value=""/>
</property>
</log>
</config>
</config>
Щоб записувати події SDBL (SDBL-запити) з контекстом виконання і DBMSSQL (оператори SQL до СУБД MS SQL Server) без контексту виконання, вміст файлу налаштування має бути таким:
<config xmlns="http://bas-soft.eu/v8/tech-log">
<log location="c:\bas\logs" history="1">
<event>
<eq property="name" value="sdbl "/>
</event>
<event>
<eq property="name" value="dbmssql"/>
</event>
<property name="context">
<event>
<eq property="name" value="sdbl"/>
</event>
</property>
</log>
</config>
Наявність елемента <property name="Context"> означає, що для подій, які записуються до журналу в разі виконання умов, зазначених у цьому елементі, буде записано інформацію про контекст. Після цього до кожної події технологічного журналу буде додано інформацію про контекст виконання у поточному процесі, а після події буде додано миттєву подію з інформацією про контекст виконання клієнтського процесу.
До технологічного журналу можуть записуватися повідомлення про виключні ситуації, пов’язані з менеджером блокувань. Для цього файл налаштування має містити такі дані:
<config xmlns="http://bas-soft.eu/v8/tech-log">
<log location="c:\bas\logs" history="7">
<event>
<eq property="name" value="excp"/>
</event>
<event>
<eq property="name" value="tlock"/>
<gt property="duration" value="100000"/>
</event>
<property name="all"/>
<property name="context">
<event>
<eq property=«name" value=""/>
</event>
</property>
</log>
<dump location="c:\bas\dumps" create="1" type="2"/>
</config>
У наведеному прикладі реєструватимуться всі виключні ситуації, пов’язані з блокуваннями, зокрема DEADLOCK – взаємні блокування з’єднань і TIMEOUT – завершення напередвизначеного часу. В обох випадках до тексту повідомлення про виключну ситуацію включається номер з’єднання, яке викликало цю виключну ситуацію, а також очікування, що перевищили 10 секунд. При цьому буде записано інформацію за всіма властивостями, крім Context.
