Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Alan işleme işlevleri

Son Güncelleme:Sep 30, 2026

Bu konuda alan işleme işlevlerinin sözdizimi, parametreleri ve örnekleri açıklanmaktadır.

İşlev listesi


İşlev


Açıklama


v

Belirli bir günlük alanının değerini alır. Birden fazla alan adı belirtirseniz işlev, günlükte bulunan ilk alanın değerini döndürür.

Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.


e_set

Yeni bir alan ekler veya mevcut bir alan için yeni bir değer ayarlar.

Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.


e_drop_fields

Belirtilen koşulları karşılayan günlük alanlarını siler.

Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. Karmaşık JSON verilerini dönüştürme.


e_keep_fields


Belirtilen koşulları karşılayan günlük alanlarını korur.


e_pack_fields


Günlük alanlarını paketler ve bunları yeni bir alana çıkarır.


e_rename

Belirtilen koşulları karşılayan günlük alanlarını yeniden adlandırır.

Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.

v

v işlevini çağırarak belirli bir günlük alanının değerini alabilirsiniz. Birden fazla alan adı belirtirseniz işlev, günlükte bulunan ilk alanın değerini döndürür.

  • Sözdizimi

    v(key, ..., default=None)
  • Parametreler


    Parametre


    Parametre Türü


    Zorunlu


    Açıklama


    key


    Dize


    Evet


    Alan adını girin.


    default


    Herhangi bir tür


    Hayır


    Belirtilen alan adı yoksa işlev default değerini döndürür. Varsayılan değer None değeridir.

  • Yanıt

    Günlükteki ilk mevcut alanın değerini döndürür. Belirtilen alanların hiçbiri mevcut değilse işlev default parametresinin değerini döndürür.

  • Örnekler

    content alanının değerini test_content alanına atayın.

    • Ham günlük

      content: hello
    • Dönüşüm kuralı

      e_set("test_content", v("content"))
    • Sonuç

      content: hello
      test_content: hello
  • İlgili Başlıklar

    Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.

e_set

e_set işlevini çağırarak yeni bir alan ekleyebilir veya mevcut bir alan için yeni bir değer ayarlayabilirsiniz.

  • Sözdizimi

    e_set(key1, value1, key2, value2, mode="overwrite")
    Önemli
    • key1 ve value1 parametreleri çiftler halinde belirtilmelidir.

    • e_set işlevini F_TIME veya __time__ gibi bir zaman alanı ayarlamak için kullanırken değer sayısal bir dize olmalıdır.

      e_set(F_TIME, "abc")   # Incorrect
      e_set(F_TIME, "12345678")   # Correct
  • Parametreler

    Parametre

    Parametre türü

    Zorunlu

    Açıklama

    key

    Dize

    Evet

    Hedef alanın adı. Alan adını bir dize ifadesinden de alabilirsiniz. Özel alan adlarının nasıl ayarlanacağı hakkında daha fazla bilgi için bkz. Olay türleri.

    value

    Herhangi bir tür

    Evet

    Yeni alan değeri. Dize olmayan değerler dizeye dönüştürülerek günlüğe eklenir. Demetler, listeler ve sözlükler JSON nesne dizelerine dönüştürülür. Dize dönüştürme hakkında daha fazla bilgi için bkz. Atama sırasında otomatik tür dönüştürme.

    Not

    Aktarılan değer None ise güncelleme yapılmaz.

    mode

    Dize

    Hayır

    Alan üzerine yazma modu. Varsayılan değer overwrite değeridir. Daha fazla bilgi için bkz. Alan çıkarma kontrolü ve üzerine yazma modları.

  • Yanıt

    Güncellenmiş günlüğü döndürür.

  • Örnekler

    • Örnek 1: Bir alan için statik bir değer ayarlama.

      city adında yeni bir alan ekleyin ve değerini Shanghai olarak ayarlayın.

      e_set("city", "Shanghai")
    • Örnek 2: Bir alan değerini kopyalama.

      Mevcut ret alanının değerini yeni result alanına atamak için tek bir ifade işlevi çağırabilirsiniz.

      e_set("result", v("ret"))
    • Örnek 3: Dinamik bir değer ayarlama.

      İlk mevcut alanın değerini almak, küçük harfe dönüştürmek ve result alanına atamak için bileşik bir ifade işlevi çağırabilirsiniz.

      e_set("result", str_lower(v("ret", "return")))
    • Örnek 4: Bir alan değerini birden çok kez ayarlama.

      1. event_type alanının değerini ayarlayın.

        e_set("event_type", "login event", "event_info", "login host")
      2. ret alanının değeri fail ise event_type alanının değerini login failed event olarak ayarlayın.

        e_if(e_search('ret==fail'), e_set("event_type", "login failed event" ))
    • İlgili Başlıklar

      Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.

e_drop_fields

e_drop_fields işlevini çağırarak belirtilen koşulları karşılayan günlük alanlarını silebilirsiniz.

  • Sözdizimi

    e_drop_fields(key1, key2, ....,regex=False)
  • Parametreler


    Parametre


    Parametre türü


    Zorunlu


    Açıklama


    key


    Dize


    Evet

    Günlük alanı adı. Düzenli ifade olabilir. Alan adı koşul ile tam eşleşirse alan silinir. Eşleşmeyen alanlar korunur. Düzenli ifadeler hakkında daha fazla bilgi için bkz. Düzenli ifadeler.

    En az bir günlük alanı yapılandırmalısınız.


    regex


    Boole


    Hayır


    Bu parametre False olarak ayarlanırsa eşleştirme için düzenli ifadeler kullanılmaz. Bu parametre yapılandırılmazsa varsayılan değer True olur.

  • Yanıt

    Silinen günlüğü döndürür.

  • Örnekler

    content alanının değeri 123 ise content ve age alanlarını silin.

    • Ham günlük

      age: 18
      content: 123
      name: twiss
    • Dönüşüm kuralı

      e_if(e_search("content==123"), e_drop_fields("content", "age",regex=True))
    • Sonuç

      name: twiss
  • İlgili Başlıklar

    Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. Karmaşık JSON verilerini dönüştürme.

e_keep_fields

e_keep_fields işlevini çağırarak belirtilen koşulları karşılayan günlük alanlarını koruyabilirsiniz.

Not

Simple Log Service, __time__ ve __topic__ gibi yerleşik meta veri alanları içerir. e_keep_fields işlevini çağırırken __time__ alanını korumazsanız günlük saati geçerli sistem saatine sıfırlanır. Meta veri alanlarının değerlerinin sıfırlanmasını önlemek için bunları listeye eklemeniz gerekir. Yaygın biçim F_TIME, F_META, F_TAGS, "f1", "f2" şeklindedir. Daha fazla bilgi için bkz. Sabit tanımlayıcılar.

  • Sözdizimi

    e_keep_fields(key1, key2, ....,regex=False)
  • Parametreler


    Parametre


    Parametre türü


    Zorunlu


    Açıklama


    key


    Dize


    Evet

    Günlük alanı adı. Düzenli ifade olabilir. Alan adı koşul ile tam eşleşirse alan korunur. Eşleşmeyen alanlar silinir.

    En az bir alan yapılandırmalısınız.


    regex


    Boole


    Hayır


    Bu parametre False olarak ayarlanırsa eşleştirme için düzenli ifadeler kullanılmaz. Bu parametre yapılandırılmazsa varsayılan değer True olur.

  • Yanıt

    Korunan günlükler döndürülür.

  • Örnekler

    content alanının değeri 123 ise content ve age alanlarını koruyun.

    • Ham günlük

      age: 18
      content: 123
      name: twiss
    • Dönüşüm kuralı

      e_if(e_search("content==123"), e_keep_fields("content", "age"))
    • Sonuç

      age: 18
      content: 123

e_pack_fields

e_pack_fields işlevini çağırarak günlük alanlarını paketleyip bunları yeni bir alana çıkarabilirsiniz.

  • Sözdizimi

    e_pack_fields(output_fields,include=".*",exclude=None,drop_packed=True)
  • Parametreler

    Parametre

    Tür

    Zorunlu

    Açıklama

    output_field

    Dize

    Evet

    Paketlemeden sonraki çıktı alanının adı. Değeri JSON biçimindedir.

    include

    Dize

    Hayır

    İzin listesi yapılandırması. Düzenli ifadeyle eşleşen alanlar paketlenir. Varsayılan değer ".*" olup tüm alanların eşleştiğini gösterir. Daha fazla bilgi için bkz. Düzenli ifadeler.

    exclude

    Dize

    Hayır

    Engelleme listesi yapılandırması. Düzenli ifadeyle eşleşen alanlar paketlenmez. Varsayılan değer None olup eşleştirme yapılmadığını gösterir. Daha fazla bilgi için bkz. Düzenli ifadeler.

    drop_packed

    Boole

    Hayır

    Orijinal paketlenmiş verilerin silinip silinmeyeceğini belirtir. Varsayılan değer True değeridir.

    • True (varsayılan): Orijinal paketlenmiş veriler çıktıda silinir.

    • False: Orijinal paketlenmiş veriler çıktıda silinmez.

  • Yanıt

    Paketlenen günlük verilerini döndürür.

  • Örnekler

    • Örnek 1: Tüm günlük alanlarını test alanında paketleyin. Varsayılan olarak orijinal paketlenmiş alanlar silinir.

      • Ham günlük

        test1:123
        test2:456
        test3:789
      • Dönüşüm kuralı

        e_pack_fields("test")
      • Sonuç

        test:{"test1": "123", "test2": "456", "test3": "789"}
    • Örnek 2: Tüm günlük alanlarını test alanında paketleyin. Orijinal paketlenmiş alanlar silinmez.

      • Ham günlük

        test1:123
        test2:456
        test3:789
      • Dönüşüm kuralı

        e_pack_fields("test",drop_packed=False)
      • Sonuç

        test:{"test1": "123", "test2": "456", "test3": "789"}
        test1:123
        test2:456
        test3:789
    • Örnek 3: test ve abcd alanlarını content alanında paketleyin. Orijinal paketlenmiş alanlar silinmez.

      • Ham günlük

        abcd@#%:123
        test:456
        abcd:789
      • Dönüşüm kuralı

        e_pack_fields("content", include="\w+", drop_packed=False)
      • Sonuç

        abcd:789
        abcd@#%:123
        content:{"test": "456", "abcd": "789"}
        test:456
    • Örnek 4: test ve abcd dışındaki tüm alanları content alanında paketleyin. Orijinal paketlenmiş alanlar silinir.

      • Ham günlük

        abcd@#%:123
        test:456
        abcd:789
      • Dönüşüm kuralı

        e_pack_fields("content", exclude="\w+", drop_packed=True)
      • Sonuç

        abcd:789
        content:{"abcd@#%": "123"}
        test:456

e_rename

e_rename işlevini çağırarak belirtilen koşulları karşılayan günlük alanlarını yeniden adlandırabilirsiniz.

  • Sözdizimi

    e_rename("key1", "new key1", "key2", "new key2", ..., regex=False)
    Not

    key ve new key parametreleri çiftler halinde belirtilmelidir. new key kaynak günlükte zaten varsa işlem yapılmaz.

  • Parametreler


    Parametre


    Parametre türü


    Zorunlu


    Açıklama


    key


    Dize


    Evet

    Günlük alanı adı. Düzenli ifade olabilir. Alan adı koşul ile tam eşleşirse alan yeniden adlandırılır. Düzenli ifadeler hakkında daha fazla bilgi için bkz. Düzenli ifadeler.

    En az bir alan yapılandırmalısınız.


    new key


    Dize


    Evet


    Alanın yeni adı.


    regex


    Boole


    Hayır


    Bu parametre False olarak ayarlanırsa eşleştirme için düzenli ifadeler kullanılmaz. Bu parametre yapılandırılmazsa varsayılan değer True olur.

  • Yanıt

    Yeniden adlandırılan alan döndürülür.

  • Örnekler

    • Örnek 1: host alanını client_host olarak yeniden adlandırın.

      • Ham günlük

        host: 1006
      • Dönüşüm kuralı

        e_rename("host","client_host")
      • Sonuç

        client_host: 1006
    • Örnek 2: Alan mevcut değilse yeniden adlandırılmaz.

      • Ham günlük

        host: 1006
      • Dönüşüm kuralı

        e_rename("url","rename_url")
      • Sonuç

        host: 1006
    • İlgili Başlıklar

      Bu işlev diğer işlevlerle birlikte kullanılabilir. Daha fazla bilgi için bkz. İşlev çağırarak verileri temizleme.