You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Общая информация

Логирование – это процесс записи в файл различных событий, связанных с работой Guardant Control Center и использованием сетевых лицензий конечным пользователем.  

Записи событий сохраняются в лог-файл со следующими параметрами:

Параметр лог-файлаОС  WindowsОС Linux
Имя

Если на текущий момент события еще записываются в лог-файл – log.

Если лог-файл достиг максимального размера и события начинают записываться в следующий лог-файл – log.[дата создания файла в формате ГГГГММДД][временная метка создания файла]

Пример.
log – события записываются в текущий лог-файл.
log.20250413110300 – запись событий в этот лог-файл завершена (он достиг максимального размера).

Максимальный размер

Задается пользователем через интерфейс или конфигурационный файл (C:\ProgramData\Guardant\Control Center\settings) Guardant Control Center . 

Значение по умолчанию – 100 Мб

Задается пользователем через интерфейс или конфигурационный файл (/etc/guardant/gcc/settings) Guardant Control Center . 

Значение по умолчанию – 100 Мб

Директория хранения

Задается пользователем через файл настроек Guardant Control Center (C:\Program Files (x86)\Guardant\Guardant Control Center\grdcontrol.properties).
При этом может указываться как абсолютный путь до директории, так и относительно  директории, заданной по умолчанию.

По умолчанию все лог-файлы сохраняются в директории C:\ProgramData\Guardant\Control Center\logs_gcc

Задается пользователем через файл настроек Guardant Control Center (/etc/guardant/gcc/grdcontrol.properties).
При этом может указываться как абсолютный путь до директории, так и относительно директории, заданной по умолчанию.

По умолчанию все лог-файлы сохраняются в директории /etc/guardant/gcc/logs_gcc

Максимальное количество лог-файлов в директории хранения 

Задается пользователем через интерфейс или конфигурационный файл (C:\ProgramData\Guardant\Control Center\settings) Guardant Control Center . 

По умолчанию в директории может хранится до 5 лог-файлов

Задается пользователем через интерфейс или конфигурационный файл (/etc/guardant/gcc/settings) Guardant Control Center . 

По умолчанию в директории может хранится до 5 лог-файлов

Запись событий в лог-файлы циклическая: при достижении последним лог-файлом максимального размера самый старый лог-файл в директории удаляется, и создается новый, в который будет продолжаться запись.

События в лог-файле записываются в следующем формате:

ГГГГ-ММ-ДД ЧЧ:ММ:СС [тип события] описание события

Часовой пояс, в котором указывается время записи события – UTC+0:00.

Пример записи события в лог-файле.

2025-05-15 08:09:54 [INFO] Guardant Control Center 4.0.3.0 (preview build)
2025-05-15 08:09:54 [INFO] GenuineIntel 11th Gen Intel(R) Core(TM) i5-1135G7 @ 2.40GHz
2025-05-15 08:09:57 [ARRIVE] License arrived BOB-PC(localhost) Guardant DL(DEMONVK) licenseid=FDC6A19C
2025-05-15 08:09:57 [INFO] Server started
2025-05-15 08:09:57 [HARDWARE] No VM environment detected
2025-05-15 08:20:22 [REMOVE] License removed from ANN-PC(172.16.126.115) Guardant DL(DEMONVK) licenseid=D75D5B95
2025-05-16 09:42:26 [DETACH] License detached from Guardant DL(DEMONVK) licenseid=8CE649C5 productid=26 featureid=9 to BOB-PC licenseid=EC149348 3 day(s),1 seat(s),expires:18 May 2025 09-53-40

Уровни логирования, типы и группы событий

Уровни логирования

Guardant Control Center поддерживает 8 уровней логирования:

  1. FATAL.
  2. CRTITCAL.
  3. ERROR.
  4. WARNING.
  5. NOTICE.
  6. INFORMATION.
  7. DEBUG.
  8. TRACE.

Все уровни логирования задаются через конфигурационный файл. Уровни WARNING (4), NOTICE (5), INFORMATION (6) дополнительно можно задать через интерфейс Guardant Control Center, включив/отключив запись соответствующей группы событий.

По умолчанию в конфигурационном файле установлен уровень логирования NOTICE (5) – запись технических событий (событий, относящихся к работе Guardant Control Center, управлению и настройке использования сетевых лицензий).

Уровень INFORMATION (6) используется для записи событий бизнес-логики (событий, относящихся непосредственно к использованию сетевых лицензий: создание/закрытие сессии работы с лицензией, ошибки, возникающие при использовании лицензии, и т.п.).

Уровни FATAL (1), CRITICAL (2), ERROR (3) и WARNING (4) используются для записи критически важных сообщений.

Уровни DEBUG (7) и TRACE (8) используются только при возникновении каких-либо проблем с работой сетевых лицензий и для сбора отладочной информации для разработчиков.

Уровень WARNING (4) используется в случаях, когда сервис Guardant Control Center нестандартно завершает свою работу. В интерфейсе Guardant Control Center он соответствует отключению записи технических событий и событий бизнес-логики.

При изменении уровня логирования через конфигурационный файл необходим перезапуск Guardant Control Center. 

 При изменении уровня логирования через интерфейс перезапуск Guardant Control Center не требуется.

Пример записи уровня логирования в конфигурационном файле.

<property name="logLevel" value="6"/>

Группы событий

В интерфейсе Guardant Control Center все события для записи в лог-файл делятся на 2 группы:

  • технические события;
  • события бизнес-логики.

Технические события

В этой группе в лог-файл записываются события, относящиеся к работе Guardant Control Center, управлению и настройке использования сетевых лицензий (подробнее см. таблицу).

Список событий в этой группе фиксированный и не может быть изменен пользователем.

Пример записи технических событий в лог-файл.

2025-05-15 11:08:32 [INFO] Server started
2025-05-15 11:08:32 [HARDWARE] No VM environment detected
2025-05-15 11:08:32 [HARDWARE] CPU = 2851286CBB671241960CE21BDB7A4658D08318B1F36C2EDE9169B9BE5C3AD881
2025-05-15 11:08:32 [HARDWARE] HDD = 3005A971F8C7A6F81D61B44CAE588894BA4C79BCCE5973CDC1C4BA715F8B63B4
2025-05-15 11:08:32 [HARDWARE] DVD NOT DETECTED
2025-05-15 11:08:32 [HARDWARE] OS = C102025FB98B6C2E33B7AA462A562DA4444E305D66C1A8BEEE149C1CC3262185
2025-05-15 11:08:32 [HARDWARE] BASEBOARD = EA3B977033243CCC3F9FE2F3EB2C0AED14EED44A9B3B7455F1F5F428094EE8FD
2025-05-15 11:08:32 [HARDWARE] MAC-ADDRESS = 4ED12D5319E5256C3518EC22597F24550D63FACE65C7F26739CEF8FCA6658A72
2025-05-15 11:08:32 [HARDWARE] FQDN = 1EB0CE186849CBB4CC233736ECD5F6A2240B56C04D21F4253CD509E32764A54E
2025-05-15 11:08:32 [HARDWARE] SID = E5651205BE475538A4A898BB8C8FA2FCD70CA28A8DC623F179124D1F9FB9503C
2025-05-15 11:08:32 [HARDWARE] IP = 51083CF6CA22005DBE7209E66F724E66D587936239D89F9649D16412E5940C21
2025-05-15 11:08:32 [STORAGE] ID = B5F388F2ED7E09E76D9D845AAE09DFB55CAA997677B505864713ED1046C28BE4
2025-05-15 11:08:37 [ARRIVE] License arrived BOB-PC(192.168.1.5) Guardant DL(DEMONVK) licenseid=EC149348
2025-05-15 11:15:03 [REMOVE] License removed from ANN-PC(192.168.1.7) Guardant DL(DEMONVK) licenseid=D75D5B95
2025-05-16 09:42:26 [DETACH] License detached from Guardant DL(DEMONVK) licenseid=8CE649C5 productid=26 featureid=9 to BOB-PC licenseid=EC149348 3 day(s),1 seat(s),expires:18 May 2025 09-53-40

Cобытия бизнес-логики

В этой группе в лог-файл записываются события, относящиеся непосредственно к использованию сетевых лицензий: создание/закрытие сессии работы с лицензией, ошибки, возникающие при использовании лицензии, и т.п.

Эту группу событий можно включить для записи в лог-файл только совместно с техническими событиями. Включить ее отдельно нельзя.

События бизнес-логики могут содержать следующие объекты для описания события:

Название объекта по умолчаниюЗначение объектаОписание
sessionid{sessionid}Идентификатор (ID) сессии
apiname{apiname}Функция API, вызванная при работе пользователя с сетевой лицензией 
apiversion{apiversion}Версия Guardant Licensing API, использованная в приложении пользователя
result{result}Результат выполнения функции API
clientaddr{clientaddr}IP-адрес пользователя
clientid{clientid}Имя пользователя
licenseid{licenseid}Идентификатор (ID) ключа
productid{productid}Номер продукта в лицензии
featureid{featureid}Номер компонента в лицензии
seats{seats}Количество занятых сетевых лицензий

Пользователь может изменять названия объектов в описании события.

Пользователь самостоятельно определяет, какие объекты будут входить в описание события. По умолчанию в описание добавлены все объекты.

Для аппаратных ключей в описании события вызова функции API значения объектов apiname и result отсутствуют (кроме функций GrdFeatureLogin и GrdFeatureLogout).

Пример записи событий бизнес-логики в лог-файл.

\\\ аппаратный ключ
2025-05-15 11:13:03 [API_CALL] sessionid=00001912 apiname=GrdFeatureLogin apiversion=4.0 result='Success' ip=192.168.111.1 user=petrov licenseid=457342bc productid=26 featureid=9 seats=1 (1/2 floating/total)
2025-05-15 11:13:03 [API_CALL] sessionid=00001912 apiname= apiversion=4.0 result='' ip=192.168.111.1 user=petrov licenseid=457342bc productid=26 featureid=9 seats=1
2025-05-15 11:13:03 [API_CALL] sessionid=00001912 apiname= apiversion=4.0 result='' ip=192.168.111.1 user=petrov licenseid=457342bc productid=26 featureid=9 seats=1
2025-05-15 11:13:03 [API_CALL] sessionid=00001912 apiname= apiversion=4.0 result='' ip=192.168.111.1 user=petrov licenseid=457342bc productid=26 featureid=9 seats=1
2025-05-22 14:41:37 [API_CALL] sessionid=00002124 функция_api= apiversion=4.0 result='' сетевой_адрес=10.128.0.126 user=smirnova licenseid=457342bc productid=26 featureid=9 seats=1
\\\ программный ключ
2025-05-22 15:05:14 [API_CALL] sessionid=00002732 функция_api=GrdFeatureGetInfo apiversion=4.0 result='Success' сетевой_адрес=10.128.0.126 user=kirillova licenseid=bf49d6d0 productid=24 featureid=9 seats=1
2025-05-22 15:05:14 [API_CALL] sessionid=00002732 функция_api=GrdFeatureGetRunCounter apiversion=4.0 result='Service is not supported' сетевой_адрес=10.128.0.126 user=kirillova licenseid=bf49d6d0 productid=24 featureid=9 seats=1
2025-05-22 15:05:14 [API_CALL] sessionid=00002732 функция_api=GrdFeatureGetTimeLimit apiversion=4.0 result='Service is not supported' сетевой_адрес=10.128.0.126 user=kirillova licenseid=bf49d6d0 productid=24 featureid=9 seats=1
2025-05-22 15:05:14 [API_CALL] sessionid=00002732 функция_api=GrdFeatureDecrypt apiversion=4.0 result='Success' сетевой_адрес=10.128.0.126 user=kirillova licenseid=bf49d6d0 productid=24 featureid=9 seats=1

Типы событий

Все события, записываемые в лог-файл, делятся на следующие типы:

Тип событияОписание типа событияГруппа событийУровень логирования

INFO

Общая информация о локальном компьютере, на котором запущен Guardant Control Center:

  • версия Guardant Control Center;
  • информация о запуске/остановке сервиса Guardant Control Center;
  • запущен ли Guardant Control Center в виртуальной машине;
  • общая информация:
    • процессор;
    • количество логических ядер процессора;
    • версия ОС

Технические события

NOTICE (5)
HARDWARE

Информация о комплектующих локального компьютера и его сетевых настройках:

  • CPU;
  • HDD;
  • DVD;
  • OS;
  • BASEBOARD;
  • MAC-ADDRESS;
  • FQDN;
  • SID;
  • IP;
  • ID
STORAGEИнформация об уникальном идентификаторе хранилища программных ключей компьютера
ARRIVE

Информация о:

  • новых обнаруженных ключах в сети;
  • активируемых программных ключах на локальном компьютере;
  • подключаемых к локальному компьютеру аппаратных ключах


REMOVE

Информация об:

  • удалении программного ключа с локального Guardant Control Center;
  • отключении аппаратного ключа от локального Guardant Control Center;
  • перестали обнаруживаться сетевые ключи на удаленных Guardant Control Center
DETACHОткрепление лицензий
API_CALLВызов функции Guardant Licensing API для работы с сетевой лицензией События бизнес-логикиINFORMATION (6)

Как включить запись группы событий в лог-файл

  1. Перейдите в раздел Настройки Guardant Control Center .
  2. Введите пароль для доступа к настройкам. По умолчанию пароль – admin.
  3. В списке Настройки выберите Логирование.

  4. Если требуется изменить максимальный размер лог-файла и их количество в директории хранения, установите необходимые значения в соответствующих полях.
  5. Чтобы включить логирование технических событий, установите соответствующий переключатель в активное состояние .
  6. Чтобы включить логирование событий бизнес-логики:
    1. Проверьте, что выполнен п.4.
    2. Выберите объекты для описания события. Если в описании должны присутствовать все объекты, перейдите к п. c.
      1. Нажмите на ссылку Выбрать объекты для записи.
      2. В открывшемся окне Состав лога событий бизнес-логики удалите объекты в поле Объекты в логе.
      3. Добавьте необходимые объекты в описание, нажав в поле Доступные объекты значок напротив нужного объекта.
      4. Укажите названия для объектов. В поле Объекты в логе перед каждым значением объекта напишите название объекта=.

      6. Нажмите на кнопку Сохранить.

    3. Установите переключатель события бизнес-логики в активное состояние .

Как отключить запись группы событий в лог-файл

  1. Перейдите в раздел Настройки Guardant Control Center.
  2. Введите пароль для доступа к настройкам Guardant Control Center. По умолчанию пароль – admin.
  3. В списке Настройки выберите Логирование.

  4. Установите переключатель группы событий, которую необходимо отключить, в неактивное состояние .

Если отключить запись технических событий, запись событий бизнес-логики отключится автоматически.




  • No labels
Если вам нужна помощь, обратитесь по адресу
hotline@guardant.ru