Surveiller Azure Cosmos DB

Cet article aborde les points suivants :

• Types de données de monitoring que vous pouvez collecter pour ce service.
• Comment analyser ces données.

Quand vous avez des applications critiques et des processus métier qui s’appuient sur des ressources Azure, vous devez monitorer votre système et obtenir des alertes. Le service Azure Monitor collecte et agrège les métriques et les journaux de chaque composant de votre système. Azure Monitor vous fournit une vue de la disponibilité, des performances et de la résilience, et vous avertit des problèmes. Vous pouvez utiliser le portail Azure, PowerShell, Azure CLI, l’API REST ou des bibliothèques de client pour configurer et visualiser les données de monitoring.

• Pour plus d’informations sur Azure Monitor, consultez la vue d’ensemble d’Azure Monitor.
• Pour plus d’informations sur le monitoring des ressources Azure en général, consultez Monitorer les ressources Azure avec Azure Monitor.

Informations

Dans Azure, certains services ont un tableau de bord de monitoring intégré dans le portail Azure, qui constitue un point de départ pour le monitoring de votre service. Ces tableaux de bord sont appelés insights et vous pouvez les trouver dans le Hub d’insights d’Azure Monitor dans le portail Azure.

Insights Azure Cosmos DB

Azure Cosmos DB Insights est une fonctionnalité basée sur la fonctionnalité de classeurs d’Azure Monitor. Utilisez Azure Cosmos DB Insights pour avoir une vue des performances, des défaillances, de la capacité et de l’intégrité opérationnelle globales de toutes vos ressources Azure Cosmos DB dans une expérience interactive unifiée.

Pour plus d’informations sur Azure Cosmos DB Insights, consultez les articles suivants :

• Explorer Azure Cosmos DB Insights
• Surveiller et déboguer à l’aide d’insights dans Azure Cosmos DB.

Types de ressource

Azure utilise le concept de types de ressources et d’ID pour identifier tout dans un abonnement. Les types de ressource font également partie des ID de ressource pour chaque ressource exécutée dans Azure. Par exemple, le type de ressource pour une machine virtuelle peut être Microsoft.Compute/virtualMachines. Pour obtenir la liste des services et leurs types de ressource associés, consultez Fournisseurs de ressources.

Azure Monitor organise de même manière les données de supervision de base en métriques et journaux en fonction des types de ressources, également appelés espaces de noms. Différentes métriques et journaux sont disponibles pour les différents types de ressource. Votre service peut être associé à plusieurs types de ressource.

Pour plus d’informations sur les types de ressources pour Azure Cosmos DB, consultez Informations de référence sur les données de surveillance Azure Cosmos DB.

Stockage des données

Pour Azure Monitor :

• Les données de métriques sont stockées dans la base de données des métriques Azure Monitor.
• Les données de journal sont stockées dans le magasin de journaux Azure Monitor. Log Analytics est un outil du portail Azure qui peut interroger ce magasin.
• Le journal d’activité Azure est un magasin distinct avec sa propre interface dans le portail Azure.

Vous pouvez aussi envoyer les données des métriques et des journaux d’activité vers le magasin de journaux Azure Monitor. Vous pouvez ensuite utiliser Log Analytics pour interroger les données et les mettre en corrélation avec d’autres données de journal.

De nombreux services peuvent utiliser les paramètres de diagnostic pour envoyer les données des métriques et des journaux vers d’autres emplacements de stockage en dehors d’Azure Monitor. Il peut ainsi s’agit du Stockage Azure, des systèmes partenaires hébergés et des systèmes partenaires non-Azure, en utilisant Event Hubs.

Pour plus d’informations sur la façon dont Azure Monitor stocke les données, consultez Plateforme de données Azure Monitor.

Métriques de plateforme Azure Monitor

Azure Monitor fournit des métriques de plateforme pour la plupart des services. Ces mesures sont :

• Définies individuellement pour chaque espace de noms.
• Stockées dans la base de données de métriques de série chronologique Azure Monitor.
• Légères et capables de prendre en charge les alertes en quasi-temps réel.
• Utilisées pour suivre les performances d’une ressource au fil du temps.

Collecte : Azure Monitor collecte automatiquement les métriques de plateforme. Aucune configuration n'est requise.

Routage : vous pouvez également acheminer certaines mesures de plateforme vers Azure Monitor Logs/Log Analytics afin de pouvoir les interroger avec d’autres données de journal. Vérifiez le paramètre d’exportation DS pour chaque métrique pour voir si vous pouvez utiliser un paramètre de diagnostic pour acheminer la métrique vers Azure Monitor Logs/Log Analytics.

• Pour plus d’informations, consultez le paramètre de diagnostic des métriques.
• Pour configurer les paramètres de diagnostic d’un service, consultez Créer des paramètres de diagnostic dans Azure Monitor.

Pour obtenir la liste de toutes les métriques qu’il est possible de collecter pour toutes les ressources dans Azure Monitor, consultez Métriques prises en charge dans Azure Monitor.

Azure Monitor collecte les métriques Azure Cosmos DB par défaut. Vous n’avez pas besoin de configurer explicitement quoi que ce soit. La plupart des métriques sont disponibles dans la page du portail Azure Cosmos DB ou dans la page Azure Monitor. Par défaut, les métriques sont collectées avec une précision d’une minute. La granularité peut varier en fonction de la mesure que vous choisissez. Pour plus d’informations sur la période de rétention par défaut, consultez Rétention des métriques Azure Monitor

Les métriques Azure Cosmos DB côté serveur comprennent le débit, le stockage, la disponibilité, la latence, la cohérence et les métriques de niveau système. Côté client, vous pouvez collecter des détails sur les frais de requête, l’ID d’activité, des informations sur l’arborescence des appels de procédure et sur les exceptions, le code d’état et de sous-état HTTP, et la chaîne de diagnostic. Par défaut, la période de conservation de ces métriques est de sept jours. Vous pouvez utiliser ces données pour déboguer des problèmes ou si vous devez contacter l’équipe du support technique Azure Cosmos DB.

Les valeurs de dimension des mesures, comme le nom du conteneur, ne respectent pas la casse. Cette situation peut entraîner une confusion ou une collision des données de télémétrie et des actions sur les conteneurs portant de tels noms. Utilisez une comparaison non sensible à la casse lorsque vous effectuez des comparaisons de chaînes sur ces valeurs de dimension.

Pour obtenir la liste des métriques disponibles pour Azure Cosmos DB, consultez Informations de référence sur les données de surveillance Azure Cosmos DB.

Métriques non basées sur Azure Monitor

Ce service fournit d’autres métriques qui ne sont pas comprises dans la base de données de métriques Azure Monitor.

• Pour plus d’informations sur les solutions et outils partenaires qui peuvent contribuer à la surveillance d’Azure Cosmos DB, consultez Surveiller Azure Cosmos DB à l’aide de solutions tierces.
• Pour implémenter des métriques Micrometer dans le SDK Java pour Azure Cosmos DB en consommant des métriques Prometheus, consultez Utiliser les métriques du client Micrometer pour Java.

Journaux de ressources Azure Monitor

Les journaux de ressource fournissent des insights sur les opérations effectuées par une ressource Azure. Les journaux sont générés automatiquement, mais vous devez les router vers les journaux Azure Monitor pour les enregistrer ou les interroger. Les journaux d’activité sont organisés en catégories. Un espace de noms donné peut avoir plusieurs catégories de journal de ressource.

Collecte : les journaux de ressource ne sont pas collectés ni stockés tant que vous n’avez pas créé un paramètre de diagnostic et routé les journaux vers un ou plusieurs emplacements. Lorsque vous créez un paramètre de diagnostic, vous spécifiez les catégories de journaux à collecter. Il existe plusieurs façons de créer et gérer des paramètres de diagnostic, notamment le portail Azure, programmatiquement et avec Azure Policy.

Routage : la valeur par défaut suggérée est le routage des journaux de ressource vers les journaux Azure Monitor afin de pouvoir les interroger avec d’autres données de journal. D’autres emplacements comme le Stockage Azure, Azure Event Hubs et certains partenaires de monitoring de Microsoft sont également disponibles. Pour plus d’informations, consultez Journaux de ressource Azure et Destinations des journaux de ressource.

Pour plus d’informations sur la collecte, le stockage et le routage des journaux de ressource, consultez Paramètres de diagnostic dans Azure Monitor.

Pour obtenir la liste de toutes les catégories de journal de ressource disponibles dans Azure Monitor, consultez Journaux de ressource pris en charge dans Azure Monitor.

Tous les journaux de ressource dans Azure Monitor ont les mêmes champs d’en-tête, suivis de champs propres au service. Le schéma commun est décrit dans Schéma des journaux des ressources Azure Monitor.

Vous pouvez superviser les journaux de diagnostic de votre compte Azure Cosmos DB et créer des tableaux de bord à partir d’Azure Monitor. Les données, traces et autres données de télémétrie avec une précision d’une seconde sont stockés sous forme de journaux. Par exemple, si le débit d’un conteneur change, les propriétés d’un compte Azure Cosmos DB changent. Les journaux capturent ces événements. Vous pouvez analyser ces journaux en exécutant des requêtes sur les données collectées.

Pour les catégories de journaux de ressources disponibles, leurs tableaux Log Analytics associés et les schémas des journaux pour Azure Cosmos DB, consultez Informations de référence sur les données de surveillance Azure Cosmos DB.

Journal des activités Azure

Le journal d’activité contient des évènements au niveau de l’abonnement qui suivent les opérations sur chaque ressource Azure qui sont vues comme extérieures à cette ressource, par exemple, la création d’une ressource ou le démarrage d’une machine virtuelle.

Collecte : les évènements de journal d’activité sont générés et collectés automatiquement dans un magasin distinct pour leur consultation dans le portail Azure.

Routage : vous pouvez envoyer les données de journal d’activité aux journaux Azure Monitor afin de pouvoir les analyser en même temps que d’autres données de journal. D’autres emplacements comme le Stockage Azure, Azure Event Hubs et certains partenaires de monitoring de Microsoft sont également disponibles. Pour plus d’informations sur le routage du journal d’activité, consultez Vue d’ensemble du journal d’activité Azure.

Auditer les actions de restauration pour le mode de sauvegarde continue

En utilisant les journaux d’activité, vous pouvez lister toutes les restaurations à un instant dans le passé qui ont été effectuées en mode de sauvegarde continue sur un compte Azure Cosmos DB. Pour savoir comment afficher ces opérations dans le portail Azure, consultez Auditer l’action de restauration dans le temps pour le mode de sauvegarde continue.

Analyser les données de surveillance

Il existe de nombreux outils pour analyser les données de supervision.

Outils Azure Monitor

Azure Monitor prend en charge les outils de base suivants :

• Metrics Explorer, un outil du portail Azure qui vous permet de voir et d’analyser les métriques des ressources Azure. Pour plus d’informations, consultez Analyser les métriques avec l’Explorateur de métriques Azure Monitor.

• Log Analytics, un outil du portail Azure qui vous permet d’interroger et d’analyser les données de journal en utilisant le langage de requête Kusto (KQL). Pour plus d’informations, voir Bien démarrer avec les requêtes de journal dans Azure Monitor.

• Le journal d’activité, qui a une interface utilisateur dans le portail Azure pour la consultation et les recherches de base. Pour effectuer une analyse plus approfondie, vous devez router les données vers les journaux Azure Monitor et exécuter des requêtes plus complexes dans Log Analytics.

Les outils qui permettent une visualisation plus complexe sont notamment :

• Les tableaux de bord, qui vous permettent de combiner différentes sortes de données dans un même volet du portail Azure.
• Les workbooks, des rapports personnalisables que vous pouvez créer dans le portail Azure. Les workbooks peuvent inclure du texte, des métriques et des requêtes de journal.
• Grafana, un outil de plateforme ouvert, parfait pour les tableaux de bord opérationnels. Vous pouvez utiliser Grafana pour créer des tableaux de bord à partir de données de plusieurs sources autres qu’Azure Monitor.
• Power BI, un service d’analyse métier qui fournit des visualisations interactives pour diverses sources de données. Vous pouvez configurer Power BI pour importer automatiquement les données de journal à partir d’Azure Monitor afin de tirer parti de ces visualisations supplémentaires.

Outils d’exportation Azure Monitor

Vous pouvez extraire des données d’Azure Monitor dans d’autres outils en utilisant les méthodes suivantes :

• Métriques : utilisez l’API REST pour les métriques pour extraire les données de métriques de la base de données de métriques Azure Monitor. L’API prend en charge les expressions de filtre pour affiner les données récupérées. Pour plus d’informations, consultez Informations de référence sur l’API REST Azure Monitor.

• Journaux : utilisez l’API REST ou les bibliothèques de client associées.

• Une autre option est l’exportation des données d’espace de travail.

Pour bien démarrer avec l’API REST pour Azure Monitor, consultez Procédure pas à pas de l’API REST d’analyse Azure.

Analyser les métriques Azure Cosmos DB

Vous pouvez utiliser Azure Monitor Metrics Explorer afin d’analyser les métriques d’Azure Cosmos DB avec les métriques d’autres services Azure en sélectionnant Métriques sous Surveillance dans la navigation du portail de votre compte Azure Cosmos DB. Pour plus d’informations sur l’utilisation de Metrics Explorer, consultez Analyser les métriques avec Azure Monitor Metrics Explorer.

Vous pouvez surveiller la latence côté serveur, l’utilisation des unités de requête et l’utilisation des unités de requêtes normalisées pour vos ressources Azure Cosmos DB. Vous pouvez sélectionner des métriques propres aux unités de requête, au stockage, à la latence, à la disponibilité, à Cassandra, etc.

Côté client, vous pouvez déboguer les problèmes en collectant les métriques pour les frais de requête, l’ID d’activité, les informations sur l’arborescence des appels de procédure et sur les exceptions, le code d’état et de sous-état HTTP, et la chaîne de diagnostic.

Pour obtenir des informations supplémentaires et des instructions détaillées, consultez les articles suivants :

• Surveiller la latence côté serveur
• Surveiller l’utilisation des unités de requête
• Surveiller l’utilisation des unités de requête normalisées

Pour obtenir la liste de toutes les métriques de ressources prises en charge dans Azure Monitor, consultez Métriques Azure Monitor prises en charge. Pour obtenir la liste des mesures de plateforme collectées pour Azure Cosmos DB, consultez l’article Analyse des mesures de référence de données Cosmos DB.

Surveiller un compte Azure Cosmos DB par programme

Les mesures au niveau du compte disponibles dans le portail, par exemple les demandes d'utilisation du stockage du compte et de total, ne sont pas disponibles via l’API pour NoSQL. Toutefois, vous pouvez extraire des données d'utilisation au niveau de la collection à l’aide de l’API pour NoSQL. Pour récupérer des données au niveau de la collection, utilisez l’une des approches suivantes :

• Pour utiliser l’API REST, effectuez une opération GET sur la collection. Les informations de quota et d'utilisation de la collection sont retournées dans les en-têtes x-ms-resource-quota et x-ms-resource-usage de la réponse.

• Pour utiliser le kit de développement logiciel (SDK) .NET, utilisez la méthode DocumentClient.ReadDocumentCollectionAsync, qui retourne une valeur ResourceResponse contenant de nombreuses propriétés d’utilisation, notamment CollectionSizeUsage, DatabaseUsage et DocumentUsage.

Pour accéder à des mesures supplémentaires, utilisez le Kit de développement logiciel (SDK) Azure Monitor. Les définitions de mesures disponibles peuvent être récupérées à l’aide de ce format :

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

Pour récupérer des métriques individuelles, utilisez le format suivant :

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

Pour plus d’informations, consultez l’article API REST de supervision Azure.

Analyser les journaux Azure Cosmos DB

Les données des journaux Azure Monitor sont stockées dans des tables. Chaque table possède son propre ensemble de propriétés uniques. Tous les journaux de ressources dans Azure Monitor ont les mêmes champs suivis de champs spécifiques au service. Le schéma commun est décrit dans Schéma des journaux des ressources Azure Monitor.

Pour les types de journaux de ressources collectés pour Azure Cosmos DB, consultez Informations de référence sur les données de surveillance Azure Cosmos DB.

Pour plus d’informations sur l’utilisation des journaux Azure Monitor pour Azure Cosmos DB, consultez les articles suivants :

• Surveiller les données à l’aide des paramètres de diagnostic Azure
• Auditer les journaux du plan de contrôle
• Ajouter une transformation pour les données d’espace de travail

Requêtes Kusto

Vous pouvez analyser les données de supervision dans les journaux Azure Monitor ou le magasin Log Analytics à l’aide du langage de requête Kusto (KQL).

Pour obtenir la liste des requêtes courantes pour n’importe quel service, consultez l’Interface de requêtes Log Analytics.

Avant d’utiliser Log Analytics pour émettre des requêtes Kusto, vous devez Activer les journaux de diagnostic pour les opérations en plan de contrôle. Lorsque vous activez les journaux de diagnostic, vous choisissez entre stocker vos données dans des tables spécifiques aux ressources ou dans la table Azure Diagnostics (héritée). Le texte exact des requêtes Kusto dépend du mode de collection que vous sélectionnez.

• Consultez Résoudre les problèmes liés aux requêtes de diagnostic pour des requêtes simples vous aidant à résoudre les problèmes liés à Azure Cosmos DB.
• Consultez Résoudre les problèmes liés aux requêtes de diagnostic avancées avec Azure Cosmos DB pour noSQL pour des requêtes plus avancées pour vous aider à résoudre les problèmes de votre compte Azure Cosmos DB en utilisant les journaux de diagnostic envoyés aux tables Diagnostics Azure (hérité) et spécifiques aux ressources (préversion).

Voici quelques requêtes que vous pouvez entrer dans la barre de recherche Recherche dans les journaux pour superviser plus facilement vos ressources Azure Cosmos DB.

CDBControlPlaneRequests

CDBDataPlaneRequests

CDBDataPlaneRequests
| where AccountName=="<account-name>"

CDBDataPlaneRequests
| summarize count() by AccountName

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="ControlPlaneRequests"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| where Resource=="<account-name>"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| summarize count() by Resource

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| summarize count() by OperationName
| render columnchart

Pour les requêtes Kusto que vous pouvez utiliser pour résoudre les problèmes liés à Azure Cosmos DB, consultez les articles suivants :

• Résoudre les problèmes avec des requêtes simples
• Résoudre les problèmes avec des requêtes de diagnostic avancées

Ces exemples ne sont qu’un petit échantillon des requêtes riches que vous pouvez exécuter dans Azure Monitor à l’aide du langage de requête Kusto (KQL). Pour obtenir d’autres exemples, consultez Exemples de requêtes Kusto.

Alertes

Azure Monitor vous alerte de façon proactive quand des conditions spécifiques sont détectées dans vos données de monitoring. Les alertes permettent d’identifier et de résoudre les problèmes affectant votre système avant que vos clients ne les remarquent. Pour plus d’informations, consultez Alertes Azure Monitor.

Il existe de nombreuses sources d’alertes courantes pour les ressources Azure. Pour obtenir des exemples d’alertes courantes pour les ressources Azure, consultez Exemples de requêtes d’alerte de journal. Le site Azure Monitor Baseline Alerts (AMBA) fournit une méthode semi-automatisée pour implémenter les alertes, les tableaux de bord et les recommandations associés·es les plus importants·es aux métriques de plateforme. Le site s’applique à un sous-ensemble des services Azure en constante expansion, y compris tous les services qui font partie de la zone d’atterrissage Azure (ALZ).

Le schéma d’alerte commun standardise la consommation de notifications d'alerte pour Azure Monitor. Pour plus d’informations, consultez Schéma d’alerte courant.

Types d'alertes

Vous pouvez définir une alerte sur n’importe quelle source de données de métrique ou de journal dans la plateforme de données Azure Monitor. Il existe de nombreux types d’alertes différents en fonction des services que vous monitorez et des données de monitoring que vous collectez. Les différents types d’alertes ont divers avantages et inconvénients. Pour plus d’informations, consultez Choisir le bon type d’alerte de monitoring.

La liste suivante décrit les types d’alertes Azure Monitor que vous pouvez créer :

• Les alertes de métrique évaluent les métriques de ressource à intervalles réguliers. Les métriques peuvent être des métriques de plateforme, des métriques personnalisées, des journaux provenant d’Azure Monitor convertis en métriques ou des métriques Application Insights. Les alertes de métriques peuvent également appliquer plusieurs conditions et seuils dynamiques.
• Les alertes de journal permettent aux utilisateurs d’utiliser une requête Log Analytics pour évaluer les journaux de ressource à une fréquence prédéfinie.
• Les alertes de journal d’activité sont déclenchées quand un nouvel événement de journal d’activité correspond à des conditions définies. Les alertes Resource Health et les alertes Service Health sont des alertes de journal d’activité qui concernent l’intégrité de votre service et de vos ressources.

Certains services Azure prennent également en charge les alertes de détection intelligente, les alertes Prometheus ou les règles d’alerte recommandées.

Pour certains services, vous pouvez opérer une surveillance à grande échelle en appliquant la même règle d’alerte de métrique à plusieurs ressources du même type qui existent dans la même région Azure. Les notifications individuelles sont envoyées pour chaque ressource supervisée. Pour connaître les services et clouds Azure pris en charge, consultez Monitorer plusieurs ressources avec une seule règle d’alerte.

Règles d’alerte Azure Cosmos DB

Le tableau suivant liste quelques règles d’alerte courantes et recommandées pour Azure Cosmos DB.

Pour plus d’informations et d’instructions sur la création d’alertes pour Azure Cosmos DB, consultez Créer une alerte sur des métriques. Pour créer une alerte afin de surveiller si le stockage d’une clé de partition logique approche de 20 Go, consultez Créer une alerte sur la taille de la clé de partition logique.

Recommandations d’Advisor

Pour certains services, si des conditions critiques ou des changements imminents se produisent pendant des opérations de ressources, une alerte s’affiche dans la page Vue d’ensemble du service concerné dans le portail. Des informations supplémentaires et les correctifs recommandés pour l’alerte sont disponibles dans les Recommandations Advisor sous Surveillance dans le menu de gauche. Pendant les opérations normales, aucune recommandation Advisor ne s’affiche.

Pour plus d’informations sur Azure Advisor, consultez Vue d’ensemble d’Azure Advisor.

Contenu connexe

• Consultez Informations de référence sur les données de surveillance Azure Cosmos DB pour obtenir une référence des métriques, des journaux et d’autres valeurs importantes créées pour Azure Cosmos DB.
• Pour obtenir des informations générales sur la supervision des ressources Azure, consultez Supervision de ressources Azure avec Azure Monitor.