Activation et configuration de Storage Analytics

  • Article
  • 2 minutes de lecture

Les métriques de Storage Analytics sont activées par défaut pour les nouveaux comptes de stockage. Vous pouvez activer la journalisation et configurer les métriques et la journalisation dans le Portail Azure ; pour plus d’informations, consultez Surveiller un compte de stockage dans le Portail Azure. Vous pouvez également activer Storage Analytics par programmation via l'API REST ou la bibliothèque cliente. Utilisez l’opération Set Service Properties pour un service individuel pour activer Storage Analytics.

Notes

Les métriques Storage Analytics sont disponibles pour les services Blob, File d’attente, Table et Fichier.

La journalisation Storage Analytics est disponible pour les services BLOB, de File d’attente et de Table. Un compte de stockage Premium n’est toutefois pas pris en charge.

L’exemple suivant active Storage Analytics pour le service Table d’un compte fictif nommé myaccount.

Important

Bien que les métriques horaires soient activées par défaut pour les nouveaux comptes de stockage, les métriques de minute doivent être activées par programme. Vous pouvez également utiliser PowerShell et Azure CLI 2.0 pour activer les métriques de minute.

  1. Configurez votre URI de demande et les en-têtes pour qu'ils correspondent aux exemples suivants. La méthode HTTP est PUT et vous devez appliquer un schéma d’autorisation pour signer la demande. Pour plus d’informations sur la signature de votre demande, consultez Autoriser les demandes à stockage Azure.

    PUT https://myaccount.table.core.windows.net/?restype=service&comp=properties HTTP/1.1  
x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.table.core.windows.net

  2. Votre demande nécessite également un corps de demande, constitué de code XML que le service de stockage traitera et utilisera pour configurer Storage Analytics. L’exemple suivant active la journalisation pour les demandes de suppression et d’écriture et définit une stratégie de rétention de journal de 7 jours. Il active également les métriques horaires et minutes, exclut les statistiques récapitulatives au niveau de l’API et définit une stratégie de rétention des données de 7 jours.

    <?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>1.0</Version>  
              <Delete>true</Delete>  
        <Read>false</Read>  
        <Write>true</Write>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
...
</StorageServiceProperties>

  3. Lorsque cette demande est envoyée, elle reçoit une réponse qui indique si Storage Analytics a été configuré. Si la réponse a un code d'état HTTP 202 (Accepté), vos paramètres Storage Analytics ont été mis à jour. L'exemple de réponse suivant indique que les paramètres ont été mis à jour :

    HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: Wed, 23 Oct 2013 04:28:20 GMT  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15

Une fois que vous avez activé Storage Analytics avec votre configuration initiale, vous pouvez toujours obtenir vos paramètres actuels en appelant les propriétés du service Blob, Get Table Service Properties ou Get Queue Service Properties.

Mise à jour de Storage Analytics

Pour modifier les paramètres Storage Analytics pour un service de stockage, appelez à nouveau l’opérationSet Service Properties. Vérifiez que votre nouveau corps de demande XML conserve les options de configuration souhaitées, telles que l'activation/désactivation de Storage Analytics et/ou une stratégie de rétention pour le service. Chaque fois que l'une de ces opérations est appelée, elle modifie les paramètres applicables immédiatement au service.

Voir aussi

Définition d'une stratégie de rétention des données Storage Analytics
Définition des propriétés du service Blob
Obtenir les propriétés du service Blob
Définition des propriétés du service de Table
Obtenir les propriétés du service table
Définition des propriétés du service de File d’attente
Obtenir les propriétés du service file d’attente
Définition des propriétés du service Fichier
Obtenir les propriétés du service de fichiers