Azure Storage Mover のコピーとジョブログを有効にする方法

2023-11-15

移行ツールを使用して、オンプレミスのソースから Azure ターゲットに重要なデータを移動する場合は、問題となる可能性のある操作を監視できるようにする必要があります。移行中に実行された操作に関連するデータは、ログエントリまたはメトリックとして保存できます。構成時に Azure Storage Mover は、コピーログとジョブ実行ログを提供できます。これらのログは、ジョブ実行と個々のファイルの移行結果をトレースできるため、特に便利です。

コピーログとジョブ実行ログはどちらも Azure Analytics ワークスペースに送信できます。 Analytics ワークスペースは、Azure サービスが生成したログデータを格納するストレージユニットです。 Log Analytics は、Storage Mover のポータルエクスペリエンスに統合されています。この統合により、コピージョブの管理に使用するものと同じ画面内で、コピージョブに関連するログを確認できます。さらに重要な機能として、この統合により、複数のログからログクエリを作成して実行し、その結果を対話形式で分析することもできます。

重要

Azure Analytics ワークスペースを作成しており、それを使用するように Storage Mover インスタンスを構成していることを、移行のログデータにアクセスする前に確認する必要があります。この構成の前に生成されたログはすべて失われます。限られた情報をエージェントから直接取得できる場合があります。

この記事では、分析ワークスペースの作成に関連する、ストレージムーバーリソース内の診断設定の構成手順を説明します。

Azure Log Analytics と Storage Mover の構成

このセクションでは、Azure Monitor Log Analytics ワークスペースと Storage Mover 診断設定を構成する方法を簡単に説明します。次の手順を完了すると、Storage Mover リソースで提供されるデータに対してクエリを実行できるようになります。

Log Analytics ワークスペースを作成する

Storage Mover は、コピーログとジョブログを収集し、Azure Log Analytics ワークスペースに情報を格納します。ワークスペースを作成したら、そこにデータを保存するように Storage Mover を構成できます。既存のワークスペースがない場合は、Azure portal にワークスペースを作成できます。

検索ボックスに「Log Analytics」と入力し、[Log Analytics ワークスペース] を選択します。コンテンツウィンドウで、[作成] または [ログ分析ワークスペースの作成] を選択してワークスペースを作成します。 [サブスクリプション]、[リソースグループ]、[名前]、および [リージョン] フィールドの値を指定し、[確認と作成] を選択します。

Log Analytics とその機能の詳細については、Log Analytics の概要に関する記事を参照してください。チュートリアルを表示する場合は、「Log Analytics チュートリアル」にアクセスしてください。

Storage Mover の診断設定を構成する

分析ワークスペースが作成されたら、それを、Storage Mover のログとメトリックを表示できる宛先として指定できます。

分析ワークスペースにログを送信するように Storage Mover を構成する際には、2 つのオプションがあります。まず、最上位レベルの Storage Mover リソースの初期デプロイ時に診断設定を構成できます。次の例は、Storage Mover リソースの作成時に Azure portal で診断設定を指定する方法を示しています。

また、デプロイ後に、Storage Mover リソースに診断設定を追加することもできます。診断設定を追加するには、Storage Mover リソースに移動します。メニューウィンドウで [診断設定] を選択し、次の例に示すように [診断設定の追加] を選択します。

[診断設定] ウィンドウで [診断設定の名前] の値を入力します。 [ログ] グループ内で、収集する 1 つ以上のログカテゴリを選択します。また、[メトリック] グループ内の [ジョブ実行] オプションを選択して、個々のジョブ実行の結果を表示することもできます。 [宛先の詳細] グループ内で、[Log Analytics ワークスペースに送信]、サブスクリプションの名前、ログデータを収集する Log Analytics ワークスペースの名前を選択します。最後に [保存] を選択して、新しい診断設定を作成します。参考として提供された画像を表示できます。

Storage Mover 診断設定が保存されると、[診断設定] 画面の [診断設定] テーブルに反映されます。

ログの分析

Azure Monitor 内のすべてのリソースログには、同じフィールドがあり、その後にサービス固有のフィールドがあります。共通のスキーマの概要については、Azure Monitor リソースログのスキーマに関する記事をご覧ください。

Storage Mover では、StorageMoverCopyLogsFailed と StorageMoverJobRunLogs という 2 つのテーブルが生成されます。 StorageMoverCopyLogsFailed のスキーマは Azure Storage Copy ログデータ参照に、StorageMoverJobRunLogs のスキーマは Azure Storage ジョブ実行ログデータ参照にあります。

ログデータは、Storage Mover の Azure portal ユーザーインターフェイス (UI) エクスペリエンスに統合されます。ログデータにアクセスするには、最上位のストレージムーバーリソースに移行し、ナビゲーションウィンドウの [監視] グループ内の [ログ] を選択します。次の例のようにメインコンテンツウィンドウに表示された、最初の [Log Analytics へようこそ] ウィンドウを閉じます。

メインコンテンツウィンドウ内の [ようこそ] ウィンドウを閉じると、[新しいクエリ] ウィンドウが表示されます。スキーマとフィルターのペインで、[テーブル] オブジェクトが選択されていることと、StorageMoverCopyLogsFailed および StorageMoverJobRunLogs テーブルが表示されていることを確認します。 Kusto 照会言語 (KQL) クエリを使用して、スキーマとフィルターのペインに表示されるテーブルから、ログデータの抽出を開始できます。次のスクリーンショットに示すように、クエリ編集フィールドにクエリを入力し、[実行] を選択します。また、単純なクエリの例も提供されています。これを使用して、過去 60 日間のコピー操作失敗の詳細を取得することができます。

    StorageMoverCopyLogsFailed 
    | top 1000 by timeGenerated desc

サンプル Kusto クエリ

Log Analytics にログを送信すると、Azure Monitor ログクエリを使用して、それらのログにアクセスすることができます。詳細については、「Log Analytics のチュートリアル」を参照してください。

次に示すサンプルクエリを [ログ検索] バーに入力すると、移行の監視に役立ちます。これらのクエリは新しい言語で使用できます。

過去 30 日以内の特定のジョブ実行でコピーできなかったすべてのファイルの一覧を表示する場合。
```
    StorageMoverCopyLogsFailed 
    | where TimeGenerated > ago(30d) and JobRunName == "[job run ID]"
```

過去 7 日間の最も一般的な 10 件のコピーログエラーコードの一覧を表示する場合。

StorageMoverCopyLogsFailed
| where TimeGenerated > ago(7d)
| summarize count() by StatusCode
| top 10 by count_ desc

過去 7 日間の最新の 10 件のジョブ失敗エラーコードの一覧を表示する場合。

StorageMoverJobRunLogs
| where TimeGenerated > ago(3d) and StatusCode != "AZSM0000"
| summarize count() by StatusCode
| top 10 by count_ desc

ジョブ実行ごとにグループ化された、過去 30 日間のコピー操作の円グラフを作成する場合。

StorageMoverCopyLogsFailed
| where TimeGenerated > ago(30d)
| summarize count() by JobRunName
| sort by count_ desc
| render piechart

次のステップ

次のいずれかのガイドを参照します。

次の方法で共有

Azure Storage Mover のコピーとジョブ ログを有効にする方法