Monitorizar una cuenta de Cosmos DB en el Centro de Base de Datos (vista previa)

Database Hub en Microsoft Fabric te ayuda a descubrir cuentas de Azure Cosmos DB en diferentes APIs (NoSQL, MongoDB, Cassandra, Gremlin, Table).

Sugerencia

💡 Configuración de agentes para Database Hub

Empieza a utilizar las habilidades de los agentes del Database Hub para entender e interactuar con el Database Hub en 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

Esta característica se encuentra en versión preliminar.

Monitorizar la base de datos Cosmos en el lugar

Tus cuentas de Cosmos DB siguen siendo recursos de Azure en sus suscripciones, grupos de recursos y regiones existentes. Usar Database Hub para el descubrimiento y monitorización no requiere mover datos a Fabric, configurar el espejamiento o incorporar a Cosmos DB Fleet Analytics.

Las métricas del Hub de Bases de Datos describen la cuenta a menos que una métrica o parámetro de filtro identifique explícitamente un alcance más limitado, como una base de datos o contenedor específico.

  • La monitorización de Cosmos DB en Database Hub utiliza métricas existentes de la plataforma Azure Monitor, que se recopilan automáticamente para cada cuenta sin una configuración explícita.
  • No necesitas habilitar los registros de diagnóstico (recursos) ni incorporarte a Cosmos DB Fleet Analytics.
  • Azure Monitor y Fleet Analytics son herramientas separadas y optables para una investigación más profunda, y no son necesarias para completar métricas de referencia.

Prerequisites

  • En la versión preliminar actual, pídele a un administrador de Fabric que incluya tu inquilino en la versión preliminar de Database Hub en el portal de administración de Fabric. En la configuración de inquilinos, activar Los usuarios pueden acceder al hub de base de datos (vista previa).

  • Empieza con la experiencia gratuita iniciando sesión con tu cuenta de trabajo o de estudios. Puedes acceder desde el portal de Azure o directamente desde Microsoft Fabric, incluso si no has usado Fabric antes. Autentica con una identidad de Microsoft Entra que tenga acceso a las suscripciones de Azure y a los recursos de Cosmos DB con los que quieres trabajar. La visibilidad de recursos de Azure por sí sola no otorga permiso para consultar una base de datos. Database Hub utiliza tus permisos existentes de Microsoft Entra ID y Azure RBAC en lugar de un modelo de permisos separado, por lo que el acceso que asignas aquí sigue los pasos estándar de asignación de roles de Azure.

    • Para descubrir y monitorizar cuentas de Cosmos DB, asigna el rol de Lector , o un rol con mayores permisos, en el alcance de la suscripción para cada suscripción que contenga cuentas que quieras monitorizar.
    • Para crear una nueva cuenta de Cosmos DB desde Database Hub, asigna el rol de Operador de Cosmos DB, o un rol con mayores permisos, en el ámbito del grupo de recursos donde se creará la cuenta.
    • La gestión o reconfiguración de una cuenta existente, como cambiar el rendimiento, indexar o configurar la red, se realiza fuera del Database Hub, utilizando el portal de Azure, CLI de Azure, Azure PowerShell o una plantilla de Azure Resource Manager. La misma identidad necesita el rol de Operador de la Base de Datos de Cosmos, o un rol con mayores permisos, en el ámbito de la cuenta para realizar estos cambios allí.

  • Para consultar datos en una base de datos o contenedor, tu identidad necesita una asignación de roles separada en el plano de datos de Cosmos DB (o claves de cuenta, cuando se permita), además de acceso en red a la cuenta. El acceso a nivel de recurso (plano de gestión) no concede este permiso. Para obtener más información, consulta Conexión mediante control de acceso basado en roles y Microsoft Entra ID para Azure Cosmos DB.

  • Database Hub respeta tus límites de acceso existentes. El Centro de Base de Datos no concede acceso adicional. Tu visibilidad en bases de datos está limitada a los recursos que tu identidad actual esté autorizada a consultar. Compartir una vista o enviar a alguien un enlace de recurso no le da acceso al servidor subyacente.

Consulta tu entorno de Cosmos DB

Sugerencia

El recurso de Cosmos DB representado en Estate es una cuenta de base de datos, no todas las bases de datos o contenedores alojados dentro de esa cuenta.

Utiliza el Centro de Bases de Datos para identificar recursos que necesitan investigación. Continúa en el portal de Azure o en Visual Studio Code para la configuración de cuentas, trabajo a nivel de contenedor o diagnósticos de consultas.

  1. Ve al centro de bases de datos en Microsoft Fabric. En la navegación de bases de datos, selecciona Resumen.
  2. La sección ¿Qué necesita atención? señala partes de tu patrimonio de base de datos que necesitan atención. Todas las tarjetas y enlaces de ¿Qué necesita atención? llevan a Estate. En la vista Estate, debajo de cada recurso, las incidencias aparecen en chips de distintos colores, mientras que las sugerencias aparecen en chips con el icono de una bombilla.
  3. Filtra el inventario a Ver: Azure Cosmos DB. Selecciona las suscripciones o grupos de recursos relevantes utilizando los filtros disponibles.
  4. Busca la cuenta que necesitas o revisa el inventario filtrado. Selecciona la cuenta para revisar los detalles de sus recursos. Trata esta cuenta como el recurso de la cuenta de Azure, no como una base de datos individual o contenedor.

Métricas de monitorización de Cosmos DB en el Database Hub

Resumen muestra la disponibilidad y los resúmenes del consumo normalizado de RU de los recursos de tu cuenta de Cosmos DB.

Para una cuenta bien dimensionada y que se usa activamente, es normal que ambas líneas se sitúen en el 100 % o cerca de ese valor la mayor parte del tiempo. Un alto consumo de RU significa que la cuenta está usando la mayor parte o todo su rendimiento provisionado. Si eso está bien depende de la disponibilidad en el mismo periodo.

  • La alta disponibilidad junto con esto significa que las solicitudes siguen teniendo éxito y la cuenta simplemente aprovecha al máximo lo que está provisionado.
  • Una caída en la disponibilidad al mismo tiempo apunta a solicitudes realmente limitadas o fallidas, ya que el consumo máximo sostenido de RU es la misma condición que activa la limitación de tasa.

Presta más atención cuando la disponibilidad cae notablemente por debajo de 100%. Vigila también si el consumo de RU sigue siendo bajo durante un periodo prolongado, ya que esto puede indicar un rendimiento aprovisionado en exceso.

El rendimiento te da una visión más detallada de cuentas específicas que seleccionas explícitamente. No incluye automáticamente todas las cuentas en Estate y, si no se aplica ningún filtro, el gráfico de rendimiento limita la vista a los 100 primeros recursos para que la página siga respondiendo. Antes de tratar un gráfico de rendimiento como de todo el patrimonio, confirma qué cuentas están seleccionadas actualmente, ya que la selección por alcance y el inventario completo de tu patrimonio pueden variar.

Faltar telemetría no es una utilización nula ni prueba de que una cuenta esté en buen estado. Comprueba si la cuenta ha producido datos durante el intervalo seleccionado y si una métrica se aplica a su tipo de API y configuración.

Interpretar señales de rendimiento de Cosmos DB

Señal métrica de Azure Monitor Agregación Descripción
Consumo de RU normalizado (% de RU normalizadas en pico) NormalizedRUConsumption Máxima Utilización máxima de RU/s en todos los rangos de claves de partición de la cuenta, de 0 a 100 %.
Unidades de solicitud totales (Total de RU consumidas) TotalRequestUnits Suma (Total) Total de RUs consumidas, sumadas durante el intervalo seleccionado.
Solicitudes con limitación (429s) TotalRequests filtrado por código de estado 429 Contar Número bruto de solicitudes rechazadas por superar la capacidad aprovisionada.
429 Tasa % TotalRequests filtrado a Código de Estado 429, dividido por el total de Solicitudes Totales Conteo (proporción) Porcentaje de solicitudes bloqueadas por superar el rendimiento aprovisionado.
Rendimiento aprovisionado (RU/s aprovisionadas) ProvisionedThroughput Máxima Las RU/s aprovisionadas para la cuenta durante el intervalo seleccionado, para que puedas comparar la capacidad aprovisionada con la consumida.
Latencia media (ms) ServerSideLatencyDirect Average Latencia media en el lado del servidor en milisegundos para las solicitudes realizadas en modo de conexión directa. No incluye la latencia en modo gateway.
Disponibilidad en % ServiceAvailability Average Porcentaje de solicitudes que tuvieron éxito durante el intervalo.

Nota:

El % de disponibilidad en Rendimiento usa la agregación Media. El resumen de disponibilidad de la página Información general utiliza en su lugar la agregación Mínimo para resaltar los valores atípicos.

Los gráficos de esta página utilizan un intervalo temporal horario: una vista de 24 horas traza 24 puntos, con la agregación correspondiente. La cuadrícula utiliza un grano temporal diferente y reduce todo el rango seleccionado a un solo valor por cuenta por columna en lugar de graficar puntos a lo largo del tiempo. Por ejemplo, el valor Peak Norm RU % de la cuadrícula es el máximo observado en todo ese intervalo, no un desglose por hora.

Para más información, consulte Monitorizar Azure Cosmos DB y Métricas soportadas para Microsoft. DocumentDB/databaseAccounts.

Interpretar las diferencias de seguridad y capacidades de Cosmos DB

La página de Seguridad del Database Hub evalúa tres señales de Cosmos DB:

  • Autenticación Microsoft Entra ID: si una cuenta aplica la autenticación solo de Entra ID o sigue permitiendo la autenticación local (basada en claves).
  • Claves gestionadas por el cliente (CMK): si el cifrado CMK está habilitado o si la cuenta depende de claves gestionadas por servicios.
  • Acceso a red pública: si una cuenta lo tiene activado.

Si una cuenta permite autenticación local o no tiene habilitada la CMK, Database Hub la lista como una Sugerencia, una mejora opcional que puedes hacer cuando te sea conveniente. Una cuenta con acceso a la red pública activado aparece como un Problema, ya que se considera más urgente.

Una señal de Hub de Base de Datos refleja lo que evalúa actualmente, no necesariamente el estado completo de la configuración de seguridad subyacente de una cuenta. Por ejemplo, una cuenta sin CMK activada sigue teniendo cifrado en reposo por defecto mediante claves gestionadas por Microsoft, así que una bandera aquí significa "no activado para esta función específica" en lugar de "no protegido". Verifica la configuración actual de la cuenta en el portal de Azure antes de actuar sobre una conclusión. Consulta Configurar claves administradas por el cliente para Azure Cosmos DB y Cifrado en reposo en Azure Cosmos DB para obtener más información.

Estas señales de seguridad ofrecen una visión general rápida para ayudarte a priorizar. Para una evaluación y remediación completa de la seguridad, utiliza servicios como Microsoft Defender para la nube y los registros de diagnóstico de tu cuenta junto con Database Hub.

Continuar la investigación en el portal de Azure

Puedes usar el portal de Azure para investigar más a fondo cualquier problema, por ejemplo, comparar las métricas de la misma cuenta lado a lado en Database Hub y el portal de Azure.

Sugerencia

Utiliza la extensión de Visual Studio Code Cosmos DB para trabajos de planos de datos como consultar y gestionar documentos, pero no para revisar métricas de rendimiento.

  1. Selecciona la cuenta de base de datos de Cosmos que pretendes en Database Hub. Se abre un panel para ese elemento en el Centro de Bases de Datos.
  2. Selecciona el botón Abrir el portal de Azure.
  3. Ve a la pestaña de Insights y establece el rango de tiempo. Compara las métricas relevantes en un intervalo de seguimiento adecuado.

Durante la vista previa actual, la pestaña Insights del portal de Azure ofrece una gama más amplia de gráficos y métricas, así que úsalo para señales que Database Hub aún no aparece.

Investigar los hallazgos de seguridad de Cosmos DB

  1. Seleccione la detección de Cosmos DB en el Resumen de seguridad o bien la cuenta afectada en Estate, si está disponible.

  2. Confirme la cuenta afectada, el nombre de la evaluación, la configuración evaluada y cualquier hora de observación disponible. Consulta la recomendación con la política de tu organización.

  3. Abre la cuenta en el portal de Azure y verifica su configuración actual. Para la autenticación de Microsoft Entra, claves gestionadas por el cliente o acceso público a la red, sigue la documentación correspondiente de servicio de Cosmos DB.

  4. Evalúa el impacto de la solicitud y obtén la aprobación requerida antes de hacer un cambio.

  5. Una vez completado el cambio autorizado, verifica la configuración en el portal de Azure. Permitir la reevaluación y actualizar el Database Hub; si el hallazgo persiste, comparar sus evidencias con la configuración actual de la cuenta.

Solucionar problemas con los datos de Cosmos DB en Database Hub

  • Si una cuenta de Cosmos DB no aparece en Estate, comprueba el inquilino iniciado sesión, el acceso a Azure, el tipo de recurso, los filtros de inventario y la autorización.
  • Si faltan métricas de rendimiento o son diferentes entre Azure Monitor y el Database Hub:
    • Elige un intervalo de tiempo en el que la cuenta estaba atendiendo activamente las solicitudes. Comprueba si la métrica se aplica al tipo de API de la cuenta; por ejemplo, el mapeo 429 difiere entre NoSQL (Código de Estado 429) y la API de MongoDB (código de error 16500).
    • Abre la misma cuenta en el portal de Azure e inspecciona la métrica correspondiente de Azure Monitor en la pestaña Insights. Compara la zona horaria, las horas de inicio y fin, la agregación y la granularidad lo más fielmente posible.
    • Si la métrica no aparece en ninguno de los dos lugares, comprueba la actividad de la cuenta y ten en cuenta un posible retraso en el procesamiento.
    • Si Azure Monitor tiene datos pero Database Hub no, actualiza la vista del Database Hub y vuelve a intentarlo solo con esa cuenta. Si la diferencia persiste, contacta con Soporte.

Limitaciones

  • Cosmos DB Fleet Analytics no está actualmente soportado en Database Hub.
  • La versión previa actual solo soporta cuentas de Azure Cosmos DB. En la vista previa actual, Cosmos DB en Fabric no está soportado actualmente.
  • En la vista previa actual, Visión General y Rendimiento muestran un subconjunto seleccionado de las métricas disponibles en Azure Monitor.
  • En la vista previa actual, la generación de alertas de Activator para métricas de Cosmos DB no está disponible.

Contenido relacionado

  • Última actualización el