監視 Azure Cosmos DB 資料參考

適用於: SQL API Cassandra API Gremlin API 資料表 API 適用於 MongoDB 的 Azure Cosmos DB API

本文提供所收集記錄和計量資料的參考,以分析 Azure Cosmos DB 的效能和可用性。 如需收集和分析 Azure Cosmos DB 監視資料的詳細資料,請參閱監視 Azure Cosmos DB 文章。

計量

所有對應至 Azure Cosmos DB 的計量都會儲存至命名空間「Cosmos DB 標準計量」中。 如需所有 Azure 監視器支援計量 (包括 Azure Cosmos DB) 清單,請參閱 Azure 監視器支援的計量。 本節列出針對 Azure Cosmos DB 收集的所有自動收集平台計量。

要求計量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 維度 時間資料粒度 舊版計量對應 使用方式
TotalRequests (要求總計) Count (計數) 進行的要求數目 DatabaseName、CollectionName、Region、StatusCode 全部 TotalRequests、Http 2xx、Http 3xx、Http 400、Http 401、內部伺服器錯誤、可用的服務、已節流的要求、平均每秒鐘要求數 用來監視各狀態碼的要求數、每分鐘資料粒度的容器。 若要取得平均每秒要求數,請使用每分鐘 Count 彙總並除以 60。
MetadataRequests (中繼資料要求) Count (計數) 中繼資料要求計數。 Azure Cosmos DB 會維護每個帳戶的系統中繼資料容器,可讓您免費列舉集合、資料庫等和其設定。 DatabaseName、CollectionName、Region、StatusCode 全部 用來依中繼資料要求而監視節流。
MongoRequests (Mongo 要求) Count (計數) 已提出的 Mongo 要求數目 DatabaseName、CollectionName、Region、CommandName、ErrorCode 全部 Mongo 查詢要求率、Mongo 更新要求率、Mongo 刪除要求率、Mongo 插入要求率,Mongo 計數要求速率 用於監視 Mongo 要求錯誤、各命令類型的使用量。

要求單位計量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 維度 時間資料粒度 舊版計量對應 使用方式
MongoRequestCharge (Mongo 要求費用) Count (總計) 已使用的 Mongo 要求單位 DatabaseName、CollectionName、Region、CommandName、ErrorCode 全部 Mongo 查詢要求費用、Mongo 更新要求費用、Mongo 刪除要求費用、Mongo 插入要求費用,Mongo 計數要求費用 用來監視在一分鐘內的 Mongo 資源 RU。
TotalRequestUnits (總要求單位) Count (總計) 已使用的要求單位 DatabaseName、CollectionName、Region、StatusCode 全部 TotalRequestUnits 用來監視每分鐘資料粒度的總 RU 使用量。 若要取得平均每秒耗用的 RU,請使用每分鐘間隔/層級 Sum 彙總並除以 60。
ProvisionedThroughput (已佈建的輸送量) Count (最大值) 以容器資料粒度的已佈建輸送量 DatabaseName、ContainerName 5M 用來監視各容器所佈建的輸送量。

儲存體度量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 維度 時間資料粒度 舊版計量對應 使用方式
AvailableStorage (可用儲存體) Bytes (總計) 各區域每 5 分鐘資料粒度報告的總可用儲存體 DatabaseName、CollectionName、Region 5M 可用的儲存體 用於監視可用的儲存體容量 (僅適用於固定的儲存體集合) 最小資料粒度應為 5 分鐘。
DataUsage (資料使用量) Bytes (總計) 各區域每 5 分鐘資料粒度報告的總資料使用量 DatabaseName、CollectionName、Region 5M 資料大小 用來監視容器和區域的總資料使用量,最小資料粒度應該是 5 分鐘。
IndexUsage (索引使用量) Bytes (總計) 各區域每 5 分鐘資料粒度報告的總索引使用量 DatabaseName、CollectionName、Region 5M 索引大小 用來監視容器和區域的總資料使用量,最小資料粒度應該是 5 分鐘。
DocumentQuota (文件配額) Bytes (總計) 各區域每 5 分鐘資料粒度報告的總儲存體配額。 DatabaseName、CollectionName、Region 5M 儲存體容量 用來監視在容器和區域的總配額,最小資料粒度應該是 5 分鐘。
DocumentCount (文件計數) Count (總計) 各區域每 5 分鐘資料粒度報告的總文件計數 DatabaseName、CollectionName、Region 5M 文件計數 用來監視在容器和區域的文件計數,最小資料粒度應該是 5 分鐘。

延遲計量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 維度 時間資料粒度 使用方式
ReplicationLatency (複寫延遲) MilliSeconds (最小值、最大值、平均值) 異地複寫啟用的帳戶其跨來源和目標區域的 P99 複寫延遲 SourceRegion、TargetRegion 全部 用來監視異地複寫的帳戶其任兩個區域之間的 P99 複寫延遲。
伺服器端延遲 MilliSeconds (平均值) 伺服器處理要求所花費的時間。 CollectionName、ConnectionMode、DatabaseName、OperationType、PublicAPIType、Region 全部 用來監視 Azure Cosmos DB 伺服器上的要求延遲。

可用性度量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 時間資料粒度 舊版計量對應 使用方式
ServiceAvailability (服務可用性) Percent (最小值、最大值) 一小時資料粒度的帳戶要求可用性 1H 服務可用性 代表總通過要求的百分比。 如果狀態碼為 410、500 或 503,則要求會因為系統錯誤而視為失敗。用於以小時資料粒度監視帳戶的可用性。

Cassandra API 計量

計量 (計量顯示名稱) 單位 (彙總類型) 描述 維度 時間資料粒度 使用方式
CassandraRequests (Cassandra 要求) Count (計數) 已提出的 Cassandra API 要求數目 DatabaseName、CollectionName、ErrorCode、Region、OperationType、ResourceType 全部 用於監視每分鐘資料粒度的 Cassandra 要求數。 若要取得平均每秒要求數,請使用每分鐘 Count 彙總並除以 60。
CassandraRequestCharges (Cassandra 要求費用) Count (Sum、Min、Max、Avg) Cassandra API 所耗用的要求單位 DatabaseName、CollectionName、Region、OperationType、ResourceType 全部 用來監視 Cassandra API 帳戶每分鐘所使用的 RU 數。
CassandraConnectionClosures (Cassandra 連線終止) Count (計數) 已終止的 Cassandra 連線數目 ClosureReason、Region 全部 用於監視用戶端與 Azure Cosmos DB Cassandra API 之間的連線。

如需詳細資訊,請參閱 Azure 監視器中支援的所有平台計量清單。

資源記錄

下表列出 Azure Cosmos DB 中資源記錄的屬性。 資源記錄會收集到 Azure 監視器記錄或 Azure 儲存體。 在 Azure 監視器中,會在資源提供者** 名稱 MICROSOFT.DOCUMENTDB 下的 AzureDiagnostics 資料表中收集記錄。

Azure 儲存體欄位或屬性 Azure 監視器記錄屬性 描述
time TimeGenerated 作業發生的日期和時間 (UTC)。
resourceId 資源 啟用記錄的 Azure Cosmos DB 帳戶。
類別 類別 針對 Azure Cosmos DB,DataPlaneRequests、MongoRequests、QueryRuntimeStatistics、PartitionKeyStatistics、PartitionKeyRUConsumption、ControlPlaneRequests、CassandraRequests、GremlinRequests 是可用的記錄類型。
operationName OperationName 作業名稱。 作業名稱可以是 CreateUpdateReadReadFeedDeleteReplaceExecuteSqlQueryQueryJSQueryHeadHeadFeedUpsert
properties n/a 此欄位的內容說明於下列資料列中。
activityId activityId_g 所記錄作業的唯一 GUID。
userAgent userAgent_s 字串,指定從中傳送要求的用戶端使用者代理程式。 使用者代理程式的格式為 {user agent name}/{version}
requestResourceType requestResourceType_s 存取的資源類型。 此值可以是資料庫、容器、文件、附件、使用者、權限、預存程序、觸發程序、使用者定義的函式或供應項目。
statusCode statusCode_s 作業的回應狀態。
requestResourceId ResourceId 關於要求的 resourceId。 根據執行的作業,此值可能會指向 databaseRidcollectionRiddocumentRid
clientIpAddress clientIpAddress_s 用戶端的 IP 位址。
requestCharge requestCharge_s 作業使用的 RU 數
collectionRid collectionId_s 集合的唯一識別碼。
duration duration_d 作業的持續時間 (以毫秒為單位)。
requestLength requestLength_s 以位元組為單位的要求長度。
responseLength responseLength_s 以位元組為單位的回應長度。
resourceTokenPermissionId resourceTokenPermissionId_s 此屬性指出您已指定的資源權杖權限識別碼。 若要深入了解權限,請參閱安全存取您的資料文章。
resourceTokenPermissionMode resourceTokenPermissionMode_s 此屬性指出您在建立資源權杖時所設定的權限模式。 權限模式可以有 "all" 或 "read" 這類的值。 若要深入了解權限,請參閱安全存取您的資料文章。
resourceTokenUserRid resourceTokenUserRid_s 使用資源權杖進行驗證時,此值為非空白值。 此值表示使用者的資源識別碼。
responseLength responseLength_s 以位元組為單位的回應長度。

如需所有 Azure 監視器記錄類別的清單和相關聯結構描述的連結,請參閱 Azure 監視器記錄類別和結構描述

Azure 監視器記錄資料表

Azure Cosmos DB 會使用 Azure 監視器記錄中的 Kusto 資料表。 您可以使用 Log Analytics 查詢這些資料表。 如需 Cosmos DB 所使用的 Kusto 資料表清單,請參閱 Azure 監視器記錄資料表參考文章。

另請參閱