Замечания и предложения по KOS Community edition 1.1.1.40

Yura Beznos · December 22, 2023

Документация
1. MessageBus в доке есть, реально отсутствует в SDK
  - Подправить документацию.
2. Cmake макрос NK_USE_UNQUALIFIED_NAMES используется везде в примерах, но нет описания в документации и даже намёка на существование. А стандартное поведение это использовать длинные имена т.е. свой проект не будет собираться и причины вылавливать потребует время.
  - Подправить документацию.
3. Документации на KOS нет в поставке KOS Community SDK (man, info, html, pdf - хоть какой).
  - Добавить хотя бы .pdf со всеми разделами помощи, который сейчас можно скачать с сайта.
4. В мобильной версии сайта нет возможности скачать .pdf со всей документацией (меню прячется с этим функционалом).
  - Подправить шаблон сайта документации, чтобы возможность скачать pdf появилась и для мобильных экранов.
5. Тесты PAL не поддерживают в 1.1.1 Community SDK, но описываются в документации с указанием как запускать (заведомо неработающий механизм).
  - Подправить документацию.
edl,cdl,idl
1. Это ведь entity, component, interface ?
  - Указать в документации что закладывалось в название.
2. В примерах иногда вместо cdl описывают endpoints в edl, хотя в документации говорится, что желательно не смешивать описания.
  - В примерах показывать то, как говорит документация.
3. Требуется три файла для одного сервиса
  - Хотелось бы иметь возможность склеивать файлы в один, как для сервиса, так и для всего проекта (по аналогии с Kubernetes описаниями).
4. Если этих файлов много, то возникает путаница
  - Возможно, было бы полезно иметь возможность автоматически создавать схему визуализирующую взаимосвязь описанных сущностей
klog
1. Показывает результаты с задержкой (30 запросов прошло, появилась первая строчка).
  - Описать причины такого поведения и что вообще ожидать.
2. Показывает не всё, кусками (30 запросов прошло, журнал отобразил только пару).
  - Описать причины такого поведения и что ожидать.
3. Фильтры выводимого. Непонятно как отфильтровывать по конкретным сервисам, если нужно видеть именно взаимодействие между своими сервисами.
  - Добавить примеров с разными фильтрами (как на уровне psl описаний, так и своего кода-фильтра)
Библиотеки
1. Работа с IPC из CPP не очень комфортна, что затрудняет портирование и повышает порог входа.
  - Наметить дорогу ведущую к высокоуровневой библиотеке IPC на CPP
Пожелания
1. Хотелось бы иметь набор генераторов базовых проектов по некоторому описанию.
  - Запустил программу с параметрами - получил проект готовый к сборке.
2. Визуализация конфигурации загрузки и связи между сервисами (init.yaml)
  - Запустил программу - получил plantuml или svg схемку

Курсивом - пожелания и возможные решения.

Edited December 22, 2023 by Yura Beznos
опечатки

Ivan Ponomarev · December 22, 2023

Здравствуйте!

Мы завели по Вашему сообщению запрос INC000016022825.

Мы сообщим как получим ответ или новые данные.

Спасибо!

Yura Beznos · December 25, 2023

Туда же:

Документация
6. Поведение вывода в stdout и stderr непонятно.
  - Описать разницу в поведении stdout и stderr и в каких ситуациях каждый из них работает и почему не работает. Например при вызове IPC в методе, в сервисе который вызываешь, stdout ничего не выведет на консоль, а stderr выведет.

Vadim N · December 25, 2023

Здравствуйте!

Мы добавили информацию в запрос INC000016022825.

Сообщим как получим ответ или новые данные.

Спасибо!

Vadim N · January 10

Здравствуйте, Yura Beznos

По вашему запросу зарегистрированы несколько новых инцидентов в службе технической поддержки.

Мы предоставим ответ, как только будет возможно

Их номера:

INC000016079222
INC000016079223
INC000016079224
INC000016079225
INC000016079226
INC000016079227
INC000016079228
INC000016079229
INC000016079230
INC000016079231
INC000016079232

Данная процедура выполнена в целях упорядочивания информации из первоначального инцидента № INC000016022825.

Ivan Ponomarev · January 11

Здравствуйте,

По инциденту INC000016079226

Ответ разработчика:
Спасибо за найденную проблему, в релизе 1.1.1 запуск PAL тестов не поддерживается. В следующем релизе 1.2 будет предоставлена актуальная информация по PAL тестам.

Cпасибо

Yura Beznos · January 11

1 час назад, Ivan Ponomarev сказал:

Здравствуйте,

По инциденту INC000016079226

Ответ разработчика:
Спасибо за найденную проблему, в релизе 1.1.1 запуск PAL тестов не поддерживается. В следующем релизе 1.2 будет предоставлена актуальная информация по PAL тестам.

Cпасибо

Запуск PAL тестов обсуждался уже на форуме. В этой теме затронута проблема соответствия документации и реальным возможностям. Соответственно если PAL тесты не работают в 1.1.1.40, то хотелось бы чтобы и документация это отражала.

Edited January 11 by Yura Beznos
Добавил ссылку.

barkov_a · January 22

Добрый день.

Отдел разработки предоставил комментарии на некототорые Ваши вопросы:

INC000016079222
1.1 MessageBus действительно нет в поставке 1.1.1.40. В предстоящем релизе 1.2 вернем пример в поставку

INC000016079224

1.3 Да, действительно документации нет в поставке, это решение было принято специально: в случае нахождения критического бага в документации мы можем более быстрым способом внести изменения в онлайн справку. Если копия будет в поставке, то будет необходим новый релиз для любых правок.

barkov_a · January 22

INC000016079227

2.1 Да, расшифровка в документации есть при первом описании. Более того, в предстоящий релиз 1.2 добавили глоссарий в документацию. В соответствующие главы добавим расшифровку тоже

2.2 В документации этот момент уже исправлен. В предстоящем релизу документации 1.2 следующий текст: Интерфейс безопасности и предоставляемые службы могут задаваться в EDL-описании и в CDL-описании. Если при разработке компонента решения используются уже готовые составные части (например, в виде библиотек), которые сопровождаются CDL-описаниями, то целесообразно сослаться на них из EDL-описания через декларацию components. В противном случае можно описать все предоставляемые службы в EDL-описании.

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

barkov_a · January 22

INC000016079229

3.3 Здесь разработчики запросили уточнение. Какой именно сценарий Вы имеете ввиду?

barkov_a · January 22

INC000016079230

4.1 Разработчики приняли к рассмотрению данное предложение, возможно предложат cpp библиотеку рекомендуемую.

barkov_a · January 22

INC000016079231

5.1 Возможно данный функционал будет добавлен в будущие релизы (не ближайший 1.2)
5.2 Предложение по визуализации будет рассмотрено тоже

Ivan Ponomarev · January 23

Здравствуйте!

INC000016079229

Нас просят уточнить:

Показывает результаты с задержкой (30 запросов прошло, появилась первая строчка).
Описать причины такого поведения и что вообще ожидать.
Показывает не всё, кусками (30 запросов прошло, журнал отобразил только пару).
Описать причины такого поведения и что ожидать.

Требуется уточнение:
Какой файл политик использует ?
Как реализован klog_storage ?
На каком проекте проверяется ?

На не больши и простых примерах все работает без задержки.

Возможна небольшая задержка при старте системы , в начале когда происходит инициализация и ожидания всех соединений.

Cпасибо.

Yura Beznos · January 25

В 22.01.2024 в 17:11, barkov_a сказал:

Отдел разработки предоставил комментарии на некототорые Ваши вопросы:

INC000016079222
1.1 MessageBus действительно нет в поставке 1.1.1.40. В предстоящем релизе 1.2 вернем пример в поставку

Отлично! Заодно хотелось бы увидеть документацию описывающую в каких ситуациях данный механизм может быть применим.

Yura Beznos · January 25

В 22.01.2024 в 17:11, barkov_a сказал:

INC000016079224

1.3 Да, действительно документации нет в поставке, это решение было принято специально: в случае нахождения критического бага в документации мы можем более быстрым способом внести изменения в онлайн справку. Если копия будет в поставке, то будет необходим новый релиз для любых правок.

Спасибо за ответ, но мне трудно принять подобное логическое построение. Продукт (яркий пример с сетевым драйвером в соседнем обсуждении) замечательно подождёт необходимого функционала до нового обновления, а документация нет? В любом случае это предложение, которое выглядит логичным если поставляется CLI SDK под Linux (где, вообще говоря, man и info приняты), но выбор за вами.

Yura Beznos · January 25

В 22.01.2024 в 17:13, barkov_a сказал:

INC000016079227

2.1 Да, расшифровка в документации есть при первом описании. Более того, в предстоящий релиз 1.2 добавили глоссарий в документацию. В соответствующие главы добавим расшифровку тоже

2.2 В документации этот момент уже исправлен. В предстоящем релизу документации 1.2 следующий текст: Интерфейс безопасности и предоставляемые службы могут задаваться в EDL-описании и в CDL-описании. Если при разработке компонента решения используются уже готовые составные части (например, в виде библиотек), которые сопровождаются CDL-описаниями, то целесообразно сослаться на них из EDL-описания через декларацию components. В противном случае можно описать все предоставляемые службы в EDL-описании.

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

Спасибо за развёрнутый ответ!

Yura Beznos · January 25

В 22.01.2024 в 17:16, barkov_a сказал:

INC000016079229

3.3 Здесь разработчики запросили уточнение. Какой именно сценарий Вы имеете ввиду?

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

- https://github.com/YuraBeznos/FireFighter-drone-kos/blob/dev/klog_storage/src/klog_storage_entity.c#L28

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

Yura Beznos · January 25

В 22.01.2024 в 17:17, barkov_a сказал:

INC000016079230

4.1 Разработчики приняли к рассмотрению данное предложение, возможно предложат cpp библиотеку рекомендуемую.

Отлично, спасибо. Понимаю, что чувство прекрасного может потребовать сделать нечто сложное и красивое, но для начала иметь хотя бы что-то простое и прикладное. Можно посмотреть на реализацию mosquitto cpp библиотеку.

Yura Beznos · January 25

В 22.01.2024 в 17:19, barkov_a сказал:

INC000016079231

5.1 Возможно данный функционал будет добавлен в будущие релизы (не ближайший 1.2)
5.2 Предложение по визуализации будет рассмотрено тоже

Спасибо!

Yura Beznos · January 25

В 23.01.2024 в 16:17, Ivan Ponomarev сказал:

Здравствуйте!

INC000016079229

Нас просят уточнить:

Показывает результаты с задержкой (30 запросов прошло, появилась первая строчка).
Описать причины такого поведения и что вообще ожидать.
Показывает не всё, кусками (30 запросов прошло, журнал отобразил только пару).
Описать причины такого поведения и что ожидать.

Требуется уточнение:
Какой файл политик использует ?
Как реализован klog_storage ?
На каком проекте проверяется ?

На не больши и простых примерах все работает без задержки.

Возможна небольшая задержка при старте системы , в начале когда происходит инициализация и ожидания всех соединений.

Cпасибо.

Как пример можно посмотреть на этом проекте (запустив с уровнем журналирования 3):

- https://github.com/YuraBeznos/FireFighter-drone-kos/tree/dev

Yura Beznos · January 25

В 22.01.2024 в 17:13, barkov_a сказал:

INC000016079227

2.1 Да, расшифровка в документации есть при первом описании. Более того, в предстоящий релиз 1.2 добавили глоссарий в документацию. В соответствующие главы добавим расшифровку тоже

2.2 В документации этот момент уже исправлен. В предстоящем релизу документации 1.2 следующий текст: Интерфейс безопасности и предоставляемые службы могут задаваться в EDL-описании и в CDL-описании. Если при разработке компонента решения используются уже готовые составные части (например, в виде библиотек), которые сопровождаются CDL-описаниями, то целесообразно сослаться на них из EDL-описания через декларацию components. В противном случае можно описать все предоставляемые службы в EDL-описании.

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

Тут перепутали нумерацию. То что вы пишете как 2.3 в исходном сообщение было 2.4, а 2.3 пока без ответа.

Alexey_Salnikov · February 1

Здравствуйте.

Все дополнительные вопросы были отправлены в инциденты. Когда появится информация мы с вами свяжемся

Alexey_Salnikov · February 5

INC000016079230

мы отправили отзыв разработчикам

Alexey_Salnikov · February 5

>Не ответили на вопрос 2.3 (edl,cdl,idl)
в INC000016079227. "Данные предложения добавили к рассмотрению, положили в беклог."

Завели отдельными элементами:
User Story 7156838: [BRQ][BS] Склеивание файлов edl, cdl, idl
User Story 7156863: [BRQ][BS] Визуализация описанных процессов

Из де-эскалации INC000016079227:
-Требуется три файла для одного сервиса. Хотелось бы иметь возможность склеивать файлы в один, как для сервиса, так и для всего проекта (по аналогии с Kubernetes описаниями).
-Возможно, было бы полезно иметь возможность автоматически создавать схему визуализирующую взаимосвязь описанных сущностей
Данные предложения добавили к рассмотрению, положили в беклог.

Cпасибо.

barkov_a · February 7

On 1/25/2024 at 10:47 PM, Yura Beznos said:

Отлично! Заодно хотелось бы увидеть документацию описывающую в каких ситуациях данный механизм может быть применим.

Добрый день.

Пожалуйста, ознакомьтесь со следующей статьей.

https://support.kaspersky.com/help/KCE/1.1/ru-RU/messagebus_component.htm

Замечания и предложения по KOS Community edition 1.1.1.40

Recommended Posts

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Please sign in to comment