Azure Files 監視データのリファレンス

Azure Files の監視データの収集と分析の詳細については、「Azure Files の監視」を参照してください。

適用対象

ファイル共有の種類 SMB NFS
Standard ファイル共有 (GPv2)、LRS/ZRS はい いいえ
Standard ファイル共有 (GPv2)、GRS/GZRS はい いいえ
Premium ファイル共有 (FileStorage)、LRS/ZRS はい はい

メトリック

次の表は、Azure Files に関して収集されるプラットフォーム メトリックを示しています。

容量メトリック

容量メトリックの値は毎日 (最大 24 時間) 更新されます。 時間グレインは、メトリック値が提供される時間間隔を定義します。 すべての容量メトリックに対して、1 時間 (PT1H) の時間グレインがサポートされます。

Azure Files は、Azure Monitor で次の容量メトリックを提供します。

アカウント レベル

この表は、アカウントレベルのメトリックを示しています。

メトリック 説明
UsedCapacity ストレージ アカウントによって使用されているストレージの量。 Standard ストレージ アカウントについては、Blob、Table、File、および Queue で使用される容量の合計です。 Premium ストレージ アカウントと BLOB ストレージ アカウントについては、BlobCapacity と同じです。

単位:バイト
集計の種類:Average
値の例:1024

Azure Files

次の表は、Azure Files メトリックを示しています。

メトリック 説明
FileCapacity ストレージ アカウントによって使用されている File ストレージの量。

単位:バイト
集計の種類:Average
ディメンション: FileShare、レベル
値の例:1024
FileCount ストレージ アカウントのファイルの数。

単位:Count
集計の種類:Average
ディメンション: FileShare、レベル
値の例:1024
FileShareCapacityQuota Azure Files サービスで使用できる記憶域の容量の上限 (バイト単位)。

単位:バイト
集計の種類:Average
値の例:1024
FileShareCount ストレージ アカウントのファイル共有の数。

単位:Count
集計の種類:Average
値の例:1024
FileShareProvisionedIOPS ファイル共有でプロビジョニングされた IOPS の数。 このメトリックは、Premium ファイル ストレージにのみ適用されます。

単位: CountPerSecond
集計の種類:Average
FileShareSnapshotCount ストレージ アカウントの Azure Files サービス内の共有に存在するスナップショットの数。

単位: カウント
集計の種類:Average
FileShareSnapshotSize ストレージ アカウントの Azure Files サービスのスナップショットによって使用されている記憶域の容量。

単位:バイト
集計の種類:Average

トランザクション メトリック

トランザクション メトリックは、ストレージ アカウントへの要求ごとに、Azure Storage から Azure Monitor に出力されます。 ストレージ アカウントにアクティビティがない場合、その間はトランザクション メトリックのデータは存在しません。 すべてのトランザクション メトリックは、アカウントと Azure Files の両方のサービス レベルで使用できます。 時間グレインは、メトリック値が提供される時間間隔を定義します。 すべてのトランザクション メトリックに対してサポートされている時間グレインは PT1H と PT1M です。

Azure Storage は、Azure Monitor で次のトランザクション メトリックを提供します。

メトリック 説明
トランザクション ストレージ サービスまたは指定された API 操作に対して行われた要求の数。 この数には、成功した要求と失敗した要求およびエラーが発生した要求が含まれます。

単位:Count
集計の種類:合計
適用可能なディメンション:ResponseType、GeoType、ApiName、Authentication (定義)
値の例:1024
イングレス イングレス データの量。 この値には、外部クライアントから Azure Storage へのイングレスおよび Azure 内でのイングレスが含まれます。

単位:バイト
集計の種類:合計
適用可能なディメンション:GeoType、ApiName、Authentication (定義)
値の例:1024
エグレス エグレス データの量。 この値には、外部クライアントから Azure Storage へのエグレスおよび Azure 内でのエグレスが含まれます。 したがって、この値には、課金対象のエグレスが反映されません。

単位:バイト
集計の種類:合計
適用可能なディメンション:GeoType、ApiName、Authentication (定義)
値の例:1024
SuccessServerLatency Azure Storage による成功した要求の平均処理時間。 この値には、SuccessE2ELatency で指定されているネットワーク待機時間は含まれません。

単位:ミリ秒
集計の種類:Average
適用可能なディメンション:GeoType、ApiName、Authentication (定義)
値の例:1024
SuccessE2ELatency ストレージ サービスまたは指定された API 操作に対して行われた成功した要求の平均エンド ツー エンド待機時間。 この値には、要求の読み取り、応答の送信、および応答の受信確認を受け取るために Azure Storage 内で必要な処理時間が含まれます。 SuccessE2ELatency 値と SuccessServerLatency 値の差は、ネットワークやクライアントによって発生する可能性のある待機時間を示します。

単位:ミリ秒
集計の種類:Average
適用可能なディメンション:GeoType、ApiName、Authentication (定義)
値の例:1024
可用性 ストレージ サービスまたは指定された API 操作の可用性の割合。 可用性は、合計課金対象要求数の値を取得し、それを該当する要求の数 (予期しないエラーになった要求を含む) で割ることによって、計算されます。 予期しないエラーすべてが、ストレージ サービスまたは指定された API 操作の可用性の低下をもたらします。

単位:Percent
集計の種類:Average
適用可能なディメンション:GeoType、ApiName、Authentication (定義)
値の例:99.99

メトリックのディメンション

Azure Files では、Azure Monitor の次のメトリック ディメンションがサポートされます。

Note

ファイル共有ディメンションは、Standard ファイル共有では使用できません (Premium ファイル共有のみ)。 Standard ファイル共有を使用する場合、提供されるメトリックは、ストレージ アカウント内のすべてのファイル共有に対するものです。 Standard ファイル共有の共有ごとのメトリックを取得するには、ストレージ アカウントごとに 1 つのファイル共有を作成します。

ディメンション名 説明
GeoType プライマリ クラスターまたはセカンダリ クラスターからのトランザクション。 使用できる値には、PrimarySecondary が含まれています。 セカンダリ テナントからオブジェクトを読み取るときに、読み取りアクセス geo 冗長ストレージ (RA-GRS) に適用されます。
ResponseType トランザクション応答の種類。 次の値をご利用いただけます。

  • ServerOtherError:記述されていない、その他すべてのサーバー側エラー
  • ServerBusyError:HTTP 503 ステータス コードを返した認証済み要求。
  • ServerTimeoutError:HTTP 500 ステータス コードを返した、タイムアウトした認証済み要求。 タイムアウトは、サーバー エラーが原因で発生しました。
  • AuthenticationError:サーバーによる要求の認証が失敗しました。
  • AuthorizationError:データの不正アクセスまたは承認エラーが原因で失敗した認証済み要求。
  • NetworkError:ネットワーク エラーが原因で失敗した認証済み要求。 クライアントがタイムアウト期限が切れる前に途中で接続を終了したときによく発生します。
  • ClientAccountBandwidthThrottlingError:この要求は、ストレージ アカウントのスケーラビリティの制限を超えたため、帯域幅が調整されます。
  • ClientAccountRequestThrottlingError:この要求は、ストレージ アカウントのスケーラビリティの制限を超えたため、要求レートが調整されます。
  • ClientThrottlingError:その他のクライアント側の調整エラー。 ClientAccountBandwidthThrottlingError と ClientAccountRequestThrottlingError は除外されます。
  • ClientShareEgressThrottlingError:Premium ファイル共有にのみ適用されます。 その他のクライアント側の調整エラー。 共有の制限が超えたことによるエグレス帯域幅の調整によって要求が失敗しました。 ClientAccountBandwidthThrottlingError は除外されます。
  • ClientShareIngressThrottlingError:Premium ファイル共有にのみ適用されます。 その他のクライアント側の調整エラー。 共有の制限が超えたことによるイングレス帯域幅の調整によって要求が失敗しました。 ClientAccountBandwidthThrottlingError は除外されます。
  • ClientShareIopsThrottlingError: その他のクライアント側の調整エラー。 IOPS 調整によって要求が失敗しました。 ClientAccountRequestThrottlingError は除外されます。
  • ClientTimeoutError:HTTP 500 ステータス コードを返した、タイムアウトした認証済み要求。 クライアントのネットワーク タイムアウトまたは要求タイムアウトが、ストレージ サービスで予期される値よりも低く設定されている場合、これは予期されるタイムアウトです。 それ以外の場合は、ServerTimeoutError としてレポートされます。
  • ClientOtherError:記述されていない、その他すべてのクライアント側エラー。
  • 成功:成功した要求
  • SuccessWithThrottling: 最初に試みたときは SMB クライアントが調整されたが再試行後に成功したときの、成功した要求。
  • SuccessWithShareEgressThrottling:Premium ファイル共有にのみ適用されます。 最初に試みたときはエグレス帯域幅の調整によって SMB クライアントが調整されたが再試行後に成功したときの、成功した要求。
  • SuccessWithShareIngressThrottling:Premium ファイル共有にのみ適用されます。 最初に試みたときはイングレス帯域幅の調整によって SMB クライアントが調整されたが再試行後に成功したときの、成功した要求。
  • SuccessWithShareIopsThrottling: 最初に試みたときは IOPS の調整によって SMB クライアントが調整されたが再試行後に成功したときの、成功した要求。
  • ApiName 操作の名前。 操作の名前が識別される前にエラーが発生した場合、名前は "Unknown" と表示されます。 ResponseType ディメンションの値を使用して、エラーの詳細について確認できます。
    認証 トランザクションで使用される認証の種類。 次の値をご利用いただけます。
  • AccountKey:トランザクションは、ストレージ アカウント キーを使って認証されます。
  • SAS:トランザクションは、Shared Access Signature を使って認証されます。
  • OAuth:トランザクションは、OAuth アクセス トークンを使って認証されます。
  • Anonymous:トランザクションは匿名で要求されます。 プリフライト要求は含まれません。
  • AnonymousPreflight:トランザクションは、プリフライト要求です。
  • トランザクションの種類 トランザクションの種類。 次の値をご利用いただけます。
  • ユーザー:トランザクションは顧客によって実行されました。
  • システム: トランザクションはシステム プロセスによって実行されました。
  • リソース ログ

    次の表に、Azure Monitor ログまたは Azure Storage で Azure Storage リソース ログが収集される場合のそれらのプロパティを示します。 プロパティによって、操作、サービス、操作の実行に使用された承認の種類が示されます。

    操作を説明するフィールド

    プロパティ 説明
    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 要求された操作のカテゴリ。 例: StorageReadStorageWrite、または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 操作で使用されるプロトコル。 例: HTTPHTTPSSMBNFS
    uri 要求された Uniform Resource Identifier

    操作がどのように認証されたかを説明するフィールド

    プロパティ 説明
    identity / type 要求の作成に使用された認証の種類。 例: OAuthKerberosSAS KeyAccount KeyAnonymous
    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 この要求に関連付けられたサービス。 例: blobtablefilesqueue
    operationCount 要求に関連する、ログに記録された各操作の数。 このカウントはインデックス 0 で始まります。 要求によっては、複数の操作が必要になる場合があります。 ほとんどの要求では 1 つの操作だけが実行されます (例: 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

    関連項目