Journalisation des diagnostics dans Azure Cosmos DBDiagnostic logging in Azure Cosmos DB

Après avoir commencé à utiliser une ou plusieurs bases de données Azure Cosmos, vous pouvez superviser comment et quand vos bases de données font l’objet d’un accès.After you start to use one or more Azure Cosmos databases, you may want to monitor how and when your databases are accessed. Cet article fournit une vue d’ensemble des journaux d’activité disponibles sur la plateforme Azure.This article provides an overview of the logs that are available on the Azure platform. Vous y apprendrez comment activer la journalisation des diagnostics à des fins de supervision pour envoyer les journaux d’activité à Stockage Azure, comment diffuser des journaux d’activité sur Azure Event Hubset comment exporter des journaux d’activité vers les journaux Azure Monitor.You learn how to enable diagnostic logging for monitoring purposes to send logs to Azure Storage, how to stream logs to Azure Event Hubs, and how to export logs to Azure Monitor logs.

Notes

Cet article a récemment été mis à jour pour utiliser le terme journaux d’activité Azure Monitor au lieu de Log Analytics.This article was recently updated to use the term Azure Monitor logs instead of Log Analytics. Les données de journal sont toujours stockées dans un espace de travail Log Analytics, et elles sont toujours collectées et analysées par le même service Log Analytics.Log data is still stored in a Log Analytics workspace and is still collected and analyzed by the same Log Analytics service. Nous mettons la terminologie à jour pour mieux refléter le rôle des journaux d’activité dans Azure Monitor.We are updating the terminology to better reflect the role of logs in Azure Monitor. Pour plus d'informations, consultez Modifications de la terminologie d'Azure Monitor.See Azure Monitor terminology changes for details.

Notes

Cet article a été mis à jour pour tenir compte de l’utilisation du nouveau module Az d’Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Vous pouvez toujours utiliser le module AzureRM, qui continue à recevoir des correctifs de bogues jusqu’à au moins décembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Pour en savoir plus sur le nouveau module Az et la compatibilité avec AzureRM, consultez Présentation du nouveau module Az d’Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pour des instructions d’installation du module Az, consultez Installer Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Journaux d’activité disponibles dans AzureLogs available in Azure

Avant de passer à la surveillance de votre compte Azure Cosmos DB, il est important de clarifier certains points concernant la journalisation et la surveillance.Before we talk about how to monitor your Azure Cosmos DB account, let's clarify a few things about logging and monitoring. Il existe plusieurs types de journaux d’activité sur la plateforme Azure.There are different types of logs on the Azure platform. Vous avez les journaux d’activité Azure, les journaux de diagnostic Azure, les métriques Azure, les événements, le monitoring des pulsations, les journaux d’activité des opérations, etc.There are Azure Activity Logs, Azure Diagnostic Logs, Azure metrics, events, heartbeat monitoring, operations logs, and so on. Il existe une multitude de journaux d’activité.There is a plethora of logs. La liste complète des journaux d’activité est disponible dans les journaux Azure Monitor sur le portail Azure.You can see the complete list of logs in Azure Monitor logs in the Azure portal.

L’illustration suivante montre les différents types de journaux d’activité Azure disponibles :The following image shows the different kind of Azure logs that are available:

Les différents types de journaux d’activité Azure

Sur l’image, les Ressources de calcul représentent les ressources Azure pour lesquelles vous pouvez accéder au système d’exploitation invité Microsoft.In the image, the Compute resources represent the Azure resources for which you can access the Microsoft Guest OS. Par exemple, les machines virtuelles Azure, les groupes de machines virtuelles identiques et Azure Container Service sont considérés comme des ressources de calcul.For example, Azure Virtual Machines, virtual machine scale sets, Azure Container Service, and so on, are considered compute resources. Les ressources de calcul génèrent des journaux d’activité, de diagnostic et des applications.Compute resources generate Activity Logs, Diagnostic Logs, and Application Logs. Pour plus d’informations, reportez-vous à l’article Sources de données de supervision dans Azure.To learn more, refer to the Sources of monitoring data in Azure article.

Les ressources non liées au calcul sont des ressources dans lesquelles il n’est pas possible d’accéder au système d’exploitation sous-jacent et de les utiliser directement,The Non-Compute resources are resources in which you can't access the underlying OS and work directly with the resource. par exemple, les Groupes de sécurité réseau, Logic Apps, etc.For example, Network Security Groups, Logic Apps, and so on. Azure Cosmos DB en est une.Azure Cosmos DB is a non-compute resource. Vous pouvez afficher les journaux d’activité des ressources non liées au calcul dans le journal d’activité ou activer l’option Journaux de diagnostic sur le portail.You can view logs for non-compute resources in the Activity Log or enable the Diagnostic Logs option in the portal. Pour plus d’informations, reportez-vous à l’article Sources de données dans Azure Monitor.To learn more, refer to the Sources of data in Azure Monitor article.

Le journal d’activité enregistre les opérations au niveau de l’abonnement pour Azure Cosmos DB.The Activity Log records the operations at a subscription level for Azure Cosmos DB. Les opérations comme ListKeys et Write DatabaseAccounts sont journalisées par exemple.Operations like ListKeys, Write DatabaseAccounts, and more are logged. Les journaux de diagnostic assurent une journalisation plus précise et permettent de consigner des DataPlaneRequests (Create, Read, Query, etc.) et MongoRequests.Diagnostic Logs provide more granular logging and allow you to log DataPlaneRequests (Create, Read, Query, and so on) and MongoRequests.

Dans cet article, nous allons nous concentrer sur le journal d’activité Azure, les journaux de diagnostic Azure et les métriques Azure.In this article, we focus on the Azure Activity Log, Azure Diagnostic Logs, and Azure metrics. Quelle est la différence entre ces trois types de journaux d’activité ?What's the difference between these three logs?

Journaux d’activitéAzure Activity Log

Le journal d’activité Azure est un journal d’abonnement qui fournit un aperçu de tous les événements relatifs aux abonnements qui se sont produits dans Azure.The Azure Activity Log is a subscription log that provides insight into subscription-level events that have occurred in Azure. Le journal d’activité signale les événements de plan de contrôle de vos abonnements sous la catégorie Administratif.The Activity Log reports control-plane events for your subscriptions under the Administrative category. Vous pouvez utiliser le journal d’activité pour déterminer « qui, quand et quoi » pour toutes les opérations d’écriture (PUT, POST, DELETE) sur des ressources dans votre abonnement.You can use the Activity Log to determine the "what, who, and when" for any write operation (PUT, POST, DELETE) on the resources in your subscription. Vous pouvez également comprendre l’état de l’opération et d’autres propriétés pertinentes.You can also understand the status of the operation and other relevant properties.

Le journal d’activité est différent du journal de diagnostic.The Activity Log differs from Diagnostic Logs. Le journal d’activité fournit des données sur les opérations effectuées sur une ressource à partir de l’extérieur (le plan de contrôle).The Activity Log provides data about the operations on a resource from the outside (the control plane). Dans le contexte d’Azure Cosmos DB, les opérations de plan de contrôle incluent notamment Créer un conteneur, Répertorier les clés, Supprimer les clés, Répertorier les bases de données, etc.In the Azure Cosmos DB context, control plane operations include create container, list keys, delete keys, list database, and so on. Les journaux de diagnostic sont émis par une ressource et fournissent des informations sur le fonctionnement de cette ressource (le plan de données).Diagnostics Logs are emitted by a resource and provide information about the operation of that resource (the data plane). Les opérations de plan de données du journal de diagnostic incluent par exemple Delete, Insert et ReadFeed.Some examples of the data plane operations in the diagnostic log are Delete, Insert, and ReadFeed.

Les journaux d’activité (opérations de plan de contrôle) peuvent être beaucoup plus complets par nature et inclure l’adresse e-mail complète de l’appelant, l’adresse IP de l’appelant, le nom de la ressource, le nom de l’opération, l’ID du locataire, etc.Activity Logs (control plane operations) can be richer in nature and can include the full email address of the caller, caller IP address, resource name, operation name, TenantId, and more. Le journal d’activité contient plusieurs catégories de données.The Activity Log contains several categories of data. Pour plus d’informations sur le schéma de ces catégories, consultez Schéma d’événements du journal d’activité.For full details on the schemata of these categories, see Azure Activity Log event schema. Cependant, les journaux de diagnostic peuvent être restrictifs par nature, car les données personnelles n’y sont généralement pas incluses.However, Diagnostic Logs can be restrictive in nature as personal data is often stripped from these logs. Si vous avez l’adresse IP de l’appelant, le dernier octet de l’adresse ne sera pas inclus.You might have the IP address of the caller, but the last octant is removed.

Métriques AzureAzure metrics

Les métriques Azure comprennent le type le plus important de données de télémétrie Azure (aussi appelées compteurs de performances), qui sont émises par la plupart des ressources Azure.Azure metrics have the most important type of Azure telemetry data (also called performance counters) that's emitted by most Azure resources. Les métriques permettent d’afficher des informations sur le débit, le stockage, la cohérence, la disponibilité et la latence de vos ressources Azure Cosmos DB.Metrics let you view information about throughput, storage, consistency, availability, and the latency of your Azure Cosmos DB resources. Pour plus d’informations, consultez la section Surveillance et débogage à l’aide de métriques dans Azure Cosmos DB.For more information, see Monitoring and debugging with metrics in Azure Cosmos DB.

Journaux de diagnostic AzureAzure Diagnostic Logs

Les journaux de diagnostic Azure sont générés par une ressource et fournissent des informations riches et fréquentes sur le fonctionnement de cette ressource.Azure Diagnostic Logs are emitted by a resource and provide rich, frequent data about the operation of that resource. Ces journaux sont capturés par demande.These logs are captured per request. Le contenu de ces journaux d’activité varie en fonction du type de ressource.The content of these logs varies by resource type. Les journaux de diagnostic des ressources diffèrent également des journaux de diagnostic de système d’exploitation invité.Resource-level diagnostic logs also differ from Guest OS-level diagnostic logs. Les journaux de diagnostic de système d’exploitation invité sont collectés par un agent exécuté sur une machine virtuelle ou un autre type de ressource pris en charge.Guest OS diagnostic logs are collected by an agent that's running inside a virtual machine or other supported resource type. Les journaux de diagnostic des ressources ne nécessitent aucun agent et capturent les données propres à la ressource à partir de la plateforme Azure elle-même.Resource-level diagnostic logs require no agent and capture resource-specific data from the Azure platform itself. Les journaux de diagnostic de système d’exploitation invité capturent les données à partir du système d’exploitation et des applications exécutées sur une machine virtuelle.Guest OS-level diagnostic logs capture data from the operating system and applications that are running on a virtual machine.

Journalisation des diagnostics dans le Stockage, Event Hubs ou les journaux d’activité Azure Monitor

Quels sont les types d’informations qui sont enregistrées dans les journaux de diagnostic Azure ?What is logged by Azure Diagnostic Logs?

  • Toutes les requêtes principales authentifiées (TCP/REST), dans toutes les API, sont enregistrées, y compris les requêtes ayant échoué suite à des demandes, des erreurs système ou des autorisations d’accès incorrectes.All authenticated backend requests (TCP/REST) across all APIs are logged, including failed requests as a result of access permissions, system errors, or bad requests. Les requêtes Graph, Cassandra et d’API de table initiées par l’utilisateur ne sont pas prises en charge.Support for user-initiated Graph, Cassandra, and Table API requests aren't currently available.
  • Les opérations sur la base de données même, notamment les opérations CRUD sur l’ensemble des documents, des conteneurs et des bases de données.Operations on the database itself, which include CRUD operations on all documents, containers, and databases.
  • Les opérations sur les clés de compte, notamment la création, la modification ou la suppression de ces clés.Operations on account keys, which include creating, modifying, or deleting the keys.
  • les requêtes non authentifiées qui génèrent une réponse 401.Unauthenticated requests that result in a 401 response. Par exemple, les requêtes qui ne possèdent pas de jeton de porteur, qui sont incorrectes, qui ont expiré ou qui comportent un jeton non valide.For example, requests that don't have a bearer token, or are malformed or expired, or have an invalid token.

Activer la journalisation dans le portail AzureTurn on logging in the Azure portal

Pour activer la journalisation des diagnostics dans le portail Azure, effectuez les étapes suivantes :Use the following steps to enable diagnostic logging in the Azure portal:

  1. Connectez-vous au portail Azure.Sign into the Azure portal.

  2. Accédez à votre compte Azure Cosmos.Navigate to your Azure Cosmos account. Ouvrez le volet des Paramètres de Diagnostic, puis sélectionnez l’option Ajouter le paramètre de diagnostic.Open the Diagnostic settings pane, and then select Add diagnostic setting option.

    Activer la journalisation des diagnostics pour Azure Cosmos DB dans le portail Azure

  3. Sur la page Paramètres de Diagnostic, remplissez le formulaire avec les informations suivantes :In the Diagnostic settings page, fill the form with the following details:

    • Nom : Entrez un nom pour les journaux d’activité à créer.Name: Enter a name for the logs to create.

    • Vous pouvez stocker les journaux pour les services suivants :You can store the logs to the following services:

      • Archiver dans un compte de stockage : Pour utiliser cette option, vous avez besoin d’un compte de stockage existant auquel vous connecter.Archive to a storage account: To use this option, you need an existing storage account to connect to. Pour créer un compte de stockage dans le portail, consultez l’article Créez un compte de stockage.To create a new storage account in the portal, see Create a storage account article. Ensuite, revenez au volet des paramètres de diagnostic Azure Cosmos Db dans le portail pour sélectionner votre compte de stockage.Then, return to the Azure Cosmos Db diagnostic settings pane in the portal to select your storage account. L’affichage des comptes de stockage nouvellement créés dans le menu déroulant peut prendre quelques minutes.It might take a few minutes for newly created storage accounts to appear in the drop-down menu.

      • Diffuser vers un hub d’événements : pour utiliser cette option, vous avez besoin d’un espace de noms Event Hubs existant et d’un hub d’événements auquel vous connecter.Stream to an event hub: To use this option, you need an existing Event Hubs namespace and event hub to connect to. Pour créer un espace de noms Event Hubs, consultez Créer un espace de noms Event Hubs et un Event Hub à l’aide du portail Azure.To create an Event Hubs namespace, see Create an Event Hubs namespace and an event hub by using the Azure portal. Puis revenez à cette page dans le portail pour sélectionner l’espace de noms Event Hub et le nom de la stratégie.Then, return to this page in the portal to select the Event Hub namespace and policy name.

      • Envoyer à Log Analytics : pour utiliser cette option, utilisez un espace de travail existant ou créez un espace de travail Log Analytics en suivant les étapes permettant de Créer un espace de travail dans le portail.Send to Log Analytics: To use this option, either use an existing workspace or create a new Log Analytics workspace by following the steps to Create a new workspace in the portal.

    • Vous pouvez entrer les données suivantes :You can log the following data:

      • DataPlaneRequests : sélectionnez cette option pour enregistrer les requêtes de back-end pour toutes les API, dont les comptes SQL, Graph, MongoDB, Cassandra et Table dans Azure Cosmos DB.DataPlaneRequests: Select this option to log back-end requests to all APIs which includes SQL, Graph, MongoDB, Cassandra, and Table API accounts in Azure Cosmos DB. Si vous effectuez un archivage dans un compte de stockage, vous pouvez sélectionner la période de rétention des journaux de diagnostic.If you're archiving to a storage account, you can select the retention period for the diagnostic logs. Les journaux d’activité sont supprimés automatiquement après l’expiration de la période de rétention.Logs are auto-deleted after the retention period expires. Les données JSON suivantes sont un exemple de sortie d’informations enregistrées via DataPlaneRequests.The following JSON data is an example output of details logged using DataPlaneRequests. Les propriétés importantes à noter sont : Requestcharge, statusCode, clientIPaddress et partitionID :Key properties to note are: Requestcharge, statusCode, clientIPaddress, and partitionID:

        { "time": "2019-04-23T23:12:52.3814846Z", "resourceId": "/SUBSCRIPTIONS/<your_subscription_ID>/RESOURCEGROUPS/<your_resource_group>/PROVIDERS/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/<your_database_account>", "category": "DataPlaneRequests", "operationName": "ReadFeed", "properties": {"activityId": "66a0c647-af38-4b8d-a92a-c48a805d6460","requestResourceType": "Database","requestResourceId": "","collectionRid": "","statusCode": "200","duration": "0","userAgent": "Microsoft.Azure.Documents.Common/2.2.0.0","clientIpAddress": "10.0.0.24","requestCharge": "1.000000","requestLength": "0","responseLength": "372","resourceTokenUserRid": "","region": "East US","partitionId": "062abe3e-de63-4aa5-b9de-4a77119c59f8","keyType": "PrimaryReadOnlyMasterKey","databaseName": "","collectionName": ""}}
        
      • MongoRequests : sélectionnez cette option pour enregistrer les requêtes initiées par l’utilisateur depuis le serveur front-end pour servir des demandes à l’API Azure Cosmos DB pour MongoDB.MongoRequests: Select this option to log user-initiated requests from the front end to serve requests to Azure Cosmos DB's API for MongoDB. Les demandes de MongoDB apparaîtront dans MongoRequests, ainsi que dans DataPlaneRequests.MongoDB requests will appear in MongoRequests as well as DataPlaneRequests. Si vous effectuez un archivage dans un compte de stockage, vous pouvez sélectionner la période de rétention des journaux de diagnostic.If you're archiving to a storage account, you can select the retention period for the diagnostic logs. Les journaux d’activité sont supprimés automatiquement après l’expiration de la période de rétention.Logs are auto-deleted after the retention period expires. Les données JSON suivantes sont un exemple de sortie d’informations enregistrées via MongoRequests.The following JSON data is an example output of details logged using MongoRequests. Les propriétés importantes à noter sont : Requestcharge, opCode :Key properties to note are: Requestcharge, opCode:

        { "time": "2019-04-10T15:10:46.7820998Z", "resourceId": "/SUBSCRIPTIONS/<your_subscription_ID>/RESOURCEGROUPS/<your_resource_group>/PROVIDERS/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/<your_database_account>", "category": "MongoRequests", "operationName": "ping", "properties": {"activityId": "823cae64-0000-0000-0000-000000000000","opCode": "MongoOpCode_OP_QUERY","errorCode": "0","duration": "0","requestCharge": "0.000000","databaseName": "admin","collectionName": "$cmd","retryCount": "0"}}
        
      • QueryRuntimeStatistics : Sélectionnez cette option pour enregistrer le texte de requête qui a été exécuté.QueryRuntimeStatistics: Select this option to log the query text that was executed. Les données JSON suivantes sont un exemple de sortie d’informations enregistrées via QueryRuntimeStatistics :The following JSON data is an example output of details logged using QueryRuntimeStatistics:

        { "time": "2019-04-14T19:08:11.6353239Z", "resourceId": "/SUBSCRIPTIONS/<your_subscription_ID>/RESOURCEGROUPS/<your_resource_group>/PROVIDERS/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/<your_database_account>", "category": "QueryRuntimeStatistics", "properties": {"activityId": "278b0661-7452-4df3-b992-8aa0864142cf","databasename": "Tasks","collectionname": "Items","partitionkeyrangeid": "0","querytext": "{"query":"SELECT *\nFROM c\nWHERE (c.p1__10 != true)","parameters":[]}"}}
        
      • Requêtes de métrique : sélectionnez cette option pour stocker des données détaillées dans les métriques Azure.Metric Requests: Select this option to store verbose data in Azure metrics. Si vous effectuez un archivage dans un compte de stockage, vous pouvez sélectionner la période de rétention des journaux de diagnostic.If you're archiving to a storage account, you can select the retention period for the diagnostic logs. Les journaux d’activité sont supprimés automatiquement après l’expiration de la période de rétention.Logs are auto-deleted after the retention period expires.

  4. Sélectionnez Enregistrer.Select Save.

    Si vous recevez une erreur indiquant « Failed to update diagnostics for <workspace name>.If you receive an error that says "Failed to update diagnostics for <workspace name>. The subscription <subscription id> is not registered to use microsoft.insights (Échec de la mise à jour des diagnostics pour <nom de l’espace de travail>. L’abonnement <id d’abonnement> n’est pas inscrit pour utiliser microsoft.insights), suivez les instructions de la page Résoudre les problèmes de Diagnostics Azure pour inscrire le compte, puis recommencez cette procédure.The subscription <subscription id> is not registered to use microsoft.insights," follow the Troubleshoot Azure Diagnostics instructions to register the account and then retry this procedure.

    Si vous souhaitez modifier la façon dont vos journaux de diagnostic seront enregistrés à l’avenir, revenez à cette page pour modifier les paramètres de journal de diagnostic pour votre compte.If you want to change how your diagnostic logs are saved at any point in the future, return to this page to modify the diagnostic log settings for your account.

Activer la journalisation à l’aide d’Azure CLITurn on logging by using Azure CLI

Pour activer la journalisation des métriques et diagnostics à l’aide d’Azure CLI, utilisez les commandes suivantes :To enable metrics and diagnostics logging by using Azure CLI, use the following commands:

  • Pour activer le stockage des journaux de diagnostic dans un compte de stockage, utilisez cette commande :To enable storage of Diagnostic Logs in a storage account, use this command:

    az monitor diagnostic-settings create --name DiagStorage --resource <resourceId> --storage-account <storageAccountName> --logs '[{"category": "QueryRuntimeStatistics", "enabled": true, "retentionPolicy": {"enabled": true, "days": 0}}]'
    

    resource est le nom du compte Azure Cosmos DB.The resource is the name of the Azure Cosmos DB account. La ressource est au format « /subscriptions/<subscriptionId>/resourceGroups/<resource_group_name>/providers/Microsoft.DocumentDB/databaseAccounts/<Azure_Cosmos_account_name> » Le storage-account représente le nom du compte de stockage auquel vous souhaitez envoyer les journaux.The resource is in the format "/subscriptions/<subscriptionId>/resourceGroups/<resource_group_name>/providers/Microsoft.DocumentDB/databaseAccounts/<Azure_Cosmos_account_name>" The storage-account is the name of the storage account to which you want to send the logs. Vous pouvez consigner les autres journaux en mettant à jour les valeurs de paramètre de catégorie à « MongoRequests » ou « DataPlaneRequests ».You can log other logs by updating the category parameter values to "MongoRequests" or "DataPlaneRequests".

  • Pour activer la diffusion en continu des journaux de diagnostic vers un hub d’événements, utilisez cette commande :To enable streaming of Diagnostic Logs to an event hub, use this command:

    az monitor diagnostic-settings create --name cdbdiagsett --resourceId <resourceId> --event-hub-rule <eventHubRuleID> --logs '[{"category":"QueryRuntimeStatistics","enabled":true,"retentionPolicy":{"days":6,"enabled":true}}]'
    

    resource est le nom du compte Azure Cosmos DB.The resource is the name of the Azure Cosmos DB account. Le event-hub-rule correspond à l’ID de la règle du hub d’événement.The event-hub-rule is the event hub rule ID.

  • Pour activer l’envoi des journaux de diagnostic vers un espace de travail Log Analytics, utilisez cette commande :To enable sending Diagnostic Logs to a Log Analytics workspace, use this command:

    az monitor diagnostic-settings create --name cdbdiagsett --resourceId <resourceId> --workspace <resource id of the log analytics workspace> --logs '[{"category":"QueryRuntimeStatistics","enabled":true,"retentionPolicy":{"days":6,"enabled":true}}]'
    

Vous pouvez combiner ces paramètres pour activer plusieurs options de sortie.You can combine these parameters to enable multiple output options.

Activer la journalisation à l’aide de PowerShellTurn on logging by using PowerShell

Pour activer la journalisation des diagnostics à l’aide de PowerShell, vous avez besoin d’Azure PowerShell (version 1.0.1 et ultérieures).To turn on diagnostic logging by using PowerShell, you need Azure Powershell with a minimum version of 1.0.1.

Pour installer Azure PowerShell et l’associer à votre abonnement Azure, consultez l’article Installation et configuration d’Azure PowerShell.To install Azure PowerShell and associate it with your Azure subscription, see How to install and configure Azure PowerShell.

Si vous avez déjà installé Azure PowerShell et que vous ne connaissez pas la version que vous utilisez, à partir de la console PowerShell, entrez (Get-Module azure -ListAvailable).Version.If you've already installed Azure PowerShell and don't know the version, from the PowerShell console type (Get-Module azure -ListAvailable).Version.

Se connecter à vos abonnementsConnect to your subscriptions

Démarrez une session Azure PowerShell et connectez-vous à votre compte Azure avec la commande suivante :Start an Azure PowerShell session and sign in to your Azure account with the following command:

Connect-AzAccount

Dans la fenêtre contextuelle de votre navigateur, entrez votre nom d’utilisateur et votre mot de passe Azure.In the pop-up browser window, enter your Azure account user name and password. Azure PowerShell obtient alors tous les abonnements associés à ce compte et utilise par défaut le premier.Azure PowerShell gets all of the subscriptions that are associated with this account, and by default, uses the first one.

Si vous disposez de plusieurs abonnements, vous devrez peut-être en spécifier un en particulier, celui qui a été utilisé pour créer votre coffre de clés Azure.If you have more than one subscription, you might have to specify the specific subscription that was used to create your Azure key vault. Pour afficher les abonnements de votre compte, entrez la commande suivante :To see the subscriptions for your account, type the following command:

Get-AzSubscription

Ensuite, pour spécifier l’abonnement associé au compte Azure Cosmos DB que vous allez journaliser, entrez la commande suivante :Then, to specify the subscription that's associated with the Azure Cosmos DB account that you're logging, type the following command:

Set-AzContext -SubscriptionId <subscription ID>

Notes

Si plusieurs abonnements sont associés à votre compte, il est important de spécifier celui que vous souhaitez utiliser.If you have more than one subscription that's associated with your account, it's important to specify the subscription that you want to use.

Pour plus d’informations sur la configuration d’Azure PowerShell, consultez la page Installation et configuration d’Azure PowerShell.For more information about how to configure Azure PowerShell, see How to install and configure Azure PowerShell.

Création d’un nouveau compte de stockage pour vos journaux d’activitéCreate a new storage account for your logs

Bien que vous puissiez utiliser un compte de stockage existant pour vos journaux d’activité, dans ce didacticiel nous en créons un nouveau qui sera dédié à vos journaux d’activité Azure Cosmos DB.Although you can use an existing storage account for your logs, in this tutorial, we create a new storage account that's dedicated to Azure Cosmos DB logs. Pour plus de commodité, nous stockons les détails du compte de stockage dans une variable nommée sa.For convenience, we store the storage account details in a variable named sa.

Pour faciliter encore la gestion, dans ce tutoriel nous utilisons le groupe de ressources qui contient la base de données Azure Cosmos.For additional ease of management, in this tutorial, we use the same resource group as the one that contains the Azure Cosmos database. Remplacez les valeurs des paramètres ContosoResourceGroup, contosocosmosdblogs et USA Centre Nord, comme il convient :Substitute your values for the ContosoResourceGroup, contosocosmosdblogs, and North Central US parameters, as applicable:

$sa = New-AzStorageAccount -ResourceGroupName ContosoResourceGroup `
-Name contosocosmosdblogs -Type Standard_LRS -Location 'North Central US'

Notes

Si vous décidez d’utiliser un compte de stockage existant, vous devez utiliser le même abonnement que pour votre abonnement Azure Cosmos DB,If you decide to use an existing storage account, the account must use the same subscription as your Azure Cosmos DB subscription. ainsi que le modèle de déploiement Resource Manager plutôt que le modèle de déploiement Classic.The account must also use the Resource Manager deployment model, rather than the classic deployment model.

Identifier le compte Azure Cosmos DB pour vos journaux d’activitéIdentify the Azure Cosmos DB account for your logs

Définissez le nom du compte Azure Cosmos DB sur une variable nommée account, où ResourceName est le nom du compte Azure Cosmos DB.Set the Azure Cosmos DB account name to a variable named account, where ResourceName is the name of the Azure Cosmos DB account.

$account = Get-AzResource -ResourceGroupName ContosoResourceGroup `
-ResourceName contosocosmosdb -ResourceType "Microsoft.DocumentDb/databaseAccounts"

Activation de la journalisationEnable logging

Pour activer la journalisation pour Azure Cosmos DB, utilisez la cmdlet Set-AzDiagnosticSetting, ainsi que les variables pour le nouveau compte de stockage, le compte Azure Cosmos DB et la catégorie pour laquelle vous souhaitez activer les journaux.To enable logging for Azure Cosmos DB, use the Set-AzDiagnosticSetting cmdlet with variables for the new storage account, Azure Cosmos DB account, and the category to enable for logging. Exécutez la commande suivante et définissez l’indicateur -Enabled sur $true :Run the following command and set the -Enabled flag to $true:

Set-AzDiagnosticSetting  -ResourceId $account.ResourceId -StorageAccountId $sa.Id -Enabled $true -Categories DataPlaneRequests

La sortie de la commande doit ressembler à l’exemple suivant :The output for the command should resemble the following sample:

    StorageAccountId            : /subscriptions/<subscription-ID>/resourceGroups/ContosoResourceGroup/providers`
    /Microsoft.Storage/storageAccounts/contosocosmosdblogs
    ServiceBusRuleId            :
    EventHubAuthorizationRuleId :
    Metrics
        TimeGrain       : PT1M
        Enabled         : False
        RetentionPolicy
        Enabled : False
        Days    : 0
    
    Logs
        Category        : DataPlaneRequests
        Enabled         : True
        RetentionPolicy
        Enabled : False
        Days    : 0
    
    WorkspaceId                 :
    Id                          : /subscriptions/<subscription-ID>/resourcegroups/ContosoResourceGroup/providers`
    /microsoft.documentdb/databaseaccounts/contosocosmosdb/providers/microsoft.insights/diagnosticSettings/service
    Name                        : service
    Type                        :
    Location                    :
    Tags                        :

La sortie de la commande confirme que la journalisation est maintenant activée pour votre base de données et que les informations sont enregistrées dans votre compte de stockage.The output from the command confirms that logging is now enabled for your database and information is being saved to your storage account.

Si vous le souhaitez, vous pouvez également définir la stratégie de rétention pour vos journaux d’activité, par exemple la suppression automatique des anciens journaux d’activité.Optionally, you can also set the retention policy for your logs, such that older logs are automatically deleted. Spécifiez par exemple la stratégie de rétention avec l’indicateur -RetentionEnabled défini sur $true.For example, set the retention policy with the -RetentionEnabled flag set to $true. Définissez le paramètre -RetentionInDays sur 90 afin que les journaux d’activité de plus de 90 jours soient automatiquement supprimés.Set the -RetentionInDays parameter to 90 so that logs older than 90 days are automatically deleted.

Set-AzDiagnosticSetting -ResourceId $account.ResourceId`
 -StorageAccountId $sa.Id -Enabled $true -Categories DataPlaneRequests`
  -RetentionEnabled $true -RetentionInDays 90

Accéder à vos journaux d’activitéAccess your logs

Les journaux d’activité Azure Cosmos DB pour la catégorie DataPlaneRequests sont stockés dans le conteneur insights-logs-data-plane-requests du compte de stockage spécifié.Azure Cosmos DB logs for the DataPlaneRequests category are stored in the insights-logs-dataplanerequests container in the storage account that you provided.

Commencez par créer une variable pour le nom du conteneur.First, create a variable for the container name. Cette variable est utilisée tout au long de la procédure pas à pas.The variable is used throughout the walk-through.

    $container = 'insights-logs-dataplanerequests'

Pour répertorier tous les objets blob présents dans ce conteneur, saisissez :To list all of the blobs in this container, type:

Get-AzStorageBlob -Container $container -Context $sa.Context

La sortie de la commande doit ressembler à l’exemple suivant :The output for the command should resemble the following sample:

ICloudBlob        : Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob
BlobType          : BlockBlob
Length            : 10510193
ContentType       : application/octet-stream
LastModified      : 9/28/2017 7:49:04 PM +00:00
SnapshotTime      :
ContinuationToken:
Context           : Microsoft.WindowsAzure.Commands.Common.Storage.`
                    LazyAzureStorageContext
Name              : resourceId=/SUBSCRIPTIONS/<subscription-ID>/RESOURCEGROUPS/CONTOSORESOURCEGROUP/PROVIDERS`
/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/CONTOSOCOSMOSDB/y=2017/m=09/d=28/h=19/m=00/PT1H.json

Comme vous pouvez le voir dans cette sortie, les objets blob suivent une convention d’affectation de noms : resourceId=/SUBSCRIPTIONS/<subscription-ID>/RESOURCEGROUPS/<resource group name>/PROVIDERS/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/<Database Account Name>/y=<year>/m=<month>/d=<day of month>/h=<hour>/m=<minute>/filename.jsonAs you can see from this output, the blobs follow a naming convention: resourceId=/SUBSCRIPTIONS/<subscription-ID>/RESOURCEGROUPS/<resource group name>/PROVIDERS/MICROSOFT.DOCUMENTDB/DATABASEACCOUNTS/<Database Account Name>/y=<year>/m=<month>/d=<day of month>/h=<hour>/m=<minute>/filename.json

Les valeurs de date et d’heure utilisent UTC.The date and time values use UTC.

Le même compte de stockage pouvant être utilisé pour collecter les journaux d’activité de plusieurs ressources, vous pouvez utiliser l’ID complet de ressource dans le nom de l’objet blob pour accéder seulement aux objets blob dont vous avez besoin et les télécharger.Because the same storage account can be used to collect logs for multiple resources, you can use the fully qualified resource ID in the blob name to access and download the specific blobs that you need. Avant cela, nous aborderons le téléchargement de tous les objets blob.Before we do that, we cover how to download all of the blobs.

Tout d’abord, créez un dossier pour télécharger les objets blob.First, create a folder to download the blobs. Par exemple :For example:

New-Item -Path 'C:\Users\username\ContosoCosmosDBLogs'`
 -ItemType Directory -Force

Procurez-vous la liste de tous les objets blob :Then, get a list of all of the blobs:

$blobs = Get-AzStorageBlob -Container $container -Context $sa.Context

Redirigez cette liste via la commande Get-AzStorageBlobContent pour télécharger les objets blob dans le dossier de destination :Pipe this list through the Get-AzStorageBlobContent command to download the blobs into the destination folder:

$blobs | Get-AzStorageBlobContent `
 -Destination 'C:\Users\username\ContosoCosmosDBLogs'

Lorsque vous exécutez cette seconde commande, le délimiteur / présent dans les noms d’objet blob crée une structure de dossiers complète sous le dossier de destination.When you run this second command, the / delimiter in the blob names creates a full folder structure under the destination folder. Cette structure de dossiers est utilisée pour télécharger et stocker les objets blob en tant que fichiers.This folder structure is used to download and store the blobs as files.

Pour télécharger les objets blob de façon sélective, utilisez des caractères génériques.To selectively download blobs, use wildcards. Par exemple :For example:

  • Si vous disposez de plusieurs bases de données et souhaitez télécharger les journaux d’activité d’une seule d’entre elles nommée CONTOSOCOSMOSDB3, utilisez la commande suivante :If you have multiple databases and want to download logs for just one database named CONTOSOCOSMOSDB3, use the command:

    Get-AzStorageBlob -Container $container `
     -Context $sa.Context -Blob '*/DATABASEACCOUNTS/CONTOSOCOSMOSDB3
    
  • Si vous disposez de plusieurs groupes de ressources et souhaitez télécharger les journaux d’activité d’un seul d’entre eux, utilisez la commande -Blob '*/RESOURCEGROUPS/<resource group name>/*' :If you have multiple resource groups and want to download logs for just one resource group, use the command -Blob '*/RESOURCEGROUPS/<resource group name>/*':

    Get-AzStorageBlob -Container $container `
    -Context $sa.Context -Blob '*/RESOURCEGROUPS/CONTOSORESOURCEGROUP3/*'
    
  • Si vous souhaitez télécharger tous les journaux d’activité du mois de juillet 2017, utilisez la commande -Blob '*/year=2017/m=07/*' :If you want to download all of the logs for the month of July 2017, use the command -Blob '*/year=2017/m=07/*':

    Get-AzStorageBlob -Container $container `
     -Context $sa.Context -Blob '*/year=2017/m=07/*'
    

Vous pouvez également exécuter les commandes suivantes :You can also run the following commands:

  • Pour interroger l’état des paramètres de diagnostic de votre ressource de base de données, utilisez la commande Get-AzDiagnosticSetting -ResourceId $account.ResourceId.To query the status of diagnostic settings for your database resource, use the command Get-AzDiagnosticSetting -ResourceId $account.ResourceId.
  • Pour désactiver la journalisation de la catégorie DataPlaneRequests pour votre ressource de compte de base de données, utilisez la commande Set-AzDiagnosticSetting -ResourceId $account.ResourceId -StorageAccountId $sa.Id -Enabled $false -Categories DataPlaneRequests.To disable logging of the DataPlaneRequests category for your database account resource, use the command Set-AzDiagnosticSetting -ResourceId $account.ResourceId -StorageAccountId $sa.Id -Enabled $false -Categories DataPlaneRequests.

Les objets blob retournés dans chacune de ces requêtes sont stockés sous forme de blob JSON au format texte, comme indiqué dans le code suivant :The blobs that are returned in each of these queries are stored as text and formatted as a JSON blob, as shown in the following code:

{
    "records":
    [
        {
           "time": "Fri, 23 Jun 2017 19:29:50.266 GMT",
           "resourceId": "contosocosmosdb",
           "category": "DataPlaneRequests",
           "operationName": "Query",
           "resourceType": "Database",
           "properties": {"activityId": "05fcf607-6f64-48fe-81a5-f13ac13dd1eb",`
           "userAgent": "documentdb-dotnet-sdk/1.12.0 Host/64-bit MicrosoftWindowsNT/6.2.9200.0 AzureSearchIndexer/1.0.0",`
           "resourceType": "Database","statusCode": "200","documentResourceId": "",`
           "clientIpAddress": "13.92.241.0","requestCharge": "2.260","collectionRid": "",`
           "duration": "9250","requestLength": "72","responseLength": "209", "resourceTokenUserRid": ""}
        }
    ]
}

Pour en savoir plus sur les données de chaque blob JSON, consultez Interpréter vos journaux d’activité Azure Cosmos DB.To learn about the data in each JSON blob, see Interpret your Azure Cosmos DB logs.

Gérer vos journaux d’activitéManage your logs

Les journaux de diagnostic sont disponibles dans votre compte pendant les deux heures qui suivent l’opération Azure Cosmos DB.Diagnostic Logs are made available in your account for two hours from the time that the Azure Cosmos DB operation was made. C’est à vous de gérer vos journaux d’activité dans votre compte de stockage :It's up to you to manage your logs in your storage account:

  • Utilisez les méthodes de contrôle d’accès Azure standard pour assurer la sécurité de vos journaux d’activité et y limiter l’accès.Use standard Azure access control methods to secure your logs and restrict who can access them.
  • Supprimez les journaux d’activité que vous ne souhaitez plus conserver dans votre compte de stockage.Delete logs that you no longer want to keep in your storage account.
  • La période de rétention pour les demandes de plan de données archivées dans un compte de stockage est configurée dans le portail lorsque le paramètre Journaliser DataPlaneRequests est sélectionné.The retention period for data plane requests that are archived to a Storage account is configured in the portal when the Log DataPlaneRequests setting is selected. Pour modifier ce paramètre, consultez Activer la journalisation dans le portail Azure.To change that setting, see Turn on logging in the Azure portal.

Voir les journaux d’activité Azure MonitorView logs in Azure Monitor logs

Si vous avez sélectionné l’option Envoyer à Log Analytics lorsque vous avez activé la journalisation des diagnostics, les données de diagnostic de votre conteneur sont transférées aux journaux Azure Monitor dans les deux heures qui suivent.If you selected the Send to Log Analytics option when you turned on diagnostic logging, diagnostic data from your container is forwarded to Azure Monitor logs within two hours. Si vous consultez les journaux Azure Monitor immédiatement après l’activation de la journalisation, aucune donnée ne s’affichera.When you look at Azure Monitor logs immediately after you turn on logging, you won't see any data. Il vous suffit alors d’attendre deux heures et de réessayer.Just wait two hours and try again.

Avant de consulter vos journaux d’activité, vérifiez que votre espace de travail Log Analytics a été mis à niveau pour utiliser le nouveau langage de requête Kusto.Before you view your logs, check and see if your Log Analytics workspace has been upgraded to use the new Kusto query language. Pour effectuer cette vérification, ouvrez le portail Azure, sélectionnez Espaces de travail Log Analytics tout à gauche, puis sélectionnez le nom de l’espace de travail, comme indiqué dans l’image suivante.To check, open the Azure portal, select Log Analytics workspaces on the far left, then select the workspace name as shown in the next image. La page Espace de travail Log Analytics est affichée :The Log Analytics workspace page is displayed:

Journaux Azure Monitor dans le portail Azure

Notes

Les espaces de travail OMS sont désormais appelés « espaces de travail Log Analytics ».OMS workspaces are now referred to as Log Analytics workspaces.

Si le message suivant s’affiche dans la page Espace de travail Log Analytics, cela signifie que votre espace de travail n’a pas été mis à niveau pour utiliser le nouveau langage.If you see the following message on the Log Analytics workspace page, your workspace hasn't been upgraded to use the new language. Pour plus d’informations sur la mise à niveau vers le nouveau langage de requête, consultez Mise à niveau de votre espace de travail Azure Log Analytics vers la nouvelle recherche dans les journaux.For more information on how to upgrade to the new query language, see Upgrade your Azure Log Analytics workspace to new log search.

Message de mise à niveau des journaux Azure Monitor

Pour afficher vos données de diagnostic dans les journaux Azure Monitor, ouvrez la page Recherche dans les journaux à partir du menu de gauche ou de la zone de gestion de la page, comme indiqué dans l’image suivante :To view your diagnostic data in Azure Monitor logs, open the Log Search page from the left menu or the Management area of the page, as shown in the following image:

Options de recherche dans les journaux dans le portail Azure

Maintenant que vous avez activé la collecte de données, exécutez une recherche dans les journaux d’activité en utilisant le nouveau langage de requête comme indiqué dans l’exemple suivant. Cet exemple permet d’afficher les dix derniers journaux d’activité AzureDiagnostics | take 10.Now that you've enabled data collection, run the following log search example by using the new query language to see the 10 most recent logs AzureDiagnostics | take 10.

Exemple de recherche dans les 10 derniers journaux d’activité

RequêtesQueries

Voici quelques requêtes supplémentaires que vous pouvez entrer dans la zone Recherche dans les journaux. Elles vous aideront à superviser vos conteneurs Azure Cosmos.Here are some additional queries that you can enter into the Log search box to help you monitor your Azure Cosmos containers. Ces requêtes fonctionnent avec le nouveau langage.These queries work with the new language.

Pour en savoir plus sur la signification des données retournées par chaque recherche dans les journaux d’activité, consultez Interpréter vos journaux d’activité Azure Cosmos DB.To learn about the meaning of the data that's returned by each log search, see Interpret your Azure Cosmos DB logs.

  • Pour rechercher tous les journaux de diagnostic issus d’Azure Cosmos DB pour la période spécifiée :To query for all of the diagnostic logs from Azure Cosmos DB for a specified time period:

    AzureDiagnostics | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests"
    
  • Pour rechercher les 10 derniers événements journalisés :To query for the 10 most recently logged events:

    AzureDiagnostics | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | take 10
    
  • Pour rechercher toutes les opérations regroupées par type :To query for all operations, grouped by operation type:

    AzureDiagnostics | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | summarize count() by OperationName
    
  • Pour rechercher toutes les opérations regroupées par Ressource :To query for all operations, grouped by Resource:

    AzureActivity | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | summarize count() by Resource
    
  • Pour rechercher toutes les activités utilisateur regroupées par ressource :To query for all user activity, grouped by resource:

    AzureActivity | where Caller == "test@company.com" and ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | summarize count() by Resource
    

    Notes

    Cette commande concerne les journaux d’activité et non les journaux de diagnostic.This command is for an activity log, not a diagnostic log.

  • Pour rechercher les opérations durant plus de 3 millisecondes :To query for which operations take longer than 3 milliseconds:

    AzureDiagnostics | where toint(duration_s) > 3 and ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | summarize count() by clientIpAddress_s, TimeGenerated
    
  • Pour rechercher l’agent exécutant les opérations :To query for which agent is running the operations:

    AzureDiagnostics | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | summarize count() by OperationName, userAgent_s
    
  • Pour recherche le moment d’exécution des opérations de longue durée :To query for when the long running operations were performed:

    AzureDiagnostics | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests" | project TimeGenerated , duration_s | render timechart
    

Pour plus d’informations sur l’utilisation du nouveau langage de recherche dans les journaux, consultez Présentation des recherches dans les journaux Azure Monitor.For more information about how to use the new Log Search language, see Understand log searches in Azure Monitor logs.

Interpréter vos journaux d’activitéInterpret your logs

Les données de diagnostic stockées dans le stockage Azure et les journaux Azure Monitor suivent un schéma similaire.Diagnostic data that's stored in Azure Storage and Azure Monitor logs uses a similar schema.

Le tableau suivant décrit le contenu de chaque entrée de journal.The following table describes the content of each log entry.

Propriété ou champ du stockage AzureAzure Storage field or property Propriété des journaux Azure MonitorAzure Monitor logs property DescriptionDescription
timetime TimeGeneratedTimeGenerated Date et heure (UTC) de l’opération.The date and time (UTC) when the operation occurred.
resourceIdresourceId RessourceResource Le compte Azure Cosmos DB pour lequel les journaux d’activité sont activés.The Azure Cosmos DB account for which logs are enabled.
categorycategory CatégorieCategory Pour les journaux d’activité Azure Cosmos DB, DataPlaneRequests est la seule valeur disponible.For Azure Cosmos DB logs, DataPlaneRequests is the only available value.
operationNameoperationName OperationNameOperationName Nom de l’opération.Name of the operation. Cette valeur peut être l’une des opérations suivantes : Create, Update, Read, ReadFeed, Delete, Replace, Execute, SqlQuery, Query, JSQuery, Head, HeadFeed ou Upsert.This value can be any of the following operations: Create, Update, Read, ReadFeed, Delete, Replace, Execute, SqlQuery, Query, JSQuery, Head, HeadFeed, or Upsert.
propertiesproperties n/an/a Le contenu de ce champ est décrit dans les lignes suivantes.The contents of this field are described in the rows that follow.
activityIdactivityId activityId_gactivityId_g GUID unique de l’opération journalisée.The unique GUID for the logged operation.
userAgentuserAgent userAgent_suserAgent_s Chaîne qui spécifie l’agent utilisateur client effectuant la demande.A string that specifies the client user agent that's performing the request. Le format est {nom de l’agent utilisateur}/{version}.The format is {user agent name}/{version}.
requestResourceTyperequestResourceType requestResourceType_srequestResourceType_s Type de la ressource faisant l’objet de l’accès.The type of the resource accessed. Cette valeur peut être l’un des types de ressources suivants : Database, Container, Document, Attachment, User, Permission, StoredProcedure, Trigger, UserDefinedFunction ou Offer.This value can be any of the following resource types: Database, Container, Document, Attachment, User, Permission, StoredProcedure, Trigger, UserDefinedFunction, or Offer.
statusCodestatusCode statusCode_sstatusCode_s État de réponse de l’opération.The response status of the operation.
requestResourceIdrequestResourceId ResourceIdResourceId L’ID de ressource qui se rapporte à la demande.The resourceId that pertains to the request. Cette valeur peut pointer vers databaseRid, collectionRid ou documentRid en fonction de l’opération exécutée.The value may point to databaseRid, collectionRid, or documentRid depending on the operation performed.
clientIpAddressclientIpAddress clientIpAddress_sclientIpAddress_s Adresse IP du client.The client's IP address.
requestChargerequestCharge requestCharge_srequestCharge_s Nombre d’unités de requête utilisées par l’opération.The number of RUs that are used by the operation
collectionRidcollectionRid collectionId_scollectionId_s ID unique de la collection.The unique ID for the collection.
durationduration duration_sduration_s Durée de l’opération en millisecondes.The duration of the operation, in milliseconds.
requestLengthrequestLength requestLength_srequestLength_s Longueur de la demande, en octets.The length of the request, in bytes.
responseLengthresponseLength responseLength_sresponseLength_s Longueur de la réponse, en octets.The length of the response, in bytes.
resourceTokenUserRidresourceTokenUserRid resourceTokenUserRid_sresourceTokenUserRid_s Cette valeur n’est pas vide lorsque des jetons de ressource sont utilisés pour l’authentification.This value is non-empty when resource tokens are used for authentication. La valeur pointe vers l’ID de ressource de l’utilisateur.The value points to the resource ID of the user.

Étapes suivantesNext steps