启用和管理 Azure 存储分析日志（经典）Enable and manage Azure Storage Analytics logs (classic)

1. 在 Azure 门户中选择“存储帐户”，然后单击存储帐户的名称打开存储帐户边栏选项卡。In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

2. 在菜单边栏选项卡的“监视(经典)”部分中选择“诊断设置(经典)”。Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

   

3. 确保“状态”设置为“打开”，选择要为其启用日志记录的服务。Ensure Status is set to On, and select the services for which you'd like to enable logging.

   

4. 确保选中“删除数据”复选框。Ensure that the Delete data check box is selected. 然后，通过移动复选框下方的滑块控件或直接修改显示在滑块控件旁边的文本框中的值，来设置要将日志数据保留的天数。Then, set the number of days that you would like log data to be retained by moving the slider control beneath the check box, or by directly modifying the value that appears in the text box next to the slider control. 新存储帐户的默认保留期为 7 天。The default for new storage accounts is seven days. 如果不需要设置保留策略，请输入零。If you do not want to set a retention policy, enter zero. 如果没有保留策略，则由用户自行决定是否删除日志数据。If there is no retention policy, it is up to you to delete the log data.

   警告

   日志作为数据存储在你的帐户中。Logs are stored as data in your account. 日志数据会随着时间的推移在你的帐户中累积，这可能会增加存储成本。log data can accumulate in your account over time which can increase the cost of storage. 如果只需要一小段时间的日志数据，则可以通过修改数据保留策略来降低成本。If you need log data for only a small period of time, you can reduce your costs by modifying the data retention policy. 陈旧的日志数据（超出保留策略的数据）将被系统删除。Stale log data (data older than your retention policy) is deleted by the system. 建议根据要将帐户的日志数据保留多长时间来设置保留策略。We recommend setting a retention policy based on how long you want to retain the log data for your account. 有关详细信息，请参阅按存储指标计费。See Billing on storage metrics for more information.

5. 单击“ 保存”。Click Save.

   诊断日志保存在存储帐户下名为 $logs 的 Blob 容器中。The diagnostics logs are saved in a blob container named $logs in your storage account. 可以使用 Microsoft Azure 存储资源管理器等存储资源管理器来查看日志数据，也可以使用存储客户端库或 PowerShell 以编程方式这样做。You can view the log data using a storage explorer like the Microsoft Azure Storage Explorer, or programmatically using the storage client library or PowerShell.

   有关如何访问 $logs 容器的信息，请参阅存储分析日志记录。For information about accessing the $logs container, see Storage analytics logging.

1. 打开 Windows PowerShell 命令窗口。Open a Windows PowerShell command window.

2. 运行 Connect-AzAccount 命令以登录 Azure 订阅，并按照屏幕上的说明操作。Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

   Connect-AzAccount -Environment AzureChinaCloud
   

3. 如果你的标识关联到多个订阅，请设置你的活动订阅。If your identity is associated with more than one subscription, then set your active subscription.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   将 <subscription-id> 占位符值替换为你的订阅 ID。Replace the <subscription-id> placeholder value with the ID of your subscription.

4. 获取定义了要使用的存储帐户的存储帐户上下文。Get the storage account context that defines the storage account you want to use.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • 将 <resource-group-name> 占位符值替换为资源组的名称。Replace the <resource-group-name> placeholder value with the name of your resource group.

   • 将 <storage-account-name> 占位符值替换为存储帐户的名称。Replace the <storage-account-name> placeholder value with the name of your storage account.

5. 使用 Set-AzStorageServiceLoggingProperty 更改当前的日志设置。Use the Set-AzStorageServiceLoggingProperty to change the current log settings. 控制存储日志记录的 cmdlet 使用 LoggingOperations 参数，该参数是一个字符串，包含要记录的请求类型的逗号分隔列表。The cmdlets that control Storage Logging use a LoggingOperations parameter that is a string containing a comma-separated list of request types to log. 三种可能的请求类型是“读取”、“写入”和“删除” 。The three possible request types are read, write, and delete. 要关闭日志记录，请对 LoggingOperations 参数使用值“无” 。To switch off logging, use the value none for the LoggingOperations parameter.

   以下命令在保留期设为 5 天的情况下，在默认存储帐户中为队列服务中的读取、写入和删除请求打开日志记录：The following command switches on logging for read, write, and delete requests in the Queue service in your default storage account with retention set to five days:

   Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
   

   警告

   日志作为数据存储在你的帐户中。Logs are stored as data in your account. 日志数据会随着时间的推移在你的帐户中累积，这可能会增加存储成本。log data can accumulate in your account over time which can increase the cost of storage. 如果只需要一小段时间的日志数据，则可以通过修改数据保留策略来降低成本。If you need log data for only a small period of time, you can reduce your costs by modifying the data retention policy. 陈旧的日志数据（超出保留策略的数据）将被系统删除。Stale log data (data older than your retention policy) is deleted by the system. 建议根据要将帐户的日志数据保留多长时间来设置保留策略。We recommend setting a retention policy based on how long you want to retain the log data for your account. 有关详细信息，请参阅按存储指标计费。See Billing on storage metrics for more information.

   以下命令在默认存储帐户中为表服务关闭日志记录：The following command switches off logging for the table service in your default storage account:

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
   

   若要了解如何配置 Azure PowerShell cmdlet 来使用 Azure 订阅并了解如何选择要使用的默认存储帐户，请参阅：如何安装和配置 Azure PowerShell。For information about how to configure the Azure PowerShell cmdlets to work with your Azure subscription and how to select the default storage account to use, see: How to install and configure 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);

var storageAccount = CloudStorageAccount.Parse(connStr);  
var queueClient = storageAccount.CreateCloudQueueClient();  
var serviceProperties = queueClient.GetServiceProperties();  

serviceProperties.Logging.LoggingOperations = LoggingOperations.All;  
serviceProperties.Logging.RetentionDays = 2;  

queueClient.SetServiceProperties(serviceProperties);  

1. 在 Azure 门户中选择“存储帐户”，然后单击存储帐户的名称打开存储帐户边栏选项卡。In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

2. 在菜单边栏选项卡的“监视(经典)”部分中选择“诊断设置(经典)”。Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

   

3. 确保选中“删除数据”复选框。Ensure that the Delete data check box is selected. 然后，通过移动复选框下方的滑块控件或直接修改显示在滑块控件旁边的文本框中的值，来设置要将日志数据保留的天数。Then, set the number of days that you would like log data to be retained by moving the slider control beneath the check box, or by directly modifying the value that appears in the text box next to the slider control.

   

   新存储帐户的默认保留天数为 7 天。The default number of days for new storage accounts is seven days. 如果不需要设置保留策略，请输入零。If you do not want to set a retention policy, enter zero. 如果没有保留策略，则由用户自行决定是否删除监视数据。If there is no retention policy, it is up to you to delete the monitoring data.

4. 单击“ 保存”。Click Save.

   诊断日志保存在存储帐户下名为 $logs 的 Blob 容器中。The diagnostics logs are saved in a blob container named $logs in your storage account. 可以使用 Microsoft Azure 存储资源管理器等存储资源管理器来查看日志数据，也可以使用存储客户端库或 PowerShell 以编程方式这样做。You can view the log data using a storage explorer like the Microsoft Azure Storage Explorer, or programmatically using the storage client library or PowerShell.

   有关如何访问 $logs 容器的信息，请参阅存储分析日志记录。For information about accessing the $logs container, see Storage analytics logging.

1. 打开 Windows PowerShell 命令窗口。Open a Windows PowerShell command window.

2. 运行 Connect-AzAccount 命令以登录 Azure 订阅，并按照屏幕上的说明操作。Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

   Connect-AzAccount -Environment AzureChinaCloud
   

3. 如果你的标识关联到多个订阅，请设置你的活动订阅。If your identity is associated with more than one subscription, then set your active subscription.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   将 <subscription-id> 占位符值替换为你的订阅 ID。Replace the <subscription-id> placeholder value with the ID of your subscription.

4. 获取定义了存储帐户的存储帐户上下文。Get the storage account context that defines the storage account.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • 将 <resource-group-name> 占位符值替换为资源组的名称。Replace the <resource-group-name> placeholder value with the name of your resource group.

   • 将 <storage-account-name> 占位符值替换为存储帐户的名称。Replace the <storage-account-name> placeholder value with the name of your storage account.

5. 使用 Get-AzStorageServiceLoggingProperty 查看当前的日志保留策略。Use the Get-AzStorageServiceLoggingProperty to view the current log retention policy. 下面的示例将 blob 和队列存储服务的保留期输出到控制台。The following example prints to the console the retention period for blob and queue storage services.

   Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
   

   在控制台输出中，保留期显示在 RetentionDays 列标题的下方。In the console output, the retention period appears beneath the RetentionDays column heading.

   

6. 使用 Set-AzStorageServiceLoggingProperty 更改保留期。Use the Set-AzStorageServiceLoggingProperty to change the retention period. 以下示例将保留期更改为 4 天。The following example changes the retention period to 4 days.

   Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
   

   若要了解如何配置 Azure PowerShell cmdlet 来使用 Azure 订阅并了解如何选择要使用的默认存储帐户，请参阅：如何安装和配置 Azure PowerShell。For information about how to configure the Azure PowerShell cmdlets to work with your Azure subscription and how to select the default storage account to use, see: How to install and configure Azure PowerShell.

下面的示例将 blob 和队列存储服务的保留期输出到控制台。The following example prints to the console the retention period for blob and queue storage services.

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 天。The following example changes the retention period to 4 days.

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");

下面的示例将 blob 和队列存储服务的保留期输出到控制台。The following example prints to the console the retention period for blob and queue storage services.

var storageAccount = CloudStorageAccount.Parse(connectionString);

var blobClient = storageAccount.CreateCloudBlobClient();
var queueClient = storageAccount.CreateCloudQueueClient();

var blobserviceProperties = blobClient.GetServiceProperties();
var queueserviceProperties = queueClient.GetServiceProperties();

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

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

下面的示例将 blob 和队列存储服务的日志保留期更改为 4 天。The following example changes the retention period for logs for the blob and queue storage services to 4 days.

blobserviceProperties.Logging.RetentionDays = 4;
queueserviceProperties.Logging.RetentionDays = 4;

blobClient.SetServiceProperties(blobserviceProperties);
queueClient.SetServiceProperties(queueserviceProperties);