Lire en anglais

Partager via

Surveiller Azure Cosmos DB

  • Article

Cet article aborde les points suivants :

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

Notes

Si vous connaissez déjà ce service et/ou Azure Monitor et que vous voulez simplement savoir comment analyser les données de monitoring, consultez la section Analyser vers la fin de cet article.

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.

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 :

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

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 :

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 :

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 :

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

HTTP 
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 :

HTTP 
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 :

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

Important

Quand vous sélectionnez Journaux dans le menu du service dans le portail, Log Analytics s’ouvre avec l’étendue de requête définie sur le service actuel. Cette étendue signifie que les requêtes de journal ont seulement des données de ce type de ressource. Si vous voulez exécuter une requête qui comprend des données d’autres services Azure, sélectionnez Journaux dans le menu Azure Monitor. Pour plus d’informations, consultez Étendue de requête de journal et intervalle de temps dans la fonctionnalité Log Analytics d’Azure Monitor.

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.

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.

Pour rechercher tous les journaux de plan de contrôle à partir d’Azure Cosmos DB :

Kusto 
CDBControlPlaneRequests

Pour rechercher tous les journaux de plan de données à partir d’Azure Cosmos DB :

Kusto 
CDBDataPlaneRequests

Pour rechercher une liste filtrée de journaux de plan de données pour une ressource spécifique :

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

Pour obtenir le nombre de journaux de plan de données, regroupés par ressource :

Kusto 
CDBDataPlaneRequests
| summarize count() by AccountName

Pour générer un graphique pour les journaux de plan de données, regroupés selon le type d’opération :

Kusto 
CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

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

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.

Type d’alerte Condition Description
Limitation du taux sur les unités de requête (alerte de métrique) Nom de la dimension : StatusCode, Opérateur : Equals, Valeurs de dimension : 429 Émet une alerte si le conteneur ou une base de données a dépassé la limite de débit provisionnée.
Région basculée Opérateur : Supérieur à, Type d’agrégation : Nombre, Valeur de seuil : 1 Quand une seule région est basculée. Cette alerte est utile si vous n'avez pas activé le basculement géré par le service.
Rotation de clés (alerte de journal d’activité) Niveau de l’événement : Informationnel, État : Démarré Émet une alerte quand les clés de compte sont permutées. Vous pouvez mettre à jour votre application avec les nouvelles clés.

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