Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Ayrıştırma işlevleri

Son Güncelleme:Sep 30, 2026

Log Service; User-Agent dizelerinden cihaz, işletim sistemi ve tarayıcı bilgilerini çıkarmak için User-Agent ayrıştırma işlevleri; URL'leri ve sorgu dizelerini bileşenlerine ayırmak için URL ayrıştırma işlevleri sunar.

İşlev listesi


İşlev


Açıklama


ua_parse_device


User-Agent dizesinden cihaz bilgilerini ayrıştırır.


ua_parse_os


User-Agent dizesinden işletim sistemi bilgilerini ayrıştırır.


ua_parse_agent


User-Agent dizesinden tarayıcı bilgilerini ayrıştırır.


ua_parse_all


User-Agent dizesindeki tüm bilgileri ayrıştırır.


url_parse


Bir URL'nin bileşenlerini ayrıştırır.


url_parse_qs


Bir URL'nin sorgu dizesinde bulunan parametreleri ayrıştırır.

Not

User-Agent ayrıştırma işlevleri, ayrıştırma sonrasında değeri None olan alanları kaldırır. Örneğin, ayrıştırılan cihaz verisi {'brand': None, 'family': 'Other', 'model': None} ise brand ve model alanları kaldırılır. Sonuç {'family': 'Other'} olur.

ua_parse_device

User-Agent dizesinden cihaz bilgilerini ayrıştırır.

  • Sözdizimi

    ua_parse_device(value)
  • Parametreler


    Parametre Adı


    Veri türü


    Zorunlu


    Açıklama


    value


    Dize


    Evet


    Ayrıştırılacak User-Agent dizesi.

  • Yanıt

    JSON döndürür.

  • Örnekler

    • Ham günlük

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • Dönüşüm kuralı

      e_set("new_column",ua_parse_device(v("http_user_agent")))
    • Sonuç

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
      new_column:{"family":"Mac","brand":"Apple","model":"Mac"}

ua_parse_os

User-Agent dizesinden işletim sistemi bilgilerini ayrıştırır.

  • Sözdizimi

    ua_parse_os(value)
  • Parametreler


    Parametre adı


    Veri türü


    Zorunlu


    Açıklama


    value


    Dize


    Evet


    Ayrıştırılacak User-Agent dizesi.

  • Yanıt

    JSON döndürür.

  • Örnekler

    • Ham günlük

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • Dönüşüm kuralı

      e_set("new_column",ua_parse_os(v("http_user_agent")))
    • Sonuç

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
      new_column:{'family': 'Mac OS X',
                          'major': '10',
                          'minor': '9',
                          'patch': '4'}

ua_parse_agent

User-Agent dizesinden tarayıcı bilgilerini ayrıştırır.

  • Sözdizimi

    ua_parse_agent(value)
  • Parametreler


    Parametre


    Veri türü


    Zorunlu


    Açıklama


    value


    Dize


    Evet


    Ayrıştırılacak User-Agent dizesi.

  • Yanıt

    JSON döndürür.

  • Örnekler

    • Ham günlük

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • Dönüşüm kuralı

      e_set("new_column",ua_parse_agent(v("http_user_agent")))
    • Sonuç

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
      new_column:{'family': 'Chrome', 'major': '192', 'minor': '168', 'patch': '0'}

ua_parse_all

User-Agent dizesindeki tüm bilgileri ayrıştırır.

  • Sözdizimi

    ua_parse_all(value)
  • Parametreler


    Parametre Adı


    Veri türü


    Zorunlu


    Açıklama


    value


    Dize


    Evet


    Ayrıştırılacak User-Agent dizesi.

  • Yanıt

    JSON döndürür.

  • Örnekler

    • Ham günlük

      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • Dönüşüm kuralı

      e_set("new_column",ua_parse_all(v("http_user_agent")))
    • Sonuç

      http_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
      new_column: {
        "user_agent": {
          "family": "Chrome",
          "major": "192",
          "minor": "168",
          "patch": "0"
        },
        "os": {
          "family": "Mac OS X",
          "major": "10",
          "minor": "9",
          "patch": "4"
        },
        "device": {
          "family": "Mac",
          "brand": "Apple",
          "model": "Mac"
        }
      }

url_parse

Bir URL'nin bileşenlerini ayrıştırır.

  • Sözdizimi

    url_parse(url, scheme="", allow_fragments=True)
  • Parametreler

    Parametre Adı

    Veri türü

    Zorunlu

    Açıklama

    value

    Dize

    Evet

    Ayrıştırılacak URL.

    scheme

    Dize

    Hayır

    Ağ protokolü. Varsayılan: boş dize.

    URL bir protokol içermediğinde yalnızca sonuçtaki scheme değeri olarak kullanılır.

    allow_fragments

    Boolean

    Hayır

    URL'nin parça (fragment) bölümünün ayrıştırılıp ayrıştırılmayacağı.

    • True (varsayılan): Parça bölümünü ayrıştırır. Sonuçtaki fragment alanı belirli değeri içerir.

    • False: Parça bölümünü ayrıştırmaz. Sonuçtaki fragment alanı boş bir dizedir.

  • Yanıt

    Aşağıdaki alanlara sahip JSON döndürür.


    Alan


    Açıklama


    scheme


    Ağ protokolü


    netloc


    Ağ konumu


    path


    Hiyerarşik yol


    query


    Sorgu bileşeni


    fragment


    Parça tanımlayıcısı

  • Örnekler

    • Örnek 1: Bir URL'nin bileşenlerini döndürmek için varsayılan parametreleri kullanın.

      • Ham günlük

        content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
      • Dönüşüm kuralı

        e_set("url",url_parse(v("content")))
      • Sonuç

        content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
        url:{
                "scheme": "https",
                "netloc": "username:username@example.com:8083",
                "path": "/hello/asdah/;type=docx",
                "query": "filename=python3.docx",
                "fragment": "urllib"
            }
    • Örnek 2: allow_fragments parametresini False olarak ayarlayın. Sonuçtaki fragment parametresinin değeri boş bir dize olur.

      • Ham günlük

        content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
      • Dönüşüm kuralı

        e_set("url",url_parse(v("content"),allow_fragments=False))
      • Sonuç

        content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
        url:{
                 "scheme": "https",
                "netloc": "username:username@example.com:8083",
                "path": "/hello/asdah/;type=docx",
                "query": "filename=python3.docx",
                "fragment": ""
            }
    • Örnek 3: scheme parametresini https ve allow_fragments parametresini False olarak ayarlayın. Sonuçtaki scheme parametresinin değeri https, fragment parametresinin değeri ise boş bir dize olur.

      • Ham günlük

        content://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
      • Dönüşüm kuralı

        e_set("url",url_parse(v("content"),scheme="https", allow_fragments=False))
      • Sonuç

        content://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib
        url:{
               "scheme": "https",
                "netloc": "username:username@example.com:8083",
                "path": "/hello/asdah/;type=docx",
                "query": "filename=python3.docx",
                "fragment": ""
            }

url_parse_qs

Bir URL sorgu dizesinin bileşenlerini ayrıştırır.

  • Sözdizimi

    url_parse_qs(
        url_qs,
        keep_blank_values=False,
        strict_parsing=False,
        encoding="utf-8",
        errors="replace",
        ignore_multi_fields=True,
    )
  • Parametreler

    Parametre Adı

    Veri türü

    Zorunlu

    Açıklama

    url_qs

    Dize

    Evet

    Ayrıştırılacak URL sorgu dizesi.

    keep_blank_values

    Boolean

    Hayır

    Boş değerlere sahip parametrelerin döndürülüp döndürülmeyeceği.

    • False (varsayılan): Değer döndürülmez.

    • True: Bu parametreleri döndürür ve değerlerini boş dizelere ayarlar.

    strict_parsing

    Boolean

    Hayır

    Ayrıştırma hatalarının nasıl ele alınacağı.

    • True: ValueError istisnası tetiklenir.

    • False (varsayılan): Hatalar yoksayılır.

    encoding

    Dize

    Hayır

    Yüzdeli kodlanmış karakterlerin Unicode'a çözümlemek için kullanılan kodlama. Varsayılan: utf-8. ASCII de desteklenir.

    errors

    Dize

    Hayır

    Belirtilen kodlama tarafından çözümlenemeyen karakterlerin nasıl ele alınacağı. Geçerli değerler:

    • ignore: Herhangi bir işlem yapılmaz.

    • strict: Bir hata bildirir ve günlük girişini atar.

    • replace (varsayılan): Tanınmayan karakterleri soru işareti (?) ile değiştirir.

    • xmlcharrefreplace: Tanınmayan karakterleri karşılık gelen XML karakter başvurularıyla değiştirir.

    ignore_multi_fields

    Sayı

    Hayır

    Her parametre için yalnızca ilk değerin döndürülüp döndürülmeyeceği.

    • True (varsayılan): Her parametre için yalnızca ilk değeri döndürür. Değer bir dizedir.

    • False: Her parametre için tüm değerleri döndürür. Değerler bir liste halinde döndürülür.

  • Yanıt

    Aşağıdaki alanlara sahip JSON döndürür.


    Parametre


    Açıklama


    logType


    Günlük türü.


    uid


    Günlüğün benzersiz tanımlayıcısı.


    time


    Günlüğün zaman damgası.


    msg


    Günlük mesajı içeriği.

  • Örnekler

    • Örnek 1: keep_blank_values parametresini True olarak ayarlayın. Sonuç, boş değerlere sahip parametreleri içerir.

      • Ham günlük

        content:logType=net_wheel_log&uid=62452****&vid=6.1.0_gf_pc&asb=1206427&git=&time=22-11-3+%e4%b8%8a11%e6%97%b649%e5%88%8633%e7%a7%92&operatingSystem=Windows+10++(10.0.0)+64bit&deviceModel=System+Product+Name+(System+manufacturer)&graphicsDeviceName=NVIDIA+GeForce+GTX+1650&graphicsDeviceType=Direct3D11&graphicsDeviceVendor=NVIDIA&graphicsDeviceVersion=Direct3D+11.0+%5blevel+11.1%5d&graphicsMemorySize=3962&systemMemorySize=8127&processorCount=6&processorFrequency=3000&processorType=Intel(R)+Core(TM)+i5-9500F+CPU+%40+3.00GHz&deviceID=96da5902a042a5f84118995f88373f73650e76be166589726****&guessUID=62452****&networkReachability=wifi&msg=GetAuthkeyRsp
      • Dönüşüm kuralı

        e_set("url",url_parse_qs(v("content"), keep_blank_values=True))
      • Sonuç

        content:logType=net_wheel_log&uid=62452****&vid=6.1.0_gf_pc&asb=1206427&git=&time=22-11-3+%e4%b8%8a11%e6%97%b649%e5%88%8633%e7%a7%92&operatingSystem=Windows+10++(10.0.0)+64bit&deviceModel=System+Product+Name+(System+manufacturer)&graphicsDeviceName=NVIDIA+GeForce+GTX+1650&graphicsDeviceType=Direct3D11&graphicsDeviceVendor=NVIDIA&graphicsDeviceVersion=Direct3D+11.0+%5blevel+11.1%5d&graphicsMemorySize=3962&systemMemorySize=8127&processorCount=6&processorFrequency=3000&processorType=Intel(R)+Core(TM)+i5-9500F+CPU+%40+3.00GHz&deviceID=96da5902a042a5f84118995f88373f73650e76be166589726****&guessUID=62452****&networkReachability=wifi&msg=GetAuthkeyRsp
        url:{
                "logType": "net_wheel_log",
                "uid": "62452****",
                "vid": "6.1.0_gf_pc",
                "asb": "1206427",
                "git": "",
                "time": "22-11-3 11:49:33 AM",
                "operatingSystem": "Windows 10  (10.0.0) 64bit",
                "deviceModel": "System Product Name (System manufacturer)",
                "graphicsDeviceName": "NVIDIA GeForce GTX 1650",
                "graphicsDeviceType": "Direct3D11",
                "graphicsDeviceVendor": "NVIDIA",
                "graphicsDeviceVersion": "Direct3D 11.0 [level 11.1]",
                "graphicsMemorySize": "3962",
                "systemMemorySize": "8127",
                "processorCount": "6",
                "processorFrequency": "3000",
                "processorType": "Intel(R) Core(TM) i5-9500F CPU @ 3.00GHz",
                "deviceID": "96da5902a042a5f84118995f88373f73650e76be166589726****",
                "guessUID": "62452****",
                "networkReachability": "wifi",
                "msg": "GetAuthkeyRsp"
            }
    • Örnek 2: keep_blank_values parametresini varsayılan değere (False) ayarlayın. Sonuç, boş değerlere sahip parametreleri içermez.

      • Ham günlük

        content:logType=net_wheel_log&uid=62452****&vid=6.1.0_gf_pc&asb=1206427&git=&time=22-11-3+%e4%b8%8a11%e6%97%b649%e5%88%8633%e7%a7%92&operatingSystem=Windows+10++(10.0.0)+64bit&deviceModel=System+Product+Name+(System+manufacturer)&graphicsDeviceName=NVIDIA+GeForce+GTX+1650&graphicsDeviceType=Direct3D11&graphicsDeviceVendor=NVIDIA&graphicsDeviceVersion=Direct3D+11.0+%5blevel+11.1%5d&graphicsMemorySize=3962&systemMemorySize=8127&processorCount=6&processorFrequency=3000&processorType=Intel(R)+Core(TM)+i5-9500F+CPU+%40+3.00GHz&deviceID=96da5902a042a5f84118995f88373f73650e76be166589726****&guessUID=62452****&networkReachability=wifi&msg=GetAuthkeyRsp
      • Dönüşüm kuralı

        e_set("url",url_parse_qs(v("content")))
      • Sonuçlar

        content:logType=net_wheel_log&uid=62452****&vid=6.1.0_gf_pc&asb=1206427&git=&time=22-11-3+%e4%b8%8a11%e6%97%b649%e5%88%8633%e7%a7%92&operatingSystem=Windows+10++(10.0.0)+64bit&deviceModel=System+Product+Name+(System+manufacturer)&graphicsDeviceName=NVIDIA+GeForce+GTX+1650&graphicsDeviceType=Direct3D11&graphicsDeviceVendor=NVIDIA&graphicsDeviceVersion=Direct3D+11.0+%5blevel+11.1%5d&graphicsMemorySize=3962&systemMemorySize=8127&processorCount=6&processorFrequency=3000&processorType=Intel(R)+Core(TM)+i5-9500F+CPU+%40+3.00GHz&deviceID=96da5902a042a5f84118995f88373f73650e76be166589726****&guessUID=62452****&networkReachability=wifi&msg=GetAuthkeyRsp
        url:{
                "logType": "net_wheel_log",
                "uid": "62452****",
                "vid": "6.1.0_gf_pc",
                "asb": "1206427",
                "time": "22-11-3 11:49:33",
                "operatingSystem": "Windows 10  (10.0.0) 64bit",
                "deviceModel": "System Product Name (System manufacturer)",
                "graphicsDeviceName": "NVIDIA GeForce GTX 1650",
                "graphicsDeviceType": "Direct3D11",
                "graphicsDeviceVendor": "NVIDIA",
                "graphicsDeviceVersion": "Direct3D 11.0 [level 11.1]",
                "graphicsMemorySize": "3962",
                "systemMemorySize": "8127",
                "processorCount": "6",
                "processorFrequency": "3000",
                "processorType": "Intel(R) Core(TM) i5-9500F CPU @ 3.00GHz",
                "deviceID": "96da5902a042a5f84118995f88373f73650e76be166589726****",
                "guessUID": "62452****",
                "networkReachability": "wifi",
                "msg": "GetAuthkeyRsp"
            }
    • Örnek 3: ignore_multi_fields parametresini varsayılan değere (True) ayarlayın. Her parametre için yalnızca ilk değer döndürülür.

      • Ham günlük

        content:logType=net_log&uid=62452****&x=1&x=2&x=3&asb=123&asb=456
      • Dönüşüm kuralı

        e_set("url",url_parse_qs(v("content")))
      • Sonuç

        content:logType=net_log&uid=62452****&x=1&x=2&x=3&asb=123&asb=456
        url:{
            "logType": "net_log",
            "uid": "62452****",
            "x": "1",
            "asb": "123"
        }
    • Örnek 4: ignore_multi_fields parametresini False olarak ayarlayın. Her parametre için tüm değerler döndürülür.

      • Ham günlük

        content:logType=net_log&uid=62452****&x=1&x=2&x=3&asb=123&asb=456
      • Dönüşüm kuralı

        e_set("url",url_parse_qs(v("content"),ignore_multi_fields=False))
      • Sonuç

        content:logType=net_log&uid=62452****&x=1&x=2&x=3&asb=123&asb=456
        url:{
            "logType": ["net_log"],
              "uid": ["62452****"],
              "x": ["1", "2", "3"],
              "asb": ["123", "456"]
        }