Azure Spring Apps uygulama konsolu günlüklerini gerçek zamanlı olarak akışla aktarma

Note

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

Bu makale şunlar için geçerlidir:✅ Java ✅ C#

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

Bu makalede, sorun giderme için gerçek zamanlı uygulama konsolu günlüklerini almak için Azure CLI'da günlük akışının nasıl etkinleştirileceği açıklanı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. Daha fazla akış günlüğü bilgisi için Azure Spring Apps iş günlüklerini gerçek zamanlı akışla ve Azure Spring Apps yönetilen bileşen günlüklerini gerçek zamanlı akışla bağlantılarına bakın.

Prerequisites

• Azure CLI, Azure Spring Apps uzantısı sürüm 1.0.0 veya üzeri ile. Uzantıyı yüklemek için aşağıdaki komutu kullanabilirsiniz: az extension add --name spring
• Çalışan bir uygulama ile Azure Spring Apps örneği. Daha fazla bilgi için bkz . Hızlı Başlangıç: İlk uygulamanızı Azure Spring Apps'e dağıtma.

Akış günlükleri

Azure portalı

Azure portalında günlükleri izlemek için aşağıdaki adımları kullanın:

1. Azure Spring Apps hizmet örneğinizin Genel Bakış sayfasına gidin ve gezinti bölmesinde Uygulamalar'ı seçin.

2. Hedef uygulamanızı bulun ve bağlam menüsünü seçin.

3. Açılır bağlam menüsünde Günlük akışını görüntüle'yi seçin.

   

Varsayılan olarak, günlükler rastgele seçilen bir uygulama örneği için akışa başlar. Daha sonra kendi seçiminizi yapabilirsiniz.

Kolaylık sağlamak için günlükleri akışa almak için birçok giriş noktası vardır. Bunları aşağıdaki bölmelerde bulabilirsiniz:

• Uygulama listesi bölmesi
• Dağıtım listesi bölmesi
• Uygulama örneği liste bölmesi

Azure CLI

Bu bölümde kuyruk günlükleri oluşturmak için Azure CLI'yi kullanma örnekleri verilmiştir. Kaynak grubunuzun ve hizmet örneği adınızın tekrar tekrar belirtilmesinden kaçınmak için aşağıdaki komutları kullanarak varsayılan kaynak grubu adınızı ve küme adınızı ayarlayın:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Kaynak grubu ve hizmet adı aşağıdaki örneklerde atlanmıştır.

Tek bir örneği olan bir uygulamanın kuyruk günlüğünü görüntüleme

Adlı auth-service bir uygulamanın yalnızca bir örneği varsa, aşağıdaki komutla uygulama örneğinin günlüğünü görüntüleyebilirsiniz:

az spring app logs --name <application-name>

komutu aşağıdaki örneklere benzer günlükleri döndürür ve burada auth-service uygulama adıdır.

...
2020-01-15 01:54:40.481  INFO [auth-service,,,] 1 --- [main] o.apache.catalina.core.StandardService  : Starting service [Tomcat]
2020-01-15 01:54:40.482  INFO [auth-service,,,] 1 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.22]
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/uaa]  : Initializing Spring embedded WebApplicationContext
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.s.web.context.ContextLoader  : Root WebApplicationContext: initialization completed in 7203 ms

...

Birden çok örneği olan bir uygulamanın kuyruk günlüklerini görüntüle

adlı auth-serviceuygulama için birden çok örnek varsa, seçeneğini kullanarak -i/--instance örnek günlüğünü görüntüleyebilirsiniz.

İlk olarak, uygulama örneği adlarını almak için aşağıdaki komutu çalıştırın:

az spring app show --name auth-service --query properties.activeDeployment.properties.instances --output table

komutu aşağıdaki çıkışa benzer sonuçlar üretir:

Name                                         Status    DiscoveryStatus
-------------------------------------------  --------  -----------------
auth-service-default-12-75cc4577fc-pw7hb  Running   UP
auth-service-default-12-75cc4577fc-8nt4m  Running   UP
auth-service-default-12-75cc4577fc-n25mh  Running   UP

Ardından, aşağıdaki seçeneği kullanarak bir uygulama örneğinin günlüklerini akışla -i/--instance aktarabilirsiniz:

az spring app logs --name auth-service --instance auth-service-default-12-75cc4577fc-pw7hb

Azure portalından uygulama örneklerinin ayrıntılarını da alabilirsiniz. Azure Spring Apps hizmetinizin sol gezinti bölmesinde Uygulamalar'ı seçtikten sonra Uygulama Örnekleri'ni seçin.

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

Varsayılan olarak, az spring app logs yalnızca uygulama konsoluna akışı yapılan mevcut günlükleri yazdırır ve sonrasında çıkar. Yeni günlüklerin akışını yapmak istiyorsanız, aşağıdaki örnekte gösterildiği gibi -f/--follow bağımsız değişkenini ekleyin.

az spring app logs --name auth-service --follow

Anlık günlükleri takip etmek için --follow bağımsız değişkenini kullandığınızda, uygulamanız sürekli günlük yazmadığı sürece Azure Spring Apps günlük akışı hizmeti, her dakika istemciye sinyal günlükleri gönderir. Kalp atışı günlüğü iletileri şu biçimi kullanır: 2020-01-15 04:27:13.473: No log from server.

Desteklenen tüm günlük seçeneklerini denetlemek için aşağıdaki komutu kullanın:

az spring app logs --help

JSON yapılandırılmış günlüklerini biçimlendirme

Note

JSON yapılandırılmış günlüklerinin biçimlendirılması için spring extension sürüm 2.4.0 veya üzeri gerekir.

Yapılandırılmış uygulama günlükleri, okunması zor olabilecek JSON biçiminde görüntülenir. --format-json bağımsız değişkenini, günlükleri JSON biçiminden daha okunabilir bir biçime dönüştürmek için kullanabilirsiniz. Daha fazla bilgi için bkz. Azure Spring Apps için yapılandırılmış uygulama günlüğü.

Aşağıdaki örnekte --format-json olarak bağımsız değişkenin nasıl kullanılacağı gösterilmektedir:

# Raw JSON log
$ az spring app logs --name auth-service
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Disable delta property : false"}
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Single vip registry refresh property : null"}

# Formatted JSON log
$ az spring app logs --name auth-service --format-json
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Disable delta property : false
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Single vip registry refresh property : null

Bağımsız değişken, --format-json biçim dizesi sözdizimini kullanarak isteğe bağlı özelleştirilmiş bir biçimi de kabul eder. Daha fazla bilgi için bkz. Dize Sözdizimini Biçimlendirme.

Aşağıdaki örnek, biçim dizesi söz diziminin nasıl kullanılacağını gösteriyor.

# Custom format
$ az spring app logs --name auth-service --format-json="{message}{n}"
Disable delta property : false
Single vip registry refresh property : null

Kullanılan varsayılan biçim:

{timestamp} {level:>5} [{thread:>15.15}] {logger{39}:<40.40}: {message}{n}{stackTrace}

Azure Spring Apps uygulama günlüğünü sanal ağ enjeksiyon örneğinde yayınlama

Ö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, Azure portalını veya Azure CLI'yi kullanarak genel bir ağdan gerçek zamanlı uygulama günlüklerine erişmenizi de sağlar.

Note

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

Azure portalı

Açık ağda bir log akışı uç noktasını etkinleştirmek için aşağıdaki adımları kullanın:

1. 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.

2. Sanal ağ ekleme sekmesini seçin.

3. Genel ağda bir günlük akışı uç noktasını etkinleştirmek için Veri Düzlemi kaynaklarının genel ağ üzerindeki durumunu etkin olarak değiştirin. Bu işlem birkaç dakika sürer.

   

Azure CLI

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, uygulama günlüğüne normal bir örneğe erişdiğiniz gibi genel bir ağdan erişebilirsiniz.

Günlük akışının genel uç noktasına olan trafiğini güvenli hale getirme

Günlük akışı, dağıtımlarınıza yönelik bağlantıların kimliğini doğrulamak için Azure Spring Apps'te hazırlama ortamı ayarlama bölümünde açıklanan test uç noktasıyla aynı anahtarı kullanır. Sonuç olarak, yalnızca test anahtarlarına okuma erişimi olan kullanıcılar kayıt akışına erişebilir.

Bir genel uç nokta kullanıma sunduğunuzda uygulamalarınızın 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.

Note

Günlük akışının genel uç noktasını etkinleştirdikten sonra sanal ağ enjeksiyon örneğindeki uygulama günlüklerine İnternet'ten erişemiyorsanız, bu tür gelen trafiğe izin verip vermediğinizi kontrol etmek 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 nslookup ile gibi <service-name>.private.azuremicroservices.io komutları kullanabilirsiniz.

Priority	Name	Port	Protocol	Source	Destination	Action
100	Kural adı	80	TCP	Internet	Hizmet IP adresi	Allow
110	Kural adı	443	TCP	Internet	Hizmet IP adresi	Allow

Sonraki Adımlar

• Hızlı Başlangıç Kılavuzu: Azure Spring Apps uygulamalarını günlükler, metrikler ve izleme ile takip etme
• Tanılama ayarlarıyla günlükleri ve ölçümleri analiz etme
• Azure Spring Apps iş günlüklerini gerçek zamanlı olarak akışla aktarma
• Azure Spring Apps yönetilen bileşen günlüklerini gerçek zamanlı olarak akışla aktarma