Bagikan melalui

parse_user_agent()

  • Artikel

Berlaku untuk: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Menafsirkan string agen-pengguna, yang mengidentifikasi browser pengguna dan memberikan rincian sistem tertentu ke server hosting situs web yang dikunjungi pengguna. Hasil yang ditampilkan adalah dynamic.

Sintaks

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

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama Tipe Wajib Deskripsi
user-agent-string string ✔️ String agen pengguna untuk diurai.
cari-untuk string atau dinamis ✔️ Nilai yang akan dicari dalam user-agent-string. Opsi yang mungkin adalah "browser", "os", atau "perangkat". Jika hanya satu target penguraian yang diperlukan, target dapat diteruskan parameter string . Jika dua atau tiga target diperlukan, target tersebut dapat diteruskan sebagai dynamic array.

Mengembalikan

Objek jenis dynamic yang berisi informasi tentang target penguraian yang diminta.

Browser: Keluarga, MajorVersion, MinorVersion, Patch

OperatingSystem: Keluarga, MajorVersion, MinorVersion, Patch, PatchMinor

Perangkat: Keluarga, Merek, Model

Peringatan

Implementasi fungsi dibuat di atas pemeriksaan regex dari string input terhadap sejumlah besar pola yang telah ditentukan. Oleh karena itu waktu yang diharapkan dan penggunaan CPU tinggi. Saat fungsi digunakan dalam kueri, pastikan fungsi tersebut berjalan secara terdistribusi pada beberapa mesin. Jika kueri dengan fungsi ini sering digunakan, Anda mungkin ingin membuat hasil terlebih dahulu melalui kebijakan pembaruan, tetapi Anda perlu memperhitungkan bahwa menggunakan fungsi ini di dalam kebijakan pembaruan akan meningkatkan latensi penyerapan.

Contoh

Parameter pencarian sebagai string

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

Hasil yang diharapkan adalah objek dinamis:

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

Parameter pencarian sebagai array dinamis

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

Hasil yang diharapkan adalah objek dinamis:

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