Simple Log Service (SLS) DSL, Python tabanlıdır ve veri dönüştürme görevlerini basitleştirmek için 200'den fazla yerleşik işlev sağlar. Bu konuda DSL'in dil modları, işlev kategorileri ve çalışma ilkeleri açıklanmaktadır.
Dil modları
SLS DSL, Python ile uyumludur. Standart modda SLS DSL, Python'un bir alt kümesidir. Temel veri yapıları ve ifadeler dışındaki diğer tüm sözdizimi kuralları işlevler aracılığıyla uygulanır.
Kategori | Python sözdizimi | Standart mod |
Veri yapısı | Sayı, dize ve Boolean | Desteklenir.
|
Tuple, liste, küme ve sözlük | Desteklenir.
| |
Nesne | Yalnızca tablo ve datetime nesneleri gibi yerleşik genişletilmiş veri yapıları desteklenir. | |
Temel sözdizimi | Artı (+), eksi (-), çarpma (×) ve bölme (/) gibi operatörler | Kodda yalnızca |
Açıklamalar | Desteklenir. | |
Değişken atama | Desteklenmez. Değeri bir işlev çağrısı aracılığıyla aktarmanız gerekir. | |
Ön koşullar | Desteklenir. İşlevler: e_if, e_if_else ve e_switch. | |
Döngüler | Dolaylı olarak desteklenir. Döngüleri uygulamak için iç içe geçmiş yerleşik işlevler kullanmanız gerekir. Aşağıdaki örnek işlevler, bir dizideki öğelerin nasıl yineleneceğini gösterir: | |
İşlev | Python'un standart yerleşik işlevleri | Desteklenmez. Bunun yerine SLS DSL tarafından sağlanan 200'den fazla yerleşik işlevi kullanabilirsiniz. |
İşlev çağrıları | Desteklenir. Parametre açma kullanan işlev çağrıları desteklenmez. | |
def veya lambda gibi kullanıcı tanımlı işlevler | Desteklenmez. Ancak, herhangi bir kombinasyonda çağrılabilen 200'den fazla genel işlem ve ifade işlevi sunulur. | |
Modül | Python standart kitaplığının içe aktarılması ve kullanılması | Desteklenmez. |
İş parçacıkları ve işlemler oluşturma | Desteklenmez. | |
Üçüncü taraf kitaplıkların içe aktarılması | Desteklenmez. | |
Harici ağ bağlantısı veya harici komut çağrısı | Yerleşik kaynak bağlayıcılarını içerir. |
İşlev kategorileri
Standart modda SLS DSL, tüm işlemleri işlevleri çağırarak gerçekleştirir. DSL, 200'den fazla yerleşik işlev sunar; bu işlevler genel işlem işlevleri ve ifade işlevleri olarak sınıflandırılır.
-
Genel işlem işlevleri
Genel işlem işlevleri, günlükleri almak, işlemek ve döndürmek için kullanılır. Bir dönüştürme kuralındaki her adımı yalnızca genel işlem işlevleriyle oluşturabilirsiniz.
-
İfade işlevleri
Genel amaçlı işlevler belirli parametreleri kabul eder. Bunları birleştirerek çağırmak ve bir genel işlem işlevine parametre olarak iletmek daha esnek mantık tanımlamanızı sağlar.
Aşağıdaki tabloda iki işlev türünün yetenekleri karşılaştırılmaktadır.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Genel işlem işlevleri
Günlükleri kabul eden ve döndüren bir işlevdir.
Her adımın ilk satırına yalnızca bir genel işlem işlevi yerleştirilebilir.
SLS DSL'deki bir dönüştürme kuralı aşağıdaki sözdizimini kullanır:
GlobalFunction1(..parameters....)
GlobalFunction2(..parameters....)
GlobalFunction3(..parameters....)
GlobalFunction4(..parameters....)
Genel işlem işlevleri iki kategoriye ayrılır:
İşlevsel sınıflandırma | Açıklama | Örnek |
Akış kontrol işlevleri | Bu işlevler süreç akışını yönetir, günlükleri alır ve günlükleri işlemek için diğer işlevleri koşullu olarak çağırır. |
|
Olay işleme işlevleri | Bu işlevler günlükleri dönüştürür ve sıfır veya daha fazla günlük döndürür. | Aşağıda bir işlev örneği verilmiştir:
|
Dönüştürme mantığı:
-
Temel işleme
Veri dönüştürme özelliği, kaynağa ait Logstore'dan verileri akış biçiminde okur. Her günlüğü bir sözlük olarak dönüştürme kuralına iletir. Sistem daha sonra kuralda tanımlanan işlevlere göre günlük verilerini sırayla işler. Son olarak sistem, dönüştürme sonucunu hedef Logstore'a çıkarır.
NotBir günlüğün tüm alanları ve değerleri dize olarak gönderilir. Örneğin, ham günlük
{"__time__": "1234567", "__topic__": "", "k1": "test"}e_set("f1", 200)işlevi tarafından işlenir. İşlev, değeri 200 olanf1alanını ekler. İşlemeden sonra günlük şu hale gelir:{"__time__": "1234567", "__topic__": "", "k1": "test", "f1": "200"}. Bu günlükte hemf1alanı hem de 200 değeri dizedir.Bir dönüştürme kuralında belirtilen olay işleme işlevleri sırayla çağrılır. Her işlev bir günlük alır, onu işler ve ardından işlenen günlüğü döndürür.
Örneğin,
e_set("type", "test")işlevi bir günlüğe değeri test olantypealanını ekler. Sonraki işlev, değiştirilen günlüğü alır ve işler. -
Koşul değerlendirme
-
e_if: e_if işlevi, günlükleri işlemek için koşullu ifadeler eklemenizi sağlar. Bir günlük belirtilen koşulu karşılamazsa ilgili işlem atlanır. e_if işlevi
ifmantığını uygular.Örneğin,
e_if(e_match("status", "200"), e_regex("data", "ret: \d+", "result"))işlevistatusalanının değerinin 200 olup olmadığını denetler. Doğruysa işlev, belirtilen normal ifadeyi kullanarakdataalanındanresultalanını ayıklar. Aksi takdirde hiçbir işlem gerçekleştirilmez. e_if_else: Bu işlev,if_elseişlemine benzer şekilde çalışır.
-
-
İşleme sonlandırma
-
Bir dönüştürme kuralındaki bir adım günlük döndürmeyebilir; bu, günlüğün silindiği anlamına gelir.
Örneğin,
e_if(str_islower(v("result")), e_drop())işleviresultalanının değerinin küçük harfli bir dize olup olmadığını denetler. Doğruysa günlük silinir ve bu günlük üzerinde sonraki adımlar gerçekleştirilmez. Sistem otomatik olarak sonraki günlüğü işler. -
Bir günlüğün hedef logstore'a yazılması işlemeyi sonlandırır. Örneğin,
e_outputişlevi bir günlüğü hedef logstore'a yazar ve silerse bu günlük üzerinde sonraki adımlar gerçekleştirilmez.Note_coutputişlevi çıkış günlüğünü kopyalar ve sonraki adımları işlemeye devam eder.
-
-
Paralel bölme:
Bir dönüştürme kuralındaki bir adım birden çok günlük döndürebilir; bu, günlüğün bölündüğü anlamına gelir.
Örneğin,
e_split(data)işlevi bir günlüğüdataalanının değerine göre iki günlüğe böler.dataalanının değeri"abc, xyz"ise günlük iki günlüğe bölünür. Bir günlüktedataalanının değeri abc olur. Diğer günlükte ise değer xyz olur.Bölme işleminden sonra oluşturulan günlükler sonraki adımlarda işlenir.
Daha fazla bilgi için bkz. Genel işlem işlevleri.
İfade işlevleri
SLS DSL, genel işlem işlevlerine ek olarak belirli parametreleri kabul eden ve belirli değerler döndüren 200 ifade işlevi sağlar. Bir ifade işlevini veya ifade işlevlerinin bir kombinasyonunu bir genel işlem işlevi içinde çağırın. Sözdizimi aşağıdaki gibidir:
Global Processing Function 1(Expression Function 1(...), ...)
Global Processing Function 2(..., Expression Function 2(...), Expression Function 3(...), ...)
İfade işlevleri dört kategoriye ayrılır:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Daha fazla bilgi için bkz. İfade işlevleri.