Journaux de diagnostic – Azure Content Delivery Network

Les journaux de diagnostic Azure permettent d’afficher l’analytique principale et de l’enregistrer dans une ou plusieurs destinations, dont les suivantes :

• Compte de Stockage Azure
• Espace de travail Log Analytics
• Azure Event Hubs

Cette fonctionnalité est disponible sur les points de terminaison de réseau de distribution de contenu à tous les niveaux tarifaires.

Les journaux de diagnostic vous permettent d’exporter des métriques d’utilisation de base de votre point de terminaison de réseau de distribution de contenu vers différents types de sources afin de pouvoir les utiliser de façon personnalisée. Voici les types d’exportation de données que vous pouvez effectuer :

• Exporter des données vers un stockage d’objets blob, exporter au format CSV et générer des graphiques dans Excel.
• Exporter des données vers des hubs d’événements et mettre les données en corrélation avec d’autres services Azure.
• Exporter des données vers des journaux Azure Monitor et afficher les données dans votre propre espace de travail Log Analytics

Un profil Azure Content Delivery Network est nécessaire pour les étapes suivantes. Reportez-vous à Créer un profil et un point de terminaison Azure Content Delivery Network avant de continuer.

Activation de la journalisation avec le portail Azure

Procédez comme suit pour activer la journalisation pour votre point de terminaison Azure Content Delivery Network :

1. Connectez-vous au portail Azure.

2. Sur le Portail Azure, accédez à Toutes les ressources>votre-profil-cdn.

3. Sélectionnez le point de terminaison de réseau de distribution de contenu pour lequel vous souhaitez activer les journaux de diagnostic :

   

4. Dans la section Supervision, sélectionnez Journaux de diagnostic :

   

Activation de la journalisation avec Stockage Azure

Pour utiliser un compte de stockage afin de stocker les journaux d’activité, effectuez les étapes suivantes :

1. Pour Nom des paramètres de diagnostic, entrez un nom pour les paramètres du journal de diagnostic.

2. Sélectionnez Archiver dans un compte de stockage, puis CoreAnalytics.

3. Dans le champ Rétention (jours) , choisissez le nombre de jours de rétention. Si la valeur zéro est appliquée à la rétention, les journaux d’activité sont stockés pour une durée indéfinie.

4. Sélectionnez l’abonnement et le compte de stockage pour les journaux.

   

5. Sélectionnez Enregistrer.

Envoyer à Log Analytics

Pour utiliser Log Analytics pour les journaux, suivez ces étapes :

1. Pour Nom des paramètres de diagnostic, entrez un nom pour les paramètres du journal de diagnostic.

2. Sélectionnez Envoyer à Log Analytics, puis CoreAnalytics.

3. Sélectionnez l’abonnement et l’espace de travail Log Analytics pour les journaux.

   

4. Sélectionnez Enregistrer.

Diffuser vers un hub d’événements

Pour utiliser un hub d’événements pour les journaux, suivez ces étapes :

1. Pour Nom des paramètres de diagnostic, entrez un nom pour les paramètres du journal de diagnostic.

2. Sélectionnez Diffuser vers Event Hub, puis CoreAnalytics.

3. Sélectionnez l’abonnement et l’espace de noms Event Hub pour les journaux.

   

4. Sélectionnez Enregistrer.

Activer la journalisation avec PowerShell

L’exemple suivant montre comment activer les journaux de diagnostic via les applets de commande Azure PowerShell.

Activer les journaux de diagnostic dans un compte de stockage

1. Connectez-vous à Azure PowerShell :

   Connect-AzAccount 
   

2. Pour activer les journaux de diagnostic dans un compte de stockage, entrez ces commandes. Remplacez les variables par vos valeurs :

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $storageacct = <your-storage-account-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   $storage = Get-AzStorageAccount -ResourceGroupName $rsg -Name $storageacct
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -StorageAccountId $storage.id -Enabled $true -Categories CoreAnalytics
   

Activer les journaux de diagnostic pour l’espace de travail Log Analytics

1. Connectez-vous à Azure PowerShell :

   Connect-AzAccount 
   

2. Pour activer les journaux de diagnostic pour un espace de travail Log Analytics, entrez ces commandes. Remplacez les variables par vos valeurs :

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $workspacename = <your-log-analytics-workspace-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   $workspace = Get-AzOperationalInsightsWorkspace -ResourceGroupName $rsg -Name $workspacename
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -WorkspaceId $workspace.ResourceId -Enabled $true -Categories CoreAnalytics
   

Activer les journaux de diagnostic pour l’espace de noms Event Hub

1. Connectez-vous à Azure PowerShell :

   Connect-AzAccount 
   

2. Pour activer les journaux de diagnostic pour un espace de travail Log Analytics, entrez ces commandes. Remplacez les variables par vos valeurs :

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $eventhubname = <your-event-hub-namespace-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -EventHubName $eventhubname -Enabled $true -Categories CoreAnalytics
   

Utilisation des journaux de diagnostic à partir de Stockage Azure

Cette section décrit le schéma de l’analytique principale du réseau de distribution de contenu et l’organisation dans un compte de Stockage Azure, et fournit un exemple de code pour télécharger les journaux dans un fichier CSV.

Utilisation de l’explorateur de stockage Microsoft Azure

Pour télécharger l’outil, consultez Explorateur de stockage Azure. Après le téléchargement et l’installation du logiciel, configurez-le pour utiliser le même compte de Stockage Azure que celui qui a été configuré en tant que destination pour les journaux de diagnostic du réseau de distribution de contenu.

1. Ouvrez l’explorateur de stockage Microsoft Azure
2. Localiser le compte de stockage
3. Développez le nœud Conteneurs d’objets Blob sous ce compte de stockage.
4. Sélectionnez le conteneur nommé journaux-insights-coreanalytics.
5. Les résultats s’affichent dans le volet droit, en commençant par le premier niveau, soir resourceId= . Continuez à sélectionner chaque niveau jusqu’à atteindre le fichier PT1H.json. Pour obtenir une explication sur le chemin, consultez Format du chemin des objets blob.
6. Chaque fichier d’objet blob PT1H.json représente les journaux d’activité d’analyse pendant une heure pour un point de terminaison de réseau de distribution de contenu spécifique ou son domaine personnalisé.
7. Le schéma du contenu de ce fichier JSON est décrit dans la section Schéma des journaux d’activité Core Analytics.

Format du chemin des objets blob

Les journaux d’activité Core Analytics sont générés toutes les heures et les données sont collectées et stockées dans un objet blob Azure unique sous forme de charge utile JSON. L’outil Explorateur de stockage interprète '/' comme un séparateur de répertoire et affiche la hiérarchie. Le chemin de l’objet blob Azure apparaît comme s’il existait une structure hiérarchique et représente le nom de l’objet blob. Ce nom d’objet blob suit la convention d’affectation de noms suivante :

resourceId=/SUBSCRIPTIONS/{Subscription Id}/RESOURCEGROUPS/{Resource Group Name}/PROVIDERS/MICROSOFT.CDN/PROFILES/{Profile Name}/ENDPOINTS/{Endpoint Name}/ y=/m=/d=/h=/m=/PT1H.json

Description des champs :

Exportation des données de Core Analytics vers un fichier CSV

Pour accéder à l’analytique principale, un exemple de code pour un outil est fourni. Cet outil permet de télécharger les fichiers JSON dans un format de fichier plat avec séparation par virgules, qui peut être utilisé pour créer des graphiques ou autres agrégations.

Voici comment vous pouvez utiliser l’outil :

1. Consultez le lien GitHub : https://github.com/Azure-Samples/azure-cdn-samples/tree/master/CoreAnalytics-ExportToCsv
2. Téléchargez le code.
3. Suivez les instructions pour la compilation et la configuration.
4. Exécutez l’outil.
5. Le fichier CSV résultant présente les données d’analyse dans une hiérarchie plate simple.

Retards des données de journal

Le tableau suivant présente les retards des données de journal pour Azure CDN Standard fourni par Microsoft et Azure CDN Standard/Premium fourni par Edgio.

Types de journaux de diagnostic pour l’analytique principale du réseau de distribution de contenu

Actuellement, Microsoft propose uniquement les journaux d’activité de l’analytique principale, qui contiennent les métriques affichant les statistiques de réponse HTTP et de sortie, comme dans les points de présence/périmètres du réseau de distribution de contenu.

Détails des métriques de Core Analytics

Le tableau suivant présente la liste des métriques disponibles dans les journaux de l’analytique principale pour :

• Azure CDN Standard par Microsoft
• Azure CDN Standard/Premium fourni par Edgio

Toutes les métriques ne sont pas disponibles auprès tous les fournisseurs, même si ces différences sont minimes. Ce tableau indique également si une métrique donnée est disponible à partir d’un fournisseur particulier. Les métriques sont disponibles uniquement pour les points de terminaison de réseau de distribution de contenu recevant du trafic.

* Le transfert de données sortantes fait référence au trafic produit des serveurs POP de réseau de distribution de contenu vers le client.

Schéma des journaux d’activité Core Analytics

Tous les journaux d’activité sont stockés au format JSON, et chaque entrée comprend des champs de chaîne conformément au schéma suivant :

    "records": [
        {
            "time": "2017-04-27T01:00:00",
            "resourceId": "<ARM Resource Id of the CDN Endpoint>",
            "operationName": "Microsoft.Cdn/profiles/endpoints/contentDelivery",
            "category": "CoreAnalytics",
            "properties": {
                "DomainName": "<Name of the domain for which the statistics is reported>",
                "RequestCountTotal": integer value,
                "RequestCountHttpStatus2xx": integer value,
                "RequestCountHttpStatus3xx": integer value,
                "RequestCountHttpStatus4xx": integer value,
                "RequestCountHttpStatus5xx": integer value,
                "RequestCountHttpStatusOthers": integer value,
                "RequestCountHttpStatus200": integer value,
                "RequestCountHttpStatus206": integer value,
                "RequestCountHttpStatus302": integer value,
                "RequestCountHttpStatus304": integer value,
                "RequestCountHttpStatus404": integer value,
                "RequestCountCacheHit": integer value,
                "RequestCountCacheMiss": integer value,
                "RequestCountCacheNoCache": integer value,
                "RequestCountCacheUncacheable": integer value,
                "RequestCountCacheOthers": integer value,
                "EgressTotal": double value,
                "EgressHttpStatus2xx": double value,
                "EgressHttpStatus3xx": double value,
                "EgressHttpStatus4xx": double value,
                "EgressHttpStatus5xx": double value,
                "EgressHttpStatusOthers": double value,
                "EgressCacheHit": double value,
                "EgressCacheMiss": double value,
                "EgressCacheNoCache": double value,
                "EgressCacheUncacheable": double value,
                "EgressCacheOthers": double value,
            }
        }

    ]
}

Où time représente l’heure de début des limites d’heure pour lesquelles les statistiques sont rapportées. Une métrique non prise en charge par un fournisseur de réseau de distribution de contenu donne une valeur Nulle et non un entier ou un double. Cette valeur null indique l’absence de métrique, et diffère de la valeur 0. Un ensemble de ces métriques par domaine est configuré sur le point de terminaison.

Exemple de propriétés :

{
     "DomainName": "azurecdntest.azureedge.net",
     "RequestCountTotal": 480,
     "RequestCountHttpStatus2xx": 480,
     "RequestCountHttpStatus3xx": 0,
     "RequestCountHttpStatus4xx": 0,
     "RequestCountHttpStatus5xx": 0,
     "RequestCountHttpStatusOthers": 0,
     "RequestCountHttpStatus200": 480,
     "RequestCountHttpStatus206": 0,
     "RequestCountHttpStatus302": 0,
     "RequestCountHttpStatus304": 0,
     "RequestCountHttpStatus404": 0,
     "RequestCountCacheHit": null,
     "RequestCountCacheMiss": null,
     "RequestCountCacheNoCache": null,
     "RequestCountCacheUncacheable": null,
     "RequestCountCacheOthers": null,
     "EgressTotal": 0.09,
     "EgressHttpStatus2xx": null,
     "EgressHttpStatus3xx": null,
     "EgressHttpStatus4xx": null,
     "EgressHttpStatus5xx": null,
     "EgressHttpStatusOthers": null,
     "EgressCacheHit": null,
     "EgressCacheMiss": null,
     "EgressCacheNoCache": null,
     "EgressCacheUncacheable": null,
     "EgressCacheOthers": null
}

Plus de ressources

• Journaux de diagnostic Azure
• Analyse de base via le Portail supplémentaire Azure Content Delivery Network
• Journaux d’activité Azure Monitor
• API REST Azure Log Analytics