你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure 文件存储监视数据参考

  • 项目

有关收集和分析 Azure 文件存储监视数据的详细信息，请参阅监视 Azure 文件存储。

适用于

文件共享类型 SMB NFS
标准文件共享 (GPv2)、LRS/ZRS 是 否
标准文件共享 (GPv2)、GRS/GZRS 是 否
高级文件共享 (FileStorage)、LRS/ZRS 是 是

指标

下表列出了为 Azure 文件存储收集的平台指标。

容量度量值

容量指标值每天刷新（最多 24 小时）。 时间粒度定义呈现指标值的时间间隔。 所有容量指标的受支持时间粒度为一小时 (PT1H)。

Azure 文件存储在 Azure Monitor 中提供以下容量指标。

帐户级别

下表显示帐户级别指标。

指标 说明
UsedCapacity 存储帐户使用的存储量。 对于标准存储帐户，该指标是 Blob、表、文件和队列使用的容量总和。 对于高级存储帐户和 Blob 存储帐户，它与 BlobCapacity 相同。

单位：字节
聚合类型：平均值
值示例：1024

Azure 文件

下表显示 Azure 文件存储指标。

指标 说明
FileCapacity 存储帐户使用的文件存储量。

单位：字节
聚合类型：平均值
维度：FileShare、层级
值示例：1024
FileCount 存储帐户中的文件数目。

单位：计数
聚合类型：平均值
维度：FileShare、层级
值示例：1024
FileShareCapacityQuota Azure 文件服务可使用的存储量上限（以字节为单位）。

单元：字节
聚合类型：平均值
值示例：1024
FileShareCount 存储帐户中的文件共享数目。

单位：计数
聚合类型：平均值
值示例：1024
FileShareProvisionedIOPS 文件共享上预配的 IOPS 数。 此指标仅适用于高级文件存储。

单位：每秒计数
聚合类型：平均值
FileShareSnapshotCount 存储帐户的 Azure 文件存储服务的共享中存在的快照数。

单位：计数
聚合类型：平均值
FileShareSnapshotSize 存储帐户的 Azure 文件存储服务中的快照所用存储量。

单元：字节
聚合类型：平均值

事务指标

从 Azure 存储到 Azure Monitor 的每个存储帐户请求都会发出事务指标。 如果存储帐户中没有任何活动，则在此期间不会有关于事务指标的数据。 所有事务指标均可用于帐户和 Azure 文件存储服务级别。 时间粒度定义呈现指标值的时间间隔。 所有事务指标的受支持时间粒度为 PT1H 和 PT1M。

Azure 存储在 Azure Monitor 中提供以下事务指标。

指标 说明
事务 向存储服务或指定的 API 操作发出的请求数。 此数字包括成功和失败的请求数，以及引发错误的请求数。

单位：计数
聚合类型：总计
适用的维度：ResponseType、GeoType、ApiName 和 Authentication（定义）
值示例：1024
流入量 流入数据量。 此数字包括从外部客户端到 Azure 存储流入的数据量，以及流入 Azure 中的数据量。

单位：字节
聚合类型：总计
适用的维度：GeoType、ApiName 和 Authentication（定义）
值示例：1024
流出量 流出数据量。 此数字包括从外部客户端到 Azure 存储流出的数据量，以及流出 Azure 中的数据量。 因此，此数字不反映计费的流出量。

单位：字节
聚合类型：总计
适用的维度：GeoType、ApiName 和 Authentication（定义）
值示例：1024
SuccessServerLatency Azure 存储处理成功请求所用的平均时间。 此值不包括 SuccessE2ELatency 中指定的网络延迟。

单位：毫秒
聚合类型：平均值
适用的维度：GeoType、ApiName 和 Authentication（定义）
值示例：1024
SuccessE2ELatency 向存储服务或指定的 API 操作发出的成功请求的平均端到端延迟。 此值包括在 Azure 存储中读取请求、发送响应和接收响应确认所需的处理时间。 SuccessE2ELatency 和 SuccessServerLatency 值之间的差异是可能由网络或客户端引起的延迟。

单位：毫秒
聚合类型：平均值
适用的维度：GeoType、ApiName 和 Authentication（定义）
值示例：1024
可用性 存储服务或指定的 API 操作的可用性百分比。 可用性通过由“计费请求总数”值除以适用的请求数（包括引发意外错误的请求）计算得出。 所有意外错误都会导致存储服务或指定的 API 操作的可用性下降。

单位：百分比
聚合类型：平均值
适用的维度：GeoType、ApiName 和 Authentication（定义）
值示例：99.99

指标维度

Azure 文件存储支持对 Azure Monitor 中的指标使用以下维度。

备注

文件共享维度不可用于标准文件共享（仅可用于高级文件共享）。 使用标准文件共享时，提供的指标适用于存储帐户中的所有文件共享。 若要获取标准文件共享的每个共享指标，请为每个存储帐户创建一个文件共享。

维度名称 说明
GeoType 来自主要或辅助群集的事务。 可用值包括 Primary 和 Secondary。 从辅助租户读取对象时，该维度会应用到读取访问异地冗余存储 (RA-GRS)。
ResponseType 事务响应类型。 可用的值包括：

  • ServerOtherError：除描述的错误以外的其他所有服务器端错误
  • ServerBusyError：已经过身份验证的请求返回了 HTTP 503 状态代码。
  • ServerTimeoutError：已经过身份验证的超时请求返回了 HTTP 500 状态代码。 由于服务器错误而发生超时。
  • AuthenticationError：服务器无法对请求进行身份验证。
  • AuthorizationError：由于未经授权访问数据或者授权失败，经过身份验证的请求失败。
  • NetworkError：由于网络错误，经过身份验证的请求失败。 往往发生于客户端在超时失效之前提前关闭了连接时。
  • ClientAccountBandwidthThrottlingError：因为超出了存储帐户可伸缩性限制，在带宽方面对请求进行了限制。
  • ClientAccountRequestThrottlingError：因为超出了存储帐户可伸缩性限制，在请求速率方面对请求进行了限制。
  • ClientThrottlingError：其他客户端限制错误。 不包括 ClientAccountBandwidthThrottlingError 和 ClientAccountRequestThrottlingError。
  • ClientShareEgressThrottlingError：仅适用于高级文件共享。 其他客户端限制错误。 请求失败，因为出口带宽限制超出了共享限制。 不包括 ClientAccountBandwidthThrottlingError。
  • ClientShareIngressThrottlingError：仅适用于高级文件共享。 其他客户端限制错误。 请求失败，因为入口带宽限制超出了共享限制。 不包括 ClientAccountBandwidthThrottlingError。
  • ClientShareIopsThrottlingError：其他客户端限制错误。 由于 IOPS 限制，请求失败。 不包括 ClientAccountRequestThrottlingError。
  • ClientTimeoutError：已经过身份验证的超时请求返回了 HTTP 500 状态代码。 如果将客户端的网络超时或请求超时设置为比存储服务预期值更小的值，则预期会发生此超时。 否则，会报告为 ServerTimeoutError。
  • ClientOtherError：除描述的错误以外的其他所有客户端错误。
  • 成功：请求成功
  • SuccessWithThrottling：请求成功，具体表现在：头一次或头几次尝试时，SMB 客户端会被限制，但重试后会成功。
  • SuccessWithShareEgressThrottling：仅适用于高级文件共享。 在第一次（前几次）尝试时由于出口带宽限制 SMB 客户端受到限制，但重试后成功的成功请求。
  • SuccessWithShareIngressThrottling：仅适用于高级文件共享。 在第一次（前几次）尝试时由于入口带宽限制 SMB 客户端受到限制，但重试后成功的成功请求。
  • SuccessWithShareIopsThrottling：在第一次（前几次）尝试时由于 IOPS 限制 SMB 客户端受到限制，但重试后成功的成功请求。
    		•
    ApiName 操作的名称。 如果在标识操作的名称之前发生了故障，则名称将显示为“未知”。 可以使用 ResponseType 维度的值来了解有关此故障的详细信息。
    身份验证 事务中所用的身份验证类型。 可用的值包括：
  • AccountKey：事务通过存储帐户密钥进行身份验证。
  • SAS：事务通过共享访问签名进行身份验证。
  • OAuth：事务通过 OAuth 访问令牌进行身份验证。
  • Anonymous：事务以匿名方式请求。 不包括预检请求。
  • AnonymousPreflight：事务为预检请求。
    		•
    TransactionType 事务的类型。 可用的值包括：
  • 用户：事务由客户进行。
  • 系统：事务由系统进程进行。
    		•

    资源日志

    下表列出了在 Azure Monitor 日志或 Azure 存储中收集 Azure 存储资源日志时这些资源日志的属性。 属性描述了操作、服务以及用来执行该操作的授权类型。

    描述操作的字段

    属性 说明
    time 存储收到请求时的协调世界时 (UTC) 时间。 例如：2018/11/08 21:09:36.6900118。
    resourceId 存储帐户的资源 ID。 例如： /subscriptions/208841be-a4v3-4234-9450-08b90c09f4/resourceGroups/
    myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount/storageAccounts/blobServices/default
    category 所请求的操作的类别。 例如：StorageRead、StorageWrite 或 StorageDelete。
    operationName 执行的 REST 操作的类型。
    有关操作的完整列表，请参阅“存储分析记录的操作和状态消息”主题。
    operationVersion 发出请求时指定的存储服务版本。 这等效于 x-ms-version 标头的值。 例如：2017-04-17。
    schemaVersion 日志的架构版本。 例如：1.0。
    statusCode 请求的 HTTP 或 SMB 状态代码。 如果 HTTP 请求被中断，那么此值可能设置为 Unknown。
    例如： 206
    statusText 所请求的操作的状态。 有关状态消息的完整列表，请参阅“存储分析记录的操作和状态消息”主题。 在版本 2017-04-17 及更高版本中，不使用状态消息 ClientOtherError。 相反，此字段包含错误代码。 例如： SASSuccess
    durationMs 执行所请求操作的总时间（以毫秒为单位）。 这包括读取传入请求和向请求者发送响应的时间。 例如：12。
    callerIpAddress 请求者的 IP 地址，包括端口号。 例如：192.100.0.102:4362。
    correlationId 用来跨资源将日志关联起来的 ID。 例如：b99ba45e-a01e-0042-4ea6-772bbb000000。
    location 存储帐户的位置。 例如：North Europe。
    protocol 操作中使用的协议。 例如：HTTP、HTTPS、SMB 或 NFS
    uri 所请求的统一资源标识符。

    描述如何对操作进行身份验证的字段

    属性 说明
    identity / type 用来发出请求的身份验证的类型。 例如 OAuth、Kerberos、SAS Key、Account Key 或 Anonymous
    identity / tokenHash 用于请求的身份验证令牌的 SHA-256 哈希。
    如果身份验证类型为 Account Key，则格式为“key1 | key2 (密钥的 SHA256 哈希)”。 例如： key1(5RTE343A6FEB12342672AFD40072B70D4A91BGH5CDF797EC56BF82B2C3635CE)。
    如果身份验证类型为 SAS Key，则格式为“key1 | key2 (密钥的 SHA 256 哈希),SasSignature(SAS 令牌的 SHA 256 哈希)”。 例如：key1(0A0XE8AADA354H19722ED12342443F0DC8FAF3E6GF8C8AD805DE6D563E0E5F8A),SasSignature(04D64C2B3A704145C9F1664F201123467A74D72DA72751A9137DDAA732FA03CF)。 如果身份验证类型为 OAuth，则格式为“OAuth 令牌的 SHA 256 哈希”。 例如：B3CC9D5C64B3351573D806751312317FE4E910877E7CBAFA9D95E0BE923DD25C
    对于其他身份验证类型，没有 tokenHash 字段。
    authorization / action 分配给请求的操作。
    authorization / roleAssignmentId 角色分配 ID。 例如：4e2521b7-13be-4363-aeda-111111111111。
    authorization / roleDefinitionId 角色定义 ID。 例如：ba92f5b4-2d11-453d-a403-111111111111"。
    principals / id 安全主体的 ID。 例如：a4711f3a-254f-4cfb-8a2d-111111111111。
    principals / type 安全主体的类型。 例如：ServicePrincipal。
    requester / appID 用作请求者的 Open Authorization (OAuth) 应用程序 ID。
    例如：d3f7d5fe-e64a-4e4e-871d-333333333333。
    requester / audience 请求的 OAuth 受众。 例如：https://storage.azure.com。
    requester / objectId 请求者的 OAuth 对象 ID。 对于 Kerberos 身份验证，此项表示已经过 Kerberos 身份验证的用户的对象标识符。 例如：0e0bf547-55e5-465c-91b7-2873712b249c。
    requester / tenantId 标识的 OAuth 租户 ID。 例如：72f988bf-86f1-41af-91ab-222222222222。
    requester / tokenIssuer OAuth 令牌颁发者。 例如：https://sts.windows.net/72f988bf-86f1-41af-91ab-222222222222/。
    requester / upn 请求者的用户主体名称 (UPN)。 例如：someone@contoso.com。
    requester / userName 此字段为保留字段，仅供内部使用。

    描述服务的字段

    属性 说明
    accountName 存储帐户的名称。 例如：mystorageaccount。
    requestUrl 所请求的 URL。
    userAgentHeader User-Agent 标头值，带引号。 例如：WA-Storage/6.2.0 (.NET CLR 4.0.30319.42000; Win32NT 6.2.9200.0)。
    referrerHeader Referrer 标头值。 例如：http://contoso.com/about.html。
    clientRequestId 请求的 x-ms-client-request-id 标头值。 例如：360b66a6-ad4f-4c4a-84a4-0ad7cb44f7a6。
    etag 返回的对象的 ETag 标识符，带引号。 例如：0x8D101F7E4B662C4。
    serverLatencyMs 执行所请求操作的总时间（以毫秒为单位）。 此值不包括网络延迟（读取传入请求和向请求者发送响应的时间）。 例如：22。
    serviceType 与此请求关联的服务。 例如：blob、table、files 或 queue。
    operationCount 请求中涉及的每个已记录操作的编号。 此计数从索引 0 开始。 某些请求需要多个操作。 大多数请求仅执行一个操作。 例如：1。
    requestHeaderSize 请求标头的大小（以字节为单位）。 例如：578。
    如果请求失败，此值可能为空。
    requestBodySize 存储服务读取的请求数据包的大小（以字节为单位）。
    例如：0。
    如果请求失败，此值可能为空。
    responseHeaderSize 响应标头的大小（以字节为单位）。 例如：216。
    如果请求失败，此值可能为空。
    responseBodySize 存储服务写入的响应数据包的大小（以字节为单位）。 如果请求失败，此值可能为空。 例如：216。
    requestMd5 请求中的 Content-MD5 标头或 x-ms-content-md5 标头的值。 此字段中指定的 MD5 哈希值表示请求中的内容。 例如：788815fd0198be0d275ad329cafd1830。
    此字段可以为空。
    serverMd5 存储服务计算的 MD5 哈希的值。 例如：3228b3cf1069a5489b298446321f8521。
    此字段可以为空。
    lastModifiedTime 返回的对象的上次修改时间 (LMT)。 例如：Tuesday, 09-Aug-11 21:13:26 GMT。
    对于可以返回多个对象的操作，此字段为空。
    conditionsUsed 表示条件的键/值对的分号分隔列表。 条件可以是以下任意一种：
  • If-Modified-Since
  • If-Unmodified-Since
  • If-Match
  • If-None-Match
    例如：If-Modified-Since=Friday, 05-Aug-11 19:11:54 GMT。
    		•
    contentLengthHeader 发送到存储服务的请求的 Content-Length 标头值。 如果请求成功，则此值等于 requestBodySize。 如果请求失败，则此值可能不等于 requestBodySize，也可能为空。
    tlsVersion 请求在连接时使用的 TLS 版本。 例如：TLS 1.2。
    smbTreeConnectID 在树连接时建立的服务器消息块 (SMB) treeConnectId。 例如： 0x3
    smbPersistentHandleID SMB2 CREATE 请求在经历网络重新连接后会保留的持久性句柄 ID。 在 MS-SMB2 2.2.14.1 中称为 SMB2_FILEID.Persistent。 例如： 0x6003f
    smbVolatileHandleID SMB2 CREATE 请求在网络重新连接时将回收的易失句柄 ID。 在 MS-SMB2 2.2.14.1 中称为 SMB2_FILEID.Volatile。 例如： 0xFFFFFFFF00000065
    smbMessageID 连接相关 MessageId。 例如： 0x3b165
    smbCreditsConsumed 请求消耗的流入量或流出量（以 64k 为单位）。 例如： 0x3
    smbCommandDetail 有关此特定请求而不是常规类型请求的详细信息。 例如： 0x2000 bytes at offset 0xf2000
    smbFileId 与文件或目录关联的 FileId。 大致类似于 NTFS FileId。 例如： 0x9223442405598953
    smbSessionID 在建立会话时建立的 SMB2 SessionId。 例如： 0x8530280128000049
    smbCommandMajor uint32 SMB2_HEADER.Command 中的值。 目前，这是一个 0 到 18（含）之间的数字。 例如： 0x6
    smbCommandMinor SmbCommandMajor 的子类（如果适用）。 例如： DirectoryCloseAndDelete

    另请参阅