Окружение
На странице Окружение перечислены все свойства, которые сервис Spring Boot определяет во время выполнения, сгруппированные по источникам свойств. Для каждого свойства указано значение, отмечен источник, который в данный момент определяет свойство, а там, где Spring связывает свойство с бином, — ссылка на @ConfigurationProperties и на точки инъекции, которые его считывают.
Окружение в
интерфейсе Axelix
Если в сервисе есть активные профили Spring или профили по умолчанию, они отображаются в верхней части страницы под
Профили: — чипы объединяют spring.profiles.default и spring.profiles.active. Блок скрыт, если профиль не задан.
Под профилями расположен прокручиваемый список всех свойств, сгруппированный по источникам свойств. Каждый источник —
раскрывающаяся секция (по умолчанию развёрнутая), над списком есть поле поиска, фильтрующее источники свойств и записи,
а также счётчик вида <соответствует> / <всего>.
- Имя источника: имя источника свойств.
- Описание: наведите курсор на иконку
рядом с названием источника, чтобы увидеть пользовательское описание этого источника свойств, если оно есть.
- Свойства: список свойств в источнике.
Подробности свойства
Выпадающий блок свойства в интерфейсе Axelix
В каждой строке свойств отображается название свойства, кнопка копирования в буфер обмена, разрешенное значение и маркер основного источника. При раскрытии строки открывается панель с подробной информацией:
- Имя: имя свойства.
- Значение: значение, полученное из этого источника свойств.
- Актуальное значение: помечено иконкой короны
в столбце значений. Корона означает, что это значение является приоритетным при разрешении — если один и тот же ключ присутствует в нескольких источниках свойств, то основным будет считаться только тот источник, к которому среда Spring обратилась первой.
- Устаревшее: устаревшие свойства выделены красным фоном в заголовке строки, а на панели сведений отображается сообщение об устаревании.
- Описание: описание из
spring-configuration-metadata.json, если доступно. - Configuration Properties:
@ConfigurationPropertiesкомпонент, который привязывает это свойство, если таковой имеется. Имя компонента — это ссылка
,
которая ведет на страницу «Свойства конфигурации» с привязкой к этому компоненту. - Инжектируется в: бины, которые потребляют это свойство через
@Valueили аналогичные механизмы. Каждый элемент — это ссылка
, которая ведёт на
страницу Beans с привязкой к этому компоненту.
По умолчанию все значения маскируются как ****** для пользователей, не обладающих полномочиями ENV_VALUES_READ. О
том, как выбрать, какие ключи будут замаскированы, а какие останутся открытыми, см. в разделе Маскирование
значений.
Маскирование значений
Axelix никогда не полагается на переключатель Spring Boot management.endpoint.env.show-values — он всегда просит
Spring Boot вернуть сырые значения (Show.ALWAYS) и поверх применяет собственное маскирование на основе проверки
полномочий.
Кто видит исходные значения. Вызывающие с полномочием ENV_VALUES_READ предоставляемыми встроенными ролями ADMIN
и SUPER_ADMIN — получают исходные значения. Остальные получают значения, заменённые на ******. Полную матрицу ролей
и полномочий см. в разделе Роли и
полномочия.
Какие ключи маскируются. Одно свойство стартера — axelix.sbs.endpoints.config.sanitized-properties — управляет
этим набором, и оно применяется и к axelix-env (эта страница), и к axelix-configprops (страница Configuration
Properties):
- Пустой список (по умолчанию) — все значения маскируются для пользователей без соответствующих полномочий.
- Непустой список — маскируются только указанные ключи, остальные возвращаются без изменений.
axelix.sbs.endpoints.config.sanitized-properties[0]=database.password
axelix.sbs.endpoints.config.sanitized-properties[1]=spring.datasource.password
axelix.sbs.endpoints.config.sanitized-properties[2]=jwt.signing-keyСм. Маскирование чувствительных значений свойств в руководстве по настройке Spring Boot Starter — то же свойство описано рядом с остальными настройками стартера.
Стандартные свойства Spring Boot Actuator для маскирования — management.endpoint.env.show-values,
management.endpoint.env.keys-to-sanitize и их эквиваленты для configprops — не учитываются. Вместо них используйте
axelix.sbs.endpoints.config.sanitized-properties.
MCP-инструменты
Полное окружение управляемого сервиса — свойства приложения, системные свойства и переменные окружения ОС — также доступно ИИ-агентам через MCP. См. Каталог MCP-инструментов.
Включите Нужный Actuator Ендпоинт
Если вы используете Axelix 1.2.0 или новее, ничего из этого не требуется: стартер сам регистрирует свои
actuator-эндпоинты, а эндпоинты health/info Axelix больше не требуются — он отлично работает и без них. Никакая
настройка здесь не нужна.
Страница работает поверх actuator-эндпоинта axelix-env, который добавляет Axelix Spring Boot Starter. Она доступна
через стандартные свойства Spring Boot Actuator. Полный список конечных точек Axelix и сопутствующих настроек см. в
разделе Настройка Spring Boot
Starter:
management.endpoints.web.exposure.include=axelix-envСм. также
Логгеры
Страница Логгеры даёт доступ ко всем настроенным механизмам логирования в сервисе на Spring Boot, группам логгеров и позволяет менять их уровни логирования.
Бины
На странице Бины перечислены все бины Spring, зарегистрированные в ApplicationContext управляемого сервиса. Каждая строка представляет собой раскрывающийся список, в котором указаны класс бина, область видимости, зависимости, квалификаторы, стратегия проксирования и исходный компонент Spring, использованный для его создания.