通过

Azure 文件存储监视数据参考

  • 项目

本文包含此服务的所有监视参考信息。

请参阅监视 Azure 文件存储，详细了解可为 Azure 文件存储收集的数据以及如何使用这些数据。

适用于

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

指标

本部分列出了为此服务自动收集的所有平台指标。

有关指标保留的信息，请参阅 Azure Monitor 指标概述。

Microsoft.Storage/storageAccounts 支持的指标

下表列出了可用于 Microsoft.Storage/storageAccounts 资源类型的指标。

  • 每个表中可能不显示所有列。
  • 某些列可能超出了页面的查看区域。 选择“展开表”以查看所有可用列。

表标题

  • 类别 - 指标组或分类。
  • 指标 - 在 Azure 门户中显示的指标显示名称。
  • REST API 中的名称 - 在 REST API 中引用的指标名称。
  • 单位 - 度量单位。
  • 聚合 - 默认的聚合类型。 有效值：平均值（平均）、最小值（最小值）、最大值（最大值）、总计（总和）、计数。
  • 维度 - 适用于指标的维度。
  • 时间粒度 - 对指标采样的间隔。 例如，PT1M 表示该指标每分钟采样一次，PT30M 表示每 30 分钟一次，PT1H 表示每小时一次，以此类推。
  • DS 导出 - 是否可通过诊断设置将指标导出到 Azure Monitor 日志。 要了解如何导出指标的信息，请参阅在 Azure Monitor 中创建诊断设置。
类别 指标 REST API 中的名称 Unit 聚合 维度 时间粒度 DS 导出
事务 可用性

存储服务或指定的 API 操作的可用性百分比。 可用性通过由 TotalBillableRequests 值除以适用的请求数（其中包括引发意外错误的请求）计算得出。 所有意外错误都会导致存储服务或指定的 API 操作的可用性下降。		 Availability 百分比 平均值、最小值、最大值 GeoType, ApiName, Authentication PT1M 是
事务 流出量

流出数据量。 此数字包括从 Azure 存储到外部客户端流出的数据量，以及 Azure 内部的流出数据量。 因此，此数字不反映计费的流出量。		 Egress 字节 总计、平均值、最小值、最大值 GeoType, ApiName, Authentication PT1M 是
事务 流入量

流入的数据量（以字节为单位）。 此数字包括从外部客户端到 Azure 存储流入的数据量，以及流入 Azure 中的数据量。		 Ingress 字节 总计、平均值、最小值、最大值 GeoType, ApiName, Authentication PT1M 是
事务 成功 E2E 延迟

向存储服务或指定的 API 操作发出的成功请求的平均端到端延迟（以毫秒为单位）。 此值包括在 Azure 存储中读取请求、发送响应和接收响应确认所需的处理时间。		 SuccessE2ELatency 毫秒 平均值、最小值、最大值 GeoType, ApiName, Authentication PT1M 是
事务 成功服务器延迟

Azure 存储处理成功请求所用的平均时间。 此值不包括 SuccessE2ELatency 中指定的网络延迟。		 SuccessServerLatency 毫秒 平均值、最小值、最大值 GeoType, ApiName, Authentication PT1M 是
事务 中的

向存储服务或指定的 API 操作发出的请求数。 此数值包括成功和失败的请求数，以及引发错误的请求数。 针对不同类型的响应数使用 ResponseType 维度。		 Transactions 计数 总计 ResponseType, GeoType, ApiName, Authentication, TransactionType PT1M 是
容量 已用容量

存储帐户使用的存储量。 对于标准存储帐户，该指标是 Blob、表、文件和队列使用的容量总和。 对于高级存储帐户和 Blob 存储帐户，它与 BlobCapacity 或 FileCapacity 相同。		 UsedCapacity 字节 平均值 <无> PT1H 否

支持的 Microsoft.Storage/storageAccounts/fileServices 指标

下表列出了可用于 Microsoft.Storage/storageAccounts/fileServices 资源类型的指标。

  • 每个表中可能不显示所有列。
  • 某些列可能超出了页面的查看区域。 选择“展开表”以查看所有可用列。

表标题

  • 类别 - 指标组或分类。
  • 指标 - 在 Azure 门户中显示的指标显示名称。
  • REST API 中的名称 - 在 REST API 中引用的指标名称。
  • 单位 - 度量单位。
  • 聚合 - 默认的聚合类型。 有效值：平均值（平均）、最小值（最小值）、最大值（最大值）、总计（总和）、计数。
  • 维度 - 适用于指标的维度。
  • 时间粒度 - 对指标采样的间隔。 例如，PT1M 表示该指标每分钟采样一次，PT30M 表示每 30 分钟一次，PT1H 表示每小时一次，以此类推。
  • DS 导出 - 是否可通过诊断设置将指标导出到 Azure Monitor 日志。 要了解如何导出指标的信息，请参阅在 Azure Monitor 中创建诊断设置。
类别 指标 REST API 中的名称 Unit 聚合 维度 时间粒度 DS 导出
事务 可用性

存储服务或指定的 API 操作的可用性百分比。 可用性通过由 TotalBillableRequests 值除以适用的请求数（其中包括引发意外错误的请求）计算得出。 所有意外错误都会导致存储服务或指定的 API 操作的可用性下降。		 Availability 百分比 Count、Average、Minimum、Maximum GeoType, ApiName, Authentication, FileShare PT1M 是
事务 流出量

流出数据量。 此数字包括从 Azure 存储到外部客户端流出的数据量，以及 Azure 内部的流出数据量。 因此，此数字不反映计费的流出量。		 Egress 字节 Total、Average、Minimum、Maximum GeoType, ApiName, Authentication, FileShare PT1M 是
容量 文件容量

存储帐户使用的文件存储量。		 FileCapacity 字节 平均值 FileShare, Tier PT1H 否
容量 文件计数

存储帐户中的文件数目。		 FileCount 计数 平均值 FileShare, Tier PT1H 否
容量 文件共享容量配额

Azure 文件服务可使用的存储量上限（以字节为单位）。		 FileShareCapacityQuota 字节 平均值 FileShare PT1H 否
容量 文件共享计数

存储帐户中的文件共享数目。		 FileShareCount 计数 平均值 <无> PT1H 否
事务 带宽（最大 MiB/s）

高级文件存储帐户中的高级文件共享按最小时间粒度 1 分钟的最大已用带宽数 (MiB/s)。		 FileShareMaxUsedBandwidthMiBps 每秒计数 最大 FileShare PT1M 否
事务 事务（最大 IOPS）

高级文件存储帐户中的高级文件共享按最小时间粒度 1 分钟的最大已用 IOPS 数。		 FileShareMaxUsedIOPS 每秒计数 最大 FileShare PT1M 否
容量 文件共享预配的带宽 MiB/s

高级文件存储帐户中高级文件共享的预配带宽 (MiB/s) 基准值。 此数字是根据共享容量的配置大小（配额）计算的。		 FileShareProvisionedBandwidthMiBps 每秒计数 平均值 FileShare PT1H 否
容量 文件共享预配的 IOPS

高级文件存储帐户中高级文件共享预配的 IOPS 的基线数。 此数字是根据共享容量的配置大小（配额）计算的。		 FileShareProvisionedIOPS 每秒计数 平均值 FileShare PT1H 否
容量 文件共享快照计数

存储帐户文件服务的共享中存在的快照数。		 FileShareSnapshotCount 计数 平均值 FileShare PT1H 否
容量 文件共享快照大小

存储帐户的文件服务中的快照所用存储量（以字节为单位）。		 FileShareSnapshotSize 字节 平均值 FileShare PT1H 否
事务 流入量

流入的数据量（以字节为单位）。 此数字包括从外部客户端到 Azure 存储流入的数据量，以及流入 Azure 中的数据量。		 Ingress 字节 Total、Average、Minimum、Maximum GeoType, ApiName, Authentication, FileShare PT1M 是
事务 成功 E2E 延迟

向存储服务或指定的 API 操作发出的成功请求的平均端到端延迟（以毫秒为单位）。 此值包括在 Azure 存储中读取请求、发送响应和接收响应确认所需的处理时间。		 SuccessE2ELatency 毫秒 Count、Average、Minimum、Maximum GeoType, ApiName, Authentication, FileShare PT1M 是
事务 成功服务器延迟

Azure 存储处理成功请求所用的平均时间。 此值不包括 SuccessE2ELatency 中指定的网络延迟。		 SuccessServerLatency 毫秒 Count、Average、Minimum、Maximum GeoType, ApiName, Authentication, FileShare PT1M 是
事务 中的

向存储服务或指定的 API 操作发出的请求数。 此数值包括成功和失败的请求数，以及引发错误的请求数。 针对不同类型的响应数使用 ResponseType 维度。		 Transactions 计数 总计 ResponseType, GeoType, ApiName, Authentication, FileShare, TransactionType PT1M 是

指标维度

有关指标维度定义的信息，请参阅多维指标。

此服务具有以下与其指标关联的维度。

注意

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

维度名称 描述
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：当 SMB 客户端在第一次或多次尝试中因 IOPS 限制而受到限制，但在重试后成功时，请求成功。
  • SuccessWithMetadataWarning：仅适用于文件共享。 当客户端运行高元数据 IOPS 时，请求成功；如果 IOPS 保持较高或增加，这可能会导致稍后的限制。
  • SuccessWithMetadataThrottling：仅适用于文件共享。 当客户端在第一次或多次尝试中因元数据 IOPS 过高而受到限制，但在重试后成功时，请求成功。
    		•
    ApiName 操作的名称。 如果在标识操作名称之前发生故障，则该名称显示为“未知”。可以使用 ResponseType 维度的值了解有关故障的详细信息。
    身份验证 事务中所用的身份验证类型。 可用的值包括：
  • AccountKey：事务通过存储帐户密钥进行身份验证。
  • SAS：事务通过服务/帐户共享访问签名进行身份验证。
  • DelegationSas：使用用户委托 SAS 对事务进行身份验证。
  • OAuth：事务通过 OAuth 访问令牌进行身份验证。
  • Anonymous：事务以匿名方式请求。 不包括预检请求。
  • AnonymousPreflight：事务为预检请求。
    		•
    TransactionType 事务的类型。 可用的值包括：
  • 用户：事务由客户进行。
  • 系统：事务由系统进程进行。
    		•

    资源日志

    本部分列出了可为此服务收集的资源日志类型。 本部分拉取自 Azure Monitor 支持的所有资源日志类别类型列表。

    支持的 Microsoft.Storage/storageAccounts/fileServices 资源日志

    Category 类别显示名称 日志表 支持基本日志计划 支持引入时间转换 导出成本
    StorageDelete StorageDelete StorageFileLogs

    存储文件服务日志架构

    		 是 是 是
    StorageRead StorageRead StorageFileLogs

    存储文件服务日志架构

    		 是 是 是
    StorageWrite StorageWrite StorageFileLogs

    存储文件服务日志架构

    		 是 是 是

    Azure Monitor 日志表

    本部分涉及与此服务相关的所有 Azure Monitor 日志表，Log Analytics 可使用 Kusto 查询来查询这些表。

    此服务使用下表来存储资源日志数据。

    • AzureActivity
    • AzureMetrics
    • StorageFileLogs

    以下表列出了在 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 存储帐户的位置。 例如：China East 2。
    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 / denyAssignmentId 拒绝分配拒绝访问的日期（采用 GUID 格式）。
    拒绝分配可能来自 Azure 蓝图或托管应用程序。
    有关拒绝分配的详细信息，请参阅了解 Azure 拒绝分配
    authorization / reason 请求授权结果的原因。
    例如，Policy、NoApplicablePolicy 或 MissingAttributes
    authorization / result 请求的授权结果。
    例如：Granted 或 Denied
    authorization / roleAssignmentId 角色分配 ID。
    例如：4e2521b7-13be-4363-aeda-111111111111。
    authorization / roleDefinitionId 角色定义 ID。
    例如：ba92f5b4-2d11-453d-a403-111111111111。
    authorization / type 请求授权结果的来源。
    例如：RBAC 或 ABAC
    principals / id 安全主体的 ID。
    例如：a4711f3a-254f-4cfb-8a2d-111111111111。
    principals / type 安全主体的类型。
    例如：ServicePrincipal。
    properties / metricResponseType 来自指标事务的响应。
    有关示例，请参阅存储服务的 ResponseType 指标维度：
    blobs
    文件
    队列
    tables
    properties / objectKey 正在访问的对象的路径。
    例如：samplestorageaccount/container1/blob.png。
    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.chinacloudapi.cn/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

    活动日志

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

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

    相关内容