Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Veri filtreleme eklentisi

Son Güncelleme:Oct 01, 2026

Veri filtreleme eklentisi, belirtilen koşullara göre hangi günlük kayıtlarının toplanacağını belirler.

Veri filtreleme eklentisine genel bakış

Log Service birkaç veri filtreleme eklentisi sunar. Gereksinimlerinize göre birini seçin.

Eklenti adı

Tür

Açıklama

Filtreleme işleyicisi

yerleşik

Yalnızca alan değerinin belirtilen izin listesindeki desenle tam olarak eşleştiği günlükleri toplar.

filter_regex

özel

Aşağıdaki filtreleme modlarını destekler:

  • Düzenli ifade filtresi (değere göre): Alan değerini eşleştirmek için düzenli ifade kullanır. Hangi günlüklerin toplanacağını veya atılacağını belirtmek üzere bir toplama koşulu ile bir atma koşulunu birleştirebilirsiniz.

  • Düzenli ifade filtresi (anahtara göre): Alan adını (anahtar) eşleştirmek için düzenli ifade kullanır ve belirtilen alanın varlığına göre günlükleri filtreler.

Giriş noktası

Günlük işlemesi için bir Logtail eklentisi kullanmak amacıyla, Logtail yapılandırmasını oluştururken veya değiştirirken bu eklentiyi ekleyin. Daha fazla bilgi için bkz. Genel Bakış.

Yerleşik ve özel eklentiler arasındaki farklar

Yerleşik eklentiler: Yüksek performans için C++ ile uygulanmıştır.

Özel eklentiler: Esneklik ve zengin bir ekosistem sağlamak için Go ile uygulanmıştır. Hizmet günlükleriniz yerleşik eklentiler için çok karmaşıksa özel bir eklenti kullanmayı düşünün.

  • Özel eklentilerin performans sınırlamaları

    • Günlükleri işlemek için özel bir eklenti kullanmak, öncelikli olarak CPU olmak üzere daha fazla LoongCollector kaynağı tüketir. Gerekirse LoongCollector parametre ayarlarını değiştirmek için yapılandırma yönetimi özelliğini kullanabilirsiniz.

    • Ham veri oluşturma hızı 5 MB/sn'yi aşarsa karmaşık eklenti kombinasyonlarından kaçının. Bunun yerine, basit işlemeler için özel bir eklenti kullanın ve gelişmiş işlemeler için veri dönüşümü uygulayın.

  • Günlük toplama sınırlamaları

    • Özel eklentiler, satır modundaki metin günlüklerini işler ve dosya düzeyindeki meta verileri (örneğin __tag__:__path__ ve __topic__) her günlük girişinde depolar.

    • Özel bir eklenti eklemek etiketle ilgili özellikleri etkiler:

      • Bağlam sorgusu ve LiveTail özelliği kullanılamaz. Bu özellikleri kullanmak için bir aggregators yapılandırması eklemeniz gerekir.

      • __topic__ alanı __log_topic__ olarak yeniden adlandırılır. Bir aggregators yapılandırması eklerseniz günlüklerde hem __topic__ hem de __log_topic__ alanları bulunur. __log_topic__ alanına ihtiyacınız yoksa bunu silmek için processor_drop eklentisini kullanabilirsiniz.

      • __tag__:__path__ gibi alanların artık yerleşik bir alan dizini yoktur. Bunlar için alan dizini oluşturmanız gerekir.

Yerel filtre eklentisi

Yerel filtre eklentisi, günlükleri alan değerlerine göre filtreler.

Yapılandırma

Parametre

Açıklama

Whitelist

Belirli koşulları karşılayan yalnızca günlükleri toplamak için bir izin listesi tanımlayın. Hedef alan adını ve filtreleme için bir düzenli ifade belirtmeniz gerekir. Düzenli ifadenin tüm dizeyle eşleşmesi gerekir. Kısmi eşleşmeler desteklenmez. Düzenli ifade yazma hakkında ayrıntılı bilgi için bkz. Düzenli İfade Öğreticisi.

İzin listesindeki birden çok koşul mantıksal VE ile birleştirilir. Aşağıda örnekler verilmiştir:

  • Bir koşulu karşılayan günlükleri toplama

    • Field Name öğesini level ve Field Value öğesini WARNING|ERROR olarak ayarlayın. Bu yapılandırma, yalnızca level alan değeri WARNING veya ERROR olan günlükleri toplar.

    • Field Name öğesini content ve Field Value öğesini .05\/Jan\/2023. olarak ayarlayın. Bu yapılandırma, yalnızca content alan değeri 05/Jan/2023 içeren günlükleri toplar.

  • Bir koşula göre günlükleri atma

    • Field Name öğesini level ve Field Value öğesini ^(?!.(INFO|DEBUG)). olarak ayarlayın. Bu yapılandırma, level alan değeri INFO veya DEBUG içeren günlükleri atar.

    • Field Name öğesini level ve Field Value öğesini ^(?!(INFO|DEBUG)$).* olarak ayarlayın. Bu yapılandırma, level alan değeri tam olarak INFO veya DEBUG olan günlükleri atar.

    • Field Name öğesini url ve Field Value öğesini .^(?!.(healthcheck)).* olarak ayarlayın. Bu yapılandırma, url alan değeri healthcheck içeren günlükleri atar.

Günlük filtreleme eklentileri (gelişmiş)

Günlükleri filtrelemek için processor_filter_regex eklentisini veya processor_filter_key_regex eklentisini kullanın. Bu konuda her bir eklenti için parametreler açıklanmakta ve yapılandırma örnekleri sunulmaktadır.

Sınırlamalar

  • Form tabanlı yapılandırma yalnızca metin günlükleri ve konteyner standart çıkışı için kullanılabilir. Diğer tüm kaynaklar için JSON tabanlı yapılandırmayı kullanmanız gerekir.

  • Go düzenli ifade motoru RE2 temel alınarak oluşturulmuştur ve PCRE motoruna kıyasla aşağıdaki sınırlamalara sahiptir:

    • Adlı yakalama gruplarında sözdizimi farklılıkları

      Go, (?P<name>...) sözdizimini kullanırken PCRE (?<name>...) sözdizimini kullanır.

    • Desteklenmeyen düzenli ifade desenleri

      • Lookaround (İleri/Geri bakış): (?=...), (?!...), (?<=...) ve (?<!...).

      • Koşullu ifadeler: (?(condition)true|false).

      • Özyinelemeli eşleşme: (?R) ve (?0).

      • Alt yordam referansları: (?&name) ve (?P>name).

      • Atomik gruplar: (?>...).

    Regex101 gibi araçlarla düzenli ifadelerde hata ayıklarken, işleme hatalarını önlemek için yukarıda listelenen desteklenmeyen desenlerden kaçının.

processor_filter_regex (Değere göre filtreleme)

Günlük alan değerlerini düzenli ifadelerle eşleştirerek günlükleri filtreler.

Form

  • Parametreler

    processor type seçeneğini Filter Logs with Regular Expression (Match Log Field Values) olarak ayarlayın. Aşağıdaki tabloda parametreler açıklanmaktadır.

    Not

    Logtail, bir günlüğün alan değerleri Collect Logs bölümündeki tüm koşulları karşılıyor ve Drop Log bölümündeki koşulların hiçbirini karşılamıyorsa o günlüğü toplar. Aksi takdirde Logtail günlüğü atar.


    Parametre


    Açıklama


    Collect Logs

    Bir günlük alan adı ve bu alanın değerinin eşleşmesi gereken bir düzenli ifade girin. Ham günlükteki alanın değeri ifadeyle eşleşiyorsa günlük toplanır.

    Birden çok anahtar-değer çifti ekleyebilirsiniz. Bu çiftler mantıksal VE ile birleştirilir.


    Drop Log

    Bir günlük alan adı ve bu alanın değerinin eşleşmesi gereken bir düzenli ifade girin. Alanın değeri ifadeyle eşleşiyorsa günlük atılır.

    Birden çok anahtar-değer çifti ekleyebilirsiniz. Bu çiftler mantıksal VEYA ile birleştirilir.

  • Yapılandırma örneği

    Yalnızca ip değeri 10 ile başlayan, method değeri POST olan ve browser değeri aliyun.* ile eşleşmeyen günlükleri toplamak için aşağıdaki yapılandırmayı kullanın:

    • Ham günlükler

      • Günlük 1

        "ip" : "10.**.**.**"
        "method" : "POST"
        "browser" : "aliyun-sdk-java"
      • Günlük 2

        "ip" : "10.**.**.**"
        "method" : "POST"
        "browser" : "chrome"
      • Günlük 3

        "ip" : "192.168.*.*"
        "method" : "POST"
        "browser" : "ali-sls-ilogtail"
    • Logtail eklenti yapılandırması

      İşlemci türünü Düzenli İfadeler Kullanarak Günlükleri Filtrele (Günlük Alan Değerlerini Eşleştir) olarak ayarlayın. Toplanacak Günlükler bölümünde method alanı (POST) ve ip alanı (10\..*) için kurallar ekleyin. Atılacak Günlükler bölümünde browser alanı (aliyun.*) için bir kural ekleyin.

    • İşleme sonuçları


      Günlük


      Toplandı


      Neden


      Günlük 1


      Hayır


      browser alanının değeri, Drop Log bölümündeki düzenli ifadeyle eşleşiyor.


      Günlük 2


      Evet


      Günlük filtreleme kriterlerini karşılıyor.


      Günlük 3


      Hayır


      ip alanının değeri, Collect Logs bölümündeki düzenli ifadeyle eşleşmiyor.

JSON

  • Parametreler

    type değerini processor_filter_regex olarak ayarlayın. Aşağıdaki tabloda detail nesnesindeki parametreler açıklanmaktadır.

    Not

    Logtail, bir günlüğün alan değerleri Include içindeki tüm düzenli ifadelerle eşleşiyor ve Exclude içindekilerden hiçbiriyle eşleşmiyorsa o günlüğü toplar. Aksi takdirde Logtail günlüğü atar.


    Parametre


    Tür


    Gerekli


    Açıklama


    Include


    JSON Nesnesi


    Hayır


    Her anahtarın bir günlük alan adı olduğu ve değerin o alanın değerini eşleştiren bir düzenli ifade olduğu bir harita belirtir. Bu çiftler mantıksal VE ile birleştirilir.


    Exclude


    JSON Nesnesi


    Hayır


    Her anahtarın bir günlük alan adı olduğu ve değerin o alanın değerini eşleştiren bir düzenli ifade olduğu bir harita belirtir. Bu çiftler mantıksal VEYA ile birleştirilir. Herhangi bir alanın değeri karşılık gelen ifadeyle eşleşirse günlük atılır.

  • Yapılandırma örneği

    Yalnızca ip değeri 10 ile başlayan, method değeri POST olan ve browser değeri aliyun.* ile eşleşmeyen günlükleri toplamak için aşağıdaki yapılandırmayı kullanın:

    • Ham günlükler

      • Günlük 1

        "ip" : "10.**.**.**"
        "method" : "POST"
        "browser" : "aliyun-sdk-java"
      • Günlük 2

        "ip" : "10.**.**.**"
        "method" : "POST"
        "browser" : "chrome"
      • Günlük 3

        "ip" : "192.168.*.*"
        "method" : "POST"
        "browser" : "ali-sls-ilogtail"
    • Logtail eklenti yapılandırması

      {
         "type" : "processor_filter_regex",
          "detail" : {
               "Include" : {
                  "ip" : "10\..*",
                  "method" : "POST"
               },
               "Exclude" : {
                  "browser" : "aliyun.*"
               }
          }
      }
    • İşleme sonuçları


      Günlük


      Toplandı


      Neden


      Günlük 1


      Hayır


      browser alanının değeri, Exclude içindeki düzenli ifadeyle eşleşiyor.


      Günlük 2


      Evet


      Günlük filtreleme kriterlerini karşılıyor.


      Günlük 3


      Hayır


      ip alanının değeri, Include içindeki düzenli ifadeyle eşleşmiyor.

processor_filter_key_regex (Anahtara göre filtreleme)

Günlük alan adlarını düzenli ifadelerle eşleştirerek günlükleri filtreler.

Form

  • Parametreler

    processor type seçeneğini Filter Logs with Regular Expression (Match Log Field Names) olarak ayarlayın. Aşağıdaki tabloda parametreler açıklanmaktadır.

    Not

    Logtail, bir günlüğün alan adları Collect Logs bölümünde tanımlanan tüm koşulları karşılıyor ve Drop Log bölümündeki koşulların hiçbirini karşılamıyorsa o günlüğü toplar. Aksi takdirde Logtail günlüğü atar.


    Parametre


    Açıklama


    Collect Logs


    Günlük alan adlarını eşleştirmek için bir veya daha fazla düzenli ifade girin. Bir günlük, belirtilen tüm ifadelerle eşleşen alan adlarını içeriyorsa toplanır; bu mantıksal VE anlamına gelir.


    Drop Log


    Günlük alan adlarını eşleştirmek için bir veya daha fazla düzenli ifade girin. Bir günlük, belirtilen herhangi bir ifadeyle eşleşen bir alan adı içeriyorsa atılır; bu mantıksal VEYA anlamına gelir.

  • Yapılandırma örneği

    request ile başlayan bir alan adı içeren günlükleri toplamak için aşağıdaki yapılandırmayı kullanın:

    • Ham günlükler

      • Günlük 1

        "request_time" : 20
        "request_length": 2314
        "request_method" : "POST"
        "browser" : "aliyun-sdk-java"
      • Günlük 2

        "request_time" : 70
        "request_method" : "GET"
        "ip" : "192.168.**.**"
      • Günlük 3

        "browser" : "ali-sls-ilogtail"
        "status" : 200
    • İşlemci türünü Düzenli İfadeler Kullanarak Günlükleri Filtrele (Günlük Alan Adlarını Eşleştir) olarak ayarlayın. Toplanacak Günlükler bölümünde request.* düzenli ifadesini ekleyin ve Atılacak Günlükler bölümünü boş bırakın.

    • İşleme sonuçları


      Günlük


      Toplandı


      Neden


      Günlük 1


      Evet


      request_time, request_length ve request_method alan adları, Collect Logs bölümündeki düzenli ifadeyle eşleşiyor.


      Günlük 2


      Evet


      request_time ve request_method alan adları, Collect Logs bölümündeki düzenli ifadeyle eşleşiyor.


      Günlük 3


      Hayır


      Günlük, Collect Logs bölümündeki düzenli ifadeyle eşleşen herhangi bir alan adı içermiyor.

JSON

  • Parametreler

    type değerini processor_filter_key_regex olarak ayarlayın. Aşağıdaki tabloda detail nesnesindeki parametreler açıklanmaktadır.

    Not

    Logtail, bir günlüğün alan adları Include içinde tanımlanan tüm koşulları karşılıyor ve Exclude içindeki koşulların hiçbirini karşılamıyorsa o günlüğü toplar. Aksi takdirde Logtail günlüğü atar.


    Parametre


    Tür


    Gerekli


    Açıklama


    Include


    dizi[]


    Hayır


    Günlük alan adları için düzenli ifadelerden oluşan bir dizi. Bu ifadeler mantıksal VE ile birleştirilir; yani bir günlük, dizideki tüm ifadelerle eşleşen alan adlarını içeriyorsa toplanır.


    Exclude


    dizi[]


    Hayır


    Günlük alan adları için düzenli ifadelerden oluşan bir dizi. Bu ifadeler mantıksal VEYA ile birleştirilir; yani bir günlük, dizideki herhangi bir ifadeyle eşleşen bir alan adı içeriyorsa atılır.

  • Yapılandırma örneği

    request ile başlayan bir alan adı içeren günlükleri toplamak için aşağıdaki yapılandırmayı kullanın:

    • Ham günlükler

      • Günlük 1

        "request_time" : 20
        "request_length": 2314
        "request_method" : "POST"
        "browser" : "aliyun-sdk-java"
      • Günlük 2

        "request_time" : 70
        "request_method" : "GET"
        "ip" : "192.168.**.**"
      • Günlük 3

        "browser" : "ali-sls-ilogtail"
        "status" : 200
    • Logtail eklenti yapılandırması

      {
         "type" : "processor_filter_key_regex",
          "detail" : {
               "Include" : [
                  "request.*"
               ]
          }
      }
    • İşleme sonuçları


      Günlük


      Toplandı


      Neden


      Günlük 1


      Evet


      request_time, request_length ve request_method alan adları, Include içindeki düzenli ifadeyle eşleşiyor.


      Günlük 2


      Evet


      request_time ve request_method alan adları, Include içindeki düzenli ifadeyle eşleşiyor.


      Günlük 3


      Hayır


      Günlük, Include içindeki düzenli ifadeyle eşleşen herhangi bir alan adı içermiyor.

İlgili Konular