Activation et gestion des journaux Azure Storage Analytics (classique)Enable and manage Azure Storage Analytics logs (classic)

Azure Storage Analytics fournit des journaux pour les objets blob, les files d’attente et les tables.Azure Storage Analytics provides logs for blobs, queues, and tables. Vous pouvez utiliser le Portail Azure afin de configurer les journaux à enregistrer pour votre compte.You can use the Azure portal to configure logs are recorded for your account. Cet article explique comment activer et gérer les journaux.This article shows you how to enable and manage logs. Pour savoir comment activer les métriques, consultez Activation et gestion des métriques Azure Storage Analytics (classique).To learn how to enable metrics, see Enable and manage Azure Storage Analytics metrics (classic). L’examen et le stockage des données de supervision sur le Portail Azure occasionne des frais.There are costs associated with examining and storing monitoring data in the Azure portal. Pour plus d’informations, consultez Storage Analytics.For more information, see Storage Analytics.

Notes

Nous vous recommandons d’utiliser les journaux Stockage Azure disponibles dans Azure Monitor au lieu des journaux Storage Analytics.We recommend that you use Azure Storage logs in Azure Monitor instead of Storage Analytics logs. Les journaux de stockage Azure dans Azure Monitor sont en préversion publique et sont disponibles pour le test en préversion dans toutes les régions de cloud public.Azure Storage logs in Azure Monitor is in public preview and is available for preview testing in all public cloud regions. Cette préversion active les journaux des objets blob (qui incluent Azure Data Lake Storage Gen2), les fichiers, les files d’attente et les tables.This preview enables logs for blobs (which includes Azure Data Lake Storage Gen2), files, queues,and tables. Pour plus d’informations, consultez l’un des articles suivants :To learn more, see any of the following articles:

Pour obtenir un guide détaillé concernant l'utilisation de Storage Analytics et d'autres outils permettant d'analyser, de diagnostiquer et de résoudre les problèmes d'Azure Storage, consultez Analyse, diagnostic et résolution des problèmes rencontrés sur 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.

Activer les journaux d’activitéEnable logs

Vous pouvez demander au Stockage Azure d’enregistrer les journaux de diagnostic pour les requêtes de lecture, d’écriture et de suppression pour les services blob, table et file d’attente.You can instruct Azure Storage to save diagnostics logs for read, write, and delete requests for the blob, table, and queue services. La stratégie de rétention des données que vous définissez s’applique également à ces journaux d’activité.The data retention policy you set also applies to these logs.

Notes

Azure Files prend actuellement en charge les métriques Storage Analytics, mais non la journalisation Storage Analytics.Azure Files currently supports Storage Analytics metrics, but does not support Storage Analytics logging.

  1. Dans le portail Azure, sélectionnez Comptes de stockage, puis le nom du compte de stockage pour ouvrir le panneau du compte de stockage.In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

  2. Sélectionnez Paramètres de diagnostic (classique) dans la section Supervision (classique) du panneau du menu.Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

    Élément de menu Diagnostics sous SURVEILLANCE dans le portail Azure.

  3. Vérifiez que l’état est défini sur On, puis sélectionnez les services pour lesquels vous souhaitez activer la journalisation.Ensure Status is set to On, and select the services for which you'd like to enable logging.

    Configurez la journalisation dans le portail Azure.Configure logging in the Azure portal.

  4. Vérifiez que la case Supprimer les données est cochée.Ensure that the Delete data check box is selected. Ensuite, définissez le nombre de jours pendant lesquels vous souhaitez conserver les données de journal en déplaçant la commande de curseur sous la case à cocher, ou en modifiant directement la valeur qui apparaît dans la zone de texte à côté de la commande de curseur.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. La valeur par défaut pour les nouveaux comptes de stockage est de sept jours.The default for new storage accounts is seven days. Si vous ne souhaitez pas définir de stratégie de rétention, entrez 0.If you do not want to set a retention policy, enter zero. Dans ce cas, il vous appartient de supprimer ou non les données de journal.If there is no retention policy, it is up to you to delete the log data.

    Avertissement

    Les journaux sont stockés sous forme de données dans votre compte.Logs are stored as data in your account. Les données de journal peuvent s’accumuler dans votre compte au fil du temps, ce qui risque d’augmenter le coût du stockage.log data can accumulate in your account over time which can increase the cost of storage. Si vous n’avez besoin de ces données que pendant une durée limitée, vous pouvez réduire vos coûts en modifiant la stratégie de rétention des données.If you need log data for only a small period of time, you can reduce your costs by modifying the data retention policy. Les données de journal périmées (antérieures à votre stratégie de rétention des données) sont supprimées par le système.Stale log data (data older than your retention policy) is deleted by the system. Nous vous recommandons de définir une stratégie de rétention en fonction de la durée de conservation souhaitée des données de journal de votre compte.We recommend setting a retention policy based on how long you want to retain the log data for your account. Pour plus d’informations, consultez la page Facturation sur les métriques de stockage.See Billing on storage metrics for more information.

  5. Cliquez sur Enregistrer.Click Save.

    Les journaux de diagnostic sont enregistrés dans un conteneur d’objets blob nommé $logs dans votre compte de stockage.The diagnostics logs are saved in a blob container named $logs in your storage account. Vous pouvez afficher les données du journal à l’aide d’un explorateur de stockage, tel que l’Explorateur Stockage Microsoft Azure, ou de façon programmatique à l’aide d’une bibliothèque de client de stockage ou 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.

    Pour plus d’informations sur l’accès au conteneur $logs, consultez la page Journalisation Storage Analytics.For information about accessing the $logs container, see Storage analytics logging.

Modification de la période de rétention des données de journalModify log data retention period

Les données de journal peuvent s’accumuler dans votre compte au fil du temps, ce qui risque d’augmenter le coût du stockage.Log data can accumulate in your account over time which can increase the cost of storage. Si vous n’avez besoin de ces données que pendant une durée limitée, vous pouvez réduire vos coûts en modifiant la période de rétention des données de journal.If you need log data for only a small period of time, you can reduce your costs by modifying the log data retention period. Par exemple, si vous n’avez besoin de journaux que pendant trois jours, définissez cette période sur 3.For example, if you need logs for only three days, set your log data retention period to a value of 3. Ainsi, les journaux sont automatiquement supprimés de votre compte au bout de trois jours.That way logs will be automatically deleted from your account after 3 days. Cette section vous montre comment afficher la période actuelle de rétention des données de journal, puis la mettre à jour si nécessaire.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.

Notes

Cette procédure s’applique uniquement aux comptes pour lesquels le paramètre Espace de noms hiérarchique est activé.These steps apply only for accounts that do not have the Hierarchical namespace setting enabled on them. Si vous avez activé ce paramètre sur votre compte, le paramètre des jours de rétention n’est pas encore pris en charge.If you've enabled that setting on your account, then the setting for retention days is not yet supported. Vous devrez donc supprimer les journaux manuellement avec n’importe quel outil pris en charge, comme l’Explorateur Stockage Azure, REST ou un kit SDK.Instead, you'll have to delete logs manually by using any supported tool such as Azure Storage Explorer, REST or an SDK. Pour rechercher ces journaux dans votre compte de stockage, consultez Mode de stockage des journaux.To find those logs in your storage account, see How logs are stored.

  1. Dans le portail Azure, sélectionnez Comptes de stockage, puis le nom du compte de stockage pour ouvrir le panneau du compte de stockage.In the Azure portal, select Storage accounts, then the name of the storage account to open the storage account blade.

  2. Sélectionnez Paramètres de diagnostic (classique) dans la section Supervision (classique) du panneau du menu.Select Diagnostic settings (classic) in the Monitoring (classic) section of the menu blade.

    Élément de menu Diagnostics sous SUPERVISION sur le Portail Azure

  3. Vérifiez que la case Supprimer les données est cochée.Ensure that the Delete data check box is selected. Ensuite, définissez le nombre de jours pendant lesquels vous souhaitez conserver les données de journal en déplaçant la commande de curseur sous la case à cocher, ou en modifiant directement la valeur qui apparaît dans la zone de texte à côté de la commande de curseur.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.

    Modification de la période de rétention sur le Portail AzureModify the retention period in the Azure portal

    Le nombre de jours par défaut pour les nouveaux comptes de stockage est de sept jours.The default number of days for new storage accounts is seven days. Si vous ne souhaitez pas définir de stratégie de rétention, entrez 0.If you do not want to set a retention policy, enter zero. Dans ce cas, il vous appartient de supprimer ou non les données de surveillance.If there is no retention policy, it is up to you to delete the monitoring data.

  4. Cliquez sur Enregistrer.Click Save.

    Les journaux de diagnostic sont enregistrés dans un conteneur d’objets blob nommé $logs dans votre compte de stockage.The diagnostics logs are saved in a blob container named $logs in your storage account. Vous pouvez afficher les données du journal à l’aide d’un explorateur de stockage, tel que l’Explorateur Stockage Microsoft Azure, ou de façon programmatique à l’aide d’une bibliothèque de client de stockage ou 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.

    Pour plus d’informations sur l’accès au conteneur $logs, consultez la page Journalisation Storage Analytics.For information about accessing the $logs container, see Storage analytics logging.

Vérification de la suppression des données de journalVerify that log data is being deleted

Vous pouvez vérifier que les journaux sont en cours de suppression en affichant le contenu du conteneur $logs de votre compte de stockage.You can verify that logs are being deleted by viewing the contents of the $logs container of your storage account. L’illustration suivante montre le contenu d’un dossier dans le conteneur $logs.The following image shows the contents of a folder in the $logs container. Le dossier correspond à janvier 2021, et chaque dossier contient les journaux d’une journée.The folder corresponds to January 2021 and each folder contains logs for one day. Si nous sommes le 29 janvier 2021 et que votre stratégie de rétention est définie sur un seul jour, ce dossier ne contient les journaux que d’une journée.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.

Liste des dossiers de journaux sur le Portail AzureList of log folders in the Azure Portal

Affichage des données de journalView log data

Pour afficher et analyser vos données de journal, vous devez télécharger les objets Blob qui contiennent les données de journal souhaitées sur un ordinateur 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. De nombreux outils de consultation du stockage vous permettent de télécharger des objets Blob de votre compte de stockage. Vous pouvez également utiliser l’outil de copie Azure de ligne de commande fourni par l’équipe de Stockage Azure AzCopy pour télécharger vos données de journal.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.

Notes

Le conteneur $logs n’étant pas intégré avec Event Grid, vous ne recevez pas de notifications lors de l’écriture de fichiers journaux.The $logs container isn't integrated with Event Grid, so you won't receive notifications when log files are written.

Pour vous assurer de télécharger les données de journal souhaitées et éviter de télécharger les mêmes données plusieurs fois :To make sure you download the log data you are interested in and to avoid downloading the same log data more than once:

  • Utilisez la convention d’affectation de noms de l’horodatage pour les objets Blob contenant les données de journal pour suivre les objets Blob que vous avez déjà téléchargés pour analyse afin d’éviter de télécharger plusieurs fois les mêmes données.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.

  • Utilisez les métadonnées des objets Blob contenant des données de journal pour identifier la période pendant laquelle l’objet Blob conserve les données de journal afin d’identifier l’objet Blob exact que vous devez télécharger.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.

Pour commencer à utiliser AzCopy, consultez Prise en main d’AzCopyTo get started with AzCopy, see Get started with AzCopy

L’exemple suivant montre comment vous pouvez télécharger les données de journal du service de file d’attente pour les heures en commençant à 9h, 10h et 11h le 20 mai 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

Pour plus d’informations sur le téléchargement de fichiers spécifiques, consultez Téléchargement d’objets blob à partir du Stockage Blob Azure avec AzCopy v10.To learn more about how to download specific files, see Download blobs from Azure Blob storage by using AzCopy v10.

Lorsque vous avez téléchargé vos données de journal, vous pouvez afficher les entrées de journal dans les fichiers.When you have downloaded your log data, you can view the log entries in the files. Ces fichiers journaux utilisent un format de texte délimité que de nombreux outils de lecture de journaux sont en mesure d’analyser (pour plus d’informations, consultez le guide Surveiller, diagnostiquer et résoudre les problèmes liés au service Stockage Microsoft Azure).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). Différents outils possèdent des fonctionnalités différentes de mise en forme, de filtrage, de tri et de recherche de contenu de vos fichiers journaux.Different tools have different facilities for formatting, filtering, sorting, ad searching the contents of your log files. Pour plus d’informations sur le format du fichier journal de journalisation du stockage et son contenu, consultez Format du journal de l’analyse de stockage et Opérations et messages d’état enregistrés Storage Analytics.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.

Étapes suivantesNext steps