Megosztás a következőn keresztül:

A Spring Boot Felügyeleti összetevő konfigurálása az Azure Container Appsben

  • Cikk

A Spring-felügyelet által felügyelt összetevő egy felügyeleti felületet biztosít a Spring Boot-webalkalmazásokhoz, amelyek aktuátorvégpontokat fednek le. Ez a cikk bemutatja, hogyan konfigurálhatja és kezelheti a Spring-összetevőt.

Megjelenítés

Az egyes összetevők adatait név szerint tekintheti meg a show parancs használatával.

A következő parancs futtatása előtt cserélje le az értékekkel körülvett <> helyőrzőket.

az containerapp env java-component admin-for-spring show \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME>

Frissítés

A spring-alapú rendszergazdai összetevő konfigurációját a update parancs használatával frissítheti.

A következő parancs futtatása előtt cserélje le az értékekkel körülvett <> helyőrzőket. A támogatott konfigurációk a tulajdonságok listájának táblázatában jelennek meg.

az containerapp env java-component admin-for-spring update \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --name <JAVA_COMPONENT_NAME> \
  --configuration <CONFIGURATION_KEY>="<CONFIGURATION_VALUE>"

Lista

A parancs használatával listázhatja az összes regisztrált Java-összetevőt list .

A következő parancs futtatása előtt cserélje le az értékekkel körülvett <> helyőrzőket.

az containerapp env java-component list \
  --environment <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Kötés megszüntetése

Ha el szeretne távolítani egy kötést egy tárolóalkalmazásból, használja a --unbind lehetőséget.

A következő parancs futtatása előtt cserélje le az értékekkel körülvett <> helyőrzőket.

az containerapp update \
  --name <APP_NAME> \
  --unbind <JAVA_COMPONENT_NAME> \
  --resource-group <RESOURCE_GROUP>

Dependency

Amikor a felügyeleti összetevőt használja a tárolóalkalmazásban, a következő függőséget kell hozzáadnia a pom.xml fájlhoz. Cserélje le a verziószámot a Maven-adattárban elérhető legújabb verzióra.

<dependency>
    <groupId>de.codecentric</groupId>
    <version>3.3.2</version>
    <artifactId>spring-boot-admin-starter-client</artifactId>
</dependency>

Konfigurálható tulajdonságok

A Spring Boot 2-től kezdve az állapottól és az adatoktól eltérő végpontok alapértelmezés szerint nem lesznek közzétéve. Ezeket az alábbi konfigurációval teheti közzé a application.properties fájlban.

management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always

A spring-hez készült rendszergazda engedélyezett konfigurációs listája

Az alábbi lista az alkalmazáshoz konfigurálható rendszergazdai összetevő tulajdonságait ismerteti. További részleteket a Spring Boot felügyeleti dokumentációjában talál.

Tulajdonság neve Leírás Alapértelmezett érték
spring.boot.admin.server.enabled Engedélyezi a Spring Boot felügyeleti kiszolgálót. true
spring.boot.admin.context-path Az elérési út előtagja, ahol a rendszergazdai kiszolgáló statikus objektumai és API-ja kiszolgálva van. A Dispatcher-Servlethez viszonyítva.
spring.boot.admin.monitor.status-interval A példányok állapotának ellenőrzéséhez ezredmásodpercben megadott időintervallum. 10,000ms
spring.boot.admin.monitor.status-lifetime Az állapot élettartama ezredmásodpercben. Az állapot nem frissül, amíg az utolsó állapot nem járt le. 10 000 ms
spring.boot.admin.monitor.info-interval Időintervallum ezredmásodpercben a példányok adatainak ellenőrzéséhez. 1m
spring.boot.admin.monitor.info-lifetime Az információk élettartama percek alatt. Az adatok nem olyan hosszúak, amíg az utolsó információ nem járt le. 1m
spring.boot.admin.monitor.default-timeout Alapértelmezett időtúllépés kérések esetén. Az egyes végpontok egyedi értékei felülírhatók a használatával spring.boot.admin.monitor.timeout.*. 10,000
spring.boot.admin.monitor.timeout.* Kulcs-érték párok az időkorlát per endpointId. Alapértelmezett érték.default-timeout
spring.boot.admin.monitor.default-retries A sikertelen kérések újrapróbálkozásának alapértelmezett száma. Az adatokat módosító kérések (PUT, POST, , PATCHDELETE) soha nem lesznek újrapróbálkozottak. Az egyes végpontok egyedi értékei felülírhatók a használatával spring.boot.admin.monitor.retries.*. 0
spring.boot.admin.monitor.retries.* Kulcs-érték párok az újrapróbálkozások endpointIdszámával . Az adatokat módosító kérések (PUT, POST, , PATCHDELETE) soha nem lesznek újrapróbálkozottak. Alapértelmezett érték.default-retries
spring.boot.admin.metadata-keys-to-sanitize Az összes JSON-kimenetben a megtisztításhoz használt regex mintáknak megfelelő kulcsok metaadat-értékei. A Spring Boot 3-tól kezdve az összes működtető érték alapértelmezés szerint maszkolt. Az egyhangúsági folyamat konfigurálásáról további információt a (Bizalmas értékek megtisztítása) című témakörben talál. ".**password$", ".\*secret$", ".\*key$", ".\*token$", ".\*credentials.**", ".*vcap_services$"
spring.boot.admin.probed-endpoints A Spring Boot 1.x-ügyfélalkalmazások esetében a Spring Boot rendszergazdai mintavételt küld a megadott végpontokra egy OPTIONS kéréssel. Ha az elérési út eltér az azonosítótól, ezt az értéket a következőképpen id:path adhatja meg (például: health:ping) "health", "env", "metrics", "httptrace:trace", "threaddump:dump", "jolokia", "info", "logfile", "refresh", "flyway", "liquibase", "heapdump", "loggers", "auditevents"
spring.boot.admin.instance-proxy.ignored-headers Az ügyfeleknek küldött kérések során nem továbbítandó fejlécek. "Cookie", "Set-Cookie", "Authorization"
spring.boot.admin.ui.title A megjelenített oldal címe. "Spring Boot Admin"
spring.boot.admin.ui.poll-timer.cache Lekérdezési időtartam ezredmásodpercben az új gyorsítótáradatok lekéréséhez. 2500
spring.boot.admin.ui.poll-timer.datasource Lekérdezés időtartama ezredmásodpercben az új adatforrásadatok lekéréséhez. 2500
spring.boot.admin.ui.poll-timer.gc Lekérdezési időtartam ezredmásodpercben az új gc-adatok lekéréséhez. 2500
spring.boot.admin.ui.poll-timer.process Lekérdezési időtartam ezredmásodpercben az új folyamatadatok lekéréséhez. 2500
spring.boot.admin.ui.poll-timer.memory A lekérdezés időtartama ezredmásodpercben új memóriaadatok beolvasásához. 2500
spring.boot.admin.ui.poll-timer.threads Lekérdezési időtartam ezredmásodpercben az új szálak adatainak lekéréséhez. 2500
spring.boot.admin.ui.poll-timer.logfile Lekérdezési időtartam ezredmásodpercben az új naplófájladatok lekéréséhez. 1000
spring.boot.admin.ui.enable-toasts Engedélyezi vagy letiltja a bejelentési értesítéseket. false
spring.boot.admin.ui.title A böngésző ablakcímének értéke. ""
spring.boot.admin.ui.brand A navigációs fejlécben renderelt HTML-kód, és alapértelmezés szerint a Spring Boot felügyeleti címkéje lesz. Alapértelmezés szerint a Spring Boot Felügyeleti emblémát a neve követi. ""
management.scheme Az aktuátorvégpontok eléréséhez használt szolgáltatás URL-címében lecserélt érték.
management.address Az aktuátorvégpontok eléréséhez használt szolgáltatás URL-címében lecserélt érték.
management.port Az aktuátorvégpontok eléréséhez használt szolgáltatás URL-címében lecserélt érték.
management.context-path Az aktuátorvégpontok eléréséhez használt szolgáltatás URL-címéhez hozzáfűzött érték. ${spring.boot.admin.discovery.converter.management-context-path}
health.path Az állapot-ellenőrzéshez használt szolgáltatás URL-címéhez hozzáfűzött érték. Figyelmen kívül hagyja a EurekaServiceInstanceConverter. ${spring.boot.admin.discovery.converter.health-endpoint}
spring.boot.admin.discovery.enabled Engedélyezi a DiscoveryClient rendszergazdai kiszolgáló támogatását. true
spring.boot.admin.discovery.converter.management-context-path A felderített szolgáltatáshoz service-url fűzött érték, amikor az értéket a management-url rendszer átalakítja.DefaultServiceInstanceConverter /actuator
spring.boot.admin.discovery.converter.health-endpoint-path A felderített szolgáltatáshoz management-url fűzött érték, amikor az értéket a health-url rendszer átalakítja.DefaultServiceInstanceConverter "health"
spring.boot.admin.discovery.ignored-services A felderítés használatakor figyelmen kívül hagyott és alkalmazásként nem regisztrált szolgáltatások. Támogatja az olyan egyszerű mintákat, mint a "foo*", "*bar". "foo*bar*"
spring.boot.admin.discovery.services A felderítés és az alkalmazásként regisztrált szolgáltatások. Támogatja az olyan egyszerű mintákat, mint a "foo*", "*bar". "foo*bar*" "*"
spring.boot.admin.discovery.ignored-instances-metadata A szolgáltatások figyelmen kívül hagyva, ha legalább egy olyan metaadatelemet tartalmaznak, amely megfelel a lista mintáinak. Támogatja az olyan mintákat, mint a "discoverable=false".
spring.boot.admin.discovery.instances-metadata Szolgáltatások, ha legalább egy olyan metaadatelemet tartalmaznak, amely megfelel a lista mintáinak. Támogatja az olyan mintákat, mint a "discoverable=true".

Gyakori konfigurációk

  • Naplózással kapcsolatos konfigurációk:
    • logging.level.*
    • logging.group.*
    • A névtérben lévő logging.* egyéb konfigurációknak tilosnak kell lenniük. Például a naplófájlok használatát logging.file tiltani kell.

Következő lépések

Oktatóanyag: Csatlakozás felügyelt rendszergazdához a Springhez

Kapcsolódó tartalom