Azure Storage Analytics ログを有効にして管理する (クラシック)

[アーティクル]
03/25/2023

Azure Storage Analytics には、BLOB、キュー、テーブル用のログが用意されています。 Azure portal を使用して、アカウントに対してログが記録されるように構成できます。この記事では、ログを有効にして管理する方法を示します。メトリックを有効にする方法については、Azure Storage Analytics メトリックを有効にして管理する (クラシック) に関する記事を参照してください。 Azure portal で監視データを調査して格納するとコストがかかります。詳細については、「Storage Analytics」を参照してください。

Note

Microsoft では、Storage Analytics ログの代わりに、Azure Monitor の Azure Storage ログを使用することをお勧めしています。以下のいずれかの記事をご覧ください。

ログの有効化

BLOB、テーブル、およびキューごとに、読み取り要求、書き込み要求、および削除要求の診断ログを保存するよう Azure Storage に指示できます。設定したデータの保持ポリシーはこうしたログにも適用されます。

Note

現在、Azure Files では、Storage Analytics のメトリックはサポートされていますが、Storage Analytics のログ記録はサポートされていません。

Azure Portal で [ストレージアカウント] を選択し、ストレージアカウントの名前を選択して、ストレージアカウントブレードを開きます。
メニューブレードの [監視 (クラシック)] セクションで [診断設定 (クラシック)] を選択します。
[ステータス] を [オン] に設定して、ログを有効にするサービスを選択します。
ログを保持するには、必ず [データの削除] チェックボックスをオンにします。次に、チェックボックスの下にあるスライダーコントロールを動かすか、スライダーコントロールの横にあるテキストボックスに表示される値を直接変更して、ログデータを保持する日数を設定します。新しいストレージアカウントの既定値は 7 日間です。アイテム保持ポリシーを設定しない場合、[データの削除] チェックボックスをオフのままにします。保持ポリシーがない場合、ログデータを削除する責任はユーザーが負います。

警告

ログは、アカウントにデータとして格納されます。ログデータは時間の経過と共にアカウントに蓄積されるため、ストレージのコストが増加するおそれがあります。ログデータが必要なのが短期間のみである場合は、データ保持ポリシーを変更することでコストを削減できます。古いログデータ (保持ポリシーよりも古いデータ) はシステムによって削除されます。アカウントのログデータを保持する必要がある期間に基づいて、保持ポリシーを設定することをお勧めします。詳細については、「Billing on storage metrics」 (ストレージメトリックへの課金) を参照してください。
[保存] をクリックします。

診断ログは、ストレージアカウントの $logs という名前の BLOB コンテナーに保存されます。ログデータを表示するには、Microsoft Azure Storage Explorer などのストレージエクスプローラーを使用するか、プログラムによってストレージクライアントライブラリまたは PowerShell を使用します。

$Logs コンテナーへのアクセスについては、ストレージ分析ログに関するページを参照してください。

注意

クラシックストレージアカウントの場合、$logs コンテナーは Azure Storage Explorerにのみ表示されます。 $logs コンテナーは、ストレージブラウザーや、Azure portal で使用できるコンテナービューからは表示されません。

Windows PowerShell コマンドウィンドウを開きます。
Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。
```
Connect-AzAccount
```
自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを設定します。
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
<subscription-id> プレースホルダーの値をサブスクリプションの ID に置き換えます。
使用するストレージアカウントを定義するストレージアカウントコンテキストを取得します。
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- <resource-group-name> プレースホルダーの値を、リソースグループの名前に置き換えます。
- <storage-account-name> プレースホルダーの値は、実際のストレージアカウントの名前に置き換えます。
Set-AzStorageServiceLoggingProperty を使用して現在のログ設定を変更します。ストレージログを制御するコマンドレットでは、LoggingOperations パラメーターが使用されます。このパラメーターは文字列で、記録する要求の種類がコンマ区切り形式で含まれています。指定できる要求の種類には、read、write、および delete の 3 つがあります。ログをオフにするには、LoggingOperations パラメーターに none の値を指定します。

以下のコマンドでは、既定のストレージアカウント内の Queue サービスで read、write、および delete の各要求に対するログがオンにされます。リテンション期間は 5 日間に設定されています。
```
Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
```
警告

ログは、アカウントにデータとして格納されます。ログデータは時間の経過と共にアカウントに蓄積されるため、ストレージのコストが増加するおそれがあります。ログデータが必要なのが短期間のみである場合は、データ保持ポリシーを変更することでコストを削減できます。古いログデータ (保持ポリシーよりも古いデータ) はシステムによって削除されます。アカウントのログデータを保持する必要がある期間に基づいて、保持ポリシーを設定することをお勧めします。詳細については、「Billing on storage metrics」 (ストレージメトリックへの課金) を参照してください。

以下のコマンドでは、既定のストレージアカウント内の Table サービスに対するログがオフにされます。
```
Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
```
Azure サブスクリプションを処理するように Azure PowerShell コマンドレットを構成する方法と、使用する既定のストレージアカウントを選択する方法については、Azure PowerShell のインストールと構成の方法に関する記事をご覧ください。

QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

QueueServiceProperties serviceProperties = queueServiceClient.GetProperties().Value;

serviceProperties.Logging.Delete = true;

QueueRetentionPolicy retentionPolicy = new QueueRetentionPolicy();
retentionPolicy.Enabled = true;
retentionPolicy.Days = 2;
serviceProperties.Logging.RetentionPolicy = retentionPolicy;

serviceProperties.HourMetrics = null;
serviceProperties.MinuteMetrics = null;
serviceProperties.Cors = null;

queueServiceClient.SetProperties(serviceProperties);

ログデータ保持期間を変更する

ログデータは時間の経過と共にアカウントに蓄積されるため、ストレージのコストが増加するおそれがあります。ログデータが必要なのが短期間のみである場合は、ログデータ保持期間を変更することでコストを削減できます。たとえば、ログが 3 日間だけ必要な場合は、ログデータ保持期間を 3 の値に設定します。これにより、ログは 3 日後にアカウントから自動的に削除されます。このセクションでは、現在のログデータ保持期間を確認し、必要に応じてその期間を更新する方法について説明します。

Azure Portal で [ストレージアカウント] を選択し、ストレージアカウントの名前を選択して、ストレージアカウントブレードを開きます。
メニューブレードの [監視 (クラシック)] セクションで [診断設定 (クラシック)] を選択します。
[データの削除] チェックボックスがオンになっていることを確認します。次に、チェックボックスの下にあるスライダーコントロールを動かすか、スライダーコントロールの横にあるテキストボックスに表示される値を直接変更して、ログデータを保持する日数を設定します。

新しいストレージアカウントの既定の日数は 7 日間です。アイテム保持ポリシーを設定しない場合、[データの削除] チェックボックスをオフのままにします。保有ポリシーがない場合、監視データを削除する責任はユーザーが負います。
[保存] をクリックします。

診断ログは、ストレージアカウントの $logs という名前の BLOB コンテナーに保存されます。ログデータを表示するには、Microsoft Azure Storage Explorer などのストレージエクスプローラーを使用するか、プログラムによってストレージクライアントライブラリまたは PowerShell を使用します。

$Logs コンテナーへのアクセスについては、ストレージ分析ログに関するページを参照してください。

Windows PowerShell コマンドウィンドウを開きます。
Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。
```
Connect-AzAccount
```
自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを設定します。
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
<subscription-id> プレースホルダーの値をサブスクリプションの ID に置き換えます。
ストレージアカウントを定義するストレージアカウントコンテキストを取得します。
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- <resource-group-name> プレースホルダーの値を、リソースグループの名前に置き換えます。
- <storage-account-name> プレースホルダーの値は、実際のストレージアカウントの名前に置き換えます。
Get-AzStorageServiceLoggingProperty を使用して現在のログ保持ポリシーを表示します。次の例では、BLOB とキューのストレージサービスの保持期間をコンソールに出力します。
```
Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
```
コンソール出力では、保持期間は RetentionDays という列見出しの下に表示されます。
Set-AzStorageServiceLoggingProperty を使用して保持期間を変更します。次の例では、保持期間を 4 日に変更します。
```
Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
```
Azure サブスクリプションを処理するように Azure PowerShell コマンドレットを構成する方法と、使用する既定のストレージアカウントを選択する方法については、Azure PowerShell のインストールと構成の方法に関する記事をご覧ください。

次の例では、BLOB とキューのストレージサービスの保持期間をコンソールに出力します。

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

BlobServiceProperties blobServiceProperties = blobServiceClient.GetProperties().Value;
QueueServiceProperties queueServiceProperties = queueServiceClient.GetProperties().Value;

Console.WriteLine("Retention period for logs from the blob service is: " +
    blobServiceProperties.Logging.RetentionPolicy.Days.ToString());

Console.WriteLine("Retention period for logs from the queue service is: " +
    queueServiceProperties.Logging.RetentionPolicy.Days.ToString());

次の例では、保持期間を 4 日に変更します。

BlobRetentionPolicy blobRetentionPolicy = new BlobRetentionPolicy();

blobRetentionPolicy.Enabled = true;
blobRetentionPolicy.Days = 4;

QueueRetentionPolicy queueRetentionPolicy = new QueueRetentionPolicy();

queueRetentionPolicy.Enabled = true;
queueRetentionPolicy.Days = 4;

blobServiceProperties.Logging.RetentionPolicy = blobRetentionPolicy;
blobServiceProperties.Cors = null;

queueServiceProperties.Logging.RetentionPolicy = queueRetentionPolicy;
queueServiceProperties.Cors = null;

blobServiceClient.SetProperties(blobServiceProperties);
queueServiceClient.SetProperties(queueServiceProperties);

Console.WriteLine("Retention policy for blobs and queues is updated");

ログデータが削除されていることを確認する

ストレージアカウントの $logs コンテナーの内容を表示することで、ログが削除されていることを確認できます。次の図は、$logs コンテナー内のフォルダーの内容を示しています。このフォルダーは 2021 年 1 月に対応し、各フォルダーには 1 日分のログが含まれています。今日が 2021 年 1 月 29 日であり、保持ポリシーが 1 日だけに設定されている場合、このフォルダーには 1 日だけのログが含まれています。

Azure Portal のログフォルダーの一覧

ログデータを表示する

ログデータを表示して分析するには、対象のログデータを含む BLOB をローカルマシンにダウンロードする必要があります。多くのストレージ閲覧ツールを使用して、ストレージアカウントから BLOB をダウンロードできます。また、Azure Storage チームが提供するコマンドライン用の Azure Copy Tool (AzCopy) を使用して、ログデータをダウンロードすることもできます。

Note

$logs コンテナーは Event Grid と統合されていないため、ログファイルが書き込まれたときにユーザーは通知を受信しません。

対象のログデータをダウンロードし、同じログデータを複数回ダウンロードしないためには、以下のようにします。

同じデータを複数回ダウンロードしないようにするには、ログデータを含む BLOB に対して日付と時刻の名前付け規則を使用し、既にダウンロードしている分析対象の BLOB を追跡します。
ダウンロードする必要がある BLOB を正確に識別するには、ログデータを含む BLOB のメタデータを使用して、BLOB がログデータを保持する期間を確認します。

AzCopy の使用を開始するには、「AzCopy を使ってみる」を参照してください。

次の例は、2014 年 5 月 20 日の午前 09 時、午前 10 時、および午前 11 時から Queue サービスのログデータをダウンロードする方法を示しています。

azcopy copy 'https://mystorageaccount.blob.core.windows.net/$logs/queue' 'C:\Logs\Storage' --include-path '2014/05/20/09;2014/05/20/10;2014/05/20/11' --recursive

特定のファイルをダウンロードする方法の詳細については、「AzCopy v10 を使用して Azure BLOB ストレージから BLOB をダウンロードする」を参照してください。

ログデータのダウンロードが完了すると、ファイル内のログエントリを表示できます。これらのログファイルでは、多くのログ読み取りツールで解析できる区切り記号付きテキスト形式が使用されています (詳細については、「Microsoft Azure Storage の監視、診断、およびトラブルシューティング」を参照してください)。ログファイルの内容を書式設定、フィルタリング、並べ替え、AD 検索するために、各種のツールがさまざまな機能を提供しています。ストレージログのログファイルの形式および内容の詳細については、「Storage Analytics Log Format (Storage Analytics のログ形式)」および「Storage Analytics Logged Operations and Status Message (Storage Analytics によって記録される操作および状態メッセージ)」を参照してください。

次のステップ

Storage Analytics の詳細については、Storage Analytics の「Storage Analytics」を参照してください。
.NET 言語を使用してストレージログを構成する方法の詳細については、「Storage Client Library Reference (ストレージクライアントライブラリリファレンス)」を参照してください。
REST API を使用してストレージログを構成する方法の概要については、「Enabling and Configuring Storage Analytics (Storage Analytics の有効化および構成)」を参照してください。
Storage Analytics ログの形式の詳細について学習します。「Storage Analytics のログの形式」を参照してください。

Azure Storage Analytics ログを有効にして管理する (クラシック)

ログの有効化

ログ データ保持期間を変更する

ログ データが削除されていることを確認する

ログ データを表示する

次のステップ

その他のリソース

ログデータ保持期間を変更する

ログデータが削除されていることを確認する

ログデータを表示する