parse_user_agent()

Växla tjänster genom att använda listrutan Version. Läs mer om navigering.
Gäller för: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Tolkar en användaragentsträng som identifierar användarens webbläsare och ger viss systeminformation till servrar som är värdar för de webbplatser som användaren besöker. Resultatet returneras som dynamic.

Syntax

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

Läs mer om syntaxkonventioner.

Parameterar

Namn	Typ	Krävs	Description
user-agent-string	string	✔️	Den användaragentsträng som ska parsas.
look-for	sträng eller dynamisk	✔️	Värdet som ska sökas efter i user-agent-string. De möjliga alternativen är "webbläsare", "os" eller "enhet". Om endast ett enda parsningsmål krävs kan det skickas en string parameter. Om två eller tre mål krävs kan de skickas som en dynamic matris.

Retur

Ett objekt av typen dynamic som innehåller information om de begärda parsningsmålen.

Webbläsare: Familj, MajorVersion, MinorVersion, Patch

OperatingSystem: Family, MajorVersion, MinorVersion, Patch, PatchMinor

Enhet: Familj, Varumärke, Modell

Varning

Funktionsimplementeringen bygger på regexkontroller av indatasträngen mot ett stort antal fördefinierade mönster. Därför är den förväntade tiden och CPU-förbrukningen hög. När funktionen används i en fråga kontrollerar du att den körs på ett distribuerat sätt på flera datorer. Om frågor med den här funktionen används ofta kanske du vill skapa resultaten i förväg via uppdateringsprincipen, men du måste ta hänsyn till att användningen av den här funktionen i uppdateringsprincipen ökar svarstiden för inmatning.

Examples

Sök efter parameter som sträng

Kör frågan

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

Förväntat resultat är ett dynamiskt objekt:

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

Sök efter parameter som dynamisk matris

Kör frågan

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

Förväntat resultat är ett dynamiskt 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"
  }
}