Habilitar e gerenciar logs da Análise de Armazenamento do Azure (clássico)

1. No portal do Azure, selecione Contas de armazenamento e o nome da conta de armazenamento para abrir a folha de conta de armazenamento.

2. Selecione Configurações de diagnóstico (clássico) na seção Monitoramento (clássico) da folha de menu.

   

3. Verifique se Status está definido como Ativadoe selecione os Serviços para os quais deseja habilitar os logs.

   

4. Para reter logs, verifique se a caixa de seleção Excluir dados está marcada. Em seguida, defina o número de dias que você gostaria que os dados de log fossem retidos movendo o controle deslizante sob a caixa de seleção ou modificando diretamente o valor que aparece na caixa de texto ao lado do controle deslizante. O padrão para novas contas de armazenamento é de sete dias. Se você não deseja definir uma política de retenção, deixe a caixa de seleção Excluir dados desmarcada. Se não houver nenhuma política de retenção, cabe a você excluir os dados do log.

   Aviso

   Os logs são armazenados como dados em sua conta. Os dados dos logs podem ser acumulados na conta ao longo do tempo, o que pode aumentar o custo do armazenamento. Se precisar dos dados dos logs por apenas um curto período, será possível reduzir os custos modificando a política de retenção de dados. Os dados dos logs obsoletos (dados anteriores à política de retenção) são excluídos pelo sistema. É recomendável configurar uma política de retenção com base no tempo durante o qual você deseja manter os dados dos logs para sua conta. Consulte Cobrança de métricas de armazenamento para obter mais informações.

5. Clique em Save (Salvar).

   Os logs de diagnóstico são salvos em um contêiner de blob denominado $logs em sua conta de armazenamento. Você pode exibir os dados de log usando um gerenciador de armazenamento como o Gerenciador de Armazenamento do Microsoft Azure ou de forma programática, usando a biblioteca de clientes de armazenamento ou o PowerShell.

   Para obter informações sobre como acessar o contêiner $logs, consulte Log de análise de armazenamento.

   Observação

   Para contas de armazenamento clássicas, o contêiner $logs aparece apenas no Gerenciador de Armazenamento do Microsoft Azure. O contêiner $logs não está visível no navegador de armazenamento ou na exibição de contêiner disponível no portal do Azure.

1. Abra uma janela de comando do Windows PowerShell.

2. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

3. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa.

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

   Substitua o valor de espaço reservado <subscription-id> pela ID da sua assinatura.

4. Obtenha o contexto da conta de armazenamento que define a conta de armazenamento que você deseja usar.

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

   • Substitua o valor do espaço reservado <resource-group-name> pelo nome do grupo de recursos.

   • Substitua o valor de espaço reservado <storage-account-name> pelo nome da sua conta de armazenamento.

5. Use Set-AzStorageServiceLoggingProperty para alterar as configurações de log atuais. Os cmdlets que controlam o Registro em Log do Armazenamento usam um parâmetro LoggingOperations que é uma cadeia de caracteres contendo uma lista de tipos de solicitação separados por vírgulas para o log. Os três tipos possíveis de solicitação são leitura, gravação e exclusão. Para desativar o registro em log, use o valor none no parâmetro LoggingOperations.

   O seguinte comando ativa o registro em log para solicitações de leitura, gravação e exclusão no serviço de Fila em sua conta de armazenamento padrão com a retenção definida como cinco dias:

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

   Aviso

   Os logs são armazenados como dados em sua conta. Os dados dos logs podem ser acumulados na conta ao longo do tempo, o que pode aumentar o custo do armazenamento. Se precisar dos dados dos logs por apenas um curto período, será possível reduzir os custos modificando a política de retenção de dados. Os dados dos logs obsoletos (dados anteriores à política de retenção) são excluídos pelo sistema. É recomendável configurar uma política de retenção com base no tempo durante o qual você deseja manter os dados dos logs para sua conta. Consulte Cobrança de métricas de armazenamento para obter mais informações.

   O seguinte comando desativa o registro em log para o serviço de tabela em sua conta de armazenamento padrão:

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

   Para saber mais sobre como configurar os cmdlets do Azure PowerShell para funcionar com sua assinatura do Azure e como escolher a conta de armazenamento padrão para usar, confira: Como instalar e configurar o 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);

1. No portal do Azure, selecione Contas de armazenamento e o nome da conta de armazenamento para abrir a folha de conta de armazenamento.

2. Selecione Configurações de diagnóstico (clássico) na seção Monitoramento (clássico) da folha de menu.

   

3. Verifique se a caixa de seleção Excluir dados está marcada. Em seguida, defina o número de dias que você gostaria que os dados de log fossem retidos movendo o controle deslizante sob a caixa de seleção ou modificando diretamente o valor que aparece na caixa de texto ao lado do controle deslizante.

   

   O padrão para novas contas de armazenamento é de sete dias. Se você não deseja definir uma política de retenção, deixe a caixa de seleção Excluir dados desmarcada. Se não houver nenhuma política de retenção, cabe a você excluir os dados de monitoramento.

4. Clique em Save (Salvar).

   Os logs de diagnóstico são salvos em um contêiner de blob denominado $logs em sua conta de armazenamento. Você pode exibir os dados de log usando um gerenciador de armazenamento como o Gerenciador de Armazenamento do Microsoft Azure ou de forma programática, usando a biblioteca de clientes de armazenamento ou o PowerShell.

   Para obter informações sobre como acessar o contêiner $logs, consulte Log de análise de armazenamento.

1. Abra uma janela de comando do Windows PowerShell.

2. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

3. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa.

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

   Substitua o valor de espaço reservado <subscription-id> pela ID da sua assinatura.

4. Obtenha o contexto da conta de armazenamento que define a conta de armazenamento.

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

   • Substitua o valor do espaço reservado <resource-group-name> pelo nome do grupo de recursos.

   • Substitua o valor de espaço reservado <storage-account-name> pelo nome da sua conta de armazenamento.

5. Use Get-AzStorageServiceLoggingProperty para exibir a política de retenção de log atual. O exemplo a seguir imprime no console o período de retenção para serviços de armazenamento de BLOB e fila.

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

   Na saída do console, o período de retenção é exibido abaixo do título da coluna RetentionDays.

   

6. Use Set-AzStorageServiceLoggingProperty para alterar o período de retenção. O exemplo a seguir altera o período de retenção para 4 dias.

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

   Para saber mais sobre como configurar os cmdlets do Azure PowerShell para funcionar com sua assinatura do Azure e como escolher a conta de armazenamento padrão para usar, confira: Como instalar e configurar o Azure PowerShell.

O exemplo a seguir imprime no console o período de retenção para serviços de armazenamento de BLOB e fila.

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

O exemplo a seguir altera o período de retenção para 4 dias.

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