從 Application Insights 匯出遙測

想要讓遙測保留比標準保留期限還久的時間？ 或者，您想要以某種特殊方式加以處理？ 連續匯出很適合此目的。 在 Application Insights 入口網站中看見的事件，可以使用 JSON 格式匯出到 Azure 中的儲存體。 從那裡，您可以下載資料並編寫處理所需的任何程式碼。

在設定連續匯出之前，您可能要考慮某些替代作法︰

• 計量或搜尋索引標籤頂端的 [匯出] 按鈕，可讓您傳送資料表和圖表到 Excel 試算表。
• Log Analytics 可提供功能強大的遙測查詢語言。 它也可以匯出結果。
• 如果您想要在 Power BI 中探索您的資料，若您已移轉至以工作區為基礎的資源，則不需使用連續匯出即可達成。
• 資料存取 REST API 可讓您以程式設計方式存取您的遙測。
• 您也可以透過 PowerShell 存取連續匯出設定。

在「連續匯出」將您的資料複製到儲存體 (資料可在此依您喜好的時間長短存放) 之後，資料仍然會在 Application Insights 中依一般的保留期間可供使用。

支援區域

以下區域支援連續匯出：

• 東南亞
• 加拿大中部
• 印度中部
• 北歐
• 英國南部
• 澳大利亞東部
• 日本東部
• 南韓中部
• 法國中部
• 東亞
• 美國西部
• 美國中部
• 美國東部 2
• 美國中南部
• 美國西部 2
• 南非北部
• 美國中北部
• 巴西南部
• 瑞士北部
• 澳大利亞東南部
• 英國西部
• 德國中西部
• 瑞士西部
• 澳大利亞中部 2
• 阿拉伯聯合大公國中部
• 巴西東南部
• 澳大利亞中部
• 阿拉伯聯合大公國北部
• 挪威東部
• 日本西部

連續匯出進階儲存體設定

連續匯出「不支援」下列 Azure 儲存體功能/設定：

• 使用 Azure 虛擬網路/Azure 儲存體防火牆搭配 Azure Blob 儲存體。
• Azure Data Lake Storage Gen2。

建立連續匯出

1. 在您應用程式的 Application Insights 資源中，於左側 [設定] 之下開啟 [連續匯出]，然後選擇 [新增]。

2. 選擇您想要匯出的遙測資料類型。

3. 建立或選取要用來儲存資料的 Azure 儲存體帳戶。 如需有關儲存體價格選項的詳細資訊，請參閱定價頁面。

   選取 [新增]>[匯出目的地]>[儲存體帳戶]。 然後建立新的存放區或選擇現有存放區。

   警告

   根據預設，儲存體位置將設為與您 Application Insights 資源相同的地理區域。 如果您儲存在不同的區域中，可能會產生傳輸費用。

4. 建立或選取儲存體中的容器。

資料出現在儲存體中之前可能有大約一小時的延遲。

第一次匯出完成之後，您會在 Blob 儲存體容器中找到下列結構。 (此結構會根據您收集的資料而有所不同。)

名稱	描述
可用性	回報 可用性 Web 測試。
事件	TrackEvent()產生的自訂事件。
例外狀況	回報在伺服器和瀏覽器中的 例外狀況 。
訊息	由 TrackTrace 及記錄配接器傳送。
計量	由計量 API 呼叫所產生。
PerformanceCounters	Application Insights 所收集的效能計數器。
要求	由 TrackRequest傳送。 標準模組使用要求來回報在伺服器上測量的伺服器回應時間。

編輯連續匯出

選取 [連續匯出]，然後選取要編輯的儲存體帳戶。

停止連續匯出

若要停止匯出，請選取 [停用]。 當您再次選取 [啟用] 時，匯出將會以新資料重新啟動。 您無法取得在停用匯出時送抵入口網站的資料。

若要永久停止匯出，請刪除它。 這麼做不會將您的資料從儲存體刪除。

無法加入或變更匯出？

若要新增或變更匯出，您需要擁有者、參與者或 Application Insights 參與者存取權。 了解角色。

您取得什麼事件？

匯出的資料是我們從您的應用程式接收的原始遙測，並加入了從用戶端 IP 位址新增的位置資料。

取樣已捨棄的資料不會包含在匯出的資料中。

未包含其他計算的計量。 例如，我們不會匯出平均 CPU 使用率，但我們會匯出用以計算平均的原始遙測。

該資料也包含您曾設定之 可用性 Web 測試 的任何結果。

檢查資料

您可以直接在入口網站中檢查儲存體。 選取最左邊功能表上的 [首頁]。 在顯示 Azure 服務的頂端，選取 [儲存體帳戶]。 選取儲存體帳戶名稱，然後在 [概觀] 頁面上選取 [服務]>[Blob]。 最後，選取容器名稱。

若要在 Visual Studio 中檢查 Azure 儲存體，請依序選取 [檢視]>[Cloud Explorer]。 如果您沒有該功能表命令，您需要安裝 Azure SDK。 開啟 [新增專案] 對話方塊，展開 Visual C#/Cloud並選取 [取得 Microsoft Azure SDK for .NET]。

當您開啟 Blob 存放區時，您會看到含有一組 Blob 檔案的容器。 您會看到衍生自您的 Application Insights 資源名稱、其檢測金鑰、遙測類型、日期和時間之每個檔案的 URI。 資源名稱全部小寫，而檢測金鑰會省略連字號。

日期和時間為 UTC，並且是遙測存放在儲存區的時間，而不是產生的時間。 基於這個理由，如果您編寫程式碼來下載資料，其可以透過資料線性地移動。

以下是路徑的格式︰

$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"

其中：

• blobCreationTimeUtc 是在內部暫存儲存體中建立 Blob 的時間。
• blobDeliveryTimeUtc 是將 Blob 複製到匯出目的地儲存體的時間。

資料格式

資料格式的設定方式：

• 每個 Blob 是包含多個以 \n 分隔的列的文字檔案。 它包含大約半分鐘的時間內所處理的遙測。

• 每個資料列都代表遙測資料點，例如要求或頁面檢視。

• 每列是未格式化的 JSON 文件。 如果您想要檢視資料列，請在 Visual Studio 中開啟 Blob，然後選取 [編輯]>[進階]>[格式檔案]。

  

時間期間依刻度為單位，10000 刻度 = 1 毫秒。 例如，這些值顯示從瀏覽器傳送要求用了 1 毫秒的時間，接收它用了 3 毫秒，以及在瀏覽器中處理頁面用了 1.8 秒：

"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}

如需屬性類型和值的詳細資料模型參考，請參閱 Application Insights 匯出資料模型。

處理資料

就小型規模而言，您可以編寫一些程式碼來取出您的資料，將其讀取為試算表。 例如：

private IEnumerable<T> DeserializeMany<T>(string folderName)
{
   var files = Directory.EnumerateFiles(folderName, "*.blob", SearchOption.AllDirectories);
   foreach (var file in files)
   {
      using (var fileReader = File.OpenText(file))
      {
         string fileContent = fileReader.ReadToEnd();
         IEnumerable<string> entities = fileContent.Split('\n').Where(s => !string.IsNullOrWhiteSpace(s));
         foreach (var entity in entities)
         {
            yield return JsonConvert.DeserializeObject<T>(entity);
         }
      }
   }
}

如需較大型的程式碼範例，請參閱使用背景工作角色。

刪除舊資料

您需負責管理儲存容量，以及在必要時刪除舊資料。

重新產生儲存體金鑰

如果您變更儲存體的金鑰，連續匯出將停止運作。 您將在 Azure 帳戶中看到通知。

選取 [連續匯出] 索引標籤，然後編輯您的匯出。 編輯 [匯出目的地] 值，但只保留選取相同的儲存體。 選取 [確定] 來確認。

連續匯出將重新開始。

匯出範例

如需匯出範例，請參閱：

• 使用串流分析匯出至 SQL
• 串流分析範例 2

就更大型規模而言，請考慮雲端中的 HDInsight Hadoop 叢集。 HDInsight 提供各種技術來管理和分析巨量資料。 您可以用其來處理已從 Application Insights 匯出的資料。

常見問題集

本節提供常見問題的答案。

我可以取得圖表的一次性下載嗎？

您可以辦得到。 在索引標籤頂端，選取 [匯出資料]。

我設定匯出，但我的存放區中為何沒有任何資料？

自從設定匯出之後，Application Insights 是否從您的應用程式收到任何遙測？ 您將只會收到新資料。

我嘗試設定匯出，但我為何被拒絕存取？

如果帳戶是組織所擁有，您必須是擁有者或參與者群組的成員。

我是否能直接匯出到我自己的內部部署儲存區？

否。 我們的匯出引擎目前僅適用於 Azure 儲存體。

放置在我的儲存區中的資料量有任何限制？

否。 我們將持續送入資料，直到刪除匯出為止。 我們會在達到 Blob 儲存體外部限制時停止，但是該限制很大。 您可以自行控制使用的儲存體數量。

應該在儲存體中看到多少 Blob？

• 針對您選取要匯出的每個資料類型，會每分鐘建立一個新的 Blob (如果有可用的資料)。
• 針對具有高流量的應用程式，則會配置額外的分割單位。 在此情況下，每個單位會每分鐘建立一個 Blob。

我對我的儲存體重新產生了金鑰，或變更了容器的名稱，但匯出為何沒有作用？

編輯匯出並選取 [匯出目的地] 索引標籤。保持選取與先前相同的儲存體，然後選取 [確定] 進行確認。 匯出將重新開始。 如果變更是在最近幾天內，您不會遺失資料。

我可以暫停匯出嗎？

是。 選取 [停用]。

程式碼範例

• 串流分析範例
• 使用串流分析匯出至 SQL
• 屬性類型和值的詳細資料模型參考

診斷設定型匯出

建議使用診斷設定匯出，因為可以提供額外功能：

診斷設定匯出與連續匯出的進一步差異如下：

• 更新的結構描述。
• 遙測資料會在到達時傳送，而不是批次上傳。

如何移轉至診斷設定匯出：

1. 在傳統 Application Insights 上啟用診斷設定。
2. 設定您的資料匯出：選取[診斷設定> ]，從 Application Insights 資源內新增診斷設定。
3. 確認新資料匯出設定與您連續匯出相同

Application Insights 匯出資料模型

此表列出從 Application Insights SDK 傳送至入口網站的遙測屬性。 您會在 連續匯出的資料輸出中看到這些屬性。 它們也會出現在計量瀏覽器和診斷搜尋的屬性篩選中。

注意事項：

• [0] 代表您必須在路徑中插入索引的一點，但它未必是 0。
• 持續時間的長度單位是微秒，因此 10000000 == 1 秒。
• 日期和時間是 UTC，並以 ISO 格式 yyyy-MM-DDThh:mm:ss.sssZ

範例

// A server report about an HTTP request
{
  "request": [
    {
      "urlData": { // derived from 'url'
        "host": "contoso.org",
        "base": "/",
        "hashTag": ""
      },
      "responseCode": 200, // Sent to client
      "success": true, // Default == responseCode<400
      // Request id becomes the operation id of child events
      "id": "fCOhCdCnZ9I=",  
      "name": "GET Home/Index",
      "count": 1, // 100% / sampling rate
      "durationMetric": {
        "value": 1046804.0, // 10000000 == 1 second
        // Currently the following fields are redundant:
        "count": 1.0,
        "min": 1046804.0,
        "max": 1046804.0,
        "stdDev": 0.0,
        "sampledValue": 1046804.0
      },
      "url": "/"
    }
  ],
  "internal": {
    "data": {
      "id": "7f156650-ef4c-11e5-8453-3f984b167d05",
      "documentVersion": "1.61"
    }
  },
  "context": {
    "device": { // client browser
      "type": "PC",
      "screenResolution": { },
      "roleInstance": "WFWEB14B.fabrikam.net"
    },
    "application": { },
    "location": { // derived from client ip
      "continent": "North America",
      "country": "United States",
      // last octagon is anonymized to 0 at portal:
      "clientip": "168.62.177.0",
      "province": "",
      "city": ""
    },
    "data": {
      "isSynthetic": true, // we identified source as a bot
      // percentage of generated data sent to portal:
      "samplingRate": 100.0,
      "eventTime": "2016-03-21T10:05:45.7334717Z" // UTC
    },
    "user": {
      "isAuthenticated": false,
      "anonId": "us-tx-sn1-azr", // bot agent id
      "anonAcquisitionDate": "0001-01-01T00:00:00Z",
      "authAcquisitionDate": "0001-01-01T00:00:00Z",
      "accountAcquisitionDate": "0001-01-01T00:00:00Z"
    },
    "operation": {
      "id": "fCOhCdCnZ9I=",
      "parentId": "fCOhCdCnZ9I=",
      "name": "GET Home/Index"
    },
    "cloud": { },
    "serverDevice": { },
    "custom": { // set by custom fields of track calls
      "dimensions": [ ],
      "metrics": [ ]
    },
    "session": {
      "id": "65504c10-44a6-489e-b9dc-94184eb00d86",
      "isFirst": true
    }
  }
}

內容

所有類型的遙測都會伴隨內容區段。 並非所有的欄位都會連同每個資料點傳輸。

路徑	類型	注意
context.custom.dimensions [0]	物件 [ ]	由自訂屬性參數設定的索引鍵-值字串組。 索引鍵的最大長度 100，值的最大長度 1024。 超過 100 個唯一值時，屬性可供搜尋，但無法用來分割。 每個 ikey 的最大值 200 索引鍵。
context.custom.metrics [0]	物件 [ ]	由自訂測量參數和 TrackMetrics 設定的索引鍵-值組。 索引鍵的最大長度 100，值可能為數值。
context.data.eventTime	字串	UTC
context.data.isSynthetic	boolean	要求似乎來自 bot 或 web 測試。
context.data.samplingRate	數字	由傳送至入口網站之 SDK 所產生的遙測百分比。 範圍 0.0-100.0。
context.device	object	用戶端裝置
context.device.browser	字串	IE, Chrome, ...
context.device.browserVersion	字串	Chrome 48.0, ...
context.device.deviceModel	字串
context.device.deviceName	字串
context.device.id	字串
context.device.locale	字串	en-GB, de-DE, ...
context.device.network	字串
context.device.oemName	字串
context.device.os	字串
context.device.osVersion	字串	主機 OS
context.device.roleInstance	字串	伺服器主機的識別碼
context.device.roleName	字串
context.device.screenResolution	字串
context.device.type	字串	PC, Browser, ...
context.location	object	衍生自 clientip。
context.location.city	字串	衍生自 clientip (如果已知)
context.location.clientip	字串	最後一個八邊形匿名設定為 0。
context.location.continent	字串
context.location.country	字串
context.location.province	字串	州或省
context.operation.id	字串	具有相同 operation id 的項目會在入口網站中顯示為相關項目。 通常是 request id。
context.operation.name	字串	url 或要求名稱
context.operation.parentId	字串	允許巢狀的相關項目。
context.session.id	字串	來自相同來源的作業群組 Id。 在 30 分鐘期間沒有發出工作階段結束訊號的作業。
context.session.isFirst	boolean
context.user.accountAcquisitionDate	字串
context.user.accountId	字串
context.user.anonAcquisitionDate	字串
context.user.anonId	字串
context.user.authAcquisitionDate	字串	已驗證的使用者
context.user.authId	字串
context.user.isAuthenticated	boolean
context.user.storeRegion	字串
internal.data.documentVersion	字串
internal.data.id	字串	項目內嵌至 Application Insights 時所指派的 Unique id

事件

TrackEvent()產生的自訂事件。

路徑	類型	注意
事件 [0] 計數	整數	100/(取樣 率)。 例如 4 => 25%。
事件 [0] 名稱	字串	事件名稱。 最大長度 250。
事件 [0] url	字串
事件 [0] urlData.base	字串
事件 [0] urlData.host	字串

例外狀況

回報在伺服器和瀏覽器中的 例外狀況 。

路徑	類型	注意
basicException [0] 組件	字串
basicException [0] 計數	整數	100/(取樣 率)。 例如 4 => 25%。
basicException [0] exceptionGroup	字串
basicException [0] exceptionType	字串
basicException [0] failedUserCodeMethod	字串
basicException [0] failedUserCodeAssembly	字串
basicException [0] handledAt	字串
basicException [0] hasFullStack	boolean
basicException [0] id	字串
basicException [0] 方法	字串
basicException [0] 訊息	字串	例外狀況訊息。 最大長度 10k。
basicException [0] outerExceptionMessage	字串
basicException [0] outerExceptionThrownAtAssembly	字串
basicException [0] outerExceptionThrownAtMethod	字串
basicException [0] outerExceptionType	字串
basicException [0] outerId	字串
basicException [0] parsedStack [0] 組件	字串
basicException [0] parsedStack [0] fileName	字串
basicException [0] parsedStack [0] 層級	整數
basicException [0] parsedStack [0] 列	整數
basicException [0] parsedStack [0] 方法	字串
basicException [0] 堆疊	字串	最大長度 10k
basicException [0] typeName	字串

追蹤訊息

由 TrackTrace 及記錄配接器傳送。

路徑	類型	注意
訊息 [0] loggerName	字串
訊息 [0] 參數	字串
訊息 [0] 原始碼	字串	記錄檔訊息，最大長度 10k。
訊息 [0] severityLevel	字串

遠端相依性

由 TrackDependency 傳送。 用於回報伺服器中 相依性呼叫 以及瀏覽器中 AJAX 呼叫的效能和使用情形。

路徑	類型	注意
remoteDependency [0] async	boolean
remoteDependency [0] baseName	字串
remoteDependency [0] commandName	字串	例如 "home/index"
remoteDependency [0] 計數	整數	100/(取樣 率)。 例如 4 => 25%。
remoteDependency [0] dependencyTypeName	字串	HTTP、SQL、...
remoteDependency [0] durationMetric.value	數字	從根據相依性呼叫回應完成開始計算的時間
remoteDependency [0] id	字串
remoteDependency [0] 名稱	字串	Url。 最大長度 250。
remoteDependency [0] resultCode	字串	從 HTTP 相依性
remoteDependency [0] 成功	boolean
remoteDependency [0] 類型	字串	Http、Sql、...
remoteDependency [0] url	字串	最大長度 2000
remoteDependency [0] urlData.base	字串	最大長度 2000
remoteDependency [0] urlData.hashTag	字串
remoteDependency [0] urlData.host	字串	最大長度 200

Requests

由 TrackRequest傳送。 標準模組使用它回報在伺服器上測量的伺服器回應時間。

路徑	類型	注意
要求 [0] 計數	整數	100/(取樣 率)。 例如：4 => 25%。
要求 [0] durationMetric.value	數字	從要求抵達到回應的時間。 1e7 == 1s
要求 [0] id	字串	Operation id
要求 [0] 名稱	字串	GET/POST + url 基底。 最大長度 250
要求 [0] responseCode	整數	傳送至用戶端的 HTTP 回應
要求 [0] 成功	boolean	預設值 == (responseCode < 400)
要求 [0] url	字串	不包括主機
要求 [0] urlData.base	字串
要求 [0] urlData.hashTag	字串
要求 [0] urlData.host	字串

頁面檢視效能

由瀏覽器傳送。 測量處理頁面的時間，從使用者起始要求到顯示完成 (不包括非同步 AJAX 呼叫)。

內容值會顯示用戶端作業系統和瀏覽器版本。

路徑	類型	注意
clientPerformance [0] clientProcess.value	整數	從接收 HTML 完成到顯示頁面的時間。
clientPerformance [0] 名稱	字串
clientPerformance [0] networkConnection.value	整數	建立網路連線所需的時間。
clientPerformance [0] receiveRequest.value	整數	從傳送要求完成至接收回覆中 HTML 的時間。
clientPerformance [0] sendRequest.value	整數	傳送 HTTP 要求所需的時間。
clientPerformance [0] total.value	整數	從開始傳送要求到顯示頁面的時間。
clientPerformance [0] url	字串	此要求的 URL
clientPerformance [0] urlData.base	字串
clientPerformance [0] urlData.hashTag	字串
clientPerformance [0] urlData.host	字串
clientPerformance [0] urlData.protocol	字串

頁面檢視

由 trackPageView() 或 stopTrackPage 傳送

路徑	類型	注意
檢視 [0] 計數	整數	100/(取樣 率)。 例如 4 => 25%。
檢視 [0] durationMetric.value	整數	在 trackPageView() 中或由 startTrackPage() - stopTrackPage() 選擇性設定的值。 和 clientPerformance 的值不同。
檢視 [0] 名稱	字串	頁面標題。 最大長度 250
檢視 [0] url	字串
檢視 [0] urlData.base	字串
檢視 [0] urlData.hashTag	字串
檢視 [0] urlData.host	字串

可用性

回報 可用性 Web 測試。

路徑	類型	注意
可用性 [0] availabilityMetric.name	字串	availability
可用性 [0] availabilityMetric.value	數字	1.0 或 0.0
可用性 [0] 計數	整數	100/(取樣 率)。 例如 4 => 25%。
可用性 [0] dataSizeMetric.name	字串
可用性 [0] dataSizeMetric.value	整數
可用性 [0] durationMetric.name	字串
可用性 [0] durationMetric.value	數字	測試持續時間。 1e7==1s
可用性 [0] 訊息	字串	失敗診斷
可用性 [0] 結果	字串	通過/失敗
可用性 [0] runLocation	字串	http req 的地理區域來源
可用性 [0] testName	字串
可用性 [0] testRunId	字串
可用性 [0] testTimestamp	字串

計量

由 TrackMetric() 產生。

度量值位於 context.custom.metrics[0]

例如：

{
  "metric": [ ],
  "context": {
  ...
    "custom": {
      "dimensions": [
        { "ProcessId": "4068" }
      ],
      "metrics": [
        {
          "dispatchRate": {
            "value": 0.001295,
            "count": 1.0,
            "min": 0.001295,
            "max": 0.001295,
            "stdDev": 0.0,
            "sampledValue": 0.001295,
            "sum": 0.001295
          }
        }
      ]  
    }
  }
}

關於度量值

在度量報告和其他位置中的度量值，會利用標準物件結構回報。 例如：

"durationMetric": {
  "name": "contoso.org",
  "type": "Aggregation",
  "value": 468.71603053650279,
  "count": 1.0,
  "min": 468.71603053650279,
  "max": 468.71603053650279,
  "stdDev": 0.0,
  "sampledValue": 468.71603053650279
}

目前 - 不過未來可能會變更 - 在所有從標準 SDK 模組回報的值中，count==1 以及只有 name 和 value 欄位是有用的。 它們會有差異的唯一案例是，如果您撰寫自己的 TrackMetric 呼叫，而且您在其中設定其他參數。

其他欄位的目的是允許度量在 SDK 中彙總，以減少入口網站的流量。 例如，您可以在傳送每個度量報告之前平均數個連續的讀數。 然後您會計算 min、max、標準差和彙總值 (sum 或 average)，並將計數設為報告所代表的讀數數目。

在上述資料表中，我們省略了很少使用的欄位計數、min、max、stdDev 和 sampledValue。

除了使用預先彙總的度量，如果您需要減少遙測量，您可以改為使用 取樣 。

持續時間

除非另有說明，否則持續時間皆以十分之一微秒表示，所以 10000000.0 表示 1 秒。

另請參閱

• Application Insights
• 連續匯出
• 程式碼範例