Bu konuda alan işleme işlevlerinin sözdizimi, parametreleri ve örnekleri açıklanmaktadır.
İşlev listesi
|
|
|
|
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. |
|
|
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. |
|
|
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. |
|
|
|
|
|
|
|
|
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şlevdefaultdeğ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
contentalanının değerinitest_contentalanı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")Önemlikey1 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.
NotAktarı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.
-
event_type alanının değerini ayarlayın.
e_set("event_type", "login event", "event_info", "login host") -
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
EvetGü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.
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
EvetGü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)Notkey ve new key parametreleri çiftler halinde belirtilmelidir.
new keykaynak günlükte zaten varsa işlem yapılmaz. -
Parametreler
Parametre
Parametre türü
Zorunlu
Açıklama
key
Dize
EvetGü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.
-