Activation et gestion des journaux Azure Storage Analytics (classique)

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.

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.

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

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.

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