Aracılığıyla paylaş

parse_user_agent()

  • Makale

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini✅ Azure İzleyici✅Microsoft Sentinel

Kullanıcının tarayıcısını tanımlayan ve kullanıcının ziyaret ettiği web sitelerini barındıran sunuculara belirli sistem ayrıntılarını sağlayan kullanıcı aracısı dizesini yorumlar. Sonuç olarak dynamicdöndürülür.

Sözdizimi

parse_user_agent(user-agent-string, look-for)

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Zorunlu Açıklama
user-agent-string string ✔️ Ayrıştırmak için kullanıcı aracısı dizesi.
arama dize veya dinamik ✔️ User-agent-string içinde aranacak değer. Olası seçenekler "tarayıcı", "os" veya "cihaz"dır. Yalnızca tek bir ayrıştırma hedefi gerekiyorsa, bir string parametre geçirilebilir. İki veya üç hedef gerekiyorsa, bunlar dizi dynamic olarak geçirilebilir.

Döndürülenler

İstenen ayrıştırma hedefleri hakkındaki bilgileri içeren türündeki dynamic bir nesne.

Tarayıcı: Family, MajorVersion, MinorVersion, Patch

OperatingSystem: Family, MajorVersion, MinorVersion, Patch, PatchMinor

Cihaz: Aile, Marka, Model

Uyarı

İşlev uygulaması, çok sayıda önceden tanımlanmış desene karşı giriş dizesinin regex denetimlerini kullanır. Bu nedenle beklenen süre ve CPU tüketimi yüksektir. İşlev bir sorguda kullanıldığında, birden çok makinede dağıtılmış bir şekilde çalıştığından emin olun. Bu işleve sahip sorgular sık sık kullanılıyorsa, güncelleştirme ilkesi aracılığıyla sonuçları önceden oluşturmak isteyebilirsiniz, ancak güncelleştirme ilkesinde bu işlevin kullanılmasının alım gecikmesini artıracağını dikkate almanız gerekir.

Örnekler

Parametreyi dize olarak ara

print useragent = "Mozilla/5.0 (Windows; U; en-US) AppleWebKit/531.9 (KHTML, like Gecko) AdobeAIR/2.5.1"
| extend x = parse_user_agent(useragent, "browser")

Beklenen sonuç dinamik bir nesnedir:

{
  "Browser": {
    "Family": "AdobeAIR",
    "MajorVersion": "2",
    "MinorVersion": "5",
    "Patch": "1"
  }
}

Parametreyi dinamik dizi olarak arayın

print useragent = "Mozilla/5.0 (SymbianOS/9.2; U; Series60/3.1 NokiaN81-3/10.0.032 Profile/MIDP-2.0 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/4"
| extend x = parse_user_agent(useragent, dynamic(["browser","os","device"]))

Beklenen sonuç dinamik bir nesnedir:

{
  "Browser": {
    "Family": "Nokia OSS Browser",
    "MajorVersion": "3",
    "MinorVersion": "1",
    "Patch": ""
  },
  "OperatingSystem": {
    "Family": "Symbian OS",
    "MajorVersion": "9",
    "MinorVersion": "2",
    "Patch": "",
    "PatchMinor": ""
  },
  "Device": {
    "Family": "Nokia N81",
    "Brand": "Nokia",
    "Model": "N81-3"
  }
}