監視 Azure Cosmos DB

  • 發行項

本文章說明：

  • 您可以為此服務收集的監視資料類別。
  • 分析該數據的方式。

注意

如果您已經熟悉此服務和/或 Azure 監視器，並只想知道如何分析監視資料，請參閱本文結尾附近的分析一節。

當您有依賴 Azure 資源的重要應用程式和商務流程時，您需要監視並取得系統的警示。 Azure 監視器服務會從您系統的每個元件收集及彙總計量和記錄。 Azure 監視器提供可用性、效能及復原能力檢視，並通知您問題。 您可以使用 Azure 入口網站、PowerShell、Azure CLI、REST API 或用戶端程式庫來設定及檢視監視資料。

深入解析

Azure 中的某些服務在 Azure 入口網站中有內建的監視儀表板，可提供監視服務的起點。 這些儀表板稱為深入解析，您可以在 Azure 入口網站中 Azure 監視器的深入解析中樞中找到這些儀表板。

Azure Cosmos DB 深入解析

Azure Cosmos DB 深入解析是以 Azure 監視器活頁簿功能為基礎的功能。 使用 Azure Cosmos DB 深入解析，以統一互動式體驗檢視您所有 Azure Cosmos DB 資源的整體效能、失敗、容量和作業健康情況。

如需 Azure Cosmos DB 深入解析的詳細資訊，請參閱下列文章：

資源類型

Azure 會使用資源類型和標識碼的概念來識別訂用帳戶中的所有內容。 Azure 監視器同樣會將核心監視數據組織成以資源類型為基礎的計量和記錄，也稱為 命名空間。 不同的計量和記錄適用於不同的資源類型。 您的服務可能會與多個資源類型相關聯。

資源類型也是 Azure 中所執行每個資源的資源識別碼組成部分。 例如，虛擬機器的資源類型是 Microsoft.Compute/virtualMachines。 如需服務及其相關聯資源類型的清單，請參閱資源提供者。

如需 Azure Cosmos DB 資源類型的詳細資訊，請參閱 Azure Cosmos DB 監視數據參考。

資料存放區

針對 Azure 監視器：

  • 計量資料會儲存在 Azure 監視器計量資料庫中。
  • 記錄資料會儲存在 Azure 監視器記錄存放區中。 Log Analytics 是可查詢此存放區的 Azure 入口網站工具。
  • Azure 活動記錄檔是個別存放區，其介面位於 Azure 入口網站。

您可以選擇性地將計量和活動記錄資料路由傳送至 Azure 監視器記錄存放區。 然後，您可以使用 Log Analytics 來查詢數據，並將它與其他記錄數據相互關聯。

許多服務都可以使用診斷設定，將計量和記錄數據傳送至 Azure 監視器以外的其他記憶體位置。 範例包括使用事件中樞 Azure 儲存體、託管的合作夥伴系統和非 Azure 合作夥伴系統。

如需 Azure 監視器如何儲存資料的詳細資訊，請參閱 Azure 監視器資料平台。

Azure 監視器平臺計量

Azure 監視器為大多數服務提供平台計量。 這些計量包括：

  • 針對每個命名空間個別定義。
  • 儲存在 Azure 監視器時間序列計量資料庫中。
  • 輕量型且能支援近乎即時的警示。
  • 用來追蹤資源效能的趨勢變化。

集合：Azure 監視器會自動收集平台計量。 不需要組態。

路由： 您通常也可以將平臺計量路由傳送至 Azure 監視器記錄/Log Analytics，以便使用其他記錄數據來查詢它們。 如需詳細資訊，請參閱計量診斷設定。 如需為服務設定診斷的說明，請參閱在 Azure 監視器中建立診斷設定。

如需 Azure 監視器中所有資源可收集的計量完整清單，請參閱 Azure 監視器中所支援的計量。

Azure 監視器預設會收集 Azure Cosmos DB 計量。 您無須明確設定任何項目。 大部分計量都可從 Azure Cosmos DB 入口網站頁面或 Azure 監視器頁面取得。 根據預設，計量會以一分鐘的粒度收集。 細微性可能會根據您選擇的計量而不同。 根據預設，這些計量的保留期間為 30 天。

Azure Cosmos DB 伺服器端計量包括輸送量、記憶體、可用性、延遲、一致性和系統層級計量。 在用戶端上，您可以收集要求費用、活動標識碼、例外狀況和堆疊追蹤資訊、HTTP 狀態和子狀態代碼，以及診斷字串的詳細數據。 根據預設，這些計量的保留期間為 7 天。 您可以使用此數據來偵錯問題，或如果您需要連絡 Azure Cosmos DB 支援小組。

容器名稱等計量的維度值不區分大小寫。 這種情況可能會導致使用這類名稱的容器在遙測和動作上出現混淆或衝突。 對這些維度值執行字串比較時，請使用不區分大小寫的比較。

如需 Azure Cosmos DB 可用計量的清單，請參閱 Azure Cosmos DB 監視數據參考。

非 Azure 監視器型計量

此服務提供 Azure 監視器計量資料庫中未包含的其他計量。

  • 如需可協助監視 Azure Cosmos DB 的合作夥伴解決方案和工具的相關信息，請參閱 使用第三方解決方案監視 Azure Cosmos DB。
  • 若要使用 Prometheus 計量在適用於 Azure Cosmos DB 的 Java SDK 中實作 Micrometer 計量，請參閱 使用適用於 Java 的 Micrometer 用戶端計量。

Azure 監視器資源記錄

資源記錄提供 Azure 資源所完成作業的深入解析。 系統會自動產生記錄，但您必須將其路由傳送至 Azure 監視器記錄，以便儲存或查詢記錄。 記錄會依類別組織。 指定的命名空間可能會有多個資源記錄類別。

集合：在您建立「診斷設定」並將其路由傳送至一個或多個位置之前，將不會收集和儲存資源記錄。 在建立診斷設定時，您可以指定要收集的記錄類別。 有多種方式可以建立和維護診斷設定，包括 Azure 入口網站、程式設計方式，以及透過 Azure 原則。

路由：建議的預設值是將資源記錄路由傳送至 Azure 監視器記錄，以便與其他記錄資料一同查詢。 您也可以使用其他位置，例如 Azure 儲存體、Azure 事件中樞及特定 Microsoft 監視合作夥伴。 如需詳細資訊，請參閱 Azure 資源記錄和資源記錄目的地。

如需收集、儲存及路由資源記錄的詳細資訊，請參閱 Azure 監視器中的診斷設定。

如需 Azure 監視器中所有可用資源記錄類別的清單，請參閱 Azure 監視器中支援的資源記錄。

Azure 監視器中的所有資源記錄都有相同的標頭欄位，後面接著服務特定的欄位。 一般結構描述如 Azure 監視器資源記錄結構描述中所述。

您可以從 Azure Cosmos DB 帳戶監視診斷記錄，並從 Azure 監視器建立儀錶板。 以第二個細微性發生的事件和追蹤之類的資料會儲存為記錄。 例如，如果容器的輸送量有所變更，Azure Cosmos DB 帳戶的屬性就會變更。 記錄會擷取這些事件。 您可以對收集到的資料執行查詢，以分析這些記錄。

如需可用的資源記錄類別、其相關聯的Log Analytics資料表，以及 Azure Cosmos DB 的記錄架構，請參閱 Azure Cosmos DB 監視數據參考。

Azure 活動記錄

活動記錄包含訂用帳戶層級事件，可追蹤每個 Azure 資源的作業，如該資源外部所示：例如，建立新的資源或啟動虛擬機。

集合：活動記錄事件會自動產生並收集在個別存放區中，以便在 Azure 入口網站中檢視。

路由： 您可以將活動記錄數據傳送至 Azure 監視器記錄，以便與其他記錄數據一起分析。 您也可以使用其他位置，例如 Azure 儲存體、Azure 事件中樞及特定 Microsoft 監視合作夥伴。 如需路由傳送活動記錄的詳細資訊，請參閱 Azure 活動記錄概觀。

分析監視資料

有許多工具可用來分析監視數據。

Azure 監視器工具

Azure 監視器支援下列基本工具：

支援更複雜的視覺效果的工具包括：

  • 儀表板可讓您將不同類型的資料合併到 Azure 入口網站中的單一窗格。
  • 活頁簿，可在 Azure 入口網站中建立的可自訂報表。 活頁簿可以包含文字、計量及記錄查詢。
  • Grafana，這是在操作儀表板中表現相當出色的開放平台工具。 您可以使用 Grafana 來建立儀表板，納入 Azure 監視器以外多個來源的資料。
  • Power BI，這是一項商務分析服務，可提供跨各種資料來源的互動式視覺效果。 你可以將 Power BI 設定為自動從 Azure 監視器匯入記錄資料，以利用這些視覺效果。

Azure 監視器匯出工具

您可以使用下列方法將資料從 Azure 監視器中提取至其他工具：

若要開始使用適用於 Azure 監視器的 REST API，請參閱 Azure 監視 REST API 逐步解說。

分析 Azure Cosmos DB 計量

您可以使用 Azure 監視器計量總管，透過在 Azure Cosmos DB 帳戶入口網站導覽中選取 [監視] 底下的 [計量]，分析 Azure Cosmos DB 的計量與其他 Azure 服務的計量。 如需如何使用計量總管的詳細資訊，請參閱 使用 Azure 監視器計量總管分析計量。

您可以監視伺服器端延遲、要求單位使用量，以及 Azure Cosmos DB 資源的標準化要求單位使用量。 您可以選取 [要求單位]、[儲存體]、[延遲]、[可用性]、[Cassandra] 等等的專屬計量。

在用戶端上，您可以收集要求費用、活動標識碼、例外狀況和堆疊追蹤資訊的計量、HTTP 狀態和子狀態代碼，以及診斷字元串，以偵錯問題。

如需詳細資訊和詳細指示，請參閱下列文章：

如需 Azure 監視器中支援的所有資源計量清單，請參閱 支援的 Azure 監視器計量。 如需針對 Azure Cosmos DB 收集的平台計量清單，請參閱監視 Azure Cosmos DB 資料參考計量。

以程式設計方式監視 Azure Cosmos DB

可在入口網站中取得的帳戶層級計量 (例如，帳戶儲存體使用量和要求總數) 無法使用 API for NoSQL 取得。 不過，您可以使用 API for NoSQL 來擷取集合層級的使用量資料。 若要擷取集合層級資料，請使用下列其中一種方法：

若要存取其他計量，請使用 Azure 監視器 SDK。 可用的計量定義可使用此格式來擷取：

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

若要擷取個別計量，請使用下列格式：

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

若要深入了解，請參閱 Azure 監視 REST API。

分析 Azure Cosmos DB 記錄

Azure 監視器記錄中的資料會儲存在資料表中。 每個資料表都有本身的一組唯一屬性。 Azure 監視器中的所有資源記錄都有相同的欄位，後面接著服務特定的欄位。 一般結構描述如 Azure 監視器資源記錄結構描述中所述。

如需針對 Azure Cosmos DB 收集的資源記錄類型，請參閱 Azure Cosmos DB 監視數據參考。

如需使用適用於 Azure Cosmos DB 的 Azure 監視器記錄的詳細資訊，請參閱下列文章：

Kusto 查詢

您可以使用 Kusto 查詢語言 （KQL） 分析 Azure 監視器記錄/Log Analytics 存放區中的監視數據。

重要

當您從入口網站的服務功能表中選取 [記錄] 時，Log Analytics 會隨即開啟，並將查詢範圍設定為目前服務。 此範圍表示記錄查詢只會包含該資源類型的資料。 如果您想要執行包含其他 Azure 服務資料的查詢，請從 [Azure 監視器] 功能表中選取 [記錄]。 如需詳細資訊，請參閱 Azure 監視器 Log Analytics 中的記錄查詢範圍和時間範圍。

如需各項服務的常見查詢清單，請參閱 Log Analytics 查詢介面。

在使用 Log Analytics 發出 Kusto 查詢之前，您必須啟用控制平面作業的診斷記錄。 當您啟用診斷記錄時，您可以選取將資料儲存在資源特定的數據表或單一 AzureDiagnostics 數據表（舊版）之間。 Kusto 查詢的確切文字取決於您選取的 集合模式 。

以下是一些您可以在 [記錄搜尋] 搜尋列中輸入以利監視 Azure Cosmos DB 資源的查詢。

若要查詢 Azure Cosmos DB 中的所有控制平面記錄：

CDBControlPlaneRequests

若要查詢 Azure Cosmos DB 中的所有資料平面記錄：

CDBDataPlaneRequests

若要查詢已篩選且特定為單一資源的資料平面記錄清單：

CDBDataPlaneRequests
| where AccountName=="<account-name>"

若要取得資料平面記錄的計數，請依資源分組：

CDBDataPlaneRequests
| summarize count() by AccountName

若要產生資料平面記錄的圖表，請依作業類型分組：

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

針對可用來針對 Azure Cosmos DB 問題進行疑難解答的 Kusto 查詢，請參閱下列文章：

這些範例只是您可以使用 Kusto 查詢語言 （KQL） 在 Azure 監視器中執行的豐富查詢小取樣。 如需更多範例，請參閱 Kusto 查詢的範例。

警示

在監視資料中發現特定狀況時，Azure 監視器會主動通知您。 警示可讓您及早識別系統中的問題並予以因應，避免客戶發現這些問題。 如需詳細資訊，請參閱 Azure 監視器警示。

Azure 資源的常見警示有許多來源。 如需 Azure 資源的常見警示範例，請參閱記錄警示查詢範例。 Azure 監視器基準警示 （AMBA） 網站提供半自動化方法來實作重要的平臺計量警示、儀錶板和指導方針。 此網站適用於持續擴充的 Azure 服務子集，包括屬於 Azure 登陸區域 （ALZ） 的所有服務。

常見的警示結構描述會將 Azure 監視器警示通知的使用量標準化。 如需詳細資訊，請參閱一般警示結構描述。

警示類型

您可以針對在 Azure 監視器資料平台中的任何計量或記錄資料來源發出警示。 警示有許多不同的類型，具體取決於您監視的服務以及所收集的監視資料。 不同類型的警示各有優缺點。 如需詳細資訊，請參閱選擇正確的監視警示類型。

下列清單描述可建立的 Azure 監視器警示類型：

  • 計量警示會定期評估資源計量。 這些計量可以是平台計量、自訂計量、Azure 監視器轉換成計量的記錄，或 Application Insights 計量。 計量警示還可以套用多個條件和動態閾值。
  • 記錄警示可讓使用者使用 Log Analytics 查詢，以預先定義的頻率評估資源記錄。
  • 活動記錄警示會在發生符合定義條件的新活動記錄事件時觸發。 資源健康狀態警示和服務健康情況警示是報告服務和資源健康狀態的活動記錄警示。

某些 Azure 服務也支援 智慧偵測警示、 Prometheus 警示或 建議的警示規則。

針對某些服務，您可以將相同的計量警示規則套用至相同 Azure 區域中相同類型的多個資源，以大規模監視。 系統會針對每個受監視的資源傳送個別通知。 如需支援的 Azure 服務和雲端，請參閱使用一個警示規則監視多個資源。

Azure Cosmos DB 警示規則

下表列出 Azure Cosmos DB 的一些常見和建議警示規則。

警示類型 Condition 描述
要求單位的速率限制 (計量警示) 維度名稱：StatusCode、運算子：Equals、維度值：429 如果容器或資料庫已超過佈建的輸送量限制，則會發出警示。
區域已容錯移轉 運算子：大於、彙總類型：計數、閾值：1 單一區域容錯移轉時。 如果您未啟用服務管理的容錯移轉，此警示將會很有幫助。
輪換金鑰 (活動記錄警示) 事件層級：資訊，狀態：已啟動 輪換帳戶金鑰時發出警示。 您可以使用新的金鑰來更新應用程式。

如需建立 Azure Cosmos DB 警示的詳細資訊和指示，請參閱 建立計量警示。 若要建立警示來監視邏輯分割區索引鍵的記憶體是否接近 20 GB，請參閱 建立邏輯分割區索引鍵大小的警示。

Advisor 建議

對於某些服務，如果資源作業期間發生重大條件或迫在眉睫的變更，入口網站中的服務 [概觀 ] 頁面上會顯示警示。 您可以在左側功能表中的 [監視] 底下，找到 Advisor 建議中警示的詳細資訊和建議修正程式。 在正常作業期間，不會顯示 Advisor 建議。

如需 Azure Advisor 的詳細資訊，請參閱 Azure Advisor 概觀。

相關內容