parse_user_agent()

  • Článek

Interpretuje řetězec uživatelského agenta, který identifikuje prohlížeč uživatele a poskytuje určité systémové podrobnosti serverům, které hostují weby, které uživatel navštíví. Výsledek se vrátí jako dynamic.

Syntax

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

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Vyžadováno Popis
user-agent-string string ✔️ Řetězec uživatelského agenta, který se má analyzovat.
hledat string nebo dynamic ✔️ Hodnota, která se má vyhledat v user-agent-string. Možné možnosti jsou "browser", "os" nebo "device". Pokud se vyžaduje pouze jeden cíl analýzy, je možné mu předat string parametr. Pokud jsou vyžadovány dva nebo tři cíle, mohou být předány dynamic jako pole.

Návraty

Objekt typu dynamic , který obsahuje informace o požadovaných cílech analýzy.

Prohlížeč: Family, MajorVersion, MinorVersion, Patch

OperatingSystem: Family, MajorVersion, MinorVersion, Patch, PatchMinor

Zařízení: Rodina, Značka, Model

Upozornění

Implementace funkce je postavená na kontrolách regulárních výrazů vstupního řetězce s velkým počtem předdefinovaných vzorů. Proto je očekávaná doba a využití procesoru vysoké. Pokud se funkce používá v dotazu, ujistěte se, že běží distribuovaně na více počítačích. Pokud se dotazy s touto funkcí používají často, možná budete chtít předem vytvořit výsledky prostřednictvím zásad aktualizace, ale je potřeba vzít v úvahu, že použití této funkce v zásadách aktualizace zvýší latenci příjmu dat.

Příklady

Hledat parametr jako řetězec

Spuštění dotazu

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")

Očekávaným výsledkem je dynamický objekt:

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

Hledat parametr jako dynamické pole

Spuštění dotazu

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"]))

Očekávaným výsledkem je dynamický objekt:

{
  "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"
  }
}