Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Çalışma zamanı yönetimi

Son Güncelleme:Oct 10, 2026

LoongCollector'ı yükledikten sonra yaşam döngüsünü ve çalışma zamanı yapılandırmasını yönetebilirsiniz.

Yaygın LoongCollector komutları

LoongCollector'ı başlatın

Veri toplama için belirli performans gereksinimleriniz varsa, LoongCollector'ı başlatmadan önce başlangıç parametresi yapılandırma dosyasını (ilogtail_config.json) değiştirin.
sudo /etc/init.d/loongcollectord start

LoongCollector'ı durdurun

sudo /etc/init.d/loongcollectord stop

LoongCollector durumunu kontrol edin

sudo /etc/init.d/loongcollectord status # A return value of "loongcollector is running" indicates a successful start.

LoongCollector sürümünü kontrol edin

cat /usr/local/ilogtail/app_info.json # The version information is stored in the loongcollector_version field.

LoongCollector'ı yeniden başlatın

sudo /etc/init.d/loongcollectord restart

LoongCollector'ı kaldırın

  1. Örnek kodda, ${region_id} ifadesini cn-hangzhou ile değiştirin. İndirme işlemini hızlandırmak için ${region_id} ifadesini ECS örneğinizin bulunduğu bölge ile değiştirin. Daha fazla bilgi için bkz. Bölgeler.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Kaldırma komutunu çalıştırın.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

LoongCollector'ı yükseltin

LoongCollector'ı daha yeni bir sürüme yükseltebilir veya Logtail'den LoongCollector'a geçiş yapabilirsiniz. Yükseltme komutları her iki senaryo için de aynıdır.

LoongCollector'ı yükseltin veya Logtail'den LoongCollector'a geçiş yapın

Önemli

Yükseltme sırasında LoongCollector durur ve yükseltme tamamlandığında otomatik olarak yeniden başlar. Yükseltme yalnızca temel dosyaların üzerine yazar. Günlük kaybını önlemek için yapılandırma ve checkpoint dosyalarınız korunur.

  1. Sunucunuzda en son yükleme paketini edinmek için indirme komutunu çalıştırın. Örnek kodda, ${region_id} ifadesini cn-hangzhou ile değiştirin. İndirme işlemini hızlandırmak için ${region_id} ifadesini ECS örneğinizin bulunduğu bölge ile değiştirin. Daha fazla bilgi için bkz. Bölgeler.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Yükseltme komutunu çalıştırın. upgrade komutunu kullanın. install komutunu kullanırsanız kurulumun üzerine yazılır ve orijinal yapılandırmanız kaybolur.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;
  3. Aşağıdaki bilgiler görüntülenirse yükseltme başarılı olmuştur.

    Upgrade loongcollector files successfully.
    Starting loongcollector ...
    Upgrade loongcollector successfully.

LoongCollector'dan Logtail'e geri dönüş yapın

Not

logtail.sh betiğini yeniden indirmeniz gerekir. Eski logtail.sh betiğini kullanmayın.

  1. Sunucunuzda yükleme paketini edinmek için indirme komutunu çalıştırın. Örnek kodda, ${region_id} ifadesini cn-hangzhou ile değiştirin. İndirme işlemini hızlandırmak için ${region_id} ifadesini ECS örneğinizin bulunduğu bölge ile değiştirin. Daha fazla bilgi için bkz. Bölgeler.

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
  2. Geri dönüş komutunu çalıştırın. 1.8.7 gibi bir sürüm belirtmek için yorum satırına bakın ve sürüm numarasını gerektiği gibi değiştirin.

    chmod +x logtail.sh; sudo ./logtail.sh upgrade;
    #chmod +x logtail.sh; sudo ./logtail.sh upgrade -v -v 1.8.7;

Başlangıç parametresi yapılandırma dosyası (ilogtail_config.json)

  • Açıklama: Bu dosya, LoongCollector'ın başlangıç parametrelerini yapılandırır. Hatalı parametre ayarları toplama performansını etkileyebilir veya toplama hatalarına neden olabilir.

  • Yol: /usr/local/ilogtail/ilogtail_config.json.

  • Senaryo: Simple Log Service (SLS), aşırı sunucu kaynağı tüketimini önlemek amacıyla LoongCollector'ın toplama performansını sınırlar. Toplama performansı ihtiyaçlarınızı karşılamıyorsa başlangıç parametrelerini ayarlayın.

  • Dosya örneği:

    {
        "primary_region" : "cn-beijing", // Default region. You can ignore this parameter.
        "config_servers" : // The address used to obtain collection configurations.
        [
            "http://logtail.cn-beijing.log.aliyuncs.com"
        ],
        "data_servers" : // The address for data transmission with SLS.
        [
            {
                "region" : "cn-beijing",
                "endpoint_list": [
                    "cn-beijing.log.aliyuncs.com"
                ]
            }
        ],
        "cpu_usage_limit" : 0.4,
        "mem_usage_limit" : 384,
        "max_bytes_per_sec" : 20971520,
        "bytes_per_sec" : 1048576,
        "buffer_file_num" : 25,
        "buffer_file_size" : 20971520,
        "buffer_map_num" : 5
    }
  • Parametreler: Aşağıdaki tabloda yalnızca yapılandırmanız gerekebilecek yaygın başlangıç parametreleri listelenmiştir. Gerektiğinde bunları ekleyin veya değiştirin. Tabloda listelenmeyen parametreler için varsayılan değerleri koruyun.

    ilogtail_config.json başlangıç parametreleri

    Parametre

    Tür

    Açıklama

    Örnek

    cpu_usage_limit

    double

    Çekirdek başına hesaplanan CPU kullanım eşiği. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 0,1 ile makinedeki CPU çekirdek sayısı arasındadır.

    • Varsayılan değer: 0,4.

    Uyarı

    cpu_usage_limit yumuşak bir sınırdır. Gerçek CPU kullanımı bu değeri aşabilir. Sınır beş dakika boyunca aşılırsa devre kesici tetiklenir ve LoongCollector otomatik olarak yeniden başlar.

    Örneğin, 0,4 değeri SLS'nin toplayıcının CPU kullanımını tek bir CPU çekirdeğinin %40'ı ile sınırlamaya çalıştığı anlamına gelir. Kullanım bu sınırı aşarsa LoongCollector yeniden başlar.

    Genellikle tek bir çekirdek minimalist modda saniyede yaklaşık 100 MB veya tam düzenli ifade modunda saniyede 20 MB işleyebilir.

    "cpu_usage_limit" : 0.4

    mem_usage_limit

    int

    Bellek kullanım eşiği. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 128 MB ile 8192 MB arasındadır.

    • Varsayılan değer: Ana bilgisayarlar için 384 MB, ACK bileşenleri için 2048 MB.

    Uyarı

    mem_usage_limit yumuşak bir sınırdır. Gerçek bellek kullanımı bu değeri aşabilir. Sınır beş dakika boyunca aşılırsa devre kesici tetiklenir ve LoongCollector otomatik olarak yeniden başlar.

    Toplama oranı, izlenen dizinlerin ve dosyaların sayısı ile gönderme tıkanıklıkları mem_usage_limit parametresi ile ilişkilidir. Daha fazla bilgi için bkz. Sınırlar.

    "mem_usage_limit" : 384

    max_bytes_per_sec

    int

    Saniye başına ham veri gönderimi için maksimum trafik. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 1024 Byte/s ile 52428800 Byte/s arasındadır.

    • Varsayılan değer: 20971520 Byte/s.

      Önemli

      20971520 Byte/s (20 MB/s) değerinden büyük bir değer hız sınırı olmadığını gösterir.

    Örneğin, 2097152 değeri veri gönderme oranını 2 MB/s olarak ayarlar.

    "max_bytes_per_sec" : 2097152

    process_thread_count

    int

    Veri işleme için kullanılan iş parçacığı sayısı. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 1 ile 64 arasındadır.

    • Varsayılan değer: 1.

    Tek bir iş parçacığı genellikle minimalist modda saniyede 24 MB veya tam düzenli ifade modunda saniyede 12 MB veri yazısını işleyebilir. Normal koşullar altında bu parametreyi ayarlamanız gerekmez.

    "process_thread_count" : 1

    send_request_concurrency

    int

    Eşzamansız eşzamanlı istek sayısı. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 1 ile 50 arasındadır.

    • Varsayılan değer: 20.

    Yüksek yazma TPS'niz varsa daha yüksek bir eşzamanlılık değeri ayarlayın. Ağ gecikmesine bağlı olarak bir eşzamanlı isteğin saniyede 0,5 MB ile 1 MB arasında ağ aktarım hızını desteklediğini tahmin edin.

    Not

    Eşzamanlılığı çok yüksek ayarlamak çok sayıda ağ bağlantı noktasını meşgul edebilir. TCP ile ilgili parametreleri ayarlamanız gerekebilir.

    "send_request_concurrency" : 4

    buffer_file_num

    int

    Maksimum önbellek dosyası sayısı. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 1 ile 100 arasındadır.

    • Varsayılan değer: 25.

    Ağ sorunları veya yazma kota aşımları oluşursa toplayıcı ayrıştırılan günlükleri yükleme dizinindeki yerel dosyalara önbelleğe alır. Sorun çözüldükten sonra yeniden göndermeyi dener.

    "buffer_file_num" : 25

    buffer_file_size

    int

    Bayt cinsinden tek bir önbellek dosyasının maksimum boyutu. Ayrıntılar aşağıda açıklanmıştır:

    • Geçerli değerler: 1048576 Bayt ile 104857600 Bayt arasındadır.

    • Varsayılan değer: 20971520 Bayt.

    Önbellek dosyaları için maksimum disk alanı buffer_file_size × buffer_file_num şeklindedir.

    "buffer_file_size" : 20971520

    buffer_file_path

    String

    Önbellek dosyalarının depolandığı dizin. Varsayılan değer boştur, bu da önbellek dosyalarının /usr/local/ilogtail yükleme dizininde depolandığı anlamına gelir.

    Bu parametreyi ayarlarsanız logtail_buffer_file_* adlı dosyaları orijinal dizinden yeni dizine manuel olarak taşımanız gerekir. Bu işlem toplayıcının önbellek dosyalarını okuyabilmesini ve gönderildikten sonra silebilmesini sağlar.

    "buffer_file_path" : ""

    bind_interface

    String

    Bağlanan ağ arabirim kartının adı. Varsayılan değer boştur, bu da LoongCollector'ın kullanılabilir bir ağ arabirim kartına otomatik olarak bağlandığı anlamına gelir.

    eth1 gibi belirli bir ağ arabirim kartına ayarlarsanız LoongCollector günlükleri yüklemek için yalnızca o kartı kullanmaya zorlanır.

    "bind_interface" : ""

    check_point_filename

    String

    Checkpoint dosyası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

    Checkpoint dosyasının güncellenme aralığı (saniye cinsinden). Varsayılan değer: 900. Varsayılan olarak Checkpoint dosyası her 15 dakikada bir güncellenir.

    "check_point_dump_interval" : 900

    user_config_file_path

    String

    Yapılandırma dosyasının kaydedildiği yol. Varsayılan değer işlem ikili dosyasının dizinidir. Varsayılan dosya adı user_log_config.json şeklindedir.

    "user_config_file_path" : user_log_config.json

    discard_old_data

    Boolean

    Eski günlüklerin atılıp atılmayacağını belirtir. Varsayılan değer: true. True olarak ayarlanırsa 12 saatten eski günlükler atılır.

    "discard_old_data" : true

    ilogtail_discard_interval

    int

    Eski günlüklerin atılması için yaş eşiği (saniye cinsinden). Varsayılan değer: 43200 (12 saat).

    "ilogtail_discard_interval": 43200

    working_ip

    String

    Varsayılan değer boştur, bu da IP adresinin sunucudan otomatik olarak alındığı anlamına gelir. Bir değer ayarlarsanız bu değer sunucunun IP adresi olarak rapor edilir.

    "working_ip" : ""

    working_hostname

    String

    Bu sunucu için rapor edilen ana bilgisayar adı. Varsayılan değer boştur, bu da ana bilgisayar adının sunucudan otomatik olarak alındığı anlamına gelir.

    "working_hostname" : ""

    max_read_buffer_size

    long

    Tek bir günlük girdisi için bayt cinsinden maksimum boyut. Varsayılan değer: 524288 (512 KB). Maksimum değer: 8388608 (8 MB).

    Tek bir günlük girdisi 524288 baytı aşarsa bu değeri artırın.

    "max_read_buffer_size" : 524288

    oas_connect_timeout

    long

    Toplama yapılandırmalarını veya AccessKey'leri almak için yapılan isteklerin bağlantı zaman aşımı (saniye cinsinden). Varsayılan değer: 5.

    Uzun bağlantı sürelerine neden olan zayıf bir ağ bağlantınız varsa bu değeri artırın.

    "oas_connect_timeout" : 5

    oas_request_timeout

    long

    Toplama yapılandırmalarını veya AccessKey'leri almak için yapılan isteklerin toplam istek zaman aşımı (saniye cinsinden). Varsayılan değer: 10.

    Zayıf bir ağ bağlantınız varsa bu değeri artırın.

    "" : 10

    data_server_port

    long

    data_server_port öğesini 443 olarak ayarlarsanız veriler HTTPS üzerinden SLS'ye gönderilir.

    "data_server_port": 443

    enable_log_time_auto_adjust

    Boolean

    enable_log_time_auto_adjust öğesini true olarak ayarlarsanız günlük zamanı sunucunun yerel saatine otomatik olarak ayarlanır.

    Veri güvenliği için SLS, LoongCollector'dan gelen istekler dahil olmak üzere her isteğin zaman damgasını doğrular. Sunucu saatinden 15 dakikadan fazla farklı olan zaman damgasına sahip istekleri reddeder. Toplayıcı istekler için sunucunun yerel saatini kullanır. Sunucunun yerel saati değiştirilirse (örneğin test amaçlı gelecekteki bir saate ayarlanırsa) istekler reddedilir ve veri yazma işlemleri başarısız olur. Günlük zamanının sunucunun yerel saatine uyum sağlamasına izin vermek için bu parametreyi kullanın.

    Önemli
    • Bu özellik etkinleştirildiğinde SLS zamanı ile sunucunun yerel saati arasındaki fark günlük zamanına eklenir. Fark yalnızca bir istek reddedildiğinde güncellendiğinden SLS'de sorguladığınız günlük zamanı gerçek yazma zamanıyla eşleşmeyebilir.

    • Bazı LoongCollector mantıkları sistem zamanının monoton olarak artmasına dayanır. Makinenin saatini ayarladıktan sonra toplayıcıyı yeniden başlatın.

    "enable_log_time_auto_adjust": true

    accept_multi_config

    Boolean

    Birden fazla toplama yapılandırmasının aynı dosyayı toplamasına izin verilip verilmeyeceğini belirtir. Varsayılan değer: false.

    Varsayılan olarak bir dosya yalnızca bir toplama yapılandırması tarafından toplanabilir. Bu kısıtlamayı kaldırmak için bu parametreyi kullanın. Her toplama yapılandırması için işleme bağımsızdır. Birden fazla yapılandırmanın aynı dosyayı toplamasına izin vermek daha fazla CPU ve bellek tüketir.

    "accept_multi_config": true

    enable_checkpoint_sync_write

    Boolean

    Eşzamanlı yazma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false.

    Eşzamanlı yazma özelliği öncelikle ExactlyOnce yazma özelliği ile birlikte kullanılır. ExactlyOnce etkinleştirildiğinde toplayıcı ayrıntılı dosya düzeyinde Checkpoint bilgilerini yerel diske kaydeder. Performans nedenleriyle Checkpoint'ler yazılırken varsayılan olarak sync çağrısı kullanılmaz. Arabellek verileri diske yazılmadan önce makine yeniden başlatılırsa Checkpoint kaybolabilir. Bu durumda eşzamanlı yazmaları etkinleştirmek için enable_checkpoint_sync_write değerini true olarak ayarlayın. Daha fazla bilgi için bkz. Logtail yapılandırması (Eski sürüm).

    "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 özellik etkinleştirildiğinde konsoldaki toplama yapılandırmasında ${xxx} ifadesini xxx ortam değişkeni için yer tutucu olarak kullanın. Örneğin toplama yolunu /${xxx}/logs olarak ayarlar ve ortam değişkeni xxx=user olursa etkili toplama yolu /user/logs olur.

    Yapılandırmanızın değişmez karakterleri ${ veya } kullanması gerekiyorsa bunları sırasıyla $${ ve $} olarak kaçış karakterleriyle yazın.

    "enable_env_ref_in_config": false

    logreader_max_rotate_queue_size

    Int

    Döndürme kuyruğunun maksimum uzunluğu. Varsayılan değer: 20. Günlük toplama engellendiğinde veya geciktiğinde 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şarsa yeni dosyaların toplanması atlanır.

    "logreader_max_rotate_queue_size" : 10

    data_endpoint_policy

    string

    SLS uç noktaları için geçiş ilkesi. Olası değerler şunlardır:

    Not

    Bir varsayılan alan adının yapılandırılıp yapılandırılmadığını görmek için ilogtail_config.json dosyasındaki data_server parametresini kontrol edin.

    • designated_first (Varsayılan)

      • Bir bölge için varsayılan bir alan adı belirtilmişse ve kullanılabilir durumdaysa sistem varsayılan alan adını kullanır.

      • Belirtilen varsayılan alan adı kullanılamıyorsa sistem kullanılabilir bir alan adını otomatik olarak seçer.

      • Varsayılan bir alan adı belirtilmemişse sistem kullanılabilir bir alan adını otomatik olarak seçer.

    • designated_locked

      • Bir bölge için varsayılan bir alan adı belirtilmişse sistem kullanılabilirliğine bakmaksızın yalnızca o alan adını kullanır.

      • Varsayılan bir alan adı belirtilmemişse sistem kullanılabilir bir alan adını otomatik olarak seçer.

    "data_endpoint_policy" : "designated_first"

    inotify_black_list

    Array<String>

    inotify dinleyicisi için bir engelleme listesi. Bu tam eşleşmeli bir listedir. Bu listedeki dizinler inotify tarafından izlenmez.

    "inotify_black_list": ["/tmp"]

    host_path_blacklist

    String

    Alt dizeyle eşleşen ana bilgisayar yolları için genel bir engelleme listesi. Linux'ta birden fazla alt dizeyi iki nokta üst üste (: ) ile ayırın.

    Örneğin, "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-" NAS bağlantılarından veri toplanmasını engeller.

    "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"

    LOGTAIL_LOG_LEVEL

    String

    Günlük düzeyi. Bu bir ortam değişkeni olarak yapılandırılmalıdır. Varsayılan değer boştur, bu info düzeyine karşılık gelir. Olası değerler trace, debug, info, warning, error ve fatal'dır.

    LOGTAIL_LOG_LEVEL=info

    FORCE_RELEASE_STOP_CONTAINER_FILE

    Boolean

    • Yapılandırma: Bu yalnızca bir ortam değişkeni olarak yapılandırılabilir.

    • Açıklama: Bu parametre true olarak ayarlandığında uygulama konteyneri durduğunda toplayıcı konteynerin dosya tanıtıcısını hemen serbest bırakır. Bu işlem dosya tanıtıcısı serbest bırakılmadığından konteynerin çıkamamasını önler.

    • Not:

      • Bu ayarla konteynerden veri toplamanın bütünlüğü garanti edilemez.

      • Tüm günlüklerin toplandığından emin olmak için uygulamanız çıkmadan önce birkaç saniyelik bir gecikme ekleyin.

    "FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"

  • Senaryolar: Aşağıdaki örnekler yaygın senaryoları ve işlemleri göstermektedir.

Toplama performansı yapılandırma planlaması

Toplayıcının diğer hizmetleri etkileyecek şekilde aşırı sunucu kaynağı tüketmesini önlemek için SLS toplama performansını sınırlar. Toplama performansını iyileştirmek için başlangıç parametrelerini değiştirin.

Önerilen parametre örnekleri

Aşağıdaki parametre yapılandırmaları yaygın JSON dosyalarını toplamak için önerilir. Tam düzenli ifade modunun ve ayırıcı modunun performansı JSON moduna benzerdir. Minimalist modun performansı JSON modundan beş kat daha yüksektir. Veri ve kural karmaşıklığı ile toplama dizinlerinin ve dosyalarının sayısı gibi faktörler CPU ve bellek tüketimini etkiler. Aşağıdaki tablodaki parametreleri gerektiği gibi ayarlayın.

/usr/local/ilogtail/ilogtail_config.json içindeki parametre değerlerini ekleyin veya değiştirin ve değişikliklerin etkili olması için LoongCollector'ı yeniden başlatın. Aşağıdaki tabloda farklı toplama oranları için önerilen değerler sağlanmıştır.

Not

Tablodaki 40 MB/s'den büyük toplama oranı sütununa göre başlangıç parametrelerini yapılandırdığınızda toplama performansı sınırına yaklaşmaktadır.

Parametre

Açıklama

10 MB/s'den büyük toplama oranı

20 MB/s'den büyük toplama oranı

40 MB/s'den büyük toplama oranı

cpu_usage_limit

Çekirdek başına hesaplanan CPU kullanım eşiği.

  • Geçerli değerler: 0,1 ile makinedeki CPU çekirdek sayısı arasındadır.

  • Varsayılan değer: 0,4.

0,4 değeri SLS'nin toplayıcının CPU kullanımını tek bir çekirdeğin %40'ı ile sınırlamaya çalıştığı anlamına gelir. Kullanım bu sınırı aşarsa LoongCollector otomatik olarak yeniden başlar.

Bu yumuşak bir sınırdır. Gerçek CPU kullanımı bu değeri aşabilir. Sınır beş dakika boyunca aşılırsa devre kesici tetiklenir ve LoongCollector otomatik olarak yeniden başlar.

1

2

4

mem_usage_limit

Bellek kullanım eşiği.

  • Geçerli değerler: 128 MB ile 8192 MB arasındadır.

  • Varsayılan değer: 384 MB.

Toplama oranı, izlenen dizinlerin ve dosyaların sayısı ile gönderme tıkanıklıkları bu parametre ile ilişkilidir. Daha fazla bilgi için bkz. Sınırlar.

Bu yumuşak bir sınırdır. Gerçek bellek kullanımı bu değeri aşabilir. Sınır beş dakika boyunca aşılırsa devre kesici tetiklenir ve LoongCollector otomatik olarak yeniden başlar.

1024

2048

4096

process_thread_count

Veri işleme için kullanılan iş parçacığı sayısı.

  • Geçerli değerler: 1 ile 64 arasındadır.

  • Varsayılan değer: 1.

Tek bir iş parçacığı minimalist modda saniyede 24 MB veya tam düzenli ifade modunda saniyede 12 MB veri yazısını işleyebilir. Normal koşullar altında bu parametreyi ayarlamanız gerekmez.

2

4

8

send_request_concurrency

Eşzamansız eşzamanlı istek sayısı.

  • Geçerli değerler: 1 ile 50 arasındadır.

  • Varsayılan değer: 20.

Yüksek yazma TPS'niz varsa daha yüksek bir eşzamanlılık değeri ayarlayın. Ağ gecikmesine bağlı olarak bir eşzamanlı isteğin saniyede 0,5 MB ile 1 MB arasında ağ aktarım hızını desteklediğini tahmin edin.

20

40

80

Yüksek ağ gecikmesi veya kararsız günlük aktarımı

Günlük kaybı, yinelenen günlük aktarımı, LoongCollector tarafından sık yeniden denemeler veya sık ağ kesintileri ya dalgalanmalar yaşayabilirsiniz. Olası nedenler şunlardır:

  • Yetersiz ağ bant genişliği: Toplanan günlüklerin hacmi büyükse yetersiz ağ bant genişliği günlük birikimine ve artan gecikmeye neden olabilir.

  • Kararsız ağ ortamı: Bölge veya ağlar arası bağlantılar ağ gecikmesine veya paket kaybına yol açabilir.

Çözüm

Günlük toplamayı hızlandırmak için Alibaba Cloud CDN kenar düğümlerini kullanın. Bu yöntem genel ağ üzerinden toplamaya kıyasla ağ gecikmesi ve kararlılığında önemli avantajlar sunar. Bu özellik aktarılan veri miktarına göre ek ücretlere neden olur.

  1. Projeniz için alanlar arası günlük aktarımı hızlandırma özelliğini etkinleştirin.

  2. LoongCollector'ı durdurun. LoongCollector'ın yüklü olduğu sunucuda oturum açın ve sudo /etc/init.d/loongcollectord stop komutunu çalıştırın.

  3. Uç noktayı değiştirin. /usr/local/ilogtail/ilogtail_config.json dosyasında data_servers parametresi altındaki endpoint_list parametresinin değerini log-global.aliyuncs.com ile değiştirin. Bu işlem veri aktarımı için kullanılan alan adını hızlandırma uç noktasına değiştirir.

  4. LoongCollector'ı başlatın. sudo /etc/init.d/loongcollectord start komutunu çalıştırın.

Büyük tek günlük girdileri kesiliyor

Tek bir günlük girdisi çok büyükse toplandıktan sonra kesilebilir. Bunun nedeni tek bir günlük girdisi için varsayılan maksimum boyutun 512 KB (524.288 bayt) olmasıdır. Bir günlük girdisi bu boyutu aşarsa SLS onu keser. İlk satır için bir düzenli ifadeye göre bölünen çok satırlı günlüklerde ortaya çıkan her günlük girdisi için boyut sınırı da 512 KB'dır. Bu sınır aşılırsa girdi zorla birden fazla girdiye bölünür.

Çözüm

  1. /usr/local/ilogtail/ilogtail_config.json dosyasında max_read_buffer_size parametresinin değerini değiştirin. Parametre yoksa ekleyin. Bu parametre için maksimum değer 8 MB (8.388.608 bayt)'tır.

    Bellek kullanımının doğrusal olarak arttığını unutmayın. max_read_buffer_size × dosya eşzamanlılığı kadar bellek ayırmanız gerekir.
  2. LoongCollector'ı yeniden başlatın. sudo /etc/init.d/loongcollectord restart komutunu çalıştırın.

Aktarım sırasında 15 dakikadan eski günlükler kayboluyor

Günlük toplama çalışıyor gibi görünebilir ancak bazı günlükler kaybolur. Bu durum bir günlüğün zaman damgası ile mevcut SLS sunucu saati arasındaki fark 15 dakikadan fazla olduğunda gerçekleşir. Veri güvenliği için SLS, LoongCollector'dan gelen istekler dahil olmak üzere her isteğin zaman damgasını doğrular ve sunucu saatinden 15 dakikadan fazla farklı olan zaman damgasına sahip istekleri reddeder. Sunucunun yerel saati değiştirilirse (örneğin test amaçlı gelecekteki bir saate ayarlanırsa) istekler reddedilir ve veri yazma işlemleri başarısız olur.

Çözüm

  1. /usr/local/ilogtail/ilogtail_config.json dosyasında enable_log_time_auto_adjust parametresinin değerini true olarak değiştirin. Parametre yoksa ekleyin. Bu ayar günlük zamanının sunucunun yerel saatine otomatik olarak ayarlanmasına olanak tanır.

    Bu özellik etkinleştirildiğinde SLS zamanı ile sunucunun yerel saati arasındaki fark günlük zamanına eklenir. Fark yalnızca bir istek reddedildiğinde güncellendiğinden SLS'de sorguladığınız günlük zamanı gerçek yazma zamanıyla eşleşmeyebilir.
  2. LoongCollector'ı yeniden başlatın. sudo /etc/init.d/loongcollectord restart komutunu çalıştırın.

Başka bir bölgedeki bir projeye geçiş yapın

Çeşitli nedenlerle bir sunucudan toplanan günlükleri yeni bir projede depolamanız gerekebilir.

Çözüm

  1. Toplama yapılandırmasını yeniden kullanmak için devam etmeden önce toplama yapılandırma dosyasının içeriğini kaydedin. Kaldırma işlemi bu dosyayı siler.

  2. LoongCollector'ı sunucudan kaldırın.

  3. Yeni proje ile sunucu arasındaki ilişkiye göre uygun LoongCollector yükleme yöntemini seçin.

  4. Geçmiş verileri de yeni projeye aktarmanız gerekiyorsa iki yöntem mevcuttur:

Uzun günlük aktarım gecikmelerini optimize edin

Bu sorun SLS'deki günlük zaman damgasının sunucuda oluşturulduğu zamandan üç saniye daha geç olduğunda gerçekleşir. Olası nedenler şunlardır:

  • Aynı anda 100'den fazla dosya toplanıyor veya izlenen dizinde 5.000'den fazla dosya bulunuyor ve bu durum büyük miktarda bellek tüketiyor.

  • Yüksek günlük veri trafiği (örneğin minimalist modda saniyede 2 MB'den fazla veya düzenli ifade modunda saniyede 1 MB'den fazla) yüksek CPU kullanımına neden oluyor.

    CloudLens for SLS hizmetini etkinleştirin ve Collection Monitoring altında geçerli ana bilgisayarın CPU kullanımını kontrol edin.
  • LoongCollector'ın SLS'ye veri gönderme oranı saniyede 10 MB'yi aşıyor.

    CloudLens for SLS hizmetini etkinleştirin ve Collection Monitoring altında geçerli ana bilgisayarın toplama oranını kontrol edin.

Çözüm

Yukarıda listelenen olası nedenlere göre dosya sayısını veya veri trafiğini ayarlayın. Bellek kullanımını azaltamıyor veya aktarım trafiğini düşüremiyorsanız toplama performansını ayarlamak için bkz. Toplama performansı yapılandırma planlaması.

Diğer yaygın yapılandırma dosyaları

Aşağıdakiler LoongCollector'ın çalışma zamanında kullandığı diğer yapılandırma ve bilgi dosyalarıdır:

LoongCollector toplama yapılandırma dosyası (user_log_config.json)

  • Açıklama: Bu dosya LoongCollector'ın SLS üzerinden aldığı toplama yapılandırma bilgilerini kaydeder. Dosya toplama yapılandırması güncellendiğinde her seferinde güncellenir. AccessKey ayrıntıları veya veritabanı parolaları gibi hassas bilgileri manuel olarak yapılandırmak dışında bu dosyayı değiştirmeyin.

  • Yol: /usr/local/ilogtail/user_log_config.json.

  • Senaryo: Bir toplama yapılandırmasının sunucuya teslim edilip edilmediğini onaylamak için bu dosyayı kontrol edin. Bu dosya mevcutsa ve içeriği SLS içindeki toplama yapılandırmasıyla eşleşiyorsa yapılandırma başarıyla teslim edilmiştir.

AppInfo kayıt dosyası (app_info.json)

  • Açıklama: app_info.json dosyası LoongCollector'ın başlatma zamanı, alınan IP adresi ve ana bilgisayar adı gibi bilgileri kaydeder. Bu dosya yalnızca kayıt amaçlıdır. Üzerinde yapılan herhangi bir değişiklik etkili olmaz.

  • Yol: /usr/local/ilogtail/app_info.json.

  • Senaryo: Toplama sırasında SLS tarafından tanımlanan sunucu IP bilgilerini görüntüleyerek SLS konsolundaki IP tabanlı makine grubundaki IP bilgileriyle eşleştiğini doğrulayın. Bu işlem genellikle IP tabanlı makine gruplarında heartbeat başarısızlıklarını çözmek için kullanılır.

    Sunucunun /etc/hosts dosyasında bir ana bilgisayar adı-IP eşlemesi ayarladıysanız eşlenen IP adresi otomatik olarak alınır. Ana bilgisayar adı eşlemesi ayarlanmamışsa ilk ağ arabirim kartının IP adresi otomatik olarak alınır. ilogtail_config.json içindeki working_ip parametresi ayarlanmışsa değeri sunucunun IP adresi olarak kullanılır.

LoongCollector çalışma zamanı günlüğü (loongcollector.LOG)

  • Açıklama: loongcollector.LOG dosyası LoongCollector'ın çalışma zamanı günlüklerini kaydeder. Günlük düzeyleri en düşükten en yükseğe doğru INFO, WARN ve ERROR şeklindedir.

  • Yol: /usr/local/ilogtail/loongcollector.LOG.

  • Senaryo: Bir toplama hatası oluşursa öncelikle hataları kontrol etmek için LoongCollector'ı Tanımlayın ve İzleyin bölümüne bakın. Ardından sorunu günlük toplama hata türlerine ve LoongCollector çalışma zamanı günlüğüne bakarak giderin.

Kullanıcı Kimliği dosyası

  • Açıklama: Bu dosya toplanan günlüklerin ait olduğu projenin Alibaba Cloud hesap kimliğini içerir. Dosya adı uzantı olmadan hesap kimliğidir. Bu hesabın bu sunucudan günlük erişim ve toplama iznine sahip olduğunu gösterir.

  • Yol: /etc/ilogtail/users/{Alibaba Cloud hesap kimliği}.

  • Senaryo: Yalnızca Alibaba Cloud olmayan ECS örneklerinden, kendi yönettiğiniz sunuculardan veya diğer cloud sağlayıcılarının sunucularından günlük toplarken bir kullanıcı kimliği yapılandırmanız gerekir. Birden fazla hesabın aynı sunucudan günlük toplaması gerekiyorsa o sunucuda birden fazla kullanıcı kimliği dosyası oluşturun.

Özel tanımlayıcı dosyası

  • Açıklama: Bu dosya özel bir tanımlayıcı yapılandırmak için kullanılır. Bu tanımlayıcı SLS'nin sunucudaki LoongCollector'ı keşfetmesine ve heartbeat kurmasına yardımcı olan özel tanımlayıcı makine grubu için içerik olarak kullanılır.

  • Yol: /etc/ilogtail/user_defined_id.

  • Senaryo: Bu yapılandırma özel tanımlayıcı makine grubu kullanırken gereklidir. Daha fazla bilgi için bkz. Bir makine grubunu LoongCollector toplama yapılandırmasıyla ilişkilendirme.

CheckPoint dosyası

  • Açıklama: Checkpoint mekanizması günlük bütünlüğünü sağlamak için geçerli toplama konumunu kaydeder.

  • Yol: Varsayılan yol /tmp/logtail_checkpoint şeklindedir.

  • Senaryo: Başlangıç parametresi dosyasını değiştirerek checkpoint dosyasını yönetin. Daha fazla bilgi için bkz. Sınırlar.

SSS

Sunucu internete bağlanamadığında nasıl yükseltme yapılır

  1. LoongCollector öğesini yükseltmeniz gereken sunucuda sistem mimarisini belirlemek için uname -m komutunu çalıştırın. Ardından genel ağa erişimi olan bir sunucuda ilgili komutu çalıştırın. ${region_id} ifadesini projenizin bölgesi ile değiştirin.

    • ARM mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;
    • x86-64 mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;
  2. Yükleme betiğini ve paketini LoongCollector öğesini yükseltmeniz gereken sunucuya kopyalayın ve ardından aşağıdaki komutu çalıştırın:

    chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;