Панель сведений о приложении
Разделы страницы App Info в dzyam.chat — детали, запросы, безопасность, релизы, настройки, журналы и экземпляры.
Страница App Info собирает сведения и настройки каждого приложения dzyam.chat — и установленного из маркетплейса, и загруженного как частное.
Здесь описан весь интерфейс App Info: так проще сопровождать приложения, разбирать поведение и точно настраивать их.
Как открыть
- Нажмите Маркетплейс
> Обзор (Explore). - В левом меню выберите раздел:
- Explore — приложения маркетплейса dzyam.chat.
- Premium — приложения только для Enterprise.
- Installed — установленные из маркетплейса.
- Requested — запросы пользователей рабочего пространства.
- Private Apps — загруженные вручную.
- Нажмите приложение в списке — откроется App Info.
Примечание.
Разделы маркетплейса описаны в статье Маркетплейс dzyam.chat.
Что видно в шапке
- Имя приложения и короткое описание.
- Кнопка Установить (Install).
- Статус установленного приложения:
EnabledилиDisabled. - Меню «⋮»: установка, включение и отключение, журналы, удаление.
- Разработчик и издатель.
- Текущая версия и дата последнего обновления.
Дальше страница делится на вкладки.
Details
Общие сведения:
- Description — краткое назначение приложения.
- Categories — метки классификации, например
Bots,Omnichannel. - Contact Info — сайт автора и ссылки поддержки.
- Documentation — документация приложения или общая документация dzyam.chat.
- APIs (для приложений на API) — эндпоинты интеграции с примерами запросов curl.
Requests
Вкладка видна у установленных приложений. Здесь запросы на установку или доступ, которые отправили участники рабочего пространства. Это нужно там, где пользователям нельзя ставить и включать приложения самим.
Если в пространстве включены запросы, здесь будут ожидающие заявки: кто запросил и когда. Если заявок нет, показывается No requests.
Security
Вкладка есть у установленных приложений. В ней разрешения и политики использования — администратор видит, какой доступ приложению нужен.
- Privacy Summary. Условия использования данных dzyam.chat. Они зависят от типа развёртывания (SaaS или self-managed) и описывают, как данные пользователя может собирать приложение или поставщик сервиса.
- Permissions. Все запрошенные разрешения. Среди них доступ к:
- данным сервера (сведения о комнатах и пользователях, настройки);
- ресурсам Livechat (данные посетителей, отделы);
- внутренним системам (запланированные задания, слэш-команды, HTTP-эндпоинты);
- интерфейсу и обработке сообщений.
По этому списку оценивают влияние на безопасность и соответствие внутренним политикам.
- Policies. Ссылки на условия использования и политику конфиденциальности.
Releases
У установленных приложений — история версий, примечания к релизам и даты. Каждая версия сворачивается и может содержать сводку изменений, улучшений и исправлений.
Settings
Настройки, которые открыл разработчик приложения. Они сгруппированы по секциям и рисуются динамически, по тому, как приложение собрано.
Примечание.
Если вы разрабатываете приложение на Apps-Engine, как задаются настройки и типы полей — в Apps Settings guide.
Где хранятся пакеты установленных приложений — в статье Хранение пакетов приложений.
Logs
Журналы установленного приложения в реальном времени, с поиском. Нужны администраторам и разработчикам, чтобы отлаживать, проверять и прослеживать поведение. Здесь события уровня приложения: смена настроек, включение и отключение, вызовы системных методов. Перед показом и выгрузкой dzyam.chat автоматически скрывает потенциально чувствительные поля.
У каждой записи:
- Timestamp — точное время события.
- Event name — метод приложения или хук жизненного цикла.
- Severity level — уровень (
debug,infoилиwarning). - Caller — источник вызова, например
constructorилиanonymous. - Execution result — результат метода, обычно
true,falseилиnull.
Записи по умолчанию свёрнуты. Можно:
- раскрыть запись стрелкой (▾) и посмотреть данные выполнения;
- в раскрытом виде увидеть полный JSON, включая
instance,events,timestampи другие поля; - Expand all — раскрыть все видимые записи;
- Collapse all — свернуть все раскрытые;
- Refresh logs — обновить ленту, удобно при проверке свежих изменений;
- Export — скачать текущий отфильтрованный вид:
- формат JSON или CSV;
- последние 2000 записей или свой лимит;
- выбрать 25, 50 или 100 записей на страницу, чтобы большой журнал не тормозил интерфейс.
Примечание. С версии 8.4 часть полей в журнале может отображаться как
[redacted], чтобы не светить токены аутентификации, учётные данные, API-ключи и персональные данные, переданные методам приложения. Скрытие применяется автоматически до сохранения журнала и не отключается. То же действует для выгруженных файлов. Пример:
{
"_id": "69ef430bc49503b2874e1bbb",
"appId": "54588e04-e779-45b4-85de-eb6d186fc859",
"method": "api:simple:post",
"x-user-id": "rocketchat.xyz.abc.test",
"x-auth-token": "[Redacted]",
"content-type": "application/json",
"query": {
"access_token": "[Redacted]",
"query": "[Redacted]"
}
}
Фильтры
Четыре фильтра сужают выборку. Они действуют и на экран, и на выгрузку.
- Event. Событие жизненного цикла:
app:initialize,app:setStatus,app:onEnable,app:construct. All показывает все типы, включая нестандартные события самого приложения — набор отличается от приложения к приложению. - Time. Когда произошло событие: Last 5 minutes, Today, This Week или свой интервал.
- Instance. Идентификатор экземпляра приложения. Полезно после перезапуска сервера: даже на одном экземпляре рабочего пространства здесь может быть больше одного ID.
- Severity. Уровень. Одновременно можно выбрать только один:
- Debug — низкоуровневые внутренние сообщения, обычно для разработки;
- Info — обычные рабочие записи;
- Warning — возможные проблемы или необычные условия.
Примечание.
Если вы разрабатываете приложение на Apps-Engine, события и то, как менять это поведение, описаны в App Development Lifecycle.
Instances
Если рабочее пространство запущено в нескольких экземплярах, на странице появляется вкладка Instances:
- Workspace instance — идентификаторы экземпляров, например
2201496f-a04a-4adf-a266-306b778e3d02. Каждый пункт списка — отдельный сервер чата в том же рабочем пространстве со своим Apps-Engine. - Status —
EnabledилиDisabled.
Чтобы посмотреть журналы экземпляра, откройте меню (⋮) напротив него и нажмите View logs. Откроется вкладка Logs с журналами этого экземпляра.
Примечание.
Как масштабировать рабочее пространство несколькими экземплярами — в статье Запуск dzyam.chat в нескольких экземплярах