Storage Analytics の有効化と構成

[アーティクル]
08/05/2023

新しいストレージアカウントでは、Storage Analytics Metrics が既定で有効になっています。 Azure portalでログ記録を有効にし、メトリックとログ記録の両方を構成できます。詳細については、「Azure portalでストレージアカウントを監視する」を参照してください。また、プログラムから REST API またはクライアントライブラリを使用して有効にすることもできます。個々のサービスの Set Service Properties 操作を使用して、Storage Analyticsを有効にします。

注意

Storage Analytics メトリックは、BLOB、キュー、テーブル、ファイルのサービスごとに利用できます。

Storage Analytics Logging は、BLOB、Queue、Table の各サービスで使用できます。ただし、Premium ストレージアカウントは、サポートされません。

次の例では、myaccount という名前の架空のアカウントの Table サービスのStorage Analyticsを有効にします。

重要

新しいストレージアカウントでは時間単位のメトリックが既定で有効になっていますが、分単位のメトリックはプログラムで有効にする必要があります。 PowerShell と Azure CLI 2.0 を使用して、分単位のメトリックを有効にすることもできます。

次の例のように、要求の URI とヘッダーを構成します。 HTTP メソッドは PUT であり、要求に署名するために承認スキームを適用する必要があります。要求への署名の詳細については、「 Azure Storage への要求を承認する」を参照してください。
```
PUT https://myaccount.table.core.windows.net/?restype=service&comp=properties HTTP/1.1  
x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.table.core.windows.net  
```

要求には、XML で構成される要求本文も必要です。ストレージサービスは、この XML を処理し、使用して Storage Analytics を構成します。次の例では、削除要求と書き込み要求のログ記録を有効にし、ログ保持ポリシーを 7 日に設定します。また、時間単位と分単位のメトリックを有効にし、API レベルの概要統計を除外し、メトリックデータ保持ポリシーを 7 日に設定します。

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>1.0</Version>  
              <Delete>true</Delete>  
        <Read>false</Read>  
        <Write>true</Write>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
...
</StorageServiceProperties>

この要求を送信すると、Storage Analytics が構成されたかどうかを示す応答が返されます。応答に HTTP ステータスコード 202 (Accepted) が含まれていた場合、目的の Storage Analytics 設定は更新されています。以下は、設定が更新されたことを示す応答の例です。
```
HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: Wed, 23 Oct 2013 04:28:20 GMT  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15  
```

初期構成でStorage Analyticsを有効にした後、Blob Service のプロパティの取得、テーブルサービスのプロパティの取得、またはキューサービスのプロパティの取得操作を呼び出すことで、常に現在の設定を取得できます。

Storage Analytics の更新

ストレージサービスStorage Analytics設定を変更するには、もう一度操作をSet Service Properties呼び出します。 Storage Analytics の有効/無効、サービスの保持ポリシーなど、必要な構成オプションを新しい XML 要求本文内で指定します。これらの操作を呼び出すと、その都度、該当するサービスの設定がすぐに変更されます。

Storage Analytics の有効化と構成

Storage Analytics の更新

関連項目

その他のリソース