Azure Spring Apps yönetilen bileşen günlüklerini gerçek zamanlı olarak akışla aktarma
Not
Azure Spring Apps, Azure Spring Cloud hizmetinin yeni adıdır. Hizmetin yeni bir adı olsa da, ekran görüntüleri, videolar ve diyagramlar gibi varlıkları güncelleştirmek için çalışırken bazı yerlerde eski adı bir süre görürsünüz.
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 bkz . Tanılama ayarlarıyla günlükleri ve ölçümleri analiz etme. Akış günlükleri hakkında daha fazla bilgi için bkz . Azure Spring Apps uygulama konsolu günlüklerini gerçek zamanlı olarak akışla aktarma ve Azure Spring Apps iş günlüklerini gerçek zamanlı olarak akışla aktarma.
Önkoşullar
- Azure Spring Apps uzantısı, sürüm 1.24.0 veya üzeri ile Azure CLI . 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üklerinin akışını yapmak için size uygun 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 | Operations |
|---|---|---|
| Uygulama Yapılandırma Hizmeti | Azure Spring Apps Uygulama Yapılandırma Hizmeti Günlük OkuyucuSu 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 Sunucusu Günlük OkuyucuSu Rolü | Microsoft.AppPlatform/Spring/configService/logstream/action |
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 ataması ekle sayfasındaki Ad listesinde hedef rolü arayıp seçin ve ardından İ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.
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 komutunu bağımsız değişkenle -i/--instance birlikte kullanınaz spring component logs.
Application-configuration-service örneği için kuyruk günlüklerini görüntüleme
için kuyruk günlüklerini görüntülemek için application-configuration-serviceaş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
için kuyruk günlüklerini görüntülemek için flux-source-controlleraş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
için kuyruk günlüklerini görüntülemek için spring-cloud-gatewayaş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ği için kuyruk günlüklerini görüntüleme
için kuyruk günlüklerini görüntülemek için spring-cloud-gateway-operatoraş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
için kuyruk günlüklerini görüntülemek için config-serveraşağıdaki komutu 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 bağımsız değişkenini kullanın --all-instances . Ö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 çıkar. Yeni günlüklerin akışını yapmak istiyorsanız bağımsız değişkenini -f/--follow ekleyin.
Anlık günlükleri takip etme seçeneğini kullandığınızda -f/--follow , bileşen günlükleri sürekli 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ü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> \
--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ğ ekleme örneğindeki akış günlükleri
Özel bir sanal ağda dağıtılan bir Azure Spring Apps örneği için günlük akışına varsayılan olarak özel bir 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 genel bir gelen IP ekler. Bu sizin için bir sorunsa dikkatli olun.
Genel ağda 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.
Sanal ağ ekleme sekmesini seçin.
Genel ağda günlük akışı uç noktasını 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.
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ğ ekleme örneğindeki yönetilen bileşen günlüklerine İnternet'ten erişemiyorsanız, bu tür gelen trafiğe izin verip vermediğinizi görmek için ağ güvenlik grubunuzu denetleyin.
Aşağıdaki tabloda, önerdiğimiz temel bir kural örneği gösterilmektedir. Bir hizmetin hedef IP adresini almak için uç nokta <service-name>.private.azuremicroservices.io ile gibi nslookup komutları kullanabilirsiniz.
| Öncelik | Name | Bağlantı noktası | 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 |
Sonraki adımlar
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin