Simple Log Service:Logtail ağ türleri, başlangıç parametreleri ve yapılandırma

Ağ türleri ve seçim

Logtail'i yüklerken, sunucunuzun Simple Log Service (SLS) konumuna göre bir ağ türü belirleyin. Doğru ağ türünü seçmek, günlük verilerinin daha hızlı ve güvenilir iletilmesini sağlar.

1. Simple Log Service konsolu üzerinde oturum açın. Projenin Project Overview sayfasında, Endpoint alanında Acceleration Endpoint öğesini bulun ve yanındaki Enable seçeneğine tıklayın.

2. İletişim kutusundaki uyarıyı okuyun ve Modify seçeneğine tıklayın.

3. Logtail için aktarım hızlandırmayı aşağıdaki yollardan biriyle yapılandırın.

   Hızlandırma ile yükleme

   Logtail'i yüklemeden önce aktarım hızlandırmayı etkinleştirirseniz kurulum sırasında aktarım hızlandırma seçeneğini belirleyebilirsiniz. Daha fazla bilgi için bkz. Logtail'i yükleme.

   Yapılandırmayı değiştirme

   Aktarım hızlandırmayı etkinleştirmeden önce Logtail'i yüklediyseniz Logtail yapılandırmasını değiştirmeniz gerekir.

   1. Logtail'i durdurun.

      • Linux

        sudo /etc/init.d/ilogtaild stop komutunu çalıştırın.

      • Windows

        1. Start > Control Panel > Tools > Service yolunu izleyin.

        2. Service iletişim kutusunda LogtailDaemon hizmetini (Logtail 1.0.0.0 ve sonraki sürümler için) veya LogtailWorker hizmetini (Logtail 0.x.x.x sürümleri için) bulun. Hizmeti sağ tıklayın ve Stop seçeneğini seçin.

   2. Logtail başlangıç yapılandırma dosyası olan ilogtail_config.json dosyasını değiştirin.

      data_server_list parametresindeki uç noktayı log-global.aliyuncs.com olarak değiştirin. Dosya yolu için bkz. Başlangıç parametresi yapılandırma dosyası (ilogtail_config.json).

   3. Logtail'i başlatın.

      • Linux

        sudo /etc/init.d/ilogtaild start komutunu çalıştırın.

      • Windows

        1. Start > Control Panel > Tools > Service yolunu izleyin.

        2. Service iletişim kutusunda LogtailDaemon hizmetini (Logtail 1.0.0.0 ve sonraki sürümler için) veya LogtailWorker hizmetini (Logtail 0.x.x.x sürümleri için) bulun. Hizmeti sağ tıklayın ve Start seçeneğini seçin.

Daha fazla bilgi için bkz. Aktarım hızlandırmayı yönetme.

Kullanım senaryoları

Önerilen parametre değerleri

Aşağıdaki tablolar, standart JSON günlük dosyalarının toplanması için önerilen parametre değerlerini listeler. Tam normal ifade modu ve sınırlayıcı modu, JSON moduna benzer performans gösterirken basit mod yaklaşık beş kat daha hızlıdır. Veri karmaşıklığı, ayrıştırma kuralları ve dizin ile dosya sayısı da CPU ve bellek tüketimini etkiler. Bu değerleri bir başlangıç noktası olarak kullanın ve iş yükünüze göre ayarlayın.

• Ana bilgisayar ortamı

  Parametre	Varsayılan toplama hızı	Toplama hızı > 10 MB/s	Toplama hızı > 20 MB/s	Toplama hızı > 40 MB/s
  cpu_usage_limit	0.4	1	2	4
  mem_usage_limit	384	1024	2048	4096
  max_bytes_per_sec	20971520	209715200	209715200	209715200
  process_thread_count	1	2	4	8
  send_request_concurrency	15	20	40	80

• Konteyner veya Kubernetes ortamı

  Parametre	Varsayılan toplama hızı	Toplama hızı > 10 MB/s	Toplama hızı > 20 MB/s	Toplama hızı > 40 MB/s
  cpu_usage_limit	2	3	5	9
  mem_usage_limit	2048	2048	2048	4096
  max_bytes_per_sec	209715200	209715200	209715200	209715200
  process_thread_count	1	2	4	8
  send_request_concurrency	15	20	40	80
  resources.limits.cpu	500M	1000M	2000M	4000M
  resources.limits.memory	2 Gi	2 Gi	3 Gi	5 Gi

  Bir konteyner veya Kubernetes ortamında Logtail başlatma parametrelerini değiştirmek için:

  • Logtail, bir Alibaba Cloud Kubernetes kümesine dağıtılmışsa ve sürümü Logtail-ds 1.7.3 veya üzeriyse parametreleri Container Service for Kubernetes konsolunda değiştirin. Add-ons sayfasında, logtail-ds eklentisinin ilgili parametrelerini değiştirin.

  • Logtail, kendi kendine yönetilen bir konteyner veya Kubernetes ortamına dağıtılmışsa ve sürümü Logtail-ds 1.7.3 veya üzeriyse DaemonSet'teki ortam değişkenlerini değiştirerek Logtail başlatma parametrelerini değiştirin. Bazı ortamlar bir ConfigMap'e başvurur. Başvurulan ConfigMap şudur: ConfigMap > kube-system > alibaba-log-configuration.

  • 1.7.3 öncesi Logtail-ds sürümleri için DaemonSet'teki ortam değişkenlerini değiştirerek Logtail başlatma parametrelerini değiştirin. Bazı ortamlarda bir ConfigMap'e başvurulur. Başvurulan ConfigMap şudur: ConfigMap > kube-system > alibaba-log-configuration. Ayrıca, kapsayıcının kaynak sınırlarını aşmasını önlemek için DaemonSet > kube-system > logtail-ds içindeki resources.limits.cpu ve resources.limits.memory parametrelerini ayarlayın.

Önceki tablolardaki Collection rate greater than 40 MB/s değerleriyle Logtail'in toplama performansı sınırına yaklaşır. İş parçacığı sayısını daha da artırmak önemli bir iyileştirme sağlamaz. Aşağıdaki tabloda toplama performansı sınırları listelenmiştir.

Başlatma parametreleri

1. Logtail'in yüklü olduğu sunucuda /usr/local/ilogtail/ilogtail_config.json dosyasını açın.

   Bu adım, ana bilgisayar ortamı için geçerlidir.

   Bir konteyner veya Kubernetes ortamında DaemonSet ortam değişkenlerini düzenleyerek Logtail başlatma parametrelerini değiştirmeniz gerekir. Bazı ortamlar bir ConfigMap'e başvurur ve yolu şöyledir: ConfigMap > kube-system > alibaba-log-configuration.

2. Başlatma parametrelerini ihtiyaca göre yapılandırın.

   Aşağıda başlatma parametrelerine bir örnek verilmiştir:

   {
       ...
       "cpu_usage_limit" : 0.4,
       "mem_usage_limit" : 384,
       "max_bytes_per_sec" : 20971520,
       "process_thread_count" : 1,
       "send_request_concurrency" : 15,
       "buffer_file_num" : 25,
       "buffer_file_size" : 20971520,
       "buffer_file_path" : "",
       ...
   }

   Not

   • Aşağıdaki tabloda yalnızca yaygın başlatma parametreleri listelenmiştir. Listelenmeyen parametreler için varsayılan ayarları koruyun.

   • İhtiyaca göre parametre ekleyebilir veya değiştirebilirsiniz.

   Tablo 1. Logtail başlatma parametreleri

   Parametre	Tür	Açıklama	Örnek
   cpu_usage_limit	double	Tek bir çekirdeğe göre hesaplanan CPU kullanım eşiği. Geçerli aralık: 0,1 ile mevcut sunucudaki CPU çekirdek sayısı arasında. Varsayılan değer: 0,4 Uyarı cpu_usage_limit parametresi yumuşak bir sınırdır. Logtail'in gerçek CPU kullanımı bu sınırı aşabilir. Kullanım 5 dakikadan uzun süre sınırı aşarsa devre kesme tetiklenir ve Logtail otomatik olarak yeniden başlar. Örneğin, bu parametreyi 0,4 olarak ayarlarsanız Logtail CPU kullanımını tek bir çekirdeğin %40'ı ile sınırlamaya çalışır. Kullanım bu sınırı aşarsa Logtail otomatik olarak yeniden başlar. Çoğu durumda tek bir çekirdek basit modda yaklaşık 100 MB/s, tam regex modunda ise 20 MB/s veri toplama hızını karşılayabilir. Not Container Service for Kubernetes (ACK) kümesinde Logtail-ds 1.7.3 veya sonraki bir sürümü dağıtıyorsanız CPU kullanım eşliğini Container Service for Kubernetes konsolunda ayarlamamanızı öneririz. Add-ons sayfasında logtail-ds bileşeninin LogtailDSLimitCPU parametresini değiştirin. Daha fazla bilgi için bkz. Bileşenleri yönetme.	"cpu_usage_limit" : 0.4
   mem_usage_limit	int	Bellek kullanım eşiği. Geçerli aralık: 128 MB - 8192 MB Varsayılan değer: 384 MB (ana bilgisayarda), 2048 MB (ACK bileşeni için) Uyarı mem_usage_limit parametresi yumuşak bir sınırdır. Logtail'in gerçek bellek kullanımı bu sınırı aşabilir. Kullanım 5 dakikadan uzun süre sınırı aşarsa devre kesme tetiklenir ve Logtail otomatik olarak yeniden başlar. Toplama hızı, izlenen dizin ve dosya sayısı ile gönderim engelleme derecesi mem_usage_limit parametresi ile ilişkilidir. Daha fazla bilgi için bkz. Logtail sınırları. Not ACK kümesinde Logtail-ds 1.7.3 veya sonraki bir sürümü dağıtıyorsanız bellek kullanım eşğini Container Service for Kubernetes konsolunda ayarlamamanızı öneririz. Add-ons sayfasında logtail-ds bileşeninin LogtailDSLimitMemory parametresini değiştirin. Daha fazla bilgi için bkz. Bileşenleri yönetme.	"mem_usage_limit" : 384
   max_bytes_per_sec	int	Logtail'in ham verileri gönderdiği maksimum hız. Birim: bayt/saniye. Geçerli aralık: 1.024 bayt/sn - 52.428.800 bayt/sn Varsayılan değer: 20.971.520 bayt/sn Önemli Bu parametreyi 20.971.520'den (20 MB/sn) büyük bir değere ayarlarsanız gönderim hızı bu parametre tarafından sınırlandırılmaz. Örneğin, bu parametreyi 2097152 olarak ayarlarsanız Logtail verileri 2 MB/sn hızında gönderir. Not ACK kümesinde Logtail-ds 1.7.3 veya sonraki bir sürümü dağıtıyorsanız trafik sınırını Container Service for Kubernetes konsolunda ayarlamamanızı öneririz. Add-ons sayfasında logtail-ds bileşeninin LogtailDSMaxBytePerSec parametresini değiştirin. Daha fazla bilgi için bkz. Bileşenleri yönetme.	"max_bytes_per_sec" : 2097152
   process_thread_count	int	Logtail'in verileri işlemek için kullandığı iş parçacığı sayısı. Geçerli aralık: 1 - 64 Varsayılan değer: 1 Çoğu durumda tek bir iş parçacığı basit modda 24 MB/sn, tam regex modunda ise 12 MB/sn veri yazma hızını karşılayabilir. Çoğu durumda bu parametrenin değerini değiştirmeniz gerekmez. Not ACK kümesinde Logtail-ds 1.7.3 veya sonraki bir sürümü dağıtıyorsanız iş parçacığı sayısını Container Service for Kubernetes konsolunda ayarlamamanızı öneririz. Add-ons sayfasında logtail-ds bileşeninin LogtailDSProcessThreadCount parametresini değiştirin. Daha fazla bilgi için bkz. Bileşenleri yönetme.	"process_thread_count" : 1
   send_request_concurrency	int	Verileri eşzamansız olarak göndermek için kullanılan eşzamanlı istek sayısı. Geçerli aralık: 15 - 80 Varsayılan değer: 15 Yazma TPS yüksekse bu değeri artırabilirsiniz. Genel bir kural olarak bir eşzamanlı istek 0,5 MB/sn - 1 MB/sn ağ aktarım hızını karşılayabilir. Gerçek aktarım hızı ağ gecikmesine bağlıdır. Not Bu değerin çok yüksek ayarlanması aşırı ağ bağlantı noktası kullanımına neden olabilir; bu da TCP ile ilgili parametreleri ayarlamanızı gerektirir. ACK kümesinde Logtail-ds 1.7.3 veya sonraki bir sürümü dağıtıyorsanız eşzamanlı istek sayısını Container Service for Kubernetes konsolunda ayarlamamanızı öneririz. Add-ons sayfasında logtail-ds bileşeninin LogtailDSSendRequestConcurrency parametresini değiştirin. Daha fazla bilgi için bkz. Bileşenleri yönetme.	"send_request_concurrency" : 4
   buffer_file_num	int	Maksimum arabellek dosyası sayısı. Geçerli aralık: 1 - 100 Varsayılan değer: 25 Bir ağ hatası oluşursa veya yazma sınırı aşılırsa Logtail günlükleri gerçek zamanlı olarak ayrıştırır ve ayrıştırılan günlükleri yükleme dizinindeki yerel arabellek dosyalarına yazar. Sorun çözüldükten sonra Logtail arabelleğe alınan günlükleri yeniden göndermeyi dener.	"buffer_file_num" : 25
   buffer_file_size	int	Tek bir arabellek dosyasının maksimum boyutu. Birim: bayt. Geçerli aralık: 1.048.576 bayt - 104.857.600 bayt Varsayılan değer: 20971520 Bayt Arabellek dosyalarının kaplayabileceği maksimum disk alanı buffer_file_size × buffer_file_num şeklindedir.	"buffer_file_size" : 20971520
   buffer_file_path	String	Arabellek dosyalarının depolandığı dizin. Varsayılan olarak bu parametre boştur; yani arabellek dosyaları Logtail yükleme dizini olan /usr/local/ilogtail içinde depolanır. Bu parametreyi ayarladıktan sonra logtail\_buffer\_file_* ile başlayan dosyaları orijinal dizinden yeni dizine manuel olarak taşımanız gerekir. Bu, Logtail'in arabellek dosyalarını okuyabilmesini ve gönderildikten sonra silebilmesini sağlar.	"buffer_file_path" : ""
   bind_interface	String	Sunucuya bağlanan ağ arayüzü denetleyicisinin (NIC) adı. Varsayılan olarak bu parametre boştur; yani Logtail kullanılabilir bir NIC'e otomatik olarak bağlanır. Bu parametreyi eth1 gibi belirli bir NIC'e ayarlarsanız Logtail günlükleri yüklemek için o NIC'i kullanmaya zorlanır. Bu parametre yalnızca Linux'ta desteklenir.	"bind_interface" : ""
   check_point_filename	String	Logtail kontrol noktası dosyalarının kaydedildiği yol. Varsayılan değer: /tmp/logtail_check_point.	"check_point_filename" : "/tmp/logtail_check_point"
   check_point_dump_interval	int	Logtail'in kontrol noktası dosyalarını güncellediği aralık (saniye cinsinden). Varsayılan: 900 (15 dakika). Bu parametre yalnızca Linux için Logtail 1.0.19 veya sonraki sürümler ve Windows için Logtail 1.0.19.0 veya sonraki sürümler tarafından desteklenir.	"check_point_dump_interval" : 900
   user_config_file_path	String	Logtail yapılandırma dosyasının kaydedildiği yol. Varsayılan olarak dosya işlem ikili dosyasını içeren dizine kaydedilir. Dosya adı user_log_config.json şeklindedir.	"user_config_file_path" : "user_log_config.json"
   docker_file_cache_path	String	Bu dosya, konteyner dosyaları ile ana bilgisayar dosyaları arasındaki yol eşlemelerini kaydeder. Varsayılan yol /usr/local/ilogtail/docker_path_config.json şeklindedir. Bu parametre yalnızca Linux için Logtail 0.16.54 veya sonraki sürümler ve Windows için Logtail 0.16.54.0 veya sonraki sürümler tarafından desteklenir.	"docker_file_cache_path": "/usr/local/ilogtail/docker_path_config.json"
   discard_old_data	Boolean	Geçmiş günlüklerin atılıp atılmayacağını belirtir. Varsayılan değer: true; yani 12 saatten eski günlükler atılır.	"discard_old_data" : true
   ilogtail_discard_interval	int	Geçmiş günlüklerin atılması için zaman eşiği. Günlüğün zaman damgası ile geçerli saat arasındaki fark bu eşiği aşarsa günlük atılır. Varsayılan değer: 43200 (12 saat). Birim: saniye.	"ilogtail_discard_interval": 43200
   working_ip	String	Varsayılan olarak bu parametre boştur; yani IP adresi sunucudan otomatik olarak alınır. Bu parametre için bir değer ayarlarsanız Logtail bu değeri sunucunun IP adresi olarak bildirir.	"working_ip" : ""
   working_hostname	String	Logtail'in sunucu için bildirdiği ana bilgisayar adı. Varsayılan olarak bu parametre boştur; yani ana bilgisayar adı sunucudan otomatik olarak alınır.	"working_hostname" : ""
   max_read_buffer_size	long	Logtail'in okuyabileceği tek bir günlük girdisinin maksimum boyutu. Varsayılan değer: 524.288 (512 KB). Maksimum değer: 8.388.608 (8 MB). Birim: bayt. Tek bir günlük girdisi 524.288 baytı aşıyorsa bu değeri artırmanız gerekir.	"max_read_buffer_size" : 524288
   oas_connect_timeout	long	Logtail'in yapılandırmasını veya bir AccessKey çiftini almak için başlattığı isteklerin bağlantı aşaması zaman aşımı. Varsayılan değer: 5. Birim: saniye. Zayıf ağ koşulları nedeniyle bağlantı kurmak uzun sürüyorsa bu değeri artırabilirsiniz.	"oas_connect_timeout" : 5
   oas_request_timeout	long	Yapılandırma veya AccessKey çifti alma işleminin toplam istek zaman aşımı. Varsayılan değer: 10. Birim: saniye. Zayıf ağ koşulları nedeniyle isteklerin tamamlanması uzun sürüyorsa bu değeri artırabilirsiniz.	"oas_request_timeout" : 10
   data_server_port	long	data_server_port öğesini 443 olarak ayarlarsanız Logtail verileri HTTPS üzerinden SLS'ye iletir. Bu parametre yalnızca Linux için Logtail 1.0.10 veya sonraki sürümler ve Windows için Logtail 1.0.10.0 veya sonraki sürümler tarafından desteklenir.	"data_server_port": 443
   enable_log_time_auto_adjust	Boolean	enable_log_time_auto_adjust öğesini true olarak ayarlarsanız günlük zaman damgaları sunucunun yerel saatine otomatik olarak uyum sağlar. Güvenlik nedenleriyle SLS, Logtail'den gelen istekler dahil olmak üzere her isteğin zaman damgasını doğrular. Zaman damgası SLS sunucu saati ile 15 dakikadan fazla farklılık gösteriyorsa SLS isteği reddeder. Logtail isteklerinde sunucunun yerel saatini kullanır. Sunucunun yerel saati değiştirilirse (örneğin test ortamında ileri bir saate ayarlanırsa) Logtail istekleri reddedilir ve veri yazma işlemleri başarısız olur. Günlük zaman damgalarını sunucunun yerel saatine uyarlamak için bu parametreyi kullanabilirsiniz. Bu parametre yalnızca Linux için Logtail 1.0.19 veya sonraki sürümler ve Windows için Logtail 1.0.19.0 veya sonraki sürümler tarafından desteklenir. Önemli Bu özellik etkinleştirildiğinde Logtail, SLS sunucu saati ile sunucunun yerel saati arasındaki farkı günlük zaman damgasına ekler. Fark yalnızca SLS bir isteği reddettiğinde güncellenir. Sonuç olarak SLS sorgularında gördüğünüz zaman damgası gerçek yazma zamanından farklı olabilir. Bazı Logtail mantıkları monoton artan sistem saatine bağlıdır. Sunucunun saatini her ayarladığınızda Logtail'i yeniden başlatmanızı öneririz.	"enable_log_time_auto_adjust": true
   accept_multi_config	Boolean	Aynı dosyadan günlük toplamak için birden fazla Logtail yapılandırmasına izin verilip verilmeyeceğini belirtir. Varsayılan değer: false. Varsayılan olarak bir dosya yalnızca bir Logtail yapılandırması tarafından toplanabilir. Bu kısıtlamayı kaldırmak için bu parametreyi kullanabilirsiniz. Her Logtail yapılandırmasının işlenmesi bağımsızdır. Aynı dosyadan günlük toplamak için birden fazla Logtail yapılandırmasına izin verirseniz CPU ve bellek tüketimi orantılı olarak artar. Bu parametre yalnızca Linux için Logtail 0.16.26 veya sonraki sürümler ve Windows için Logtail 0.16.26.0 veya sonraki sürümler tarafından desteklenir.	"accept_multi_config": true
   enable_checkpoint_sync_write	Boolean	Kontrol noktaları için senkron yazmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false. Bu özellik öncelikle ExactlyOnce yazma özelliği ile birlikte kullanılır. ExactlyOnce etkinleştirildiğinde Logtail ayrıntılı, dosya düzeyinde kontrol noktası bilgilerini yerel diske kaydeder. Performans nedenleriyle Logtail varsayılan olarak kontrol noktalarını yazarken verileri diske flush etmek için sync komutunu çağırmaz. Arabelleğe alınan veriler diske yazılmadan önce makine yeniden başlatılırsa kontrol noktası bilgileri kaybolabilir. Bu durumda senkron yazmayı etkinleştirmek için enable_checkpoint_sync_write öğesini true olarak ayarlayabilirsiniz. Daha fazla bilgi için bkz. Logtail yapılandırmaları (eski). Bu parametre yalnızca Linux için Logtail 1.0.20 veya sonraki sürümler ve Windows için Logtail 1.0.20.0 veya sonraki sürümler tarafından desteklenir.	"enable_checkpoint_sync_write": false
   enable_env_ref_in_config	Boolean	Toplama yapılandırmalarında ortam değişkeni değiştirmenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false. Bu özelliği etkinleştirdikten sonra konsoldaki Logtail toplama yapılandırmasında ortam değişkeni xxx için yer tutucu olarak ${xxx} kullanabilirsiniz. Örneğin toplama yolunu /${xxx}/logs olarak ayarlar ve ortam değişkenini xxx=user olarak belirlerseniz etkili toplama yolu /user/logs olur. Yapılandırmanızda ${ veya } değişmez karakterlerini kullanmanız gerekiyorsa bunları $${ veya $} kullanarak kaçış karakteriyle belirtebilirsiniz. Bu parametre yalnızca Linux için Logtail 1.0.31 veya sonraki sürümler ve Windows için Logtail 1.0.31.0 veya sonraki sürümler tarafından desteklenir.	"enable_env_ref_in_config": false
   docker_config_update_interval	int	Konteyner yollarının güncellendiği minimum aralık. Bu parametre max_docker_config_update_times parametresi ile birlikte kullanılır. Her iki parametreden birinin eşiğine ulaşılırsa konteyner yolu güncellemeleri durur. Linux için Logtail 1.0.32 veya sonraki sürümler ve Windows için Logtail 1.0.32.0 veya sonraki sürümlerde varsayılan değer 3'tür. Birim: saniye. Linux için Logtail 1.0.32 öncesi sürümler ve Windows için Logtail 1.0.32.0 öncesi sürümlerde varsayılan değer 10'dur. Birim: saniye.	"docker_config_update_interval": 3
   max_docker_config_update_times	int	3 dakikalık bir süre içinde izin verilen maksimum konteyner yolu güncelleme sayısı. Varsayılan olarak 3 dakika içinde güncelleme sayısı bu sınırı aşarsa süre sona erene kadar konteyner yolu güncellemeleri durur. Linux için Logtail 1.0.32 veya sonraki sürümler ve Windows için Logtail 1.0.32.0 veya sonraki sürümlerde varsayılan değer 10'dur. Linux için Logtail 1.0.32 öncesi sürümler ve Windows için Logtail 1.0.32.0 öncesi sürümlerde varsayılan değer 3'tür.	"max_docker_config_update_times": 10
   DOCKER_HOST	String	Docker ile iletişim kurmak için kullanılan soket adresi. Bu bir ortam değişkeni olarak yapılandırılmalıdır. Varsayılan değer: boş dize; yani varsayılan adres unix:///var/run/docker.sock kullanılır.	DOCKER_HOST=unix:///var/run/docker.sock
   CONTAINERD_SOCK_PATH	String	containerd ile iletişim kurmak için kullanılan soket adresi. Bu bir ortam değişkeni olarak yapılandırılmalıdır. Varsayılan değer: boş dize; yani varsayılan adres unix:///run/containerd/containerd.sock kullanılır. K3s kümesi kullanıyorsanız değeri örnekte gösterildiği gibi değiştirebilirsiniz.	CONTAINERD_SOCK_PATH=/run/k3s/containerd/containerd.sock
   logreader_max_rotate_queue_size	Int	Dosya döndürme kuyruğunun maksimum uzunluğu. Varsayılan değer: 20. Günlük toplama engellenirse veya gecikirse toplanmayı bekleyen dosyalar dosya tanıtıcılarını tutar ve bu kuyrukta bekler. Toplama gecikiyorsa ve maksimum disk kullanımını kontrol etmeniz gerekiyorsa bu değeri azaltmayı düşünün. Uyarı Geciken dosya sayısı bu değeri aştığında Logtail yeni dosyaların toplanmasını atlar.	"logreader_max_rotate_queue_size" : 10
   force_release_deleted_file_fd_timeout	Int	Bir konteyner çıktıktan veya bir dosya silindikten sonra dosya tanıtıcısının serbest bırakılması için zaman aşımı süresi. Varsayılan değer: -1; bu özelliği devre dışı bırakır. 0 değeri tanıtıcının hemen serbest bırakıldığını gösterir. Birim: saniye. containerd konteynerleri için maksimum yok olma gecikmesini kontrol etmek istiyorsanız bu parametreyi ayarlayabilirsiniz. Uyarı Günlük toplama gecikirse yapılandırılmış zaman aşımını aşan veriler kaybolur.	"force_release_deleted_file_fd_timeout" : 0
   data_endpoint_policy	string	Logtail'in SLS uç noktalarına erişmek için geçiş ilkesi. Geçerli değerler: Not ilogtail_config.json dosyasında data_server_list parametresinde varsayılan bir uç noktanın yapılandırılıp yapılandırılmadığını kontrol edebilirsiniz. Daha fazla bilgi için bkz. Başlatma parametresi yapılandırma dosyası (ilogtail_config.json). designated_first (varsayılan) Bir bölge için varsayılan bir uç nokta belirtilmişse ve uç nokta kullanılabilir durumdaysa Logtail önce varsayılan uç noktayı kullanır. Bir bölge için varsayılan bir uç nokta belirtilmiş ancak uç nokta kullanılamıyorsa Logtail otomatik olarak kullanılabilir bir uç nokta seçer. Bir bölge için varsayılan bir uç nokta belirtilmemişse Logtail otomatik olarak kullanılabilir bir uç nokta seçer. designated_locked Bir bölge için varsayılan bir uç nokta belirtilmişse Logtail kullanılabilirliğinden bağımsız olarak yalnızca varsayılan uç noktayı kullanır. Bir bölge için varsayılan bir uç nokta belirtilmemişse Logtail otomatik olarak kullanılabilir bir uç nokta seçer. Bu parametre yalnızca Linux için Logtail 1.5.0 veya sonraki sürümler ve Windows için Logtail 1.5.0.0 veya sonraki sürümler tarafından desteklenir.	"data_endpoint_policy" : "designated_first"
   inotify_black_list	Array<String>	inotify izleme kara listesi. Bu parametre yalnızca tam yol eşleştirmeyi destekler. Bu listedeki dizinler inotify tarafından izlenmez.	"inotify_black_list": ["/tmp"]
   host_path_blacklist	String	Genel ana bilgisayar yolu kara listesi. Bu parametre yalnızca alt dize eşleştirmeyi destekler. Linux sunucularda birden fazla alt dizeyi ayırmak için iki nokta üst üste (:) kullanın. Windows sunucularda birden fazla alt dizeyi ayırmak için noktalı virgül (;) kullanın. Örneğin "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-" Logtail'in NAS bağlantılarından veri toplamasını yasaklar. Bu parametre yalnızca Linux için Logtail 1.8.0 veya sonraki sürümler ve Windows için Logtail 1.8.0.0 veya sonraki sürümler tarafından desteklenir.	"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"
   LOGTAIL_LOG_LEVEL	String	Logtail'in dahili günlüklerinin günlük düzeyi. Bu bir ortam değişkeni olarak yapılandırılmalıdır. Varsayılan olarak bu parametre boştur ve INFO düzeyine karşılık gelir. Geçerli değerler: TRACE, DEBUG, INFO, WARNING, ERROR ve FATAL. Bu parametre yalnızca Linux için Logtail 1.8.0 veya sonraki sürümler ve Windows için Logtail 1.8.0.0 veya sonraki sürümler tarafından desteklenir.	LOGTAIL_LOG_LEVEL=info
   FORCE_RELEASE_STOP_CONTAINER_FILE	Boolean	Yapılandırma yöntemi: Bu parametre yalnızca bir ortam değişkeni kullanılarak yapılandırılabilir. Açıklama: Bu parametre true olarak ayarlandığında Logtail uygulama konteyneri çıktığında konteyner dosya tanıtıcılarını hemen serbest bırakır. Bu, dosya tanıtıcıları serbest bırakılmadığı için bir konteynerin çıkamamasını önler. Önemli: Bu durumda konteynerden toplanan verilerin bütünlüğü garanti edilemez. Günlüklerin tamamen toplanmasını sağlamak için uygulama çıkmadan önce birkaç saniyelik bir gecikme ekleyin. Desteklenen sürümler: Linux için Logtail 2.1.6 veya sonraki sürümler	"FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"
   default_reader_flush_timeout	int	Son günlük satırının bütünlüğünü belirlemek için zaman aşımı süresi. Varsayılan değer: 60. Birim: saniye. Bu parametre yalnızca Logtail 2.0.0 veya sonraki sürümler tarafından desteklenir.	"default_reader_flush_timeout" : 1

3. Yeni yapılandırmayı uygulamak için Logtail'i yeniden başlatın.

   /etc/init.d/ilogtaild stop && /etc/init.d/ilogtaild start                        

   Yeniden başlatmadan sonra Logtail'in durumunu kontrol etmek için /etc/init.d/ilogtaild status komutunu çalıştırabilirsiniz.

Ortam değişkenleri

Aşağıdaki tabloda ortam değişkenlerinin Logtail başlatma parametreleriyle eşleşmesi gösterilmektedir.

Başlangıç parametre dosyası (ilogtail_config.json)

• Dosya yolu

  • Sunucu ortamı

    İşletim sistemi	Logtail	Yol
    Linux	Logtail (64-bit)	/usr/local/ilogtail/ilogtail_config.json
    Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
    	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json Not 64-bit Windows işletim sisteminde hem 32-bit hem de 64-bit uygulamaları çalıştırabilirsiniz. Uyumluluk amacıyla Windows, 32-bit uygulamaları ayrı bir x86 dizininde saklar.
    Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

  • Konteyner ortamı

    ilogtail_config.json dosyası Logtail konteynerinde depolanır. Dosya yolu, ALIYUN_LOGTAIL_CONFIG ortam değişkeninde yapılandırılır ve bu değişkeni docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_CONFIG komutunu çalıştırarak görüntüleyebilirsiniz. Örneğin: /etc/ilogtail/conf/cn-hangzhou/ilogtail_config.json.

• Dosya örneği

  $cat /usr/local/ilogtail/ilogtail_config.json
  {
      "config_server_address" : "http://logtail.cn-hangzhou-intranet.log.aliyuncs.com",
      "data_server_list" :
      [
          {
              "cluster" : "cn-hangzhou",
              "endpoint" : "cn-hangzhou-intranet.log.aliyuncs.com"
          }
      ],
      "cpu_usage_limit" : 0.4,
      "mem_usage_limit" : 100,
      "max_bytes_per_sec" : 2097152,
      "process_thread_count" : 1,
      "send_request_concurrency" : 15,
      "streamlog_open" : false
  }

Kullanıcı tanımlayıcı dosyası

Kullanıcı tanımlayıcı dosyası, bir Alibaba Cloud kök hesabının ID bilgisini içerir. Bu dosya, Logtail'in söz konusu hesap adına sunucuya erişmesine ve günlük toplamasına yetki verir. Daha fazla bilgi için bkz. Kullanıcı tanımlayıcısını yapılandırma.

• Dosya yolu

  • Sunucu ortamı

    • Linux: /etc/ilogtail/users/

    • Windows: C:\LogtailData\users\

  • Konteyner ortamı

    Kullanıcı tanımlayıcısı, Logtail konteynerinin ALIYUN_LOGTAIL_USER_ID ortam değişkeninde depolanır. Tanımlayıcıyı görüntülemek için docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_ID komutunu çalıştırın.

• Dosya örneği

  $ls /etc/ilogtail/users/

Özel tanımlayıcı dosyası (user_defined_id)

user_defined_id dosyası, özel bir tanımlayıcı yapılandırmak için kullanılır. Daha fazla bilgi için bkz. Özel tanımlayıcı tabanlı makine grubu oluşturma.

• Dosya yolu

  • Ana bilgisayar ortamı

    • Linux: /etc/ilogtail/user_defined_id.

    • Windows: C:\LogtailData\user_defined_id.

  • Konteyner ortamı

    Özel tanımlayıcı, Logtail konteynerinin ALIYUN_LOGTAIL_USER_DEFINED_ID ortam değişkeninde yapılandırılır. Tanımlayıcıyı görüntülemek için docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID komutunu çalıştırabilirsiniz.

• Dosya örneği

  $cat /etc/ilogtail/user_defined_id
  aliyun-ecs-rs1e16355

Logtail yapılandırma dosyası (user_log_config.json)

user_log_config.json, Simple Log Service üzerinden alınan Logtail yapılandırmasını depolayan bir JSON dosyasıdır. Bir Logtail yapılandırması her değiştirildiğinde bu dosya güncellenir. Logtail yapılandırmasının sunucuya iletildiğini doğrulamak için bu dosyayı kontrol edebilirsiniz. Dosya mevcut ve içeriği Simple Log Service içindeki Logtail yapılandırmasıyla eşleşiyorsa yapılandırma başarıyla iletilmiştir.

• Dosya yolu

  • Ana bilgisayar ortamı

    İşletim sistemi	Logtail	Yol
    Linux	Logtail (64-bit)	/usr/local/ilogtail/user_log_config.json
    Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json
    	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\user_log_config.json Not 64 bitlik Windows işletim sistemi hem 32 bit hem de 64 bit uygulamaları çalıştırabilir. Uyumluluk amacıyla Windows, 32 bit uygulamaları ayrı bir x86 dizininde saklar.
    Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json

  • Konteyner ortamı

    user_log_config.json dosyası Logtail konteynerinde /usr/local/ilogtail/user_log_config.json konumunda saklanır.

• Dosya örneği

  $cat /usr/local/ilogtail/user_log_config.json
  {
     "metrics" : {
        "##1.0##k8s-log-c12ba2028*****939f0b$app-java" : {
           "aliuid" : "16542189*****50",
           "category" : "app-java",
           "create_time" : 1534739165,
           "defaultEndpoint" : "cn-hangzhou-intranet.log.aliyuncs.com",
           "delay_alarm_bytes" : 0,
           "enable" : true,
           "enable_tag" : true,
           "filter_keys" : [],
           "filter_regs" : [],
           "group_topic" : "",
           "local_storage" : true,
           "log_type" : "plugin",
           "log_tz" : "",
           "max_send_rate" : -1,
           "merge_type" : "topic",
           "plugin" : {
              "inputs" : [
                 {
                    "detail" : {
                       "IncludeEnv" : {
                          "aliyun_logs_app-java" : "stdout"
                       },
                       "IncludeLable" : {
                          "io.kubernetes.container.name" : "java-log-demo-2",
                          "io.kubernetes.pod.namespace" : "default"
                       },
                       "Stderr" : true,
                       "Stdout" : true
                    },
                    "type" : "service_docker_stdout"
                 }
              ]
           },
           "priority" : 0,
           "project_name" : "k8s-log-c12ba2028c*****ac1286939f0b",
           "raw_log" : false,
           "region" : "cn-hangzhou",
           "send_rate_expire" : 0,
           "sensitive_keys" : [],
           "tz_adjust" : false,
           "version" : 1
        }
     }
  }

AppInfo kayıt dosyası (app_info.json)

app_info.json dosyası başlangıç zamanı, IP adresi ve ana bilgisayar adı gibi Logtail ile ilgili bilgileri kaydeder.

• Dosya yolu

  • Ana bilgisayar ortamı

    İşletim sistemi	Logtail	app_info.json dosya yolu
    Linux	Logtail (64-bit)	/usr/local/ilogtail/app_info.json
    Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\app_info.json
    	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json Not 64 bitlik Windows işletim sistemi hem 32 bit hem de 64 bit uygulamaları çalıştırabilir. Uyumluluk amacıyla işletim sistemi 32 bit uygulamaları ayrı bir x86 dizininde saklar.
    Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\app_info.json

  • Konteyner ortamı

    app_info.json dosyası Logtail konteynerinde /usr/local/ilogtail/app_info.json konumunda saklanır.

• Örnek dosya

  $cat /usr/local/ilogtail/app_info.json
  {
     "UUID" : "",
     "hostname" : "logtail-ds-slpn8",
     "instance_id" : "E5F93BC6-B024-11E8-8831-0A58AC14039E_1**.***.***.***_1536053315",
     "ip" : "1**.***.***.***",
     "logtail_version" : "0.16.13",
     "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
     "update_time" : "2018-09-04 09:28:36"
  }

  Alan	Açıklama
  UUID	Sunucu seri numarası.
  hostname	Ana bilgisayar adı.
  instance_id	Logtail için rastgele oluşturulan benzersiz tanımlayıcı.
  ip	Logtail tarafından alınan IP adresi. Bu alan boşsa Logtail bir IP adresi alamamıştır ve çalışamaz. Sunucu için bir IP adresi ayarlayın ve Logtail'i yeniden başlatın. Not IP adreslerine göre bir makine grubu oluşturuyorsanız makine grubunda yapılandırılan IP adresinin burada görüntülenen IP adresiyle eşleştiğinden emin olun. Eşleşmiyorlarsa doğru ana bilgisayar IP adresini onaylayın. Ardından Simple Log Service konsolunda makine grubundaki IP adresini değiştirin veya Logtail başlangıç parametrelerini ayarlayın bölümündeki working_ip parametresinin değerini değiştirin.
  logtail_version	Logtail istemci sürümü.
  os	İşletim sistemi sürümü.
  update_time	Logtail'in en son başlatıldığı zaman.

Logtail çalışma günlüğü (ilogtail.LOG)

ilogtail.LOG dosyası, Logtail'in çalışma günlüklerini kaydeder. Günlük düzeyleri önem sırasına göre INFO, WARN ve ERROR şeklindedir. INFO düzeyindeki günlükleri genellikle dikkate almayabilirsiniz.

• Dosya yolu

  • Sunucu ortamı

    İşletim sistemi	Logtail	Yol
    Linux	Logtail (64-bit)	/usr/local/ilogtail/ilogtail.LOG
    Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG
    	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail.LOG Not 64 bit Windows işletim sistemi hem 32 bit hem de 64 bit uygulamaları çalıştırabilir. Uyumluluk amacıyla Windows, 32 bit uygulamaları ayrı bir x86 dizininde saklar.
    Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG

  • Konteyner ortamı

    ilogtail.LOG dosyası /usr/local/ilogtail/ilogtail.LOG konumundaki Logtail konteynerinde saklanır.

• Dosya örneği

  $tail /usr/local/ilogtail/ilogtail.LOG
  [2018-09-13 01:13:59.024679]    [INFO]    [3155]    [build/release64/sls/ilogtail/elogtail.cpp:123]    change working dir:/usr/local/ilogtail/
  [2018-09-13 01:13:59.025443]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:175]    load logtail config file, path:/etc/ilogtail/conf/ap-southeast-1/ilogtail_config.json
  [2018-09-13 01:13:59.025460]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:176]    load logtail config file, detail:{
     "config_server_address" : "http://logtail.ap-southeast-1-intranet.log.aliyuncs.com",
     "data_server_list" : [
        {
           "cluster" : "ap-southeast-1",
           "endpoint" : "ap-southeast-1-intranet.log.aliyuncs.com"
        }
  ]

Logtail eklenti günlüğü (logtail_plugin.LOG)

logtail_plugin.LOG dosyası, Logtail eklentisinin çalışma günlüklerini kaydeder. Günlük düzeyleri önem sırasına göre INFO, WARN ve ERROR şeklindedir. INFO düzeyindeki günlükleri güvenle göz ardı edebilirsiniz.

CANAL_RUNTIME_ALARM gibi toplama hatalarını gidermek için logtail_plugin.LOG dosyasını kontrol edin.

• Dosya yolu

  • Ana bilgisayar ortamı

    İşletim sistemi	Logtail	logtail_plugin.LOG dosya yolu
    Linux	Logtail (64-bit)	/usr/local/ilogtail/logtail_plugin.LOG
    Windows (64-bit işletim sistemi)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG
    	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\logtail_plugin.LOG Not 64 bit Windows işletim sistemi hem 32 bit hem de 64 bit uygulamaları çalıştırabilir. Uyumluluk amacıyla Windows, 32 bit uygulamaları ayrı bir x86 dizininde saklar.
    Windows (32-bit işletim sistemi)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG

  • Konteyner ortamı

    logtail_plugin.LOG dosyası /usr/local/ilogtail/logtail_plugin.LOG konumundaki Logtail konteynerinde saklanır.

• Örnek

  $tail /usr/local/ilogtail/logtail_plugin.LOG
  2018-09-13 02:55:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 02:55:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:00:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:00:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:04:26 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:04:27 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:05:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:05:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop

Konteyner yol eşlemesi (docker_path_config.json)

docker_path_config.json dosyası, yalnızca konteyner günlüklerini topladığınızda oluşturulan bir JSON dosyasıdır. Bu dosya, konteyner ile ana bilgisayar dosyaları arasındaki yol eşlemelerini kaydeder.

Toplama hatalarını teşhis ederken DOCKER_FILE_MAPPING_ALARM hatası oluşursa, Docker dosya yolu eşlemesinin başarısız olduğu anlamına gelir. Sorunu gidermek için docker_path_config.json dosyasını kontrol edin.

• Dosya yolu

  /usr/local/ilogtail/docker_path_config.json

• Örnek

  $cat /usr/local/ilogtail/docker_path_config.json
  {
     "detail" : [
        {
           "config_name" : "##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$nginx",
           "container_id" : "df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10",
           "params" : "{\n   \"ID\" : \"df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10\",\n   \"Path\" : \"/logtail_host/var/lib/docker/overlay2/947db346695a1f65e63e582ecfd10ae1f57019a1b99260b6c83d00fcd1892874/diff/var/log\",\n   \"Tags\" : [\n      \"nginx-type\",\n      \"access-log\",\n      \"_image_name_\",\n      \"registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest\",\n      \"_container_name_\",\n      \"nginx-log-demo\",\n      \"_pod_name_\",\n      \"nginx-log-demo-h2lzc\",\n      \"_namespace_\",\n      \"default\",\n      \"_pod_uid_\",\n      \"87e56ac3-b65b-11e8-b172-00163f008685\",\n      \"_container_ip_\",\n      \"172.20.4.224\",\n      \"purpose\",\n      \"test\"\n   ]\n}\n"
        } 
     ],
     "version" : "0.1.0"
  }