Activation et gestion des journaux Azure Storage Analytics (classique)

Azure Storage Analytics fournit des journaux pour les objets blob, les files d’attente et les tables. Vous pouvez utiliser le Portail Azure afin de configurer les journaux à enregistrer pour votre compte. Cet article explique comment activer et gérer les journaux. Pour savoir comment activer les métriques, consultez Activation et gestion des métriques Azure Storage Analytics (classique). L’examen et le stockage des données de supervision sur le Portail Azure occasionne des frais. Pour plus d’informations, consultez Storage Analytics.

Notes

Nous vous recommandons d’utiliser les journaux Stockage Azure disponibles dans Azure Monitor au lieu des journaux Storage Analytics. Consultez l’un des articles suivants :

• Supervision du Stockage Blob Azure
• Supervision d’Azure Files
• Surveiller le service Stockage File d'attente
• Supervision du stockage Table Azure

Activer les journaux d’activité

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. La stratégie de rétention des données que vous définissez s’applique également à ces journaux d’activité.

Notes

Azure Files prend actuellement en charge les métriques Storage Analytics, mais non la journalisation Storage Analytics.

Portail

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.

2. Sélectionnez Paramètres de diagnostic (classique) dans la section Supervision (classique) du panneau du menu.

   

3. Vérifiez que l’état est défini sur On, puis sélectionnez les services pour lesquels vous souhaitez activer la journalisation.

   

4. Pour conserver les journaux, vérifiez que la case Supprimer les données est cochée. 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. La valeur par défaut pour les nouveaux comptes de stockage est de sept jours. Si vous ne souhaitez pas définir de stratégie de rétention, n’activez pas la case à cocher Supprimer les données. Dans ce cas, il vous appartient de supprimer ou non les données de journal.

   Avertissement

   Les journaux sont stockés sous forme de données dans votre compte. 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. 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. 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. 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. Pour plus d’informations, consultez la page Facturation sur les métriques de stockage.

5. Cliquez sur Enregistrer.

   Les journaux de diagnostic sont enregistrés dans un conteneur d’objets blob nommé $logs dans votre compte de stockage. 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.

   Pour plus d’informations sur l’accès au conteneur $logs, consultez la page Journalisation Storage Analytics.

   Notes

   Pour les comptes de stockage classiques, le conteneur $logs s’affiche uniquement dans l’Explorateur Stockage Azure. Le conteneur $logs n’est pas visible à partir du navigateur de stockage ou de la vue conteneur disponible dans le Portail Azure.

PowerShell

1. Ouvrez une fenêtre Commande Windows PowerShell.

2. Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.

   Connect-AzAccount
   

3. Si votre identité est associée à plusieurs abonnements, définissez votre abonnement actif.

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

   Remplacez la valeur d’espace réservé <subscription-id> par l’ID de votre abonnement.

4. Obtenez le contexte du compte de stockage qui définit le compte de stockage à utiliser.

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

   • Remplacez la valeur d’espace réservé <resource-group-name> par le nom de votre groupe de ressources.

   • Remplacez la valeur d’espace réservé <storage-account-name> par le nom de votre compte de stockage.

5. Utilisez Set-AzStorageServiceLoggingProperty pour changer les paramètres des journaux actuels. Les cmdlets qui contrôlent la journalisation du stockage utilisent un paramètre LoggingOperations, une chaîne contenant une liste de types de requêtes à consigner séparée par des virgules. Les trois types de requêtes possibles sont lire, écrire et supprimer. Pour désactiver la journalisation, utilisez la valeur aucun pour le paramètre LoggingOperations.

   La commande suivante active la journalisation des requêtes de lecture, d’écriture et de suppression dans le service de File d’attente de votre compte de stockage par défaut avec une rétention de cinq jours :

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

   Avertissement

   Les journaux sont stockés sous forme de données dans votre compte. 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. 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. 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. 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. Pour plus d’informations, consultez la page Facturation sur les métriques de stockage.

   La commande suivante désactive la journalisation du service de table dans votre compte de stockage par défaut :

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

   Pour plus d’informations sur la configuration des applets de commande Azure PowerShell avec votre abonnement Azure et sur la sélection du compte de stockage par défaut à utiliser, consultez : Guide pratique pour installer et configurer Azure PowerShell.

.NET

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

Modification de la période de rétention des données de journal

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. 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. Par exemple, si vous n’avez besoin de journaux que pendant trois jours, définissez cette période sur 3. Ainsi, les journaux sont automatiquement supprimés de votre compte au bout de trois jours. 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.

Portail

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.

2. Sélectionnez Paramètres de diagnostic (classique) dans la section Supervision (classique) du panneau du menu.

   

3. Vérifiez que la case Supprimer les données est cochée. 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.

   

   Le nombre de jours par défaut pour les nouveaux comptes de stockage est de sept jours. Si vous ne souhaitez pas définir de stratégie de rétention, n’activez pas la case à cocher Supprimer les données. Dans ce cas, il vous appartient de supprimer ou non les données de surveillance.

4. Cliquez sur Enregistrer.

   Les journaux de diagnostic sont enregistrés dans un conteneur d’objets blob nommé $logs dans votre compte de stockage. 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.

   Pour plus d’informations sur l’accès au conteneur $logs, consultez la page Journalisation Storage Analytics.

PowerShell

1. Ouvrez une fenêtre Commande Windows PowerShell.

2. Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.

   Connect-AzAccount
   

3. Si votre identité est associée à plusieurs abonnements, définissez votre abonnement actif.

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

   Remplacez la valeur d’espace réservé <subscription-id> par l’ID de votre abonnement.

4. Récupérez le contexte du compte de stockage qui définit le compte de stockage.

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

   • Remplacez la valeur d’espace réservé <resource-group-name> par le nom de votre groupe de ressources.

   • Remplacez la valeur d’espace réservé <storage-account-name> par le nom de votre compte de stockage.

5. Utilisez Get-AzStorageServiceLoggingProperty pour afficher la stratégie actuelle de rétention des journaux. L’exemple suivant imprime sur la console la période de rétention des services de stockage Blob et File d’attente.

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

   Dans la sortie de la console, la période de rétention s’affiche sous l’en-tête de colonne RetentionDays.

   

6. Utilisez Set-AzStorageServiceLoggingProperty pour changer la période de rétention. Dans l’exemple suivant, elle est remplacée par quatre jours.

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

   Pour plus d’informations sur la configuration des applets de commande Azure PowerShell avec votre abonnement Azure et sur la sélection du compte de stockage par défaut à utiliser, consultez : Guide pratique pour installer et configurer Azure PowerShell.

.NET

L’exemple suivant imprime sur la console la période de rétention des services de stockage Blob et File d’attente.

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

Dans l’exemple suivant, elle est remplacée par quatre jours.

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

Vérification de la suppression des données de journal

Vous pouvez vérifier que les journaux sont en cours de suppression en affichant le contenu du conteneur $logs de votre compte de stockage. L’illustration suivante montre le contenu d’un dossier dans le conteneur $logs. Le dossier correspond à janvier 2021, et chaque dossier contient les journaux d’une journée. 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.

Affichage des données de journal

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. 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.

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.

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 :

• 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.

• 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.

Pour commencer à utiliser AzCopy, consultez Prise en main d’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.

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.

Lorsque vous avez téléchargé vos données de journal, vous pouvez afficher les entrées de journal dans les fichiers. 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). 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. 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.

Étapes suivantes

• Pour en savoir plus sur Storage Analytics, consultez Storage Analytics pour Storage Analytics.
• Pour plus d’informations sur l’utilisation d’un langage .NET pour configurer la journalisation du stockage, consultez la référence sur la bibliothèque cliente de stockage.
• Pour obtenir des informations générales sur la configuration de la journalisation du stockage avec l’API REST, consultez Activation et configuration de Storage Analytics.
• Pour plus d’informations sur le format des journaux Storage Analytics, consultez Format des journaux Storage Analytics.