Microsoft.VisualStudio.Telemetry 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
類別
AssetEvent |
類別,儲存資產事件的資訊。 資產是使用者工作或作業的目標,例如 Solution、Project、File、Extension、License、Designer。 |
AssetService |
類別,可為資產取用者和提供者提供說明方法。 取用者可以使用這個類別,透過 GetCorrelation 方法來取得相互關聯。 提供者可以透過 RegisterCorrelation 方法來註冊此服務中的現有相互關聯,或 (並) 透過 RegisterProvider 方法註冊自己,以傳送資產事件並傳回每個取用者的要求相互關聯。 |
DataModelEventNameHelper |
協助程式類別,用來驗證事件名稱是否符合數據模型事件名稱架構,並根據名稱設定屬性。 以下是數據模型事件名稱架構,它要求事件名稱是唯一的,而不是 Null 或空字串。 它包含 3 個部分,必須遵循模式 [product]/[featureName]/[entityName]。 FeatureName 可以是以 「」分隔的一層功能或功能階層。 例如,vs/platform/opensolution;vs/platform/editor/lightbulb/fixerror; |
FaultEvent |
代表Fault的遙測事件,例如例外狀況我們有2個後端可傳送數據:遙測後端和 Watson (後端) 。 跨平臺, (如同 Mac、Linux) ,我們可以使用相同的架構。 例如,在 Mac 上,有 Merp,這是 Windows 錯誤報告 的 Max 實作。 FaultEvent 繼承自 TelemetryEvent 使用者可以直接建立此類別的實例,而且可以直接在類別上新增自定義屬性,而不需使用回呼。 建立其中一項之後,請呼叫 Session.PostFault (faultEvent) 呼叫回呼、將事件張貼至 Watson (,如果取樣) 和 Post 作為一般遙測事件,或者您可以使用 TelemetrySession.PostFault () ,而不是直接使用此類別。 |
JsonCreationConverter<T> |
抽象基類,在使用Newtonsoft.Json從 Json 還原串行化對象期間,做為物件建立者的基類 |
OperationEvent |
類別,儲存作業數據模型事件的資訊。 作業會在應用程式中執行一些工作,併產生結果 (例如成功、失敗) 。 如果使用者直接叫用作業,請使用 UserTaskEvent 或相關方法。 作業的一些範例包括授權檢查、套件載入、Windows 版面配置載入。 對於長時間執行或異步操作,若要了解時間期間發生的其他狀況,或追蹤是否因為錯誤而部分完成,請使用追蹤起點和終點的方法 StartOperation(TelemetrySession, String) 。 |
TelemetryActivity |
[過時]請使用數據模型 TelemetryScope<T> 來追蹤 dev15 和更新版本中的效能。 更多詳細資料位於 http://aka.ms/datamodel。 |
TelemetryComplexProperty |
這個類別代表複雜值支援,例如陣列、字典。 處理器會將它轉換成 JSON 字串。 此外,針對這類類型,我們會放寬屬性值的1K限制。 |
TelemetryContext |
遙測內容是工作單位的概念。 更多詳細資料請看這裡 |
TelemetryDataModelProperty |
這個類別代表數據模型屬性。 |
TelemetryDisposableObject |
協助程式基類提供虛擬方法來釋放Managed資源,並防止呼叫 Dispose 數次。 |
TelemetryEvent |
類別代表可張貼至伺服器的遙測事件。 類別不是安全線程 |
TelemetryEventMatchByName |
這個類別可用來依遙測事件名稱來表示遙測篩選。 |
TelemetryHashedProperty |
這個類別代表應該哈希的屬性。 在處理期間,包含的原始值將會由密碼編譯演算法轉換成哈希值。 |
TelemetryMetricProperty |
這個類別代表數據模型計量屬性。 屬性名稱將會以後綴 「.張貼事件時的 DataModelMetric” 計量是收集為系統特定特性度量的值或匯總計數。 例如,檔案大小、項目計數、上傳大小等使用計量;效能計量,例如持續時間。 |
TelemetryPiiProperty |
這個類別代表個人標識資訊屬性。 在處理期間,包含的原始值將會由密碼編譯演算法轉換成哈希值。 |
TelemetryPropertyBag |
TelemetryPropertyBag 適用於將屬性新增至子事件 |
TelemetryPropertyBags |
屬性包的集合 |
TelemetryPropertyBags.Concurrent<TValue> |
並行屬性包 |
TelemetryResultStrings |
類別,定義用於屬性 Result 的字串。 |
TelemetryScope<T> |
這個類別是用來傳送應用程式使用持續時間和結果的數據模型事件。 事件可以是 , UserTaskEvent 或者 OperationEvent 它會在開頭傳送一個事件,另一個事件則傳送在工作結束時。 |
TelemetryScopeSettings |
這個類別是包裝用來控制 TelemetryScope 行為建立實例時的設定。 |
TelemetryService |
核心遙測類別。 它有預設的會話物件。 |
TelemetrySession |
表示可以張貼遙測事件和會話屬性的一個遙測會話。 API 會盡最大努力將遙測數據傳遞至伺服器。 要求會以批次方式排入佇列並傳送。 如果進程結束之前無法傳送事件,事件將會儲存在本機。 當下一個應用程式實例呼叫遙測 API 時,傳送將會繼續。 當進程沒有回應或嚴重損毀或沒有因特網連線 30 天時,遙測可能會遺失。 所有方法都是安全線程,並立即傳回。 |
TelemetrySessionCommandLineExtensions |
用於 TelemetrySession 張貼命令行自變數的擴充方法。 |
TelemetrySessionExtensions |
類別,包含現有類別 TelemetrySession 的所有數據模型擴充方法。 |
TelemetrySettingProperty |
這個類別代表數據模型設定屬性。 屬性名稱將會以後綴 「.張貼事件時,DataModelSetting“。 設定是使用者可以自定義值,以變更應用程式的外觀/風格/行為。 例如 VS 工具選項對話框中的所有設定。 機器層級或環境屬性不是設定。 它們應該張貼為一般屬性。 例如 CPU 計數、OS 地區設定。 |
TelemetryTestChannelEventArgs |
測試通道自變數 |
UserTaskEvent |
類別,儲存使用者工作數據模型事件的資訊。 使用者工作是直接由 USER 叫用的應用程式作業,其結果 (例如成功、失敗) 。 用於用戶行為/意圖分析。 使用者知道作業並能夠執行。 例如,開啟專案和顯示工具視窗是使用者工作;而是載入 VS 套件和設計時間建置是作業。 對於長時間執行或異步使用者工作,若要了解時間期間發生的其他狀況,或追蹤是否因為錯誤而部分完成,請使用追蹤起點和終點的方法 StartUserTask(TelemetrySession, String) 。 |
結構
TelemetryEventCorrelation |
用來定義相互關聯信息的結構。 |
介面
IAssetProvider |
資產提供者所實作的介面,可依需求提供資產相互關聯標識碼。 |
IFaultUtility |
用於原生程式代碼呼叫端的FaultCallback介面 |
ISetTelemetrySession |
TelemetryNotificationService.Default 和 TelemetryService.DefaultSession |
ITelemetryEtwProvider |
遙測事件的主機特定 ETW 提供者實作。 |
ITelemetryEventMatch |
表示遙測事件篩選。 |
ITelemetryManifestRouteArgs |
ITelemetryManifestRouteArgs 介面,用於提供自變數給路由器 |
ITelemetryPropertyBag<TValue> |
泛型 PropertyBag 的 ITelemetryPropertyBag 介面 |
ITelemetryTestChannel |
要接收事件的測試通道介面 |
列舉
DataModelEventType |
支援的數據模型事件類型 |
FaultSeverity |
根據預期的重要性或影響,指定錯誤的嚴重性指標。 在報告中,會提升更嚴重的錯誤,而較不嚴重的錯誤將會反強調。 |
OperationStageType |
要定義作業階段類型的列舉。 請勿變更列舉名稱,因為它是用戶端-伺服器合約的一部分。 |
TelemetryResult |
要定義使用者工作或作業結果的列舉。 |
TelemetrySeverity |
要定義遙測事件嚴重性之列舉。 它用於任何想要根據嚴重性分類數據的數據取用者。 |
WER_DUMP_TYPE |
傾印類型 https://msdn.microsoft.com/en-us/library/windows/desktop/bb513622(v=vs.85).aspx |