Supervisión de Azure Cosmos DB
En este artículo se describe:
- Los tipos de datos de supervisión que puede recopilar para este servicio.
- Formas de analizar esos datos.
Nota:
Si ya está familiarizado con este servicio o Azure Monitor y solo quiere saber cómo analizar los datos de supervisión, consulte la sección Analizar cerca del final de este artículo.
Cuando tenga aplicaciones críticas y procesos empresariales que dependan de los recursos de Azure, deberá supervisar y obtener alertas para el sistema. El servicio Azure Monitor recopila y agrega métricas y registros de todos los componentes del sistema. Azure Monitor proporciona una vista de la disponibilidad, el rendimiento y la resistencia, y le notifica los problemas. Puede usar Azure Portal, PowerShell, la CLI de Azure, la API de REST o las bibliotecas cliente para configurar y ver los datos de supervisión.
- Para más información sobre Azure Monitor, consulte la Información general de Azure Monitor.
- Para más información sobre cómo supervisar los recursos de Azure en general, consulte Supervisión de recursos de Azure con Azure Monitor.
Información detallada
Algunos servicios de Azure tienen un panel de supervisión integrado en Azure Portal que proporciona un punto de partida para supervisar el servicio. Estos paneles se denominan información, y puede encontrarlos en el Centro de información de Azure Monitor en Azure Portal.
Información sobre Azure Cosmos DB
La información de Azure Cosmos DB es una característica basada en la característica de libros de Azure Monitor. Use la información de Azure Cosmos DB para obtener una vista del rendimiento general, los errores, la capacidad y el estado operativo de todos los recursos de Azure Cosmos DB en una experiencia interactiva unificada.
Para más detalles sobre la información de Azure Cosmos DB, consulte los artículos siguientes:
- Exploración de la información de Azure Cosmos DB
- Supervisión y depuración con la información de Azure Cosmos DB.
Tipos de recursos
Azure usa el concepto de tipos de recursos e identificadores para identificar todo el contenido de una suscripción. Los tipos de recursos también forman parte de los identificadores de recursos para cada recurso que se ejecuta en Azure. Por ejemplo, un tipo de recurso para una máquina virtual es Microsoft.Compute/virtualMachines. Para obtener una lista de los servicios y sus tipos de recursos asociados, consulte Proveedores de recursos.
De forma similar, Azure Monitor organiza los datos principales de supervisión en métricas y registros en función de tipos de recursos, que también se denominan espacios de nombres. Hay diferentes métricas y registros disponibles para distintos tipos de recursos. Es posible que el servicio esté asociado a más de un tipo de recurso.
Para más información sobre los tipos de recursos para Azure Cosmos DB, consulte Referencia de datos de supervisión de Azure Cosmos DB.
Almacenamiento de datos
Para Azure Monitor:
- Los datos de métricas se almacenan en la base de datos de métricas de Azure Monitor.
- Los datos de registro se almacenan en el almacén de registros de Azure Monitor. Log Analytics es una herramienta de Azure Portal que puede hacer consultas en este almacén.
- El registro de actividad de Azure es un almacén independiente con su propia interfaz en Azure Portal.
Opcionalmente, puede enrutar los datos del registro de actividad y las métricas al almacén de registros de Azure Monitor. A continuación, puede usar Log Analytics para consultar los datos y correlacionarlos con otros datos de registro.
Muchos servicios pueden usar la configuración de diagnóstico para enviar datos de métricas y de registro a otras ubicaciones de almacenamiento fuera de Azure Monitor. Algunos ejemplos son Azure Storage, sistemas de asociados hospedados y sistemas de asociados que no son de Azure mediante Event Hubs.
Para obtener información detallada sobre cómo Azure Monitor almacena datos, consulte Plataforma de datos de Azure Monitor.
Métricas de plataforma de Azure Monitor
Azure Monitor proporciona métricas de plataforma para la mayoría de los servicios. Estas son las métricas:
- Se define individualmente para cada espacio de nombres.
- Almacenado en la base de datos de métricas de serie temporal de Azure Monitor.
- Ligero y capaz de admitir alertas casi en tiempo real.
- Se usa para supervisar el rendimiento de un recurso a lo largo del tiempo.
Recopilación: Azure Monitor recopila automáticamente las métricas de la plataforma. No se requiere ninguna configuración.
Enrutamiento: también puede enrutar algunas métricas de la plataforma a registros de Azure Monitor o Log Analytics para poder consultarlas con otros datos de registro. Compruebe el valor Exportación de DS para ver si puede usar una configuración de diagnóstico a fin de enrutar la métrica a registros de Azure Monitor o Log Analytics.
- Para más información, consulta el valor Diagnóstico de métricas.
- A fin de configurar valores de diagnóstico para un servicio, vea Creación de valores de diagnóstico en Azure Monitor.
Para obtener una lista de todas las métricas que es posible recopilar para todos los recursos de Azure Monitor, consulte Métricas admitidas en Azure Monitor.
Azure Monitor recopila las métricas de Azure Cosmos DB de forma predeterminada. No es necesario configurar explícitamente nada. La mayoría de las métricas están disponibles en la página del portal de Azure Cosmos DB o en la página de Azure Monitor. De forma predeterminada, estas métricas se recopilan con granularidad de un minuto. La granularidad puede variar en función de la métrica que elija. Para obtener más información sobre el período de retención predeterminado, consulte Retención de métricas de Azure Monitor
Las métricas del lado servidor de Azure Cosmos DB incluyen rendimiento, almacenamiento, disponibilidad, latencia, coherencia y métricas de nivel de sistema. Puede recopilar en el lado cliente los detalles de la carga de solicitudes, el identificador de actividad, la información de seguimiento de la pila y excepciones, el código de estado y subestado HTTP y la cadena de diagnóstico. De manera predeterminada, estas métricas tienen un período de retención de siete días. Puede usar estos datos para depurar problemas o si necesita comunicarse con el equipo de soporte técnico de Azure Cosmos DB.
Los valores de la dimensión para las métricas, como el nombre del contenedor, no distinguen entre mayúsculas y minúsculas. Esta situación puede provocar confusión o colisión en datos de telemetría y acciones en contenedores con estos nombres. Debe usar una comparación sin distinción entre mayúsculas y minúsculas al realizar comparaciones de cadenas en estos valores de dimensión.
Para obtener una lista de las métricas disponibles para Azure Cosmos DB, consulte Referencia de datos de supervisión de Azure Cosmos DB.
Métricas no basadas en Azure Monitor
Este servicio proporciona otras métricas que no se incluyen en la base de datos de métricas de Azure Monitor.
- Para obtener información sobre las soluciones y herramientas de asociados que pueden ayudar a supervisar Azure Cosmos DB, consulte Supervisión de Azure Cosmos DB mediante soluciones de terceros.
- Para implementar métricas de Micrometer en el SDK de Java para Azure Cosmos DB mediante el consumo de métricas de Prometheus, consulte Uso de métricas de cliente de Micrometer para Java.
Registros de recursos de Azure Monitor
Los registros de recursos proporcionan información sobre las operaciones realizadas por un recurso de Azure. Los registros se generan automáticamente, pero debe enrutarlos a los registros de Azure Monitor para guardarlos o consultarlos. Los registros se organizan en categorías. Un espacio de nombres determinado puede tener varias categorías de registro de recursos.
Recopilación: los registros de recursos no se recopilan ni almacenan hasta que se crea una configuración de diagnóstico y se enrutan los registros a una o varias ubicaciones. Cuando se crea una configuración de diagnóstico, se especifican las categorías de registros que se van a recopilar. Hay varias maneras de crear y mantener la configuración de diagnóstico, como Azure Portal, hacerlo mediante programación o usar Azure Policy.
Enrutamiento: el valor predeterminado sugerido es enrutar los registros de recursos a los registros de Azure Monitor para poder consultarlos con otros datos de registro. También están disponibles otras ubicaciones como Azure Storage, Azure Event Hubs y determinados asociados de supervisión de Microsoft. Para más información, consulte los Registros de recursos de Azure y los Destinos de registro de recursos.
Para obtener información detallada sobre cómo recopilar, almacenar y enrutar registros de recursos, consulte Configuración de diagnóstico en Azure Monitor.
Para obtener una lista de todas las categorías de registro de recursos disponibles en Azure Monitor, consulte Registros de recursos admitidos en Azure Monitor.
Todos los registros de recursos de Azure Monitor tienen los mismos campos de encabezado, seguidos de campos específicos del servicio. El esquema común se describe en Esquema de registros de recursos de Azure Monitor.
Puede supervisar los registros de diagnóstico desde la cuenta de Azure Cosmos DB y crear paneles desde Azure Monitor. Los datos, como eventos y seguimientos que tienen lugar en un segundo nivel de granularidad, se almacenan como registros. Por ejemplo, si cambia el rendimiento de un contenedor o cambian las propiedades de una cuenta de Azure Cosmos DB. Los registros capturan estos eventos. Estos registros se pueden analizar mediante la ejecución de consultas en los datos recopilados.
Para las categorías de registro de recursos disponibles, sus tablas de Log Analytics asociadas y los esquemas de registros de Azure Cosmos DB, consulte la referencia de datos de supervisión de Azure Cosmos DB.
Registro de actividades de Azure
El registro de actividad contiene eventos de nivel de suscripción que realizan el seguimiento de las operaciones de cada recurso de Azure, tal como se ve desde fuera de ese recurso; por ejemplo, crear un recurso o iniciar una máquina virtual.
Recopilación: los eventos del registro de actividad se generan y recopilan automáticamente en un almacén independiente para su visualización en Azure Portal.
Enrutamiento: puedes enviar datos del registro de actividad a los registros de Azure Monitor para poder analizarlos junto con otros datos de registro. También están disponibles otras ubicaciones como Azure Storage, Azure Event Hubs y determinados asociados de supervisión de Microsoft. Para más información sobre cómo enrutar el registro de actividad, consulte Información general del registro de actividad de Azure.
Auditar acciones de restauración para el modo de copia de seguridad continua
Mediante el uso de registros de actividad, puede enumerar todas las restauraciones a un momento dado para el modo continuo que se realizaron en una cuenta de Azure Cosmos DB. Para obtener información sobre cómo ver estas operaciones en Azure Portal, consulte Auditar la acción de restauración a un momento dado para el modo de copia de seguridad continua.
Analizar los datos de supervisión
Hay muchas herramientas para analizar los datos de supervisión.
Herramientas de Azure Monitor
Azure Monitor admite las siguientes herramientas básicas:
Explorador de métricas: una herramienta de Azure Portal que le permite ver y analizar métricas de recursos de Azure. Para obtener más información, consulte Análisis de métricas con el explorador de métricas de Azure Monitor.
Log Analytics, una herramienta de Azure Portal que le permite consultar y analizar datos de registro mediante el lenguaje de consulta Kusto (KQL). Para más información, consulte Introducción a las consultas de registro en Azure Monitor.
El registro de actividad: que tiene una interfaz de usuario en Azure Portal para visualización y búsquedas básicas. Para realizar un análisis más detallado, debe enrutar los datos a los registros de Azure Monitor y ejecutar consultas más complejas en Log Analytics.
Entre las herramientas que permiten una visualización más compleja se incluyen:
- Paneles que permiten combinar diferentes tipos de datos en un único panel de Azure Portal.
- Libros: informes personalizables que se pueden crear en Azure Portal. Los libros pueden incluir texto, métricas y consultas de registro.
- Grafana: una herramienta de plataforma abierta que se destaca en los paneles operativos. Puede usar Grafana para crear paneles que incluyan datos de varios orígenes distintos de Azure Monitor.
- Power BI: un servicio de análisis empresarial que proporciona visualizaciones interactivas en varios orígenes de datos. Puede configurar Power BI para que los datos de registro se importen automáticamente desde Azure Monitor y utilizar estas otras adicionales.
Herramientas de exportación de Azure Monitor
Puede obtener datos de Azure Monitor en otras herramientas mediante los siguientes métodos:
Métricas: con la API de REST para métricas puede extraer datos de métricas de la base de datos de métricas de Azure Monitor. La API admite expresiones de filtro para refinar los datos recuperados. Para obtener más información, consulte Referencia de la API de REST de Azure Monitor.
Registros: use la API de REST o las bibliotecas de cliente asociadas.
Otra opción es la exportación de datos del área de trabajo.
Para empezar a trabajar con la API de REST para Azure Monitor, consulte Tutorial de la API de REST de supervisión de Azure.
Análisis de métricas de Azure Cosmos DB
Puede usar el Explorador de métricas de Azure Monitor para analizar las métricas de Azure Cosmos DB con métricas de otros servicios de Azure. Para hacerlo, seleccione Métricas en Supervisión en la navegación del portal de la cuenta de Azure Cosmos DB. Para más información sobre cómo usar el Explorador de métricas, consulte Análisis de métricas con el Explorador de métricas de Azure Monitor.
Puede supervisar la latencia del servidor, el uso de las unidades de solicitud y el uso normalizado de unidades de solicitud para los recursos de Azure Cosmos DB. Puede seleccionar métricas específicas de unidades de solicitud, almacenamiento, latencia, disponibilidad, Cassandra, etc.
En el lado cliente, puede depurar problemas mediante la recopilación de métricas para el cargo de solicitud, el identificador de actividad, la información de seguimiento de la excepción y la pila, el estado HTTP y el código de subestado, y la cadena de diagnóstico.
Para obtener más información e instrucciones detalladas, consulte los siguientes artículos:
- Supervisión de latencia del lado servidor
- Supervisión del uso de la unidad de solicitud
- Supervisión del uso de unidades de solicitud normalizadas
Para obtener una lista de todas las métricas de recursos admitidas en Azure Monitor, consulte Métricas de Azure Monitor admitidas. Para ver una lista de las métricas de la plataforma recopiladas para Azure Cosmos DB, vea Supervisión de métricas de referencia de datos de Azure Cosmos DB.
Supervisión de Azure Cosmos DB mediante programación
Las métricas a nivel de cuenta disponibles en el portal, como el uso de almacenamiento de cuenta y el total de solicitudes, no están disponibles al usar la API para NoSQL. Sin embargo, puede recuperar datos de uso en el nivel de colección mediante la API para NoSQL. Para recuperar datos de nivel de recopilación, use uno de los métodos siguientes:
Para usar la API de REST, ejecute una operación GET en la colección. La información de cuota y uso de la colección se devuelve en los encabezados
x-ms-resource-quotayx-ms-resource-usagede la respuesta.Para usar el SDK de .NET, use el método DocumentClient.ReadDocumentCollectionAsync, que devuelve un objeto ResourceResponse que contiene muchas propiedades de uso, como CollectionSizeUsage, DatabaseUsage y DocumentUsage.
Para acceder a más métricas, use el SDK de Azure Monitor. Se pueden recuperar definiciones de métricas con este formato:
https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01
Para recuperar métricas individuales, use el siguiente formato:
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
Para más información, vea API de REST de supervisión de Azure.
Análisis de registros de Azure Cosmos DB
Los datos de los registros de Azure Monitor se almacenan en tablas. Cada tabla tiene un conjunto único de propiedades. Todos los registros de recursos de Azure Monitor tienen los mismos campos seguidos de campos específicos del servicio. El esquema común se describe en Esquema de registros de recursos de Azure Monitor.
Para ver los tipos de registros de recursos recopilados para Azure Cosmos DB, consulte Supervisión de la referencia de datos de Azure Cosmos DB.
Consulte los artículos siguientes para más información sobre cómo trabajar con registros de Azure Monitor para Azure Cosmos DB:
- Supervisión de datos mediante la configuración de diagnóstico de Azure
- Auditoría de registros del plano de control
- Agregar una transformación para los datos del área de trabajo
Consultas de Kusto
Puedes analizar datos de supervisión en el almacén de registros de Azure Monitor o Log Analytics mediante el lenguaje de consulta Kusto (KQL).
Importante
Al seleccionar Registros en el menú del servicio del portal, Log Analytics se abre con el ámbito de consulta establecido en el servicio actual. Este ámbito significa que las consultas de registro solo incluirán datos de ese tipo de recurso. Si quiere ejecutar una consulta que incluya datos de otros servicios de Azure, seleccione Registros en el menú Azure Monitor. Consulte Ámbito e intervalo de tiempo de una consulta de registro en Log Analytics de Azure Monitor para obtener más información.
Para obtener una lista de las consultas comunes de cualquier servicio, consulte Interfaz de consultas de Log Analytics.
Antes de usar Log Analytics para emitir consultas de Kusto, tiene que habilitar los registros de diagnóstico para las operaciones del plano de control. Cuando habilita los registros de diagnóstico, seleccione entre almacenar los datos en tablas específicas del recurso o la tabla AzureDiagnostics única. El texto exacto de las consultas de Kusto depende del modo de recopilación que seleccione.
- Consulte Solución de problemas con consultas de diagnóstico para obtener consultas sencillas para ayudar a solucionar problemas con Azure Cosmos DB.
- Consulte Solución de problemas con consultas de diagnóstico avanzadas con Azure Cosmos DB for NoSQL para obtener consultas más avanzadas para ayudar a solucionar problemas con la cuenta de Azure Cosmos DB mediante registros de diagnóstico enviados a tablas de Azure Diagnostics (heredadas) y específicas de recursos (versión preliminar).
Estas son algunas consultas que puede escribir en la barra de búsqueda Búsqueda de registros para ayudarle a supervisar los recursos de Azure Cosmos DB.
Para consultar todos los registros del plano de control desde Azure Cosmos DB:
CDBControlPlaneRequests
Para consultar todos los registros del plano de datos desde Azure Cosmos DB:
CDBDataPlaneRequests
Para consultar una lista filtrada de registros del plano de datos, específica de un único recurso:
CDBDataPlaneRequests
| where AccountName=="<account-name>"
Para obtener un recuento de registros del plano de datos, agrupados por recurso:
CDBDataPlaneRequests
| summarize count() by AccountName
Para generar un gráfico para los registros del plano de datos, agrupados por tipo de operación:
CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart
En el caso de las consultas de Kusto que puede usar para solucionar problemas con Azure Cosmos DB, consulte los artículos siguientes:
- Solución de problemas mediante consultas básicas
- Solución de problemas mediante consultas de diagnóstico avanzadas
Estos ejemplos son solo un pequeño muestreo de las consultas enriquecidas que puede ejecutar en Azure Monitor mediante el lenguaje de consulta Kusto (KQL). Para más ejemplos, consulte ejemplos de consultas de Kusto.
Alertas
Las alertas de Azure Monitor le informan de forma proactiva cuando se detectan condiciones específicas en los datos que se supervisan. Las alertas permiten identificar y solucionar las incidencias en el sistema antes de que los clientes puedan verlos. Para obtener más información, vea Alertas de Azure Monitor.
Hay muchos orígenes de alertas comunes para los recursos de Azure. Para obtener ejemplos de alertas comunes para recursos de Azure, consulte Consultas de alertas de registro de ejemplo. El sitio de Alertas de línea de base de Azure Monitor (AMBA) proporciona un método semiautomatizado para implementar alertas, paneles e instrucciones importantes de métricas de plataforma. El sitio se aplica a un subconjunto de servicios de Azure que se expande continuamente, incluidos todos los servicios que forman parte de la zona de aterrizaje de Azure (ALZ).
El esquema de alerta común normaliza el consumo de notificaciones de alerta de Azure Monitor. Para obtener más información, consulte Esquema de alertas comunes.
Tipos de alertas
Puede alertar sobre cualquier métrica o fuente de datos de registro en la plataforma de datos de Azure Monitor. Hay muchos tipos diferentes de alertas en función de los servicios que está supervisando y de los datos de supervisión que está recopilando. Los distintos tipos de alertas tienen varias ventajas y desventajas. Para obtener más información, consulte Elegir el tipo de alerta de supervisión adecuado.
En la siguiente lista se describen los tipos de alertas de Azure Monitor que puede crear:
- Alertas de métricas: evalúan las métricas de recursos a intervalos regulares. Las métricas pueden ser métricas de plataforma, métricas personalizadas, registros de Azure Monitor convertidos en métricas o métricas de Application Insights. Las alertas de métricas también pueden aplicar varias condiciones y umbrales dinámicos.
- Alertas de registro: permiten a los usuarios emplear una consulta de Log Analytics para evaluar los registros de recursos con una frecuencia predefinida.
- Alertas del registro de actividad: se desencadenan cuando se produce un nuevo evento del registro de actividad que coincide con las condiciones definidas. Las alertas de Resource Health y de Service Health son alertas del registro de actividad que informan sobre el servicio y el estado de los recursos.
Algunos servicios de Azure también admiten alertas de detección inteligente, alertas de Prometheus, o reglas de alerta recomendadas.
Para algunos servicios, puede supervisar a escala aplicando la misma regla de alertas de métricas a varios recursos del mismo tipo que existen en la misma región de Azure. Se envían notificaciones individuales para cada recurso supervisado. Para obtener servicios y nubes de Azure compatibles, consulte Supervisión de varios recursos con una regla de alerta.
Reglas de alertas de Azure Cosmos DB
En la tabla siguiente, se enumeran algunas reglas de alertas de métricas comunes y recomendadas para Azure Cosmos DB.
| Tipo de alerta | Condición | Descripción |
|---|---|---|
| Limitación de velocidad en unidades de solicitud (alerta de métrica) | Nombre de dimensión: StatusCode - Operador: Igual a - Valores de dimensión: 429 | Genera una alerta si el contenedor o una base de datos han superado el límite de rendimiento aprovisionado. |
| Región conmutada por error | Operador: Mayor que - Tipo de agregación: Recuento - Valor de umbral: 1 | Cuando se conmuta por error una sola región. Esta alerta es útil si no habilitó la conmutación por error administrada por el servicio. |
| Rotar claves (alerta de registro de actividad) | Nivel de evento: Informativo, estado: iniciado | Genera una alerta cuando se rotan las claves de cuenta. Puede actualizar la aplicación con las nuevas claves. |
Para más información e instrucciones sobre cómo crear alertas para Azure Cosmos DB, consulte Creación de alertas sobre métricas. Para crear una alerta para supervisar si el almacenamiento de una clave de partición lógica se aproxima a 20 GB, consulte Creación de alertas sobre el tamaño de la clave de partición lógica.
Recomendaciones de Advisor
Para algunos servicios, si se producen condiciones críticas o cambios inminentes durante las operaciones de recursos, se muestra una alerta en la página Información general del servicio del portal. Puede encontrar más información y correcciones recomendadas para la alerta en Recomendaciones de Advisor en Supervisión en el menú izquierdo. Durante las operaciones normales, no se muestran recomendaciones de Advisor.
Para más información sobre Azure Advisor, consulte Introducción a Azure Advisor.
Contenido relacionado
- Consulte Referencia de datos de supervisión de Azure Cosmos DB para obtener una referencia de las métricas, registros y otros valores importantes creados para Azure Cosmos DB.
- Consulte Supervisión de recursos de Azure con Azure Monitor para obtener información general sobre la supervisión de recursos de Azure.