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 操作的名称。 操作名称可以是 CreateUpdateReadReadFeedDeleteReplaceExecuteSqlQueryQueryJSQueryHeadHeadFeedUpsert
properties 不适用 下面的行中描述了此字段的内容。
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 集合的唯一 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 响应的长度(按字节计)。

活动日志

链接表列出了可在此服务的活动日志中记录的操作。 这是活动日志中所有可能的资源提供程序操作的子集。

有关活动日志条目架构的详细信息,请参阅活动日志架构