Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:IP adresi ayrıştırma işlevleri

Son Güncelleme:Sep 30, 2026

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


İşlev


Açıklama


geo_parse


IP adresini ülke, il ve şehir bilgilerine ayırır.


ip_cidrmatch


Bir IP adresinin Classless Inter-Domain Routing (CIDR) bloğuna ait olup olmadığını denetler.


ip_version


Bir IP adresinin IPv4 mü yoksa IPv6 mı olduğunu denetler.


ip_type


Bir IP adresinin özel mi yoksa genel mi olduğunu denetler.


ip_makenet


Bir IP adresini CIDR bloğuna dönüştürür.


ip_to_format


CIDR bloğunu ön ek uzunluğu veya alt ağ maskesi kullanacak şekilde biçimlendirir.


ip_overlaps


İki CIDR bloğunun örtüşüp örtüşmediğini denetler.


ip2long


Bir IP adresini dizeden uzun tamsayıya dönüştürür.


long2ip


Uzun tamsayıyı IP adresi dizelerine dönüştürür.

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ızca city ve country alanlarını döndürür.

    Anahtarları yeniden adlandırmak için de keep_fields kullanabilirsiniz. Örneğin, (("city","cty"),("country","state")) çıktı alanlarını cty ve state olarak 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                               

      IP2Location Python SDK.

    • Ö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.

    Not

    ip 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