Surveillez un compte Cosmos DB dans le Database Hub (aperçu)

Database Hub dans Microsoft Fabric vous aide à découvrir les comptes Azure Cosmos DB à travers les API (NoSQL, MongoDB, Cassandra, Gremlin, Table).

Conseil / Astuce

💡 Configuration d’agent pour Database Hub

Commencez à utiliser les compétences d’agent du Database Hub pour comprendre et interagir avec le Database Hub dans Fabric :

- Use [Database Hub skills](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh).
- Review [Database Hub in Fabric documentation](https://learn.microsoft.com/fabric/database/hub/)
  and use the [Microsoft Learn MCP server](https://learn.microsoft.com/api/mcp) for official docs.

Important

Cette fonctionnalité est en version préliminaire.

Surveiller Cosmos DB sur place

Vos comptes Cosmos DB restent des ressources Azure dans leurs abonnements, groupes de ressources et régions existants. Utiliser Database Hub pour la découverte et le suivi ne nécessite pas de transférer les données dans Fabric, de configurer le miroir ou d'intégrer Cosmos DB Fleet Analytics.

Les métriques du Hub de base de données décrivent le compte, sauf si une métrique ou un paramètre de filtre identifie explicitement un champ d’application plus restreint, comme une base de données ou un conteneur spécifique.

  • La surveillance Cosmos DB dans Database Hub utilise les métriques existantes de la plateforme Azure Monitor, qui sont collectées automatiquement pour chaque compte sans configuration explicite.
  • Vous n’avez pas besoin d’activer les journaux de diagnostic (ressources) ni d’intégrer Cosmos DB Fleet Analytics.
  • Azure Monitor et Fleet Analytics sont des outils distincts, à adhésion directe, pour une investigation approfondie, et ils ne sont pas nécessaires pour remplir les indicateurs de base.

Prerequisites

  • Dans la prévisualisation actuelle, demandez à un administrateur Fabric d’inscrire votre locataire dans l’expérience d’aperçu du Database Hub dans le portail d’administration Fabric. Dans Paramètres du locataire, activez Les utilisateurs peuvent accéder au hub Base de données (préversion).

  • Commencez par l’expérience gratuite en vous connectant avec votre compte professionnel ou scolaire. Vous pouvez accéder depuis le portail Azure ou directement depuis Microsoft Fabric, même si vous n'avez jamais utilisé Fabric auparavant. Authentifiez-vous avec une identité Microsoft Entra qui a accès aux abonnements Azure et aux ressources Cosmos DB avec lesquelles vous souhaitez travailler. La visibilité des ressources Azure seule ne donne pas la permission d'interroger une base de données. Database Hub utilise vos autorisations Microsoft Entra ID et Azure RBAC existantes plutôt qu’un modèle d’autorisations séparé, donc l’accès que vous attribuez ici suit les étapes standard d’attribution des rôles Azure.

    • Pour découvrir et surveiller les comptes Cosmos DB, attribuez le rôle Reader , ou un rôle avec des permissions plus élevées, dans l’étendue d’abonnement pour chaque abonnement contenant des comptes que vous souhaitez surveiller.
    • Pour créer un nouveau compte Cosmos DB depuis Database Hub, attribuez le rôle d’Opérateur Cosmos DB, ou un rôle avec des permissions plus élevées, dans le champ de répartition du groupe de ressources où le compte sera créé.
    • La gestion ou la reconfiguration d’un compte existant, comme modifier le débit, l’indexation ou les paramètres réseau, se fait en dehors du Database Hub, en utilisant le portail Azure, Azure CLI, Azure PowerShell ou un modèle Azure Resource Manager. La même identité nécessite le rôle d’Opérateur de la Base de Données Cosmos, ou un rôle avec des permissions plus élevées, dans le périmètre du compte pour y effectuer ces changements.

  • Pour interroger des données dans une base de données ou un conteneur, votre identité nécessite une assignation de rôle séparée dans le plan de données Cosmos DB (ou des clés de compte, lorsque cela est autorisé), ainsi qu’un accès réseau au compte. L’accès au niveau des ressources (plan de gestion) n’accorde pas cette permission. Pour en savoir plus, consultez Se connecter à l’aide du contrôle d’accès en fonction du rôle et de Microsoft Entra ID pour Azure Cosmos DB.

  • Database Hub respecte vos limites d’accès existantes. Le Database Hub n’accorde pas d’accès supplémentaire. Votre visibilité dans les bases de données est limitée aux ressources que votre identité actuelle est autorisée à consulter. Partager une vue ou envoyer un lien de ressource à quelqu’un ne lui donne pas accès au serveur sous-jacent.

Consultez votre domaine Cosmos DB

Conseil / Astuce

La ressource Cosmos DB représentée dans Estate est un compte de base de données, et non chaque base de données ou conteneur hébergé à l’intérieur de ce compte.

Utilisez le Database Hub pour identifier les ressources nécessitant une enquête. Continuez dans le portail Azure ou Visual Studio Code pour la configuration de compte, le travail au niveau conteneur ou les diagnostics de requêtes.

  1. Allez dans le centre de base de données dans Microsoft Fabric. Dans la navigation des bases de données, sélectionnez Aperçu.
  2. La section Que nécessite une attention ? met en évidence les parties de votre patrimoine de base de données qui nécessitent une attention. Chaque carte et chaque lien dans Nécessite votre attention mène à Estate. Dans la vue Estate, sous chaque ressource, les problèmes apparaissent dans des pastilles colorées, tandis que les suggestions apparaissent dans des pastilles accompagnées d’une icône en forme d’ampoule.
  3. Filtrez l’inventaire sur Affichage : Azure Cosmos DB. Sélectionnez les abonnements ou groupes de ressources concernés en utilisant les filtres disponibles.
  4. Recherchez le compte dont vous avez besoin, ou consultez l’inventaire filtré. Sélectionnez le compte pour consulter ses informations sur les ressources. Considérez ce compte comme la ressource Azure, et non comme une base de données ou un conteneur individuel.

Métriques de surveillance de Cosmos DB dans le Database Hub

Vue d’ensemble affiche la disponibilité et les résumés de la consommation normalisée d’unités de requête (RU) pour l’ensemble des ressources de votre compte Cosmos DB.

Pour un compte correctement dimensionné et activement utilisé, il est normal que les deux lignes se situent à 100 % ou presque la plupart du temps. Une consommation élevée de RU signifie que le compte utilise la plus grande partie, voire la totalité, de son débit alloué. Si cela convient dépend de la disponibilité dans la même fenêtre.

  • La haute disponibilité en plus signifie que les requêtes continuent de réussir et que le compte utilise pleinement ce qui est provisionné.
  • Une baisse de la disponibilité au même moment indique de véritables requêtes soumises à une limitation du débit ou en échec, puisque la consommation maximale soutenue de RU est précisément la condition qui déclenche cette limitation.

Soyez plus attentif lorsque la disponibilité tombe nettement en dessous de 100%. Faites également attention à ce que la consommation d’URI reste faible sur une longue période, ce qui peut indiquer un débit surprovisionné.

Performance vous donne un aperçu plus attentif des comptes spécifiques que vous sélectionnez explicitement. Cela n’inclut pas automatiquement tous les comptes dans Estate, et si aucun filtre n’est appliqué, le graphique Performances limite l’affichage aux 100 premières ressources afin de préserver la réactivité de la page. Avant de considérer un graphique Performance comme couvrant l’ensemble de l’Estate, confirmez quels comptes sont actuellement sélectionnés, car la sélection définie par le périmètre et l’inventaire complet de l’Estate peuvent différer.

Manquer de la télémétrie n’est pas une utilisation nulle ni une preuve qu’un compte est sain. Vérifiez si le compte a produit des données pendant l’intervalle sélectionné et si une métrique s’applique à son type d’API et à sa configuration.

Interpréter les signaux de performance de la base de données Cosmos

Signal Métrique Azure Monitor Agrégation Description
Consommation RU normalisée (pic de RU normalisé en %) NormalizedRUConsumption Maximale Utilisation de pointe des RU/s sur l’ensemble des plages de clés de partition du compte, de 0 à 100 %.
Unités de demande totales (RU totale consommée) TotalRequestUnits Total (Somme) Total des RUs consommées, sommées sur l’intervalle sélectionné.
Requêtes limitées (429) TotalRequests filtré vers StatusCode 429 Nombre Nombre brut de requêtes rejetées pour dépasser le débit provisionné.
429 Taux % TotalRequests filtré sur le code d’état 429, divisé par le nombre total de requêtes Nombre (ratio) Pourcentage de requêtes bridées pour avoir dépassé le débit provisionné.
Débit provisionné (RU/s provisionnées) ProvisionedThroughput Maximale Les RU/s provisionnées pour ce compte sur la période sélectionnée, afin de comparer la capacité provisionnée à la capacité consommée.
Latence moyenne (ms) ServerSideLatencyDirect Average Latence moyenne côté serveur en millisecondes pour les requêtes effectuées en mode connexion directe. Cela n’inclut pas la latence en mode passerelle.
Disponibilité en % ServiceAvailability Average Pourcentage de demandes réussies pendant l’intervalle.

Note

Le % de disponibilité dans Performance utilise l’agrégation Moyenne. Le résumé de disponibilité de la page Aperçu utilise plutôt l’agrégation Minimum pour mettre en évidence les valeurs aberrantes.

Les graphiques de cette page utilisent un grain horaire : une vue 24 heures trace 24 points, en utilisant l’agrégation associée. La grille utilise un grain temporel différent et réduit toute la plage sélectionnée à une seule valeur par compte et par colonne au lieu de tracer les points dans le temps. Par exemple, le RU % de norme de crête du tableau correspond au maximum observé sur l’ensemble de cette plage, et non à une ventilation heure par heure.

Pour plus d’informations, voir Surveiller Azure Cosmos DB et Indicateurs pris en charge pour Microsoft. DocumentDB/databaseAccounts.

Interpréter les différences de sécurité et de capacités dans la base de données Cosmos

La page Sécurité du Database Hub évalue trois signaux Cosmos DB :

  • Authentification Microsoft Entra ID : si un compte applique une authentification uniquement Entra ID ou permet toujours une authentification locale (basée sur des clés).
  • Clés gérées par le client (CMK) : si le chiffrement CMK est activé, ou si le compte dépend de clés gérées par le service.
  • Accès au réseau public : si un compte l’a activé.

Si un compte permet l’authentification locale ou n’a pas de CMK activé, Database Hub l’indique comme une suggestion, une amélioration optionnelle que vous pouvez faire quand vous le souhaitez. Un compte avec l’accès au réseau public activé est répertorié comme un problème, car cela est considéré comme nécessitant une intervention plus rapide.

Un signal de Base de Données reflète ce qu’il évalue actuellement, pas nécessairement l’état complet de la configuration de sécurité sous-jacente d’un compte. Par exemple, un compte sans CMK activé a toujours le chiffrement au repos par défaut via des clés gérées par Microsoft, donc un drapeau ici signifie « non activé pour cette fonctionnalité spécifique » plutôt que « non protégé ». Vérifiez la configuration actuelle du compte dans le portail Azure avant d'agir sur une conclusion. Voir Configurer les clés gérées par le client pour Azure Cosmos DB et Chiffrement au repos dans Azure Cosmos DB pour plus d’informations.

Ces signaux de sécurité offrent une vue rapide pour vous aider à trier. Pour une évaluation complète de la sécurité et une correction, utilisez des services comme Microsoft Defender for Cloud et les journaux de diagnostic de votre compte en plus de Database Hub.

Poursuivre l’enquête dans le portail Azure

Vous pouvez utiliser le portail Azure pour approfondir d'éventuels problèmes, par exemple pour comparer les métriques du même compte côte à côte dans Database Hub et le portail Azure.

Conseil / Astuce

Utilisez l’extension Visual Studio Code Cosmos DB pour le travail sur les plans de données comme la requête et la gestion de documents, mais pas pour examiner les métriques de performance.

  1. Sélectionnez le compte Cosmos DB prévu dans Database Hub. Un volet pour cet élément s’ouvre dans le Centre de base de données.
  2. Sélectionnez le bouton Ouvrir le portail Azure.
  3. Allez dans l’onglet Insights et définissez la plage de temps. Comparez les indicateurs pertinents sur un intervalle de suivi approprié.

Lors de la préversion actuelle, l'onglet Insights du portail Azure propose un éventail plus large de graphiques et de métriques ; utilisez-le donc pour les signaux que Database Hub n'affiche pas encore.

Enquêter sur les résultats de sécurité de Cosmos DB

  1. Sélectionnez l’alerte Cosmos DB dans le résumé de sécurité ou le compte concerné dans Estate, le cas échéant.

  2. Confirmez le compte concerné, le nom de l’évaluation, le cadre évalué et tout temps d’observation disponible. Vérifiez la recommandation par rapport à la politique de votre organisation.

  3. Ouvrez le compte dans le portail Azure et vérifiez sa configuration actuelle. Pour l’authentification Microsoft Entra, les clés gérées par le client ou l’accès au réseau public, suivez la documentation correspondante du service Cosmos DB.

  4. Évaluez l’impact de la candidature et obtenez l’approbation requise avant de faire un changement.

  5. Après la fin du changement autorisé, vérifiez les paramètres dans le portail Azure. Permettre une réévaluation et rafraîchir le Database Hub ; si la découverte persiste, comparer ses preuves avec la configuration du compte courant.

Dépannage des données de Cosmos DB dans Database Hub

  • Si un compte de base de données Cosmos n'apparaît pas dans Estate, vérifiez le locataire connecté, l'accès Azure, le type de ressource, les filtres d'inventaire et l'autorisation.
  • Si des indicateurs de performance manquent ou diffèrent entre Azure Monitor et le Database Hub :
    • Choisissez un intervalle de temps pendant lequel le compte servait activement les requêtes. Vérifiez si la métrique s'applique au type d'API du compte ; par exemple, la correspondance 429 diffère entre NoSQL (StatusCode 429) et l'API MongoDB (code d'erreur 16500).
    • Ouvrez le même compte dans le portail Azure et inspectez la métrique Azure Monitor correspondante sous l’onglet Insights. Ajustez aussi précisément que possible le fuseau horaire, les heures de début et de fin, l’agrégation et la granularité.
    • Si la métrique est absente aux deux endroits, vérifiez l’activité du compte et prévoyez un délai de traitement.
    • Si Azure Monitor a des données mais que Database Hub non, rafraîchissez la vue Database Hub et réessayez avec ce compte seul. Si la différence persiste, contactez le support.

Limitations

  • Cosmos DB Fleet Analytics n’est actuellement pas pris en charge dans Database Hub.
  • La version preview actuelle ne prend en charge que les comptes Azure Cosmos DB. Dans l'aperçu actuel, Cosmos DB dans Fabric n'est pas actuellement pris en charge.
  • Dans la prévisualisation actuelle, Aperçu et Performance présentent un sous-ensemble sélectionné des métriques disponibles dans Azure Monitor.
  • Dans l’aperçu actuel, les alertes Activator sur les métriques de la base de données Cosmos ne sont pas disponibles.

Contenu connexe

  • Dernière mise à jour :