Application Insights 會將遙測從 Web 應用程式傳送至 Azure 入口網站,以提供應用程式和基礎結構效能和使用方式的深入解析。 為了協助您進一步瞭解及組織遙測數據,我們會將其分類為不同的類型。
遙測數據模型已標準化,因此可以建立平臺和語言無關的監視。 我們盡量讓模型保持簡單且輕鬆,就能支援重要的情節,並擴充結構描述以供進階使用。
Application Insights 所收集的數據會建立此一般應用程式執行模式的模型:
1availabilityResults
預設無法使用,需要設定可用性測試。
2customEvents
和 customMetrics
僅適用於自定義儀表。
附註
Application Insights 因為歷史原因,將記錄儲存在表格 traces
中。 分散式追蹤範圍將儲存在 requests
和 dependencies
資料表中。 我們計劃在未來版本中解決此問題,以避免任何混淆。
遙測類型
下列類型的遙測可用來監視應用程式的執行。 Azure 監視器 OpenTelemetry Distro 和 Application Insights JavaScript SDK 會收集:
遙測類型 | 數據表名稱 (Application Insights) |
數據表名稱 (Log Analytics) |
描述 |
---|---|---|---|
可用性 | availabilityResults |
AppAvailabilityResults |
定期傳送 Web 要求,並在應用程式沒有回應或響應時間太慢時發出警示,以監視應用程式的可用性和回應性。 |
瀏覽器計時 | browserTimings |
AppBrowserTimings |
測量網頁的效能,包括頁面載入時間和網路持續時間。 |
相依性 | dependencies |
AppDependencies |
追蹤從您的應用程式到外部服務或記憶體的呼叫,例如 REST API 或 SQL 資料庫,並測量這些呼叫的持續時間和成功。 |
事件 | customEvents |
AppEvents |
通常用來擷取應用程式內的用戶互動和其他重要事件,例如按鈕點擊或訂單結帳,以分析使用模式。 |
例外狀況 | exceptions |
AppExceptions |
擷取關鍵的錯誤資訊,有助於故障排除和理解錯誤原因。 |
指標 | performanceCounters customMetrics |
AppPerformanceCounters AppMetrics |
性能計數器提供應用程式和系統效能各個層面的數值數據,例如CPU使用量和記憶體耗用量。 此外,自定義計量可讓您定義和追蹤應用程式特有的特定度量,提供監視自定義效能指標的彈性。 |
頁面檢視 | pageViews |
AppPageViews |
追蹤使用者所檢視的頁面,提供您應用程式內使用者瀏覽和參與的深入解析。 |
請求 | requests |
AppRequests |
記錄應用程式收到的要求,並提供作業標識碼、持續時間和成功或失敗狀態等詳細數據。 |
追蹤 | traces |
AppTraces |
記錄應用程式特定事件,例如自定義診斷訊息或追蹤語句,這些事件有助於偵錯和監視一段時間的應用程式行為。 |
這很重要
您可以從 Application Insights 和 Log Analytics 查詢應用程式遙測 (建議),但數據表和功能變數名稱不同。 此區別會保留向後相容性,例如確保客戶儀錶板中已按照之前的 Log Analytics 命名慣例建立的自定義查詢能繼續正常運作。
若要比較 Azure 入口網站中的欄位名稱,請開啟 Application Insights>記錄,執行查詢,然後複製遙測項目的 Id
(例如 1234a5b6c7de8f90
)。 然後,在瀏覽器中開啟新的索引標籤,移至 Log Analytics>記錄、切換至 KQL 模式,然後執行查詢:
AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"
選取每個列左邊的箭頭以展開這兩個遙測項目,並檢視其所有屬性。
每個遙測專案都可以包含 內容資訊 ,例如應用程式版本或使用者會話標識碼。 內容包含一組強型別欄位,可啟用不同的分析案例。
例如,當應用程式版本正確初始化時,Application Insights 可以在與重新部署相關的應用程式行為中偵測新的模式。 同樣地,您可以使用會話 ID 來評估中斷或用戶問題的影響。 藉由計算與失敗相依性、錯誤追蹤或重大例外狀況相關聯的唯一會話標識碼數目,您可以更清楚瞭解用戶的影響。
Application Insights 遙測模型也支援將遙測項目與其所屬的作業相互關聯。 例如,如果要求觸發SQL Database呼叫,要求和相依性呼叫都可以包含診斷數據,並透過共用相互關聯內容連結,讓您追蹤作業的完整流程。
本文涵蓋每個遙測類型特有的領域。 若要檢視任何遙測類型可用欄位的完整清單(包括內容欄位),請遵循每個相關數據表下方提供的連結。
可用性遙測
可用性遙測牽涉到綜合監視,其中測試會模擬用戶互動,以確認應用程式是否可用且回應回應。 建議您設定 標準可用性測試 ,以監視全球各個點的應用程式可用性,並將您自己的測試資訊傳送至 Application Insights。
可用性特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
id |
Id |
可用性測試結果的唯一標識符,用於個別測試執行之間的相互關聯,這有助於追蹤一段時間的特定失敗或模式。 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
name |
Name |
可用性測試的名稱。 建立測試時會定義它(例如「首頁 ping 測試」)。 |
location |
Location |
執行可用性測試的地理位置或數據中心區域(例如美國西部、北歐)。 它有助於識別區域性中斷或延遲問題。 |
success |
Success |
此欄位指出可用性測試是否成功。 這是布爾值,表示 true 測試成功且 false 表示失敗。 |
message |
Message |
描述性訊息,其中包含測試結果的詳細數據。 它通常包含例外狀況詳細數據或錯誤回應。 |
duration |
Duration |
執行可用性測試所花費的時間量。 它有助於測量效能並識別回應時間問題。 持續時間通常以毫秒為單位來測量。 |
如需所有可用欄位的清單,請參閱 AppAvailabilityResults。
瀏覽器計時遙測
瀏覽器會使用 效能 API 公開頁面載入動作的度量。 Application Insights 藉由將相關時間合併到 標準瀏覽器計量,來簡化這些度量。
瀏覽器計時特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
networkDuration |
NetworkDurationMs |
用戶端會觸達 DNS 以解析網站主機名,而 DNS 會以 IP 位址回應。 用戶端會建立 TCP,然後與網頁伺服器進行 TLS 交握。 |
sendDuration |
SendDurationMs |
用戶端傳送要求承載、等候伺服器執行要求,並接收第一個回應封包。 |
receiveDuration |
ReceiveDurationMs |
用戶端會從網頁伺服器接收其餘的響應承載位元組。 |
processingDuration |
ProcessingDurationMs |
用戶端現在具有完整的響應承載,且必須將內容轉譯至瀏覽器並載入 DOM。 |
totalDuration |
TotalDurationMs |
所有瀏覽器計時的總和。 |
如需所有可用欄位的清單,請參閱 AppBrowserTimings。
依賴性遙測技術
相依性遙測專案代表受監視元件與 SQL 或 HTTP 端點等遠端元件的互動。
相依性特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
id |
Id |
相依性呼叫實例的唯一識別碼,用於與對應此相依性呼叫的要求遙測項目相互關聯。 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
target |
Target |
相依性呼叫的目標網站。 例如伺服器名稱和主機位址。 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
type |
DependencyType |
相依性類型名稱。 這有相依性邏輯群組和其他欄位 (如 commandName 和 resultCode ) 解譯的基數值較低。 範例為 SQL、Azure 資料表和 HTTP。 |
name |
Name |
以這個相依性呼叫起始的命令名稱。 其基數值很低。 範例為預存程序名稱和 URL 路徑範本。 |
data |
Data |
此相依性呼叫起始的命令。 範例為搭配所有查詢參數的 SQL 陳述式和 HTTP URL。 |
success |
Success |
此欄位指出呼叫是否成功。 這是布爾值,表示 true 呼叫成功,表示 false 呼叫失敗。 |
resultCode |
ResultCode |
相依性呼叫的結果碼。 範例為 SQL 錯誤碼與 HTTP 狀態碼。 |
duration |
DurationMs |
要求持續時間的格式為 DD.HH:MM:SS.MMMMMM 。 這必須小於 1000 天。 |
如需所有可用欄位的清單,請參閱 AppDependencies。
事件遙測
您可以建立事件遙測項目來代表應用程式中發生的事件。 通常這是與使用者互動的事件,例如按一下按鈕或簽出訂單。 這也可以是初始化或設定更新等應用程式生命週期事件。
若要深入瞭解如何建立自定義事件遙測,請參閱 新增和修改適用於 .NET、Java、Node.js和 Python 應用程式的 Azure 監視器 OpenTelemetry。
事件特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
name |
Name |
若要允許適當的分組和有用的計量,請限制您的應用程式,使其產生一些個別的事件名稱。 例如,不要為每個產生的事件使用不同的名稱。 |
如需所有可用欄位的清單,請參閱 AppEvents。
例外狀況遙測
例外狀況遙測項目代表受監視應用程式執行期間所發生的已處理或未處理例外狀況。
例外狀況特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
problemId |
ProblemId |
識別在程式碼中擲回例外狀況的位置。 這用於例外狀況群組。 這通常是例外狀況類型和呼叫堆疊中的函式兩者的組合。 |
type |
ExceptionType |
發生的特定例外狀況種類。 這通常包含命名空間和類別名稱,例如 System.NullReferenceException 或 System.InvalidOperationException 。 |
assembly |
Assembly |
擲回例外狀況的組件。 這適用於找出負責例外狀況的應用程式元件。 |
method |
Method |
擲回例外狀況的程序集內的方法名稱。 這提供了發生錯誤的程式碼位置相關資訊。 |
outerType |
OuterType |
如果目前的例外狀況巢狀於另一個例外狀況內,則為外部 (包裝) 例外狀況的型別。 這適用於了解發生內部例外狀況的內容,並有助於追蹤錯誤順序。 |
outerMessage |
OuterMessage |
此訊息提供人類可讀的外部例外狀況說明,並有助於瞭解更廣泛的問題。 |
outerAssembly |
OuterAssembly |
外部例外狀況產生所在的組件。 |
outerMethod |
OuterMethod |
外部例外狀況的方法。 這會提供有關外部例外狀況內失敗點的詳細資訊。 |
severityLevel |
SeverityLevel |
追蹤嚴重性層級可以是下列其中一個值:Verbose 、Information 、Warning 、Error 或 Critical 。 |
details |
Details |
包含例外狀況資訊,例如例外狀況訊息和呼叫堆疊。 |
如需所有可用欄位的清單,請參閱 AppExceptions。
計量遙測
Application Insights 支援兩種類型的計量遙測:
- 單一度量具有名稱和值。
- 預先匯總的計量會在 1 分鐘的匯總期間內採用多個度量。
效能計數器
性能計數器始終為具有 name
和 value
的單一度量計量,但會附加其他欄位 category
和 counter
,另外,instance
只適用於 Windows 應用程式。
效能計數器特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
name |
Name |
您想要在 Application Insights 入口網站中看到的計量名稱。 |
value |
Value |
測量的單一值。 這是個別彙總度量的總和。 |
category |
Category |
表示一組相關的效能計數器(例如 )。 Process |
counter |
Counter |
指定在類別內測量的特定效能計量(例如 , IO Data Bytes/sec 。 |
instance |
Instance |
識別類別內特定出現的計數器 (例如 ??APP_WIN32_PROC?? )。 |
如需所有可用欄位的清單,請參閱 AppPerformanceCounters。
若要深入瞭解計量,請參閱 Application Insights 中的計量。 如需計量 REST API 的詳細資訊,請參閱 計量 - 取得。
系統與流程計數器指標
.NET 名稱 | 描述 |
---|---|
\Processor(_Total)\% Processor Time |
電腦 CPU 總數。 |
\Memory\Available Bytes |
顯示在電腦上執行的程序可用的實體記憶體數量 (以位元組為單位)。 其計算方式為加總填零、可用和待命記憶體清單上的空間數量。 可用記憶體可供立即使用。 填零記憶體由填滿零的記憶體分頁所組成,以免後續程序看見前一個程序所用的資料。 待命記憶體是已從程序的工作集 (其實體記憶體) 移除並傳送到磁碟,但仍可供使用回收的記憶體。 請參閱 記憶體物件。 |
\Process(??APP_WIN32_PROC??)\% Processor Time |
執行應用程式的處理序所用的 CPU。 |
\Process(??APP_WIN32_PROC??)\Private Bytes |
裝載應用程式的處理序所使用的記憶體。 |
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec |
裝載應用程式的處理序執行的 I/O 作業速率。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec |
應用程式處理要求的速率。 |
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec |
應用程式擲回例外狀況的速率。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time |
平均要求執行時間。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue |
佇列中等候處理的要求數目。 |
自訂屬性
將自訂屬性 CustomPerfCounter
設為 true
的計量,會顯示出該計量代表 Windows 效能計數器。 這些計量會放在 performanceCounters
資料表中,而不會放在 customMetrics
中。 另外也會剖析此計量名稱,以擷取分類、計數器,以及執行個體名稱。
自訂計量
自定義計量是您定義的效能指標或商務特定計量,可取得標準計量未涵蓋的深入解析。 若要深入瞭解自定義計量,請參閱 Azure 監視器中的自定義計量(預覽版)。
自訂計量特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
單一測量 | 預先匯總的計量 |
---|---|---|---|
name |
Name |
此欄位是您想要在 Application Insights 入口網站和 UI 中看到的計量名稱。 | |
value |
Value |
此欄位是度量的單一值。 這是個別彙總度量的總和。 | 針對預先匯總的計量, Value 等於 Sum。 |
Max |
Max |
對於單一度量計量, 最大值 等於 Value。 | 此欄位是彙總計量的最大值。 這不應該為度量設定。 |
Min |
Min |
對於單一度量計量, 最小值 等於 Value。 | 此欄位是彙總計量的最小值。 這不應該為度量設定。 |
Sum |
Sum |
對於單一度量計量, Sum 等於 Value。 | 匯總計量的所有值總和。 這不應該為度量設定。 |
Count |
Count |
對於單一度量計量, Count 為 1 。 |
1 分鐘匯總期間中的度量數目。 這不應該為度量設定。 |
如需所有可用欄位的清單,請參閱 AppMetrics。
附註
若要計算平均值,請將 Sum 除以 Count。
網頁檢視遙測
當應用程式用戶開啟受監視應用程式的新頁面時,會記錄頁面檢視遙測。 此內容中的 Page
是邏輯單元,該邏輯單元是由開發人員定義成應用程式索引標籤或畫面,而不一定與瀏覽器網頁負載或重新整理動作相互關聯。
您可以在單頁應用程式 (SPA) 的內容中進一步了解此區別,其中分頁之間的切換不會繫結至瀏覽器分頁動作。 pageViews.duration
是應用程式向使用者呈現分頁的時間。
頁面檢視特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
name |
Name |
用戶檢視的頁面名稱(例如或 "Home" "Shopping Cart" )。 |
url |
Url |
已檢視之頁面的完整 URL。 此欄位對於分析整個應用程式的流量和用戶行為至關重要。 |
duration |
DurationMs |
PageView 持續時間來自瀏覽器的效能計時介面 PerformanceNavigationTiming.duration 。PerformanceNavigationTiming 在該期間使用時,是否為可用狀態。 如果不是,會使用「已取代」PerformanceTiming 的介面,並計算 NavigationStart 和 LoadEventEnd 之間的差異。使用 PageView 來記錄自訂 事件時,開發人員會指定持續時間值。 |
如需所有可用欄位的清單,請參閱 AppPageViews。
附註
根據預設,Application Insights JavaScript SDK 會在每個瀏覽器網頁載入動作上記錄單一
PageView
事件,並pageViews.duration
填入 瀏覽器計時。 開發人員可以藉由使用PageView
來擴充 事件的其他追蹤。默認記錄保留期為 30 天。 如果您想要在較長時間內檢視
PageView
統計數據,您必須調整設定。
要求遙測
要求遙測代表與進入您應用程式的 HTTP 要求相關的資訊。 這種類型的遙測可協助您監視應用程式的 Web 服務效能和成功。 要求遙測項目代表外部要求對應用程式所觸發的執行邏輯順序。 每個要求執行都是由包含全部執行參數的唯一 id
和 url
所識別。
您可以將這些要求依邏輯 name
群組,並定義這項要求的 source
。 程式碼執行可能會導致 success
或 fail
,並且有特定 duration
。 您可以使用 resultCode
,進一步將成功和失敗執行分組。 要求遙測的開始時間是在信封層級上定義的。 要求遙測支援使用自訂 properties
和 measurements
的標準擴充性模型。
要求特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
id |
Id |
要求呼叫實例的唯一標識碼,用於要求與其他遙測項目之間的相互關聯。 識別碼必須是全域唯一的識別碼。 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
source |
Source |
來源是要求的來源。 範例包括呼叫端的檢測金鑰或呼叫端的 IP 位址。 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
name |
Name |
此欄位是要求的名稱,這代表處理要求所採用的程式碼路徑。 低區別度的值可使請求更有效地分組。 針對 HTTP 要求,這表示 HTTP 方法和 URL 路徑範本,例如 GET /values/{id} ,沒有實際的 id 值。Application Insights Web SDK 會將要求名稱依「現狀」傳送 (考量字母大小寫)。 使用者介面的群組是區分大小寫的,因此即使 GET /Home/Index 和 GET /home/INDEX 通常導致相同的控制器和動作執行,它們仍然會被分開計算。 原因是 URL 一般會 區分大小寫。 您可能要查看是否所有 404 錯誤都是在 URL 以大寫輸入時發生的。 您可以在部落格 文章中,閱讀 ASP.NET Web SDK 關於要求名稱集合的詳細資訊。 |
url |
Url |
URL 是包含全部查詢字串參數的要求 URL。 |
success |
Success |
「成功」指出呼叫成功或失敗。 這是必要欄位。 未明確設定為 false 時,要求會視為成功。 如果例外狀況或傳回的錯誤結果碼中斷作業,請將此值設定為 false 。針對 Web 應用程式,當回應碼小於 400 或等於 401 時,Application Insights 會將要求定義為成功。 不過有可能會發生這個預設對應與應用程式的語意不相符的情況。回應碼 404 可能表示「沒有記錄」,這可能是一般流程的一部分。 這也可能表示中斷的連結。 針對中斷的連結,您可以實作更進階的邏輯。 只有當藉由分析 URL 來源判斷損壞的連結位於相同網站時,您才可以將這些連結標示為失敗。 或者,當它們從公司的行動應用程式被存取時,您可以將它們標示為失敗狀態。 同樣地,從不支援重新導向的用戶端存取時,301 和 302 會表示失敗。部分接受的內容 206 可能表示整體要求失敗。 例如,Application Insights 端點可能會接收一批遙測項目做為單一要求。 批次中的某些項目未處理成功時,這會傳回 206 。 206 的速率遞增表示有需要調查的問題。 類似的邏輯也適用於 207 多狀態,其中成功可能是不同回應代碼的最差狀況。 |
resultCode |
ResultCode |
回應碼是要求執行的結果。 這是 HTTP 請求的狀態碼。 可能是 HRESULT 值或其他要求類型的例外狀況類型。 |
duration |
DurationMs |
要求持續時間的格式為 DD.HH:MM:SS.MMMMMM 。 這必須是正數且小於 1000 天。 這是必要欄位,因為要求遙測代表開頭與結尾的作業。 |
如需所有可用欄位的清單,請參閱 AppRequests。
追蹤遙測
追蹤遙測代表以文字搜尋的 printf
樣式追蹤陳述式。 Log4Net
、NLog
和其他文本類型的記錄檔項目會轉換成此類型的實例。 追蹤沒有做為擴充性的度量。
追蹤特定欄位:
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
message |
Message |
追蹤訊息。 |
severityLevel |
SeverityLevel |
記錄嚴重性層級。 |
如需所有可用欄位的清單,請參閱 AppTraces。
附註
severityLevel
的值會列舉且因應不同平台而有所不同。
自訂屬性和度量
自訂屬性
自訂屬性的名稱值集合: 此集合是用來使用自定義維度擴充標準遙測。 產生了遙測或遙測項目特有屬性 (例如訂單編號) 的部署位置就是範例。
- 密鑰長度上限: 150
- 最大值長度: 8,192
自訂度量
自定義度量的集合: 使用此集合來報告與遙測項目相關聯的具名度量。 一般使用案例如下:
- 相依性遙測承載大小。
- 要求遙測所處理的佇列項目數。
- 客戶完成精靈步驟完成事件遙測的時間。
您可以在應用程式分析中查詢自訂度量:
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
附註
- 自訂度量會與其所屬的遙測項目相關聯。 系統會使用包含這些自訂度量的遙測項目來進行取樣。 若要追蹤與其他遙測類型無關值的度量,請使用 計量遙測。
- 請勿對自訂度量使用字串值。 僅支援數值。
密鑰長度上限:150
上下文
每個遙測項目都可能具有強型別的內容欄位。 每個欄位都具有特定的監視案例。 請使用自訂屬性集合來儲存自訂或應用程式特定的內容資訊。
欄位名稱 (Application Insights) |
欄位名稱 (Log Analytics) |
描述 |
---|---|---|
account_ID |
user_AccountId |
在多租用戶應用程式中,帳戶識別碼是使用者行動所依據的租用戶帳戶識別碼或名稱。 使用者識別碼和已驗證的使用者識別碼不足時,其會用於更多的使用者分割。 例如,Azure 入口網站的訂用帳戶識別碼或部落格平台的部落格名稱。 |
application_Version |
AppVersion |
應用程式內容欄位中一律是與傳送遙測的應用程式相關的資訊。 應用程式版本可用於分析應用程式行為及其與部署相互關聯中的趨勢變更。 |
appId |
ResourceGUID |
Application Insights 資源的唯一識別碼,用於區分來自不同應用程式的遙測資料。 |
appName |
N/A | 在 Application Insights 中, appName 與 _ResourceId 相同。 |
client_Browser |
ClientBrowser |
用戶端所使用的網頁瀏覽器名稱。 |
client_City |
ClientCity |
收集遙測時用戶端所在的城市(根據IP地理位置)。 |
client_CountryOrRegion |
ClientCountryOrRegion |
收集遙測時用戶端所在的國家或地區(根據IP地理位置)。 |
client_IP |
ClientIP |
用戶端裝置的IP位址。 可支援 IPv4 和 IPv6。 從服務傳送遙測時,位置內容與服務中起始作業的使用者相關。 Application Insights 會從用戶端 IP 擷取地理位置資訊,然後截斷它。 因此用戶端 IP 本身無法作為使用者識別資訊。 |
client_OS |
ClientOS |
指示生成遙測數據的用戶端的操作系統。 |
client_StateorProvince |
ClientStateOrProvince |
收集遙測時用戶端所在的州或省(根據IP地理位置)。 |
client_Type |
ClientType |
描述傳送遙測的用戶端裝置類型(例如 Browser 或 PC 。 |
cloud_RoleInstance |
AppRoleInstance |
應用程式執行所在的實例名稱。 例如,這是內部部署的電腦名稱或 Azure 的執行個體名稱。 |
cloud_RoleName |
AppRoleName |
應用程式所屬角色的名稱。 這在 Azure 中直接對應於角色名稱。 您也可以將其用於區別微服務,這是單一應用程式的一部分。 |
iKey |
IKey |
用來將遙測數據與特定 Application Insights 資源產生關聯的舊版唯一標識符。 |
itemId |
N/A | 特定遙測專案的唯一標識符。 |
itemCount |
ItemCount |
與單一遙測事件相關聯的發生次數或計數。 |
operation_Id |
OperationId |
根作業的唯一標識碼。 此識別碼允許將遙測資料群組化於多個元件之間。 如需詳細資訊,請參閱 遙測相互關聯。 要求或頁面檢視會建立作業識別碼。 所有其他遙測會將此欄位設定為包含要求或頁面檢視的值。 |
operation_Name |
OperationName |
作業的名稱(群組)。 要求或頁面檢視會建立作業名稱。 所有其他遙測項目會將此欄位設定為包含要求或頁面檢視的值。 作業名稱可用於尋找作業群組的全部遙測項目 (例如 GET Home/Index )。 此內容屬性可用於回答「此頁面擲回的一般例外狀況為何?」等問題。 |
operation_ParentId |
ParentId |
遙測項目直屬父代的唯一識別碼。 如需詳細資訊,請參閱 遙測相互關聯。 |
operation_SyntheticSource |
SyntheticSource |
合成來源的名稱。 應用程式中的一些遙測數據可能代表模擬流量。 這可能是網頁爬蟲在為網站建立索引、網站可用性測試,或是來自診斷程式庫(例如 Application Insights SDK 本身)的追蹤記錄。 |
sdkVersion |
SDKVersion |
傳送遙測數據的Application Insights SDK 版本。 如需詳細資訊,請參閱 SDK 版本。 |
session_Id |
SessionId |
工作階段識別碼是與應用程式進行使用者互動的執行個體。 會話上下文欄位中的資訊總是與使用者相關。 從服務傳送遙測時,工作階段內容與服務中起始作業的使用者相關。 |
user_AuthenticatedId |
UserAuthenticatedId |
已驗證的使用者識別碼與匿名使用者識別碼相反。 此欄位代表名稱易記的使用者。 根據預設,只會使用 ASP.NET Framework SDK 的 AuthenticatedUserIdTelemetryInitializer 收集此識別碼。使用 Application Insights SDK,搭配在瀏覽器和裝置之間持續識別使用者的值,初始化已驗證的使用者識別碼。 如此一來,所有遙測項目都會屬於該唯一識別碼。 此標識元可針對特定使用者收集的所有遙測進行查詢(受限於 取樣組態 和 遙測篩選)。 使用者識別碼可以與工作階段識別碼交叉參考,以提供唯一的遙測維度,並在工作階段期間建立使用者活動。 |
user_Id |
UserId |
匿名使用者識別碼代表應用程式的使用者。 從服務傳送遙測時,使用者內容與服務中起始作業的使用者相關。 取樣 是將所收集遙測量降至最低的其中一種技術。 取樣演算法會嘗試取樣輸入或輸出全部相互關聯的遙測。 匿名使用者識別碼用於產生取樣分數,因此匿名使用者識別碼應該為足夠隨機的值。 匿名使用者識別碼的計數與唯一應用程式使用者的數目不同。 匿名使用者識別碼的計數通常較高,因為每次使用者在不同的裝置或瀏覽器上開啟您的應用程式,或清除瀏覽器 Cookie 時,都會配置新的唯一匿名使用者識別碼。 此計算可能會導致將相同的實體使用者計數多次。 使用者識別碼可以與工作階段識別碼交叉參考,以提供唯一的遙測維度,並在工作階段期間建立使用者活動。 使用匿名使用者識別碼儲存使用者名稱是濫用欄位的做法。 使用已驗證的使用者識別碼。 |
_ResourceId |
_ResourceId |
Application Insights 元件的完整 Azure 資源識別碼,其中包含訂用帳戶、資源群組和資源名稱。 |
下一步
- 檢閱常見問題(常見問題): 遙測數據模型常見問題
- 瀏覽 Application Insights 所支援的平臺。
- 了解如何使用 Azure 監視器 OpenTelemetry Distro 收集自訂遙測。
- 瞭解如何 使用Application Insights API進行自定義事件和計量。
- 瞭解如何 擴充和篩選遙測。
- 瞭解如何使用 取樣 ,根據數據模型將遙測量降到最低。