Azure Spring Apps yönetilen bileşen günlüklerini gerçek zamanlı olarak akışla aktarma

2025-04-09

Notlar

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış planı 30 Eylül 2024'te emeklilik dönemine girdi ve Mart 2025 sonuna kadar tamamen kapatılacak. Daha fazla bilgi için bkz. Azure Spring Apps Standard tüketimi ve ayrılmış planı Azure Container Apps'e geçirme.

Bu makale şunlar için geçerlidir: ❎ Temel/Standart ✅ Kurumsal

Bu makalede, sorun giderme için yönetilen bileşenlerin gerçek zamanlı günlüklerini almak için Azure CLI'nin nasıl kullanılacağı açıklanmaktadır. Azure Spring Apps'te tanılama verilerini analiz etmek için tanılama ayarlarını da kullanabilirsiniz. Daha fazla bilgi için Tanılama ayarlarıyla günlükleri ve ölçümleri analiz etme bölümüne bakın. Akış günlüğü hakkında daha fazla bilgi için bkz. Azure Spring Apps uygulama konsolu günlüklerini gerçek zamanlı yayınlama ve Azure Spring Apps iş günlüklerini gerçek zamanlı yayınlama.

Önkoşullar

Azure CLI, Azure Spring Apps uzantısı sürüm 1.24.0 veya üzeri ile birlikte. Uzantıyı yüklemek için aşağıdaki komutu kullanabilirsiniz: az extension add --name spring.

Desteklenen yönetilen bileşenler

Aşağıdaki tabloda, şu anda desteklenen yönetilen bileşenler ve bunların alt bileşenleri listelenmektedir:

Yönetilen bileşen	Alt bileşenler
Uygulama Yapılandırma Hizmeti	`application-configuration-service` `flux-source-controller` (ACS 2. Nesil sürümünde desteklenir)
Spring Cloud Gateway	`spring-cloud-gateway` `spring-cloud-gateway-operator`
Spring Cloud Config Server	`config-server`

Tüm alt bileşenleri listelemek için aşağıdaki komutu kullanabilirsiniz:

az spring component list
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name>

Azure rolü atama

Yönetilen bileşenlerin günlük akışını sağlamak için size ilgili Azure rollerinin atanmış olması gerekir. Aşağıdaki tabloda gerekli roller ve bu rollere izin verilen işlemler listelenmiştir:

Yönetilen bileşen	Gerekli rol	Operasyonlar
Uygulama Yapılandırma Hizmeti	Azure Spring Apps Uygulama Yapılandırma Hizmeti Günlük Okuyucu Rolü	`Microsoft.AppPlatform/Spring/ApplicationConfigurationService/logstream/action`
Spring Cloud Gateway	Azure Spring Apps Spring Cloud Gateway Günlük Okuyucusu Rolü	`Microsoft.AppPlatform/Spring/SpringCloudGateway/logstream/action`
Spring Cloud Config Server	Azure Spring Apps Spring Cloud Config Server Günlük Okuyucusu Rolü	`Microsoft.AppPlatform/Spring/configService/logstream/action`

Azure portalı
Azure CLI

Azure portalını kullanarak bir Azure rolü atamak için aşağıdaki adımları kullanın:

Azure portalını açın.
Azure Spring Apps hizmet örneğinizi açın.
Gezinti bölmesinde Erişim Denetimi (IAM) öğesini seçin.
Erişim Denetimi (IAM) sayfasında Ekle'yi ve ardından Rol ataması ekle'yi seçin.
Rol Atama Ekle sayfasında Ad listesinde hedef rolü arayıp seçin ve sonra İleri'yi seçin.
Üyeler'i seçin ve ardından kullanıcı adınızı arayın ve seçin.
Gözden geçir + ata'yı seçin.

Azure rolü atamak için aşağıdaki komutu kullanın:

az role assignment create \
    --role "<Log-reader-role-for-managed-component>" \
    --scope "<service-instance-resource-id>" \
    --assignee "<your-identity>"

Bir bileşendeki tüm örnekleri listeleme

Bir bileşendeki tüm örnekleri listelemek için aşağıdaki komutu kullanın:

az spring component instance list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --component <component-name>

Örneğin, ACS 2. Nesil sürümündeki tüm örneklerini listelemek için flux-source-controller aşağıdaki komutu kullanın:

az spring component instance list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --component flux-source-controller

Kuyruk günlüklerini görüntüleme

Bu bölümde kuyruk günlükleri oluşturmak için Azure CLI'yi kullanma örnekleri verilmiştir.

Belirli bir örneğin kuyruk günlüklerini görüntüleme

Belirli bir örneğin kuyruk günlüklerini görüntülemek için, sonraki bölümde gösterildiği gibi az spring component logs komutunu -i/--instance bağımsız değişkeniyle birlikte kullanın.

Application-configuration-service örneği için kuyruk günlüklerini görüntüleme

application-configuration-service için kuyruk günlüklerini görüntülemek üzere aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name application-configuration-service \
    --instance <instance-name>

ACS 2. Nesil için komut, aşağıdaki örneğe benzer günlükleri döndürür:

...
2023-12-18T07:09:54.020Z  INFO  16715 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8090 (https)
2023-12-18T07:09:54.116Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Starting service [Tomcat]
2023-12-18T07:09:54.117Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Starting Servlet engine: [Apache Tomcat/10.1.12]
2023-12-18T07:09:54.522Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Initializing Spring embedded WebApplicationContext
2023-12-18T07:09:54.524Z  INFO  16715 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 14100 ms
2023-12-18T07:09:56.920Z  INFO  16715 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8090 (https) with context path ''
2023-12-18T07:09:57.528Z  INFO  16715 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8081 (http)
2023-12-18T07:09:57.529Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Starting service [Tomcat]
2023-12-18T07:09:57.529Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Starting Servlet engine: [Apache Tomcat/10.1.12]
2023-12-18T07:09:57.629Z  INFO  16715 --- [main] org.apache.juli.logging.DirectJDKLog     : Initializing Spring embedded WebApplicationContext
2023-12-18T07:09:57.629Z  INFO  16715 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 603 ms
2023-12-18T07:09:57.824Z  INFO  16715 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8081 (http) with context path ''
2023-12-18T07:09:58.127Z  INFO  16715 --- [main] o.springframework.boot.StartupInfoLogger : Started ReconcilerApplication in 21.005 seconds (process running for 22.875)
...

flux-source-controller örneği için kuyruk günlüklerini görüntüleme

flux-source-controller için kuyruk günlüklerini görüntülemek üzere aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name flux-source-controller \
    --instance <instance-name>

Komutu aşağıdaki örneğe benzer günlükleri döndürür:

...
{"level":"info","ts":"2023-12-18T07:07:54.615Z","logger":"controller-runtime.metrics","msg":"Metrics server is starting to listen","addr":":8080"}
{"level":"info","ts":"2023-12-18T07:07:54.615Z","logger":"setup","msg":"starting manager"}
{"level":"info","ts":"2023-12-18T07:07:54.615Z","msg":"Starting server","path":"/metrics","kind":"metrics","addr":"[::]:8080"}
{"level":"info","ts":"2023-12-18T07:07:54.615Z","msg":"Starting server","kind":"health probe","addr":"[::]:9440"}
{"level":"info","ts":"2023-12-18T07:07:54.817Z","logger":"runtime","msg":"attempting to acquire leader lease flux-system/source-controller-leader-election...\n"}
{"level":"info","ts":"2023-12-18T07:07:54.830Z","logger":"runtime","msg":"successfully acquired lease flux-system/source-controller-leader-election\n"}
...

Spring-cloud-gateway örneği için kuyruk günlüklerini görüntüleme

Kuyruk günlüklerini görüntülemek için spring-cloud-gateway için aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway \
    --instance <instance-name>

Komutu aşağıdaki örneğe benzer günlükleri döndürür:

...
2023-12-11T14:13:40.310Z  INFO 1 --- [           main] i.p.s.c.g.s.SsoDeactivatedConfiguration  : SSO is deactivated, setting up default security filters
2023-12-11T14:13:40.506Z  INFO 1 --- [           main] .h.HazelcastReactiveSessionConfiguration : Configuring Hazelcast as a session management storage
2023-12-11T14:13:51.008Z  INFO 1 --- [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 8443
2023-12-11T14:13:51.810Z  INFO 1 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 7 endpoint(s) beneath base path '/actuator'
2023-12-11T14:13:52.410Z  INFO 1 --- [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 8090
2023-12-11T14:13:52.907Z  INFO 1 --- [           main] i.p.s.c.g.r.h.HazelcastRateLimitsRemover : Removing Hazelcast map 'GLOBAL_RATE_LIMIT' with rate limit information
2023-12-11T14:13:52.912Z  INFO 1 --- [           main] i.p.s.cloud.gateway.GatewayApplication   : Started GatewayApplication in 36.084 seconds (process running for 38.651)
...

Spring-cloud-gateway-operator örneğinin son günlüklerini görüntüleme

spring-cloud-gateway-operator için kuyruk günlüklerini görüntülemek üzere aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway-operator \
    --instance <instance-name>

Komutu aşağıdaki örneğe benzer günlükleri döndürür:

...
2023-12-01T08:37:05.080Z  INFO 1 --- [           main] c.v.t.s.OperatorApplication              : Starting OperatorApplication v2.0.6 using Java 17.0.7 with PID 1 (/workspace/BOOT-INF/classes started by cnb in /workspace)
2023-12-01T08:37:05.157Z  INFO 1 --- [           main] c.v.t.s.OperatorApplication              : No active profile set, falling back to 1 default profile: "default"
2023-12-01T08:37:14.379Z  INFO 1 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 1 endpoint(s) beneath base path '/actuator'
2023-12-01T08:37:15.274Z  INFO 1 --- [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 8080
2023-12-01T08:37:15.366Z  INFO 1 --- [           main] c.v.t.s.OperatorApplication              : Started OperatorApplication in 11.489 seconds (process running for 12.467)
...

config-server örneği için kuyruk günlüklerini görüntüleme

Aşağıdaki komutu config-server için kuyruk günlüklerini görüntülemek amacıyla kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name config-server \
    --instance <instance-name>

Komutu aşağıdaki örneğe benzer günlükleri döndürür:

...
{"app":"config-server","ts":"2024-05-08T05:38:29.44Z","logger":"org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext","level":"INFO","class":"org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext","method":"prepareWebApplicationContext","file":"ServletWebServerApplicationContext.java","line":291,"thread":"main","message":"Root WebApplicationContext: initialization completed in 3771 ms"}
{"app":"config-server","ts":"2024-05-08T05:38:31.058Z","logger":"com.microsoft.azure.spring.service.CloudConfigServerApplication","level":"INFO","class":"org.springframework.boot.StartupInfoLogger","method":"logStarted","file":"StartupInfoLogger.java","line":57,"thread":"main","message":"Started CloudConfigServerApplication in 6.888 seconds (process running for 8.986)"}
...

Tüm örneklerin kuyruk günlüklerini tek bir komutla görüntüleme

Tüm örneklerin kuyruk günlüklerini görüntülemek için, aşağıdaki komutta gösterildiği gibi `--all-instances` parametresini kullanın. Örnek adı, her günlük satırının ön ekidir. Birden çok örnek olduğunda günlükler her örnek için toplu olarak yazdırılır, bu nedenle bir örneğin günlükleri başka bir örneğin günlükleriyle kesişemez.

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <component-name> \
    --all-instances

Yeni günlükleri sürekli akışla aktarma

Varsayılan olarak, az spring component logs yalnızca konsola akışı yapılan mevcut günlükleri yazdırır ve ardından sonlandırır. Yeni günlükleri akışa almak istiyorsanız -f/--follow bağımsız değişkenini ekleyin.

Anlık günlükleri takip etme seçeneği -f/--follow kullanıldığında, bileşen sürekli olarak günlük yazmadığı sürece, Azure Spring Apps günlük akışı hizmeti dakikada bir istemciye sinyal günlükleri gönderir. Sinyal günlüğü iletileri şu biçimi kullanır: 2023-12-18 09:12:17.745: No log from server.

Belirli bir örnek için akış günlükleri

Belirli bir örneğin günlüklerinin akışını yapmak için aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <component-name> \
    --instance <instance-name> \
    --follow

Tüm örnekler için akış günlükleri

Tüm örneklerin günlüklerini yayınlamak için aşağıdaki komutu kullanın:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <component-name> \
    --all-instances \
    --follow

Bir bileşendeki birden çok örneğin günlüklerini akışla aktardığınızda, bir örneğin günlükleri başkalarının günlükleriyle kesişer.

Sanal ağ enjeksiyonu örneğindeki akış günlükleri

Özelleştirilmiş bir sanal ağda dağıtılan bir Azure Spring Apps örneği için günlük akışına varsayılan olarak özel sanal ağdan erişebilirsiniz. Daha fazla bilgi için bkz . Azure Spring Apps'i sanal ağda dağıtma

Azure Spring Apps, genel bir ağdan gerçek zamanlı yönetilen bileşen günlüklerine erişmenizi de sağlar.

Not

Genel ağda günlük akışı uç noktasının etkinleştirilmesi, sanal ağınıza gelen genel bir IP adresi ekler. Bu sizin için bir sorunsa dikkatli olun.

Azure portalı
Azure CLI

Açık ağ üzerinde bir günlük akışı uç noktasını etkinleştirmek için aşağıdaki adımları kullanın:

Sanal ağınızda dağıtılan Azure Spring Apps hizmet örneğini seçin ve ardından gezinti menüsünden Ağ'ı seçin.
Vnet enjeksiyonu sekmesini seçin.
Genel ağda bir günlük akışı uç noktası etkinleştirmek için Genel ağdaki Veri Düzlemi kaynaklarının durumunu Etkinleştir olarak değiştirin. Bu işlem birkaç dakika sürer.

Kayıt akışı genel uç noktasını etkinleştirmek için aşağıdaki komutu kullanın.

az spring update \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --enable-dataplane-public-endpoint true

Günlük akışı genel uç noktasını etkinleştirdikten sonra, yönetilen bileşen günlüklerine normal bir örneğe erişdiğiniz gibi genel bir ağdan erişebilirsiniz.

Günlük akışı genel uç noktasına trafiğin güvenliğini sağlama

Yönetilen bileşenler için günlük akışı, bileşenlere yönelik bağlantıların kimliğini doğrulamak için Azure RBAC kullanır. Sonuç olarak, günlüklere yalnızca uygun rollere sahip kullanıcılar erişebilir.

Bir genel uç nokta kullanıma sunduğunuzda yönetilen bileşenlerinizin güvenliğini sağlamak için, bir ağ güvenlik grubuyla hizmetinize yönelik ağ trafiğini filtreleyerek uç noktanın güvenliğini sağlayın. Daha fazla bilgi için bkz . Öğretici: Azure portalını kullanarak ağ güvenlik grubuyla ağ trafiğini filtreleme. Ağ güvenlik grupları, farklı Azure kaynaklarına gelen ya da bu kaynaklardan dışarı giden ağ trafiğine izin veren veya bu trafiği reddeden güvenlik kuralları içerir. Her kural için kaynak, hedef, bağlantı noktası ve protokol belirtebilirsiniz.

Not

Bir günlük akışı genel uç noktasını etkinleştirdikten sonra sanal ağ enjeksiyon örneğindeki yönetilen bileşen günlüklerine internetten erişemiyorsanız, bu tür giriş trafiğine izin verip vermediğinizi görmek için ağ güvenlik grubunuzu kontrol edin.

Aşağıdaki tabloda, önerdiğimiz temel bir kural örneği gösterilmektedir. Bir hizmetin hedef IP adresini almak için uç nokta nslookup ile gibi <service-name>.private.azuremicroservices.io komutları kullanabilirsiniz.

Öncelik	Name	Liman	Protokol	Kaynak	Hedef	Eylem
100	Kural adı	80	TCP	İnternet	Hizmet IP adresi	İzin Ver
110	Kural adı	443	TCP	İnternet	Hizmet IP adresi	İzin Ver

Aracılığıyla paylaş

Azure Spring Apps yönetilen bileşen günlüklerini gerçek zamanlı olarak akışla aktarma

Önkoşullar

Desteklenen yönetilen bileşenler

Azure rolü atama

Bir bileşendeki tüm örnekleri listeleme

Kuyruk günlüklerini görüntüleme

Belirli bir örneğin kuyruk günlüklerini görüntüleme

Application-configuration-service örneği için kuyruk günlüklerini görüntüleme

flux-source-controller örneği için kuyruk günlüklerini görüntüleme

Spring-cloud-gateway örneği için kuyruk günlüklerini görüntüleme

Spring-cloud-gateway-operator örneğinin son günlüklerini görüntüleme

config-server örneği için kuyruk günlüklerini görüntüleme

Tüm örneklerin kuyruk günlüklerini tek bir komutla görüntüleme

Yeni günlükleri sürekli akışla aktarma

Belirli bir örnek için akış günlükleri

Tüm örnekler için akış günlükleri

Sanal ağ enjeksiyonu örneğindeki akış günlükleri

Günlük akışı genel uç noktasına trafiğin güvenliğini sağlama

Sonraki adımlar

Geri Bildirim

Ek kaynaklar