Azure Cosmos DB 监视数据引用
本文包含此服务的所有监视参考信息。
请参阅监视 Azure Cosmos DB，详细了解可为 Azure Cosmos DB 收集的数据以及如何使用它。
指标
本部分列出了为此服务自动收集的所有平台指标。 这些指标也是 Azure Monitor 中支持的所有平台指标的全局列表的一部分。
有关指标保留的信息，请参阅 Azure Monitor 指标概述。 有关所有 Azure Monitor 支持的指标（包括 Azure Cosmos DB）的列表，请参阅 Azure Monitor 支持的指标。
按类别划分的指标
下表列出了按指标类型分类的 Azure Cosmos DB 指标。
请求指标
- TotalRequests（请求总数）
- MetadataRequests（元数据请求数）
- MongoRequests（Mongo 请求数）
请求单位指标
- MongoRequestCharge（Mongo 请求费用）
- TotalRequestUnits（请求单位总数）
- ProvisionedThroughput（预配的吞吐量）
- AutoscaleMaxThroughput（自动缩放最大吞吐量）
- PhysicalPartitionThroughputInfo（物理分区吞吐量信息）
存储度量值
- AvailableStorage（可用存储空间）
- DataUsage（数据用量）
- IndexUsage（索引用量）
- DocumentQuota（文档配额）
- DocumentCount（文档计数）
- PhysicalPartitionSizeInfo（物理分区大小信息）
延迟指标
- ReplicationLatency（复制延迟）
- 服务器端延迟
可用性指标
- ServiceAvailability（服务可用性）
API for Cassandra 指标
- CassandraRequests（Cassandra 请求数）
- CassandraRequestCharges（Cassandra 请求费用）
- CassandraConnectionClosures（Cassandra 连接关闭次数）
Cassandra 的错误代码
下表列出了 API for Cassandra 帐户的错误代码。 有关示例查询，请参阅 Azure Cosmos DB for Apache Cassandra 服务器诊断
| 状态代码 | 错误代码 | 说明 |
|---|---|---|
| 200 | -1 | 成功 |
| 400 | 8704 | 查询正确，但语法无效。 |
| 400 | 8192 | 提交的查询有语法错误。 检查查询。 |
| 400 | 8960 | 由于某些配置问题，查询无效。 |
| 401 | 8448 | 登录的用户没有执行查询的正确权限。 |
| 403 | 8448 | 禁止响应，因为用户可能没有执行请求所需的权限。 |
| 404 | 5376 | 由于找不到响应，写入请求期间出现非超时异常。 |
| 405 | 0 | 服务器端 Cassandra 错误。 错误很少发生，请打开支持票证。 |
| 408 | 4608 | 读取请求期间超时。 |
| 408 | 4352 | 写入 serviceRequest 期间出现超时异常。 |
| 409 | 9216 | 尝试创建已存在的键空间或表。 |
| 412 | 5376 | 不满足前提条件。 为了确保数据完整性，我们确保基于读取响应的写入请求为 true。 已返回非超时写入请求异常。 |
| 413 | 5376 | 写入请求期间出现此非超时异常的原因是有效负载可能太大。 目前，每行限制为 2MB。 |
| 417 | 9472 | 当准备的语句未缓存在服务器节点上时，将引发异常。 它应该是暂时性的/非阻塞的。 |
| 423 | 5376 | 由于当前正在处理写入请求，因此存在锁定。 |
| 429 | 4097 | 重载异常是 RU 不足或请求速率过高的结果。 可能需要更多的 RU 来处理较高的卷请求。 在本机 Cassandra 中，这可以解释为其中一个没有足够 CPU 的VM。 建议查看当前数据模型，以确保没有可能导致热分区的过度倾斜。 |
| 449 | 5376 | 并发执行异常。 出现这种情况是为了确保一次只对给定行执行一次写入更新。 |
| 500 | 0 | 服务器 cassandraError：发生了意外情况。 这表示服务器端 bug。 |
| 503 | 4096 | 服务不可用。 |
| 256 | 这可能是由于连接凭据无效。 请检查连接凭据。 | |
| 10 | 客户端消息触发了协议冲突。 例如，在发送启动消息之前发送的查询消息。 |
指标维度
有关指标维度定义的信息，请参阅多维指标。 此服务具有以下与其指标关联的维度。
Microsoft.DocumentDB/DatabaseAccounts
- ApiKindResourceType
- APIType
- ApplicationType
- BuildType
- CacheEntryType
- CacheExercised
- CacheHit
- CapacityType
- ChildResourceName
- ClosureReason
- CommandName
- ConnectionMode
- DiagnosticSettingsName
- 错误
- ErrorCode
- IsExternal
- IsSharedThroughputOffer
- IsThroughputRequest
- KeyType
- MetricType
- NotStarted
- OfferOwnerRid
- PartitionKeyRangeId
- PhysicalPartitionId
- PhysicalPartitionId
- PriorityLevel
- PublicAPIType
- ReplicationInProgress
- ResourceGroupName
- ResourceName
- 角色
- SourceRegion
- TargetContainerName
- TargetRegion
Microsoft.DocumentDB/cassandraClusters
- cassandra_datacenter
- cassandra_node
- cache_name
Microsoft.DocumentDB/mongoClusters
- ServerName
资源日志
本部分列出了可为此服务收集的资源日志类型。 本部分拉取自 Azure Monitor 支持的所有资源日志类别类型列表。
Azure Cosmos DB 资源日志属性
下表列出了 Azure Cosmos DB 中资源日志的属性。 将资源日志收集到 Azure Monitor 日志或 Azure 存储。
| Azure 存储字段或属性 | Azure Monitor 日志属性 | 说明 |
|---|---|---|
| time | TimeGenerated | 操作发生时的日期和时间 (UTC)。 |
| resourceId | 资源 | 为其启用日志的 Azure Cosmos DB 帐户。 |
| category | 类别 | 对于 Azure Cosmos DB，DataPlaneRequests、MongoRequests、QueryRuntimeStatistics、PartitionKeyStatistics、PartitionKeyRUConsumption、ControlPlaneRequests、CassandraRequests、GremlinRequests 是可用的日志类型。 |
| operationName | OperationName | 操作的名称。 操作名称可以是 Create、Update、Read、ReadFeed、Delete、Replace、Execute、SqlQuery、Query、JSQuery、Head、HeadFeed 或 Upsert。 |
| properties | 不适用 | 下面的行中描述了此字段的内容。 |
| activityId | activityId_g | 日志记录操作的唯一 GUID。 |
| userAgent | userAgent_s | 用于指定从中发送请求的客户端用户代理的字符串。 用户代理的格式是 {user agent name}/{version}。 |
| requestResourceType | requestResourceType_s | 所访问资源的类型。 此值可以是数据库、容器、文档、附件、用户、权限、存储过程、触发器、用户定义的函数或产品/服务。 |
| statusCode | statusCode_s | 操作的响应状态。 |
| requestResourceId | ResourceId | 与请求相关的 resourceId。 根据执行的操作，此值可能指向 databaseRid、collectionRid 或 documentRid。 |
| clientIpAddress | clientIpAddress_s | 客户端的 IP 地址。 |
| requestCharge | requestCharge_s | 操作使用的 RU 数目 |
| collectionRid | collectionId_s | 集合的唯一 ID。 |
| duration | duration_d | 操作持续时间，以毫秒为单位。 |
| requestLength | requestLength_s | 请求的长度（按字节计）。 |
| responseLength | responseLength_s | 响应的长度（按字节计）。 |
| resourceTokenPermissionId | resourceTokenPermissionId_s | 此属性指示为备选身份验证方法指定的权限 ID。 |
| resourceTokenPermissionMode | resourceTokenPermissionMode_s | 此属性指示在创建资源令牌时设置的权限模式。 权限模式可以设置值，例如“all”或“read”。 |
| resourceTokenUserRid | resourceTokenUserRid_s | 该值指向用户用于备选身份验证方法的资源 ID。 |
| responseLength | responseLength_s | 响应的长度（按字节计）。 |
活动日志
链接表列出了可在此服务的活动日志中记录的操作。 这是活动日志中所有可能的资源提供程序操作的子集。
有关活动日志条目架构的详细信息，请参阅活动日志架构。
相关内容
- 有关如何监视 Azure Cosmos DB 的说明，请参阅监视 Azure Cosmos DB。
- 请参阅使用 Azure Monitor 监视 Azure 资源，详细了解如何监视 Azure 资源。