ストレージレポート - Amazon FSx for Windows File Server
レポートタイプレポート形式インタラクティブレポートとスケジュールされたレポートレポートの実行ストレージレポートへのアクセスベストプラクティス管理コマンド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ストレージレポート

ストレージレポートは、ファイルシステムの使用状況の詳細な分析を提供し、ストレージの使用状況の把握、アーカイブまたは削除できるファイルの特定、ファイル管理ポリシーへの準拠のモニタリングに役立ちます。ファイルの所有権、ファイルタイプ、重複ファイル、大きなファイル、ファイルスクリーニング、クォータの使用状況を分析する複数のタイプのレポートを生成できます。

レポートタイプ

次のレポートタイプを作成できます。

  • DuplicateFiles

    ファイルサイズとハッシュ比較に基づいて、同じコンテンツを持つファイルを識別します。このレポートを使用して、不要なストレージ領域を消費する冗長ファイルを検索します。レポートは重複ファイルをグループ化し、重複を削除することで復旧できる合計領域を表示します。

  • FilesByFileGroup

    ファイルグループメンバーシップでファイルをグループ化し、各ファイルグループのストレージ消費量を表示します。このレポートを使用して、どのタイプのファイル (ドキュメント、メディア、実行可能ファイルなど) が最も消費するストレージ領域を把握します。

  • FilesByOwner

    所有者ごとにファイルをグループ化し、各ユーザーまたはグループが消費するストレージの量を示します。このレポートを使用して、ストレージ領域を最も多く消費しているユーザーを特定し、ストレージコストまたはクォータを適切に割り当てます。

  • FilesByProperty

    分類プロパティ値でファイルをグループ化し、各プロパティ値のファイル数とストレージ消費量を表示します。このレポートを使用して、データの機密性レベル、部門、保持期間などの分類に基づいてファイルを分析します。このレポートでは、ファイルが を使用して分類されている必要があります分類ルール。

  • FileScreenAuditFiles

    アクティブなファイル画面によってブロックされたファイルを保存しようとしたファイルスクリーニング違反を一覧表示します。このレポートを使用して、ファイルスクリーニングポリシーへの準拠をモニタリングし、不正なファイルタイプの保存を頻繁に試みるユーザーを特定します。

  • FoldersByProperty

    管理プロパティ値でフォルダをグループ化し、各プロパティ値のストレージ消費量を表示します。このレポートを使用して、ユーザーファイル、グループ共有、アプリケーションファイルなど、フォルダの目的別にストレージの使用状況を分析します。

  • LargeFiles

    指定されたサイズのしきい値を超えるファイルを一覧表示します。このレポートを使用して、大量のストレージ領域を消費し、アーカイブ、圧縮、または削除の対象となる可能性のあるファイルを特定します。

  • LeastRecentlyAccessed

    指定した日数アクセスされていないファイルを一覧表示します。このレポートを使用して、アーカイブまたは低コストのストレージ階層に移動できる非アクティブなファイルを特定します。

  • MostRecentlyAccessed

    指定された日数内にアクセスされたファイルを一覧表示します。

  • QuotaUsage

    クォータが設定されたフォルダのクォータ使用状況統計を表示します。このレポートを使用して、クォータのコンプライアンスをモニタリングし、クォータの制限に近づいているフォルダを特定します。

レポート形式

さまざまなユースケースに合わせて、複数の形式でレポートを生成できます。

  • DHTML - ソートやフィルタリングなどのインタラクティブな機能を備えた動的 HTML 形式。

  • HTML - アーカイブまたは E メール送信に適した静的 HTML 形式。

  • XML - プログラムによる処理のための構造化データ形式。

  • CSV - スプレッドシートアプリケーションにインポートするためのカンマ区切り値形式。

  • Text - シンプルな表示または処理のためのプレーンテキスト形式。

1 つのレポートに複数の形式を指定できます。

インタラクティブレポートとスケジュールされたレポート

次の 2 種類のストレージレポートを作成できます。

  1. インタラクティブレポート - 作成時にすぐに実行し、1 回だけ実行します。アドホック分析やトラブルシューティングには、インタラクティブなレポートを使用します。インタラクティブレポートにはスケジュールがないため、作成後に変更することはできません。別のインタラクティブレポートを実行するには、別の名前で新しいレポートを作成する必要があります。

  2. スケジュールされたレポート - 設定されたスケジュールに従って自動的に実行されます。スケジュールされたレポートを使用して、定期的なモニタリングとコンプライアンスレポートを作成します。レポートは、週 1 回または月 1 回、特定の時間に実行するようにスケジュールできます。スケジュールされたレポートは設定を変更できます。また、スケジュールされた時間を待たずに Start-FSxFSRMStorageReport コマンドを使用してオンデマンドで実行することもできます。

レポートの実行

スケジュールされたレポートを作成したら、いくつかの方法で実行できます。

  • 自動実行 - スケジュールされたレポートは、設定されたスケジュール時刻に自動的に実行されます。

  • 手動実行 - スケジュールされた時間を待たずに、スケジュールされたレポートをオンデマンドで実行Start-FSxFSRMStorageReportするために使用します。

を使用してレポートの実行をモニタリングGet-FSxFSRMStorageReportし、ステータスを確認できます。

ストレージレポートへのアクセス

FSRM がストレージレポートを生成すると、レポートファイルはファイルシステムのデフォルトの場所に保存されます。これらのレポートにアクセスするには、ファイルシステムの管理 D$ 共有をマッピングする必要があります。

ストレージレポートにアクセスするには

  1. 次のパス形式を使用して管理 D$ 共有をマッピングします。

    \\file-system-dns-name\D$

    例えば、次のようになります。

    \\amznfsxaa11bb22.corp.example.com\D$

  2. StorageReports フォルダに移動します。このフォルダには、レポートタイプと実行日別に整理されたサブフォルダが含まれています。

注記

管理 D$ 共有にアクセスするには、管理者認証情報が必要です。

ストレージレポートのベストプラクティス

効率的で効果的なストレージレポートを行うには、以下のベストプラクティスに従ってください。

パフォーマンスに関する考慮事項

FSRM は大量のファイルをスキャンする必要があるため、ストレージレポートの生成はリソースを大量に消費します。

  • レポート範囲の制限 - ファイルシステム全体をスキャンするのではなく、 Namespaceパラメータを使用してレポートを特定のフォルダに制限します。大規模なディレクトリ構造のスキャンはリソースを大量に消費するため、完了までに数時間かかる場合があります。

  • オフピーク時間帯にレポートをスケジュールする - システムアクティビティが少ない時間帯にスケジュールされたレポートを実行して、パフォーマンスへの影響を最小限に抑えます。バックアップウィンドウやその他のメンテナンスタスク中にレポートを実行しないでください。

  • 妥当なしきい値を設定する - しきい値パラメータを使用して、レポート出力を実用的なデータに制限します。たとえば、 LargeFileMinimumを 1 1MB を超えるすべてのファイルではなく、調査する価値のあるファイルを識別する値に設定します。

  • RunDuration の制限を使用する - RunDurationパラメータを設定して、レポートの実行時間が長すぎてシステムパフォーマンスに影響を与えないようにします。レポートが時間制限内に完了しない場合、次回のスケジュールされた実行中に再開されます。

  • レポートパフォーマンスのモニタリング - レポートの完了にかかる時間をチェックGet-FSxFSRMStorageReportするために使用します。レポートが一貫して長すぎる場合は、範囲を狭めるか、実行頻度を低くすることを検討してください。

レポート設計

  • わかりやすい名前を使用する - 「毎週の大きなファイル - 財務共有」や「毎月の重複ファイル - すべての共有」など、分析内容と実行時期を示すわかりやすい名前をレポートに付けます。

  • 関連する分析を組み合わせる - 同じ名前空間に対して複数のレポートタイプを生成する場合は、個別のレポートではなく、複数のReportType値を持つ単一のレポートを作成します。これは、FSRM がディレクトリ構造を 1 回スキャンするだけで済むため、より効率的です。

  • ファイルパターンでフィルタリングする - ファイルパターンパラメータを使用して、特定のファイルタイプにレポートに焦点を当てます。たとえば、大きなファイルを分析する際に、ストレージの消費パターンをよりよく理解するために、ビデオファイル、データベースファイル、アーカイブファイルの個別のレポートを作成できます。

  • 分類プロパティを活用する - FilesByPropertyレポートを使用して、分類に基づいてファイルを分析します。これにより、より有意義なインサイトが得られます。

レポート管理

  • レポートを定期的に確認する - レポート結果を確認し、結果に対してアクションを実行する時間をスケジュールします。レポートは、ストレージ管理の決定に使用する場合にのみ役立ちます。

  • 古いレポートをアーカイブ - レポートファイルは時間の経過とともに蓄積され、ストレージ領域を消費します。レポートファイルの保持ポリシーを確立し、不要になった古いレポートを削除またはアーカイブします。

  • スケジュール前にレポートをテストする - インタラクティブレポートを作成してレポート設定をテストし、スケジュールされたバージョンを作成する前に期待される結果が得られることを確認します。

ストレージレポート管理コマンド

ストレージレポートを管理するために、FSx リモート PowerShell コマンドの 2 つのファミリーにアクセスできます。

  1. レポート定義コマンド - 分析するデータ、レポートを実行するタイミング、生成する形式を指定するストレージレポート設定を作成、取得、変更、削除します。

  2. レポート実行コマンド - ストレージレポートの生成を開始、停止、モニタリング、待機します。これらのコマンドを使用して、レポートをオンデマンドで実行したり、長時間実行されるレポートジョブを管理したりできます。

Storage Report FSx リモート PowerShell コマンドのリスト

注記

このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで $FSxWindowsRemotePowerShellEndpoint変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの Amazon FSx コンソール、または コマンドを使用して AWS CLI describe-file-systems確認できます。

レポート定義コマンド

New-FSxFSRMStorageReport

New-FSxFSRMStorageReport: 指定されたディレクトリを分析して 1 つ以上のレポートタイプを生成するストレージレポートを作成します。

パラメータ :

  • Name (string) - 必須。ストレージレポートの名前。

  • Namespace (array) - 必須。分析するパスまたはフォルダタイプの配列。パスは複数の形式で指定できます。

  • ReportType (array) - 必須。生成するレポートタイプの配列。次の値を指定できます。

    • DuplicateFiles: ファイルサイズとコンテンツに基づいて重複ファイルを識別します

    • FilesByFileGroup: ファイルグループメンバーシップでファイルをグループ化する

    • FilesByOwner: 所有者別にファイルをグループ化する

    • FilesByProperty: 分類プロパティでファイルをグループ化する

    • FileScreenAuditFiles: ファイルスクリーニング違反を一覧表示します

    • FoldersByProperty: 管理プロパティでフォルダをグループ化する

    • LargeFiles: 指定されたサイズしきい値を超えるファイルを一覧表示します

    • LeastRecentlyAccessed: 最近アクセスされていないファイルを一覧表示します

    • MostRecentlyAccessed: 最近アクセスされたファイルを一覧表示します

    • QuotaUsage: クォータ使用状況統計を表示します

  • ReportFormat (array) - オプション。出力形式の配列。次の値を指定できます。

    • DHTML: 動的 HTML 形式

    • HTML: 静的 HTML 形式

    • XML: XML 形式

    • CSV: カンマ区切り値形式

    • Text: プレーンテキスト形式

  • Interactive (boolean) - オプション。true に設定すると、 はインタラクティブレポートを生成します。インタラクティブレポートは、作成後に変更することはできません。

  • ScheduleConfigurations (hashtable) - レポートがインタラクティブでない限り必要です。次のプロパティを持つスケジュール設定を含むハッシュテーブル。

    • Time (datetime): タスクを実行するタイミングを指定する DateTime オブジェクト (必須)

    • RunDuration (number): タスクを実行する時間数 (オプション)

    • Weekly (array): 平日の配列 (オプション)

    • Monthly (array): 曜日の配列、最終日-1に使用します (オプション)

レポート固有のパラメータ:

  • FileScreenAuditDaysSince (number) - オプション。FileScreenAuditFiles レポートの場合、監査イベントを含めるまでの日数を指定します。

  • FileScreenAuditUser (array) - オプション。FileScreenAuditFiles レポートの場合、レポートに含めるユーザーアカウントの配列を指定します。これらのユーザーによるファイルスクリーニング違反のみが含まれます。

  • FileGroupIncluded (array) - オプション。FilesByFileGroup レポートの場合、含めるファイルグループを指定します。

  • FileOwnerFilePattern (string) - オプション。FilesByOwner レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • PropertyName (string) - オプション。FilesByProperty レポートの場合、グループ化する分類プロパティを指定します。

  • FolderPropertyName (string) - オプション。FoldersByProperty レポートの場合、グループ化するフォルダプロパティを指定します。

  • PropertyFilePattern (string) - オプション。FilesByProperty および FoldersByProperty の場合、結果をフィルタリングするファイルパターンを指定します。

  • LargeFileMinimum (number) - オプション。LargeFiles レポートの場合、最小ファイルサイズをバイト単位で指定します。

  • LargeFilePattern (string) - オプション。LargeFiles レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • LeastAccessedMinimum (number) - オプション。LeastRecentlyAccessed レポートの場合、前回のアクセスからの最小日数を指定します。

  • LeastAccessedFilePattern (string) - オプション。LeastRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • MostAccessedMaximum (number) - オプション。MostRecentlyAccessed レポートの場合、前回のアクセスからの最大日数を指定します。

  • MostAccessedFilePattern (string) - オプション。MostRecentlyAccessed レポートの場合、 は結果をフィルタリングするファイルパターンを指定します。

  • QuotaMinimumUsage (number) - オプション。QuotaUsage レポートの場合、含める最小クォータ使用率を指定します。

例:

1. 毎月のラージファイルレポートを作成します。

$schedule = @{
    Time = ("3:00 AM")
    Monthly = @(1) # Run on first day
}

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
    param($schedule)
    New-FSxFSRMStorageReport -Name "Monthly Large Files" -Namespace "share\data" -ReportType "LargeFiles" -LargeFileMinimum 100MB -ReportFormat "HTML" -ScheduleConfigurations $schedule 
}

2. 複数の名前空間と形式で毎週重複ファイルレポートを作成します。

$schedule = @{
    Time = ("12:00 AM")
    Weekly = @('Sunday')
    RunDuration = 4
}

$namespaces = @("share\docs", "[FolderUsage_MS=User Files]") 
$reportFormats = @("HTML", "CSV")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $namespaces, $reportFormats) -ScriptBlock {
    param($schedule, $namespaces, $reportFormats)
    New-FSxFSRMStorageReport -Name "Weekly Duplicates" -Namespace $namespaces -ReportType "DuplicateFiles" -ReportFormat $reportFormats -ScheduleConfigurations $schedule 
}

3. すぐに実行されるインタラクティブレポートを作成します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    New-FSxFSRMStorageReport -Name "Find large files" -Namespace "share" -Interactive $true -ReportType "QuotaUsage" 
}

Get-FSxFSRMStorageReport

Get-FSxFSRMStorageReport: ファイルシステムから 1 つ以上のストレージレポートを取得します。レポートの設定とステータスに関する詳細を返します。

パラメータ :

  • Name (array) - オプション。取得するレポート名の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのストレージレポートを返します。

例:

1. ファイルシステム上のすべてのストレージレポートを取得します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Get-FSxFSRMStorageReport
}

Remove-FSxFSRMStorageReport

Remove-FSxFSRMStorageReport: ファイルシステムから 1 つ以上のストレージレポートを削除します。現在実行中のレポートは削除できません。

パラメータ :

  • Name (array) - 必須。削除するレポート名の配列。

  • PassThru (boolean) - オプション。true に設定すると、削除されたレポートオブジェクトが返されます。

例:

1. 1 つのストレージレポートを削除します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMStorageReport -Name "Monthly Report" -PassThru 
}

Set-FSxFSRMStorageReport

パラメータ

  • Name (array) - 必須。変更するレポート名の配列。

  • Namespace (array) - オプション。分析するパスまたはフォルダタイプの配列。パスは複数の形式で指定できます。

  • ReportType (array) - オプション。生成するレポートタイプの配列。次の値を指定できます。

    • DuplicateFiles: ファイルサイズとコンテンツに基づいて重複ファイルを識別します

    • FilesByFileGroup: ファイルグループメンバーシップでファイルをグループ化する

    • FilesByOwner: 所有者別にファイルをグループ化する

    • FilesByProperty: 分類プロパティでファイルをグループ化する

    • FileScreenAuditFiles: ファイルスクリーニング違反を一覧表示します

    • FoldersByProperty: 管理プロパティでフォルダをグループ化する

    • LargeFiles: 指定されたサイズしきい値を超えるファイルを一覧表示します

    • LeastRecentlyAccessed: 最近アクセスされていないファイルを一覧表示します

    • MostRecentlyAccessed: 最近アクセスされたファイルを一覧表示します

    • QuotaUsage: クォータ使用状況統計を表示します

  • ReportFormat (array) - オプション。出力形式の配列。次の値を指定できます。

    • DHTML: 動的 HTML 形式

    • HTML: 静的 HTML 形式

    • XML: XML 形式

    • CSV: カンマ区切り値形式

    • Text: プレーンテキスト形式

  • ScheduleConfigurations (hashtable) - レポートがインタラクティブでない限り必要です。次のプロパティを持つスケジュール設定を含むハッシュテーブル。

    • Time (datetime): タスクを実行するタイミングを指定する DateTime オブジェクト (必須)

    • RunDuration (number): タスクを実行する時間数 (オプション)

    • Weekly (array): 平日の配列 (オプション)

    • Monthly (array): 曜日の配列、最終日-1に使用します (オプション)

  • PassThru (boolean) - オプション。true に設定すると、変更されたレポートオブジェクトが返されます。

レポート固有のパラメータ

  • FileScreenAuditDaysSince (number) - オプション。FileScreenAuditFiles レポートの場合、監査イベントを含めるまでの日数を指定します。

  • FileScreenAuditUser (array) - オプション。FileScreenAuditFiles レポートの場合、レポートに含めるユーザーアカウントの配列を指定します。これらのユーザーによるファイルスクリーニング違反のみが含まれます。

  • FileGroupIncluded (array) - オプション。FilesByFileGroup レポートの場合、含めるファイルグループを指定します。

  • FileOwnerFilePattern (string) - オプション。FilesByOwner レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • PropertyName (string) - オプション。FilesByProperty レポートの場合、グループ化する分類プロパティを指定します。

  • FolderPropertyName (string) - オプション。FoldersByProperty レポートの場合、グループ化するフォルダプロパティを指定します。

  • PropertyFilePattern (string) - オプション。FilesByProperty および FoldersByProperty の場合、結果をフィルタリングするファイルパターンを指定します。

  • LargeFileMinimum (number) - オプション。LargeFiles レポートの場合、最小ファイルサイズをバイト単位で指定します。

  • LargeFilePattern (string) - オプション。LargeFiles レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • LeastAccessedMinimum (number) - オプション。LeastRecentlyAccessed レポートの場合、前回のアクセスからの最小日数を指定します。

  • LeastAccessedFilePattern (string) - オプション。LeastRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • MostAccessedMaximum (number) - オプション。MostRecentlyAccessed レポートの場合、前回のアクセスからの最大日数を指定します。

  • MostAccessedFilePattern (string) - オプション。MostRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。

  • QuotaMinimumUsage (number) - オプション。QuotaUsage レポートの場合、含める最小クォータ使用率を指定します。

例:

1. 既存のレポートのスケジュールと形式を更新します。

$schedule = @{
    Time = ("3:00 AM")
    Monthly = @(1)
}
$reportFormats = @("HTML", "CSV")

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $reportFormats) -ScriptBlock {
    param($schedule, $reportFormats)
    Set-FSxFSRMStorageReport -Name "Monthly Report" -ScheduleConfigurations $schedule -ReportFormat $reportFormats -PassThru 
}

レポート実行コマンド

Start-FSxFSRMStorageReport

パラメータ

  • Name (array) - 必須。開始するレポート名の配列。

  • Queue (boolean) - オプション。true に設定すると、 はレポートをキューに追加して、5 分以内に実行します。この期間中にキューに入れられたレポートは一緒に実行されます。false に設定するか、指定しない場合、レポートはすぐに開始されます。

  • RunDuration (number) - オプション。キャンセルされるまでにレポートを実行する時間を指定します。有効な値: -1 から 2147483。特殊な値:

    • 0: 完了まで実行

    • -1: キャンセルされるまで実行

    指定しない場合、 は完了まで実行されます。

例

1. ストレージレポートをすぐに起動します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Start-FSxFSRMStorageReport -Name "Monthly Report"
}

2. 期間制限のあるストレージレポートをキューに入れます。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Start-FSxFSRMStorageReport -Name "Quarterly Report" -Queue: $true -RunDuration 4 
}

Stop-FSxFSRMStorageReport

パラメータ

  • Name (array) - 必須。停止するレポート名の配列。

例:

1. 1 つのストレージレポートを停止します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Stop-FSxFSRMStorageReport -Name "Monthly Report"
}

Wait-FSxFSRMStorageReport

パラメータ

  • Name (array) - 必須。待機するレポート名の配列。

  • Timeout (number) - オプション。レポートが完了するまでの待機時間を秒単位で指定します。レポートが終了する前にタイムアウトが期限切れになると、コマンドは を返しますが、レポート生成はバックグラウンドで実行され続けます。有効な値: -1 から 2147483。特殊な値:

    • -1: レポートが完了するまで無期限に待機する (デフォルト)

    • 0: 現在のステータスを確認し、待たずにすぐに戻る

例:

1. ストレージレポートが完了するまで無期限に待ちます。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Wait-FSxFSRMStorageReport -Name "Monthly Report"
}