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

Логирование – это процесс записи в файл различных событий, связанных с работой 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;
  • общая информация:
    • процессор;
    • количество логических ядер процессора;
    • версия ОС

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

NOTICE (5)
HARDWARE

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

  • наличие/отсутствие окружения виртуальной машины;
  • CPU;
  • HDD;
  • DVD;
  • OS;
  • BASEBOARD;
  • MAC-ADDRESS;
  • FQDN;
  • SID;
  • IP
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. Проверьте, что выполнен п.5.
    2. Выберите объекты для описания события. Если в описании должны присутствовать все объекты, перейдите к п. c.
      1. Нажмите на ссылку Выбрать объекты для записи.
      2. В открывшемся окне Состав лога событий бизнес-логики удалите объекты в поле Объекты в логе.
      3. Добавьте необходимые объекты в описание, нажав в поле Доступные объекты значок напротив нужного объекта.
      4. Укажите названия для объектов. В поле Объекты в логе перед каждым значением объекта напишите название объекта=.

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

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

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

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

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

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




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