IP adresi ayrıştırma işlevleri; IP adreslerini coğrafi konumlara çözümler, adres türlerini sınıflandırır, biçimler arasında dönüşüm yapar ve CIDR bloğu üyeliğini denetler.
İşlevler
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
geo_parse
Bir IP adresini ayrıştırarak ülke, il ve şehir bilgilerini elde eder.
-
Söz dizimi
geo_parse(ip, ip_db="SLS-GeoIP", keep_fields=None, provider="ipip", ip_sep=None) -
Parametreler
Parametre
Parametre türü
Gerekli
Açıklama
ip
String
Evet
Ayrıştırılacak IP adresi. Tek bir dizedeki birden fazla IP adresini ayrıştırmak için ip_sep parametresini kullanarak bir ayırıcı belirtin.
ip_db
String
Evet
Ayrıştırma için kullanılan IP adresi veritabanı. Geçerli değerler:
-
SLS-GeoIP: Yerleşik SLS IP veritabanı. Varsayılan değerdir. Günlük olarak güncellenir. Ek yapılandırma gerektirmez.
-
Özel IP veritabanı:
res_oss_file(endpoint, ak_id, ak_key, bucket, file, format='text', change_detect_interval=0,fetch_interval=2,refresh_retry_max=60,encoding='utf8',error='ignore')kullanın. Parametre ayrıntıları için bkz. res_oss_file.
keep_fields
Tuple
Hayır
Dönen sonuçta yer alacak anahtarlar.
-
Yerleşik SLS IP veritabanını kullanıyorsanız varsayılan olarak aşağıdaki bilgiler döndürülür:
-
city: Şehir adı.
-
province: İl adı.
-
country: Ülke adı.
-
city_en: Şehrin idari bölge kodu veya İngilizce adı.
-
province_en: İlin idari bölge kodu veya İngilizce adı.
-
country_en: Ülkenin veya bölgenin kodu ya da İngilizce adı.
-
isp: İnternet Hizmet Sağlayıcısı (ISP) adı.
-
lat: IP adresi konumunun enlemi.
-
lon: IP adresi konumunun boylamı.
-
-
Özel IP veritabanı kullanıyorsanız varsayılan olarak aşağıdaki bilgiler döndürülür:
-
city: Şehir adı.
-
province: İl adı.
-
country: Ülke adı.
-
Örneğin,
keep_fields=("city","country")yalnızcacityvecountryalanlarını döndürür.Anahtarları yeniden adlandırmak için de
keep_fieldskullanabilirsiniz. Örneğin,(("city","cty"),("country","state"))çıktı alanlarınıctyvestateolarak yeniden adlandırır.provider
String
Hayır
Bu parametre yalnızca ip_db bir özel IP veritabanı olarak ayarlandığında geçerlidir. Geçerli değerler:
-
ipip: Varsayılan değerdir. IPIP tarafından sağlanan IPDB biçimindeki ikili IP adresi veritabanını kullanır. Veritabanını indirmek için ipip adresini ziyaret edin.
-
ip2location: IP2Location'dan küresel ikili IP adresi veritabanını kullanır. Veritabanını indirmek için ip2location adresini ziyaret edin. Yalnızca ikili paketler desteklenir.
ip_sep
String
Hayır
Tek bir dizedeki birden fazla IP adresi için ayırıcı. Sonuçlar JSON biçiminde döndürülür. Varsayılan: None (bölme yok).
-
-
Yanıt
Bir sözlük döndürür:
{ "city": "...", "province":"...", "country": "..." } -
Örnekler
-
Örnek 1: Yerleşik SLS IP veritabanını kullanarak veri sorgulama.
-
Ham günlük
ip : 203.0.113.1 -
Dönüşüm kuralı
e_set("geo", geo_parse(v("ip"))) -
Sonuç
ip : 203.0.113.1 geo: {"city":"Hangzhou","province":"Zhejiang","country":"China","isp":"China Mobile","lat":30.16,"lon":120.12}
-
-
Örnek 2: Yerleşik SLS IP veritabanını kullanarak tek bir alandan birden fazla IP adresini ayrıştırma.
-
Ham günlük
ip : 203.0.113.4, 192.0.2.2, 198.51.100.2 -
Dönüşüm kuralı
e_set("geo", geo_parse(v("ip"), ip_sep=",")) -
Sonuç
ip : 203.0.113.4, 192.0.2.2, 198.51.100.2 geo : {"203.0.113.4": {"country_en": "CN", "province_en": "330000", "city_en": "330200", "country": "China", "province": "Zhejiang", "city": "Ningbo", "isp": "China Telecom", "lat": 29.8782, "lon": 121.549}, "192.0.2.2": {"country_en": "CN", "province_en": "320000", "city_en": "321300", "country": "China", "province": "Jiangsu", "city": "Suqian", "isp": "China Telecom", "lat": 33.9492, "lon": 118.296}, "198.51.100.2": {"country_en": "CN", "province_en": "330000", "city_en": "330500", "country": "China", "province": "Zhejiang", "city": "Huzhou", "isp": "China Telecom", "lat": 30.8703, "lon": 120.093}}
-
-
Örnek 3: Özel IP veritabanını kullanarak veri sorgulama.
-
Ham günlük
ip : 203.0.113.1 -
Dönüşüm kuralı
e_set("geo",geo_parse(v("ip"), ip_db=res_oss_file(endpoint='http://oss-cn-hangzhou.aliyuncs.com', ak_id='your ak_id', ak_key='your ak_key', bucket='your bucket', file='ipipfree.ipdb', format='binary',change_detect_interval=20))) -
Sonuç
ip : 203.0.113.1 geo : {"city": "Hangzhou", "province":"Zhejiang","country": "China"}
-
-
Örnek 4: Özel IP veritabanıyla sorgulama ve çıktı alanlarını yeniden adlandırma.
-
Ham günlük
ip : 203.0.113.1 -
Dönüşüm kuralı
e_set("geo",geo_parse(v("ip"), ip_db=res_oss_file(endpoint='http://oss-cn-hangzhou.aliyuncs.com', ak_id='your ak_id', ak_key='your ak_key', bucket='your bucket', file='ipipfree.ipdb', format='binary',change_detect_interval=20),keep_fields=(("city","cty"),("country","state"),("province","pro")))) -
Sonuç
ip : 203.0.113.1 geo : { "state": "China","pro": "Zhejiang","cty": "Hangzhou"}
-
-
Örnek 5: Özel IP veritabanıyla sorgulama ve çıktı alanlarını seçme.
-
Ham günlük
ip : 203.0.113.1 -
Dönüşüm kuralı
e_set("geo",geo_parse(v("ip"), ip_db=res_oss_file(endpoint='http://oss-cn-hangzhou.aliyuncs.com', ak_id='your ak_id', ak_key='your ak_key', bucket='your bucket', file='ipipfree.ipdb', format='binary',change_detect_interval=20),keep_fields=("country","province"))) -
Sonuç
ip : 203.0.113.1 geo : { "country": "China","province": "Zhejiang"}
-
-
Örnek 6: IP2Location sağlayıcısını kullanarak özel IP veritabanıyla sorgulama.
-
Ham günlük
ip : 203.0.113.2 -
Dönüşüm kuralı
e_set("geo", geo_parse(v("ip"), ip_db=res_oss_file(endpoint='http://oss-cn-hangzhou.aliyuncs.com',ak_id="your ak_id", ak_key="your ak_secret", bucket='log-etl-staging', file='your ip2location bin file', format='binary', change_detect_interval=20),provider="ip2location")) -
Sonuç
ip : 203.0.113.2 geo : {"city":"Dearborn","province":"Michigan","country":"United States"}
Veri dönüştürme, Python için açık kaynaklı IP2Location SDK'sını kullanır; bu SDK aşağıda listelenen alanları destekler. Bir alan ayrıştırılamıyorsa IP2Location veritabanınızın bu alanı içerdiğini doğrulayın.
country_short country_long / Data transformation uses the country field instead. region / Data transformation uses the province field instead. city isp latitude longitude domain zipcode timezone netspeed idd_code area_code weather_code weather_name mcc mnc mobile_brand elevation usage_type -
-
Örnek 7: Özel IP veritabanını kullanarak birden fazla IP adresini ayrıştırma.
-
Ham günlük
ip : 203.0.113.3, 192.0.2.1, 198.51.100.1 -
Dönüşüm kuralı
e_set("geo", geo_parse(v("ip"), ip_db=res_oss_file(endpoint='http://oss-cn-hangzhou.aliyuncs.com', ak_id="ak_id", ak_key="ak_secret", bucket='log-etl-staging', file='calendar.csv/IP2LOCATION-LITE-DB3.BIN', format='binary', change_detect_interval=20), provider="ip2location", ip_sep=",")) -
Sonuç
ip : 203.0.113.3, 192.0.2.1, 198.51.100.1 geo : {"203.0.113.3": {"city": "Dearborn", "province": "Michigan", "country": "United States"}, "192.0.2.1": {"city": "Hangzhou", "province": "Zhejiang", "country": "China"}, "198.51.100.1": {"city": "Hangzhou", "province": "Zhejiang", "country": "China"}}
-
-
ip_cidrmatch
Bir IP adresinin bir CIDR bloğuna ait olup olmadığını denetler. Eşleşirse True, aksi takdirde False döndürür. IPv4 ve IPv6'yı destekler.
-
Söz dizimi
ip_cidrmatch(cidr_subnet, ip,default="") -
Parametreler
Parametre Adı
Parametre türü
Gerekli
Açıklama
cidr_subnet
String
Evet
CIDR bloğu. Örnek: 192.168.1.0/24.
ip
String
Evet
Denetlenecek IP adresi.
default
String
Hayır
IP adresi eşleştirilemezse kullanılacak yedek değer. Boş olabilir. -
Yanıt
IP adresi CIDR bloğuyla eşleşirse True döner. Aksi takdirde False döner.
-
Örnekler
-
Örnek 1: Bir IPv4 adresi CIDR bloğuyla eşleşir ve işlev True döndürür.
-
Ham günlük
cidr_subnet: 192.168.1.0/24 ip: 192.168.1.100 -
Dönüşüm kuralı
e_set("is_belong",ip_cidrmatch(v("cidr_subnet"),v("ip"))) -
Sonuç
cidr_subnet: 192.168.1.0/24 ip: 192.168.1.100 is_belong: true
-
-
Örnek 2: Bir IPv4 adresi CIDR bloğuyla eşleşmez ve işlev False döndürür.
-
Ham günlük
cidr_subnet: 192.168.1.0/24 ip: 10.10.1.100 -
Dönüşüm kuralı
e_set("is_belong",ip_cidrmatch(v("cidr_subnet"),v("ip"))) -
Sonuç
cidr_subnet: 192.168.1.0/24 ip: 10.10.1.100 is_belong: false
-
-
Örnek 3: IP adresi CIDR bloğuyla eşleştirilemez ve işlev unknown döndürür.
-
Ham günlük
cidr_subnet: 192.168.1.0/24 ip: a -
Dönüşüm kuralı
e_set("is_belong",ip_cidrmatch(v("cidr_subnet"),v("ip"),default="unknown")) -
Sonuç
cidr_subnet: 192.168.1.0/24 ip: a is_belong: unknown
-
-
ip_version
Bir IP adresinin sürümünü döndürür: IPv4 veya IPv6.
-
Söz dizimi
ip_version(ip,default="") -
Parametreler
Parametre
Parametre türü
Gerekli
Açıklama
ip
String
Evet
IP adresi.
default
String
Hayır
Sürüm belirlenemezse kullanılacak yedek değer. Boş olabilir. -
Yanıt
IPv4 veya IPv6 döndürür.
-
Örnekler
-
Örnek 1: Bir IPv4 adresinin sürümünü denetleme.
-
Ham günlük
ip: 192.168.1.100 -
Dönüşüm kuralı
e_set("version",ip_version(v("ip"))) -
Sonuç
ip: 192.168.1.100 version: IPv4
-
-
Örnek 2: Bir IPv6 adresinin sürümünü denetleme.
-
Ham günlük
ip: ::1 -
Dönüşüm kuralı
e_set("version",ip_version(v("ip"))) -
Sonuç
ip: ::1 version: IPv6
-
-
ip_type
Bir IP adresinin türünü döndürür: private, reserved, loopback, public veya allocated ripe ncc.
-
Söz dizimi
ip_type(ip,default="") -
Parametreler
Parametre
Tür
Gerekli
Açıklama
ip
String
Evet
IP adresi.
default
String
Hayır
Tür belirlenemezse kullanılacak yedek değer. Boş olabilir. -
Yanıt
IP adresi türünü döndürür. Geçerli değerler: private, reserved, loopback, public ve allocated ripe ncc.
-
Örnekler
-
Örnek 1: Geri döngü adresini denetleme.
-
Ham günlük
ip: 127.0.0.1 -
Dönüşüm kuralı
e_set("type",ip_type(v("ip"))) -
Sonuç
ip: 127.0.0.1 type: loopback
-
-
Örnek 2: Bir IP adresinin özel olup olmadığını denetleme.
-
Ham günlük
ip: 47.100.XX.XX -
Dönüşüm kuralı
e_set("type",ip_type(v("ip"))) -
Sonuç
ip: 47.100.XX.XX type: private
-
-
Örnek 3: Genel adresi denetleme.
-
Ham günlük
ip: 47.100.XX.XX -
Dönüşüm kuralı
e_set("type",ip_type(v("ip"))) -
Sonuç
ip: 47.100.XX.XX type: public
-
-
Örnek 4: Geri döngü adresi olan bir IPv6 adresinin türünü denetleme.
-
Ham günlük
ip: ::1 -
Dönüşüm kuralı
e_set("type",ip_type(v("ip"))) -
Sonuç
ip: ::1 type: loopback
-
-
Örnek 5: Alınmış RIPE NCC adresi olan bir IPv6 adresinin türünü denetleme.
-
Ham günlük
ip: 2001:0658:022a:cafe:0200::1 -
Dönüşüm kuralı
e_set("type",ip_type(v("ip"))) -
Sonuç
ip: 2001:0658:022a:cafe:0200::1 type: allocated ripe ncc
-
-
ip_makenet
Bir IP adresini CIDR bloğuna dönüştürür.
-
Söz dizimi
ip_makenet(ip, subnet_mask=None,default="") -
Parametreler
Parametre adı
Parametre türü
Gerekli
Açıklama
ip
String
Evet
IP adresi.
subnet_mask
String
Evet
Alt ağ maskesi. Örnek: 255.255.255.0.
Notip parametresi için bir IP adresi aralığı belirtirseniz subnet_mask parametresini boş bırakabilirsiniz.
default
String
Hayır
Dönüşüm başarısız olursa kullanılacak yedek değer. Boş olabilir.
-
Yanıt
Bir CIDR bloğu döndürür.
-
Örnekler
-
Örnek 1: Bir IP adresini CIDR bloğuna dönüştürme.
-
Ham günlük
ip: 192.168.1.0 -
Dönüşüm kuralı
e_set("makenet",ip_makenet(v("ip"),"255.255.255.0")) -
Sonuç
ip: 192.168.1.0 makenet: 192.168.1.0/24
-
-
Örnek 2: Bir IP adresi aralığını CIDR bloğuna dönüştürme.
-
Ham günlük
ip: 192.168.1.0-192.168.1.255 -
Dönüşüm kuralı
e_set("makenet",ip_makenet(v("ip"))) -
Sonuç
ip: 192.168.1.0-192.168.1.255 makenet: 192.168.1.0/24
-
-
Örnek 3: Bir IP adresi aralığını CIDR bloğuna dönüştürme.
-
Ham günlük
ip: 192.168.1.0/255.255.255.0 -
Dönüşüm kuralı
e_set("makenet",ip_makenet(v("ip"))) -
Sonuç
ip: 192.168.1.0/255.255.255.0 makenet: 192.168.1.0/24
-
-
ip_to_format
Bir CIDR bloğunu ön ek uzunluğu, alt ağ maskesi veya IP adresi aralığı gibi belirli bir biçime dönüştürür.
-
Söz dizimi
ip_to_format(cidr_subnet, want_prefix_len=0,default="") -
Parametreler
Parametre adı
Tür
Gerekli
Açıklama
cidr_subnet
String
Evet
CIDR bloğu. Örnek: 192.168.1.0/24
want_prefix_len
Int
Hayır
Çıktı biçimi. Varsayılan: 0.
-
0: Biçimlendirilmemiş.
-
1: Ön ek biçimi.
-
2: Ağ maskesi biçimi.
-
3: IP adresi aralığı.
default
String
Hayır
Biçimlendirme başarısız olursa kullanılacak yedek değer. Boş olabilir.
-
-
Yanıt
Belirtilen biçimde bir IP adresi döndürür.
-
Örnekler
-
Örnek 1: Girdi CIDR bloğunu biçimi değiştirmeden döndürme.
-
Ham günlük
ip: 192.168.1.0/24 -
Dönüşüm kuralı
e_set("strNormal",ip_to_format(v("ip"),0)) -
Sonuç
ip: 192.168.1.0/24 strNormal: 192.168.1.0/24
-
-
Örnek 2: CIDR bloğunu ön ek kullanacak şekilde biçimlendirme.
-
Ham günlük
ip: 192.168.1.0/24 -
Dönüşüm kuralı
e_set("strNormal",ip_to_format(v("ip"),1)) -
Sonuç
ip: 192.168.1.0/24 strNormal: 192.168.1.0/24
-
-
Örnek 3: CIDR bloğunu alt ağ maskesi kullanacak şekilde biçimlendirme.
-
Ham günlük
ip: 192.168.1.0/24 -
Dönüşüm kuralı
e_set("strNormal",ip_to_format(v("ip"),2)) -
Sonuç
ip: 192.168.1.0/24 strNormal: 192.168.1.0/255.255.255.0
-
-
Örnek 4: CIDR bloğunu IP adresi aralığı olarak biçimlendirme.
-
Ham günlük
ip: 192.168.1.0/24 -
Dönüşüm kuralı
e_set("strNormal",ip_to_format(v("ip"),3)) -
Sonuç
ip: 192.168.1.0/24 strNormal: 192.168.1.0-192.168.1.255
-
-
ip_overlaps
İki CIDR bloğunun örtüşüp örtüşmediğini belirler.
-
Söz dizimi
ip_overlaps(cidr_subnet, cidr_subnet2,default="") -
Parametreler
Parametre adı
Parametre türü
Gerekli
Açıklama
cidr_subnet
String
Evet
Birinci CIDR bloğu.
cidr_subnet2
String
Evet
İkinci CIDR bloğu.
default
String
Hayır
Örtüşme belirlenemezse kullanılacak yedek değer. Boş olabilir. -
Yanıt
İki CIDR bloğu örtüşmüyorsa işlev 0 döndürür.
İki CIDR bloğu sonunda örtüşüyorsa işlev 1 döndürür.
İki CIDR bloğu başlangıçta örtüşüyorsa işlev -1 döndürür.
-
Örnekler
-
Örnek 1: İki CIDR bloğu örtüşmüyor.
-
Ham günlük
cidr1: 192.168.0.0/23 cidr2: 192.168.2.0/24 -
Dönüşüm kuralı
e_set("overlaps",ip_overlaps(v("cidr1"),v("cidr2"))) -
Sonuç
cidr1: 192.168.0.0/23 cidr2: 192.168.2.0/24 overlaps: 0
-
-
Örnek 2: İki CIDR bloğu başlangıçta örtüşüyor.
-
Ham günlük
cidr1: 192.168.1.0/24 cidr2: 192.168.0.0/23 -
Dönüşüm kuralı
e_set("overlaps",ip_overlaps(v("cidr1"),v("cidr2"))) -
Sonuç
cidr1: 192.168.1.0/24 cidr2: 192.168.0.0/23 overlaps: -1
-
-
Örnek 3: İki CIDR bloğu sonunda örtüşüyor.
-
Ham günlük
cidr1: 192.168.0.0/23 cidr2: 192.168.1.0/24 -
Dönüşüm kuralı
e_set("overlaps",ip_overlaps(v("cidr1"),v("cidr2"))) -
Sonuç
cidr1: 192.168.0.0/23 cidr2: 192.168.1.0/24 overlaps: 1
-
-
ip2long
Bir IP adresini dizeden uzun tamsayıya dönüştürür.
-
Söz dizimi
ip2long(value,default=0) -
Parametreler
Parametre Adı
Parametre türü
Gerekli
Açıklama
value
String
Evet
Dönüştürülecek değer.
default
String
Hayır
Geçersiz bir IP adresi için yedek değer. Örnek: 0. -
Yanıt
Geçerli bir IP adresinin uzun tamsayı temsilini döndürür.
-
Örnekler
-
Örnek 1: Varsayılan durum
-
Ham günlük
ip: 192.168.0.100 -
Dönüşüm kuralı
e_set("long_ip",ip2long(v("ip"))) -
Sonuç
ip: 192.168.0.100 long_ip: 167772160
-
-
Örnek 2: Geçersiz IP adresi
-
Ham günlük
ip: 47.100.XX.XX -
Dönüşüm kuralı
e_set("long_ip",ip2long(v("ip"), "ignore")) -
Sonuç
ip:47.100.XX.XX long_ip:ignore
-
-
long2ip
Uzun tamsayıyı dize biçimli bir IP adresine dönüştürür.
-
Söz dizimi
long2ip(value,default="") -
Parametreler
Parametre Adı
Parametre türü
Gerekli
Açıklama
value
String
Evet
Dönüştürülecek değer.
default
String
Hayır
Geçersiz uzun tamsayı için yedek değer. Varsayılan: boş dize. -
Yanıt
Geçerli bir uzun tamsayıdan dönüştürülen dize biçimli IP adresini döndürür.
-
Örnekler
-
Örnek 1: Varsayılan durum
-
Ham günlük
long: 167772160 -
Dönüşüm kuralı
e_set("ip",long2ip(v("long"))) -
Sonuç
long: 167772160 ip: 192.168.0.100
-
-
Örnek 2: Uzun tamsayıdan IP adresine dönüştürme başarısız oldu
-
Ham günlük
long: 4294967296 -
Dönüşüm kuralı
e_set("ip",long2ip(v("long"))) -
Sonuç
long: 4294967296 ip:
-
-
Örnek 3: Başarısız bir dönüştürme için özel hata işleme
-
Ham günlük
long: 4294967296 -
Dönüşüm kuralı
e_set("ip",long2ip(v("long"),default="xxx")) -
Sonuç
long: 4294967296 ip: xxx
-
-