Ativar e gerir registos Azure Storage Analytics (clássico)Enable and manage Azure Storage Analytics logs (classic)

A Azure Storage Analytics fornece registos para bolhas, filas e mesas.Azure Storage Analytics provides logs for blobs, queues, and tables. Pode utilizar o portal Azure para configurar registos para a sua conta.You can use the Azure portal to configure logs are recorded for your account. Este artigo mostra-lhe como ativar e gerir registos.This article shows you how to enable and manage logs. Para aprender a ativar métricas, consulte Ativar e gerir as métricas Azure Storage Analytics (clássica).To learn how to enable metrics, see Enable and manage Azure Storage Analytics metrics (classic). Existem custos associados à análise e armazenamento de dados de monitorização no portal Azure.There are costs associated with examining and storing monitoring data in the Azure portal. Para obter mais informações, veja Análise de Armazenamento.For more information, see Storage Analytics.

Nota

Recomendamos que utilize registos de armazenamento Azure no Monitor Azure em vez de registos de Storage Analytics.We recommend that you use Azure Storage logs in Azure Monitor instead of Storage Analytics logs. Os registos de armazenamento Azure no Azure Monitor estão em pré-visualização pública e estão disponíveis para testes de pré-visualização em todas as regiões de nuvem pública.Azure Storage logs in Azure Monitor is in public preview and is available for preview testing in all public cloud regions. Esta pré-visualização permite registos para bolhas (que inclui Azure Data Lake Storage Gen2), ficheiros, filas e tabelas.This preview enables logs for blobs (which includes Azure Data Lake Storage Gen2), files, queues,and tables. Para saber mais, consulte qualquer um dos seguintes artigos:To learn more, see any of the following articles:

Para obter um guia aprofundado sobre a utilização de Storage Analytics e outras ferramentas para identificar, diagnosticar e resolver problemas relacionados com o Armazenamento Azure, consulte Monitor, diagnóstico e resolução de problemas do Microsoft Azure Storage.For an in-depth guide on using Storage Analytics and other tools to identify, diagnose, and troubleshoot Azure Storage-related issues, see Monitor, diagnose, and troubleshoot Microsoft Azure Storage.

Ativar registosEnable logs

Pode instruir o Azure Storage para guardar registos de diagnósticos para ler, escrever e apagar pedidos para os serviços de bolha, mesa e fila.You can instruct Azure Storage to save diagnostics logs for read, write, and delete requests for the blob, table, and queue services. A política de retenção de dados que definiu também se aplica a estes registos.The data retention policy you set also applies to these logs.

Nota

A Azure Files suporta atualmente métricas de Storage Analytics, mas não suporta o registo de Storage Analytics.Azure Files currently supports Storage Analytics metrics, but does not support Storage Analytics logging.

  1. No portal Azure, selecione Contas de Armazenamento, em seguida, o nome da conta de armazenamento para abrir a lâmina da conta de armazenamento.In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

  2. Selecione as definições de diagnóstico (clássica) na secção de Monitorização (clássica) da lâmina do menu.Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

    Artigo de menu de diagnóstico em MONITORIZAÇÃO no portal Azure.

  3. Certifique-se de que o Estado está definido para On, e selecione os serviços para os quais pretende ativar a sessão.Ensure Status is set to On, and select the services for which you'd like to enable logging.

    Configurar o registo no portal Azure.Configure logging in the Azure portal.

  4. Certifique-se de que a caixa de verificação de dados Delete está selecionada.Ensure that the Delete data check box is selected. Em seguida, desafine o número de dias que pretende que os dados de registo sejam retidos movendo o controlo do slider por baixo da caixa de verificação, ou modificando diretamente o valor que aparece na caixa de texto ao lado do controlo do deslizador.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. O incumprimento das novas contas de armazenamento é de sete dias.The default for new storage accounts is seven days. Se não quiser definir uma política de retenção, insira zero.If you do not want to set a retention policy, enter zero. Se não houver uma política de retenção, cabe-lhe a si eliminar os dados de registo.If there is no retention policy, it is up to you to delete the log data.

    Aviso

    Os registos são armazenados como dados na sua conta.Logs are stored as data in your account. os dados de registo podem acumular-se na sua conta ao longo do tempo, o que pode aumentar o custo de armazenamento.log data can accumulate in your account over time which can increase the cost of storage. Se necessitar de registar dados por apenas um pequeno período de tempo, pode reduzir os seus custos modificando a política de retenção de dados.If you need log data for only a small period of time, you can reduce your costs by modifying the data retention policy. Os dados de registo stale (dados mais antigos do que a sua política de retenção) são eliminados pelo sistema.Stale log data (data older than your retention policy) is deleted by the system. Recomendamos a definição de uma política de retenção com base no tempo que pretende reter os dados de registo da sua conta.We recommend setting a retention policy based on how long you want to retain the log data for your account. Consulte a Faturação nas métricas de armazenamento para obter mais informações.See Billing on storage metrics for more information.

  5. Clique em Guardar.Click Save.

    Os registos de diagnóstico são guardados num recipiente de bolhas denominado $logs na sua conta de armazenamento.The diagnostics logs are saved in a blob container named $logs in your storage account. Pode visualizar os dados de registo utilizando um explorador de armazenamento como o Microsoft Azure Storage Explorer,ou utilizar programáticamente a biblioteca do cliente de armazenamento ou o 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.

    Para obter informações sobre o acesso ao recipiente $logs, consulte o registo de análises de armazenamento.For information about accessing the $logs container, see Storage analytics logging.

Modificar o período de retenção de dados de registoModify log data retention period

Os dados de registo podem acumular-se na sua conta ao longo do tempo, o que pode aumentar o custo de armazenamento.Log data can accumulate in your account over time which can increase the cost of storage. Se necessitar de dados de registo por apenas um pequeno período de tempo, pode reduzir os seus custos modificando o período de retenção de dados de registo.If you need log data for only a small period of time, you can reduce your costs by modifying the log data retention period. Por exemplo, se necessitar de registos por apenas três dias, desa um prazo de retenção de dados de registo para um valor de 3 .For example, if you need logs for only three days, set your log data retention period to a value of 3. Desta forma, os registos serão automaticamente eliminados da sua conta após 3 dias.That way logs will be automatically deleted from your account after 3 days. Esta secção mostra-lhe como visualizar o período atual de retenção de dados de registo e, em seguida, atualizar esse período se é isso que pretende fazer.This section shows you how to view your current log data retention period, and then update that period if that's what you want to do.

Nota

Estes passos aplicam-se apenas a contas que não têm a definição hierárquica do espaço de identificação ativada.These steps apply only for accounts that do not have the Hierarchical namespace setting enabled on them. Se ativou essa definição na sua conta, então a definição para dias de retenção ainda não está suportada.If you've enabled that setting on your account, then the setting for retention days is not yet supported. Em vez disso, terá de eliminar os registos manualmente utilizando qualquer ferramenta suportada, como o Azure Storage Explorer, REST ou um SDK.Instead, you'll have to delete logs manually by using any supported tool such as Azure Storage Explorer, REST or an SDK. Para encontrar esses registos na sua conta de armazenamento, consulte como os registos são armazenados.To find those logs in your storage account, see How logs are stored.

  1. No portal Azure, selecione Contas de Armazenamento, em seguida, o nome da conta de armazenamento para abrir a lâmina da conta de armazenamento.In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

  2. Selecione as definições de diagnóstico (clássica) na secção de Monitorização (clássica) da lâmina do menu.Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

    Artigo do menu de diagnósticos no âmbito do MONITORING no portal Azure

  3. Certifique-se de que a caixa de verificação de dados Delete está selecionada.Ensure that the Delete data check box is selected. Em seguida, desafine o número de dias que pretende que os dados de registo sejam retidos movendo o controlo do slider por baixo da caixa de verificação, ou modificando diretamente o valor que aparece na caixa de texto ao lado do controlo do deslizador.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.

    Modifique o período de retenção no portal AzureModify the retention period in the Azure portal

    O número predefinido de dias para novas contas de armazenamento é de sete dias.The default number of days for new storage accounts is seven days. Se não quiser definir uma política de retenção, insira zero.If you do not want to set a retention policy, enter zero. Se não houver uma política de retenção, cabe-lhe a si eliminar os dados de monitorização.If there is no retention policy, it is up to you to delete the monitoring data.

  4. Clique em Guardar.Click Save.

    Os registos de diagnóstico são guardados num recipiente de bolhas denominado $logs na sua conta de armazenamento.The diagnostics logs are saved in a blob container named $logs in your storage account. Pode visualizar os dados de registo utilizando um explorador de armazenamento como o Microsoft Azure Storage Explorer,ou utilizar programáticamente a biblioteca do cliente de armazenamento ou o 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.

    Para obter informações sobre o acesso ao recipiente $logs, consulte o registo de análises de armazenamento.For information about accessing the $logs container, see Storage analytics logging.

Verifique se os dados de registo estão a ser eliminadosVerify that log data is being deleted

Pode verificar se os registos estão a ser apagados visualizando o conteúdo do $logs recipiente da sua conta de armazenamento.You can verify that logs are being deleted by viewing the contents of the $logs container of your storage account. A imagem a seguir mostra o conteúdo de uma pasta no $logs recipiente.The following image shows the contents of a folder in the $logs container. A pasta corresponde a janeiro de 2021 e cada pasta contém registos para um dia.The folder corresponds to January 2021 and each folder contains logs for one day. Se o dia de hoje era 29 de janeiro de 2021, e a sua política de retenção está definida para apenas um dia, então esta pasta deve conter registos por apenas um dia.If the day today was January 29th 2021, and your retention policy is set to only one day, then this folder should contain logs for only one day.

Lista de pastas de registo no Portal AzureList of log folders in the Azure Portal

Ver dados de registoView log data

Para visualizar e analisar os seus dados de registo, deverá descarregar as bolhas que contêm os dados de registo que lhe interessam para uma máquina local.To view and analyze your log data, you should download the blobs that contain the log data you are interested in to a local machine. Muitas ferramentas de navegação de armazenamento permitem-lhe descarregar bolhas da sua conta de armazenamento; também pode utilizar a equipa de Armazenamento Azure, fornecida pela linha de comando Azure Copy Tool AzCopy para descarregar os seus dados de registo.Many storage-browsing tools enable you to download blobs from your storage account; you can also use the Azure Storage team provided command-line Azure Copy Tool AzCopy to download your log data.

Nota

O $logs contentor não está integrado com a Grade de Eventos, pelo que não receberá notificações quando os ficheiros de registo estiverem escritos.The $logs container isn't integrated with Event Grid, so you won't receive notifications when log files are written.

Para se certificar de que descarrega os dados de registo em que está interessado e para evitar descarregar os mesmos dados de registo mais de uma vez:To make sure you download the log data you are interested in and to avoid downloading the same log data more than once:

  • Utilize a convenção de nomeação de data e hora para as bolhas que contenham dados de registo para rastrear quais as bolhas que já descarregou para análise para evitar o refiamento dos mesmos dados mais de uma vez.Use the date and time naming convention for blobs containing log data to track which blobs you have already downloaded for analysis to avoid re-downloading the same data more than once.

  • Utilize os metadados nas bolhas que contêm dados de registo para identificar o período específico para o qual a bolha detém dados de registo para identificar a bolha exata que precisa de descarregar.Use the metadata on the blobs containing log data to identify the specific period for which the blob holds log data to identify the exact blob you need to download.

Para começar com a AzCopy, consulte Começar com a AzCopyTo get started with AzCopy, see Get started with AzCopy

O exemplo a seguir mostra como pode descarregar os dados de registo do serviço de fila para as horas a partir das 09:00, 10:00 e 11:00 no dia 20 de maio de 2014.The following example shows how you can download the log data for the queue service for the hours starting at 09 AM, 10 AM, and 11 AM on 20th May, 2014.

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

Para saber mais sobre como descarregar ficheiros específicos, consulte descarregar blobs do armazenamento Azure Blob utilizando a AzCopy v10.To learn more about how to download specific files, see Download blobs from Azure Blob storage by using AzCopy v10.

Quando tiver descarregado os seus dados de registo, pode visualizar as entradas de registo nos ficheiros.When you have downloaded your log data, you can view the log entries in the files. Estes ficheiros de registo utilizam um formato de texto delimitado que muitas ferramentas de leitura de registos são capazes de analisar (para mais informações, consulte o guia Monitor, Diagnóstico e Resolução de Problemas do Microsoft Azure Storage).These log files use a delimited text format that many log reading tools are able to parse (for more information, see the guide Monitoring, Diagnosing, and Troubleshooting Microsoft Azure Storage). Diferentes ferramentas têm diferentes instalações para formatação, filtragem, triagem, anúncio de pesquisa do conteúdo dos seus ficheiros de registo.Different tools have different facilities for formatting, filtering, sorting, ad searching the contents of your log files. Para obter mais informações sobre o formato e conteúdo do ficheiro de registo de armazenamento, consulte o formato de registo de armazenamento Analytics e o armazenamento de analítica operações registadas e mensagens de estado.For more information about the Storage Logging log file format and content, see Storage Analytics Log Format and Storage Analytics Logged Operations and Status Messages.

Passos seguintesNext steps