parse_user_agent()

Alterne entre serviços usando a lista suspensa Version. Saiba mais sobre navegação.
Aplica a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Interpreta uma cadeia user-agent, que identifica o navegador do utilizador e fornece certos detalhes do sistema aos servidores que alojam os sites visitados. O resultado é devolvido como dynamic.

Sintaxe

parse_user_agent( user-agent-string, procurar)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Description
user-agent-string	string	✔️	A cadeia user-agent para analisar.
procurar	corda ou dinâmica	✔️	O valor a procurar em user-agent-string. As opções possíveis são "browser", "systemate operativo" ou "dispositivo". Se for necessário apenas um único alvo de análise, pode ser transmitido um string parâmetro. Se forem necessários dois ou três alvos, podem ser passados como uma dynamic matriz.

Devoluções

Um objeto de tipo dynamic que contém a informação sobre os alvos de análise analisados solicitados.

Browser: Family, MajorVersion, MinorVersion, Patch

OperatingSystem: Family, MajorVersion, MinorVersion, Patch, PatchMinor

Dispositivo: Família, Marca, Modelo

Advertência

A implementação da função baseia-se em verificações regulares da cadeia de entrada contra um enorme número de padrões pré-definidos. Portanto, o tempo esperado e o consumo de CPU são elevados. Quando a função é usada numa consulta, certifique-se de que corre de forma distribuída em várias máquinas. Se as consultas com esta função forem frequentemente usadas, pode querer pré-criar os resultados através da política de atualização, mas deve ter em conta que usar esta função dentro da política de atualização aumentará a latência de ingestão.

Examples

Parâmetro de procura como cadeia

Executar a consulta

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 resultado esperado é um objeto dinâmico:

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

Parâmetro de procura como matriz dinâmica

Executar a consulta

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 resultado esperado é um objeto dinâmico:

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