Application Real-Time Monitoring Service:ARMS convergence policies

Spring ek açıklamasına dayalı yakınsama

Yol değişkenleri içeren RESTful API'lerde ham istek URL'lerinin boyut değeri olarak kullanılması ıraksamaya neden olur. ARMS, Spring yönlendirme ek açıklamalarından (örneğin @RequestMapping) yol bilgilerini okur ve bunun yerine ek açıklamasında tanımlanan yolu boyut değeri olarak kullanır.

Örnek

Aşağıdaki APIController bir yol değişkeni kullanarak kullanıcı bilgilerini alan bir RESTful uç noktası tanımlar. @RequestMapping("/api/v1/user/{userId}/info") ek açıklaması URL desenini belirtir.

@RestController
@RequestMapping("/api/v1")
public class APIController {

    @RequestMapping("/user/{userId}/info")
    public String getUserInfo(@PathVariable("userId") String userId) {
        return "hello " + userId;
    }
}

Sonuç: /api/v1/user/1234/info değeri /api/v1/user/{userId}/info olarak yakınsanır.

Bellek istatistiğine dayalı yakınsama

Spring Web çerçevesini kullanmayan uygulamalar veya ek açıklamasına dayalı yakınsamanın başarısız olduğu durumlarda ARMS, bellek istatistiğine dayalı yakınsamaya geri döner.

Örnek

Bir uygulama /api/v1/user/${userId}/info URL şablonunu sağlar. Bellek istatistikleri modülü kullanıcı kimliklerinde ıraksama tespit eder ve URL'yi /api/v1/user/*/info olarak yakınsar.

Özel yakınsama

URL'leri normal ifadelere göre eşleştirmek ve bunları belirtilen bir hedefle değiştirmek için özel yakınsama kuralları tanımlayın.

Örnek

Özel kural: /api/v1/user/[\d]+/info ile eşleşen tüm URL'leri /api/v1/getUserInfo olarak yakınsa.

Sonuç: /api/v1/user/[\d]+/info normal ifadesiyle eşleşen tüm URL'ler /api/v1/getUserInfo olarak yakınsanır.

Statik kaynak yakınsaması

ARMS aracının bazı eski sürümleri statik kaynaklar için ölçümleri izler. Statik kaynak URL'leri sık sık değiştiğinden bu ölçümler için yakınsama varsayılan olarak etkindir.

Varsayılan statik kaynak uzantıları:

.log .7z .tgz .jpg .jpeg .png .gif .css .js .ico .woff2 .xml .svg .pdf .txt .text .ppt .word .xlsx .tar.gz .tar.bz2 .sh .yml .yaml .zip .gz .ttf .woff .eot .rar .properties

Örnek

Varsayılan olarak /api/v1/hello.jpg değeri {ARMS_STATIC_REQ} olarak yakınsanır. Gelişmiş yapılandırma etkinleştirildiğinde ise {ARMS_S_JPG} olarak yakınsanır.

Siber saldırı isteği yakınsaması

Hizmetler siber saldırı istekleri alabilir (örneğin /etc/passwd dosyasını okuma girişimleri). Bu istekler saldırganlar tarafından hazırlanır ve sık sık değişir. Tümünün kaydedilmesi depolama kaynaklarını zorlar.

Varsayılan karakterler: ' $ \ ' !

Örnek

/app/v1/user/info?cmd='more /etc/passwd' değeri {ARMS_ATTACK_REQ} olarak yakınsanır.

Sorgu parametresi yakınsaması

Varsayılan olarak ARMS aracı URL'leri toplarken sorgu parametrelerini yakalamaz. Ancak bazı URL'ler ıraksamaya neden olabilecek sorgu parametreleri içerir.

Varsayılan sorgu parametresi ayraçları: ; ? &

Örnek

Varsayılan olarak /api/v1/user/info?userId=12345 değeri {ARMS_PARAMED_REQ} olarak yakınsanır. Gelişmiş yapılandırma etkinleştirildiğinde ise /api/v1/user/info?{ARMS_REQ_PARAMS} olarak yakınsanır.

Anlamsız sözcük yakınsaması

Aşırı uzun kelimeler veya rakam dizileri içeren URL'lerin ıraksama olasılığı yüksektir. ARMS, belirtilen uzunluk eşiklerini aşan yol segmentlerini değiştirir.

Örnek

/api/2024040710/hello2024040710 değeri /api/{ARMS_NUMBER}/{ARMS_ANY} olarak yakınsanır.

Akıllı yakınsama

Önceki ilkeler uygulandıktan sonra bazı ıraksayan URL'ler kalabilir. ARMS, bu URL'leri işlemek için algoritmalar kullanarak periyodik olarak yakınsama kuralları oluşturur.

Örnek

/api/product/1/info
/api/product/2/info
....
/api/product/N/info

Sunucu bu URL'leri /api/product/[\d]+/info normal ifadesini kullanarak eşleştirir ve /api/product/{ARMS_NUMBER}/info olarak yakınsar.

SQL normalizasyonu

ARMS aracı; parçalama, ek açıklamaları veya satır içi değişmez değerler nedeniyle çok sayıda SQL deyimi toplayabilir. ARMS, her bir SQL deyimini ıraksayan değerleri değiştirerek normalize eder.

Örnek

select * from cache_0 where ckey='23'

Sonuç:

select * from cache_{NUM} where ckey=?

IP adresi yakınsaması

Uygulamanız IP adresleri üzerinden erişilen birçok harici hizmete bağlıysa ARMS aracı çok sayıda benzersiz IP adresi toplayarak ıraksamaya neden olabilir.

Örnek

1.1.1.1:8080
...
1.1.1.255:8080

Bu IP adresleri {ARMS_IP}:8080 olarak yakınsanır.

Kardinalite alanı yakınsaması

Önceki ilkeler URL'lerdeki yüksek kardinalite sorunlarının çoğunu çözer. Ancak SQL deyimleri ve diğer veri türleri için yine de çok sayıda boyut değeri kaydedilebilir. Bunu önlemek için ARMS, her zaman diliminde kaydedilen boyut değeri sayısını sınırlar.

Varsayılan saatlik eşikler

Örnek

Kardinalite alanı boyutunun saat başına 100 kayıt olarak ayarlandığını varsayalım. Harici hizmet adresleri:

www.a1.com
www.a2.com
....
www.a1000.com

Saat başına yalnızca ilk 100 adres kaydedilir. Sonraki adresler {ARMS_OTHERS} olarak yakınsanır.

V4.x öncesi ARMS aracı

Aracı tarafında:

• URL: Spring ek açıklamasına dayalı yakınsama > Bellek istatistiğine dayalı yakınsama

• SQL: Bellek istatistiğine dayalı yakınsama

• IP ve diğerleri: Bellek istatistiğine dayalı yakınsama

Sunucu tarafında:

• URL: Özel yakınsama > Siber saldırı isteği yakınsaması > Sorgu parametresi yakınsaması > Statik kaynak yakınsaması > Anlamsız sözcük yakınsaması > Akıllı yakınsama > Kardinalite alanı yakınsaması

• SQL: Özel yakınsama > Kardinalite alanı yakınsaması

• IP ve diğerleri: Özel yakınsama > IP adresi yakınsaması > Kardinalite alanı yakınsaması

ARMS aracı V4.x ve sonrası

Aracı tarafında:

• URL: Spring ek açıklamasına dayalı yakınsama > Özel yakınsama > Siber saldırı isteği yakınsaması > Sorgu parametresi yakınsaması > Statik kaynak yakınsaması > Anlamsız sözcük yakınsaması > Akıllı yakınsama > Kardinalite alanı yakınsaması

• SQL: Özel yakınsama > SQL normalizasyonu > Kardinalite alanı yakınsaması

• IP ve diğerleri: Özel yakınsama > IP adresi yakınsaması > Kardinalite alanı yakınsaması

Sunucu tarafında: Yok (tüm yakınsama işlemleri araçta çalışır).

Yakınsamadan önceki orijinal değerleri nasıl görüntülerim?

• ARMS aracı V4.x ve sonrası: Hem orijinal hem de yakınsanmış değerler izleme verilerinde kaydedilir. Orijinal değerleri görüntülemek için Trace Explorer kullanın.

• V4.x öncesi ARMS aracı: Yakınsama sunucuda gerçekleştiğinden orijinal değerler kullanılamaz.

Yakınsama kurallarını nasıl özelleştiririm?

ARMS konsolunda özel yakınsama kuralları tanımlayın. Uygulama ayrıntıları sayfasında üst gezinme çubuğundan Configuration > Convergence seçeneğini belirleyin.

Örneğin, eşleşen tüm URL'leri /api/v1/user/userId/info olarak yakınsamak için /api/v1/user/\d+/info normal ifadesini belirtin. /api/v1/user/124343543/info URL'si daha sonra /api/v1/user/userId/info olarak yakınsanır.

Belirli URL'leri yakınsamadan nasıl hariç tutarım?

ARMS konsolunda yakınsamadan hariç tutulacak URL'leri belirtin. Önceki soruda açıklanan aynı Configuration > Convergence sayfasına gidin.

Örneğin, /api/v1/user/9999/info URL'sini yakınsamadan hariç tutarsanız bu URL /api/v1/user/userId/info olarak yakınsanmaz.

Aracı tarafı ve sunucu tarafı yakınsama arasındaki fark nedir?

Aracı tarafı yakınsama, verileri sunucuya raporlamadan önce ARMS aracısında işler. Bu yaklaşım sunucu işleme yükünü azaltır ve %100 veri doğruluğu sağlar.

Sunucu tarafı yakınsama, aracı sürümünün belirli ilkeleri desteklemediği durumlarda uygulanır. Aracı tarafı yakınsama olmadan aracı yakınsanmamış veri paketlerini sunucuya gönderir. Büyük paketler iki risk oluşturur:

• Veri kaybı: Aşırı büyük paketler reddedilebilir.

• Azalan doğruluk: Sunucu tarafı işleme sınırlamaları yakınsanmış verilerin doğruluğunu etkileyebilir.

Tüm yakınsama ilkelerini araçta çalıştırmak için en son ARMS aracı sürümüne yükseltin.