Comprender cómo funcionan juntos los tipos de recursos supervisados, los tipos de métricas, las etiquetas y las series temporales en Cloud Monitoring te ayuda a consultar y, también, interpretar los datos de supervisión con precisión. Aplica estos conceptos cuando recuperes datos de series temporales con la API de Cloud Monitoring.
Si estos conceptos son nuevos para ti, comienza con Métricas, series temporales y recursos. Para ver los esquemas de objetos de la API de Monitoring, consulta Estructura de las series temporales.
Información sobre las etiquetas
Los tipos de recursos supervisados y los tipos de métricas admiten etiquetas que permiten clasificar los datos durante el análisis. Por ejemplo:
- Un tipo de recurso supervisado para una máquina virtual puede incluir etiquetas para la ubicación de la máquina y el ID del proyecto asociado a ella. Cuando se registra información sobre el recurso supervisado, esta incluye los valores de las etiquetas.
- Un tipo de métrica que cuenta las solicitudes a la API puede tener etiquetas para registrar el nombre del método invocado y el estado de la solicitud.
El uso de etiquetas se analiza con más detalle en Etiquetas.
Tipos de recursos supervisados
Un recurso supervisado es un recurso del que se capturan datos de métricas. Cloud Monitoring admite alrededor de 270 tipos de recursos supervisados.
Entre los tipos de recursos supervisados, se incluyen nodos y tareas genéricos, componentes arquitectónicos en Google Kubernetes Engine y muchos más.Cada tipo de recurso supervisado se describe de manera formal en una estructura de datos llamada descriptor de recurso supervisado. Para obtener más información, consulta Descriptores de recursos supervisados.
Cada uno de los tipos de recursos supervisados admitidos tiene una entrada en la lista de recursos supervisados. Las entradas de la lista se crean a partir de los descriptores de recursos supervisados. En esta sección, se describe la información que se captura en un descriptor de recurso supervisado y se muestra cómo se presenta en la lista.
Un muestra de tipo de recurso supervisado
En la siguiente imagen, se muestra la entrada en la lista de un bucket de Cloud Storage:
Todas las entradas de la lista incluyen la siguiente información:
- Tipo: El encabezado de la entrada enumera el tipo de recurso supervisado,
gcs_bucketen el ejemplo. - Nombre visible: una descripción breve del recurso supervisado.
- Descripción: Es una descripción más larga del recurso supervisado.
- Etiquetas: Es un conjunto de dimensiones para clasificar datos. Para obtener más información, consulta Etiquetas.
Tipos de métricas
Un tipo de métrica describe las mediciones que se pueden recopilar de un recurso supervisado. Un tipo de métrica incluye una descripción de lo que se mide y cómo se interpretan las mediciones.Los tipos de métricas incluyen recuentos de llamadas a la API, estadísticas de uso del disco, consumo de almacenamiento y mucho más.
Cada tipo de métrica se describe de manera formal en una estructura de datos llamada descriptor de métrica. Para obtener más información, consulta Descriptores de métricas.
Cada uno de los tipos de métricas integrados tiene una entrada en las páginas de la lista de métricas. Las entradas de estas tablas se crean a partir de los descriptores de métricas. En esta sección, se describe la información capturada en un tipo de métrica y se muestra cómo se presenta en el material de referencia.
Un tipo de métrica de muestra
En la siguiente imagen, se muestra una entrada para un tipo de métrica de Cloud Storage:
Los tipos de métricas se muestran en una tabla, y el encabezado de la tabla explica el diseño de la información. En esta sección, se usa una entrada como ejemplo, pero todas las tablas usan el mismo formato.
La entrada de la tabla de muestra de Cloud Storage te brinda la siguiente información sobre un tipo de métrica:
Tipo de métrica: Un identificador para el tipo de métrica,
storage.googleapis.com/api/request_counten el ejemplo.El prefijo
storage.googleapis.comactúa como un espacio de nombres para Cloud Storage. Todos los tipos de métricas asociados con un tipo de recurso supervisado en particular usan el mismo espacio de nombres.Los espacios de nombres se omiten en las entradas en las tablas.
Todos los tipos de métricas asociados con Cloud Storage se enumeran en la tabla de métricas de Cloud Storage.
Etapa de lanzamiento: Es un bloque de color que indica la etapa de lanzamiento del tipo de métrica con un valor como Alfa, Beta o DG.
Nombre visible: una string breve que describe el tipo de métrica, “Request count” en el ejemplo.
Clase, tipo, unidad: Esta línea proporciona información para interpretar los valores de datos. El ejemplo muestra una métrica delta registrada como un número entero de 64 bits sin unidad (ese es el valor
1).Tipo: Este ejemplo es una métrica delta, que registra un cambio durante un período. Es decir, cada dato registra la cantidad de llamadas a la API desde que se escribió el dato anterior. Para obtener más información sobre las clases, consulta Tipos de valores y clases de métricas.
Tipo: En este ejemplo, se registran sus valores como números enteros de 64 bits. Para obtener más información sobre los tipos, consulta Tipos de valores y clases de métricas.
Unidad: Esta métrica no necesita una unidad explícita porque representa un recuento, el dígito
1se usa para indicar que no se necesita ninguna unidad.
Recursos supervisados: Son los recursos supervisados para los que está disponible este tipo de métrica. Los valores que se muestran aquí son los mismos que se describen en Tipos de recursos supervisados.
Descripción: información más detallada sobre lo que se registra y cómo. Configura las cursivas para distinguirla de las etiquetas.
Etiquetas: Es un conjunto de dimensiones para clasificar datos. Para obtener más información, consulta Etiquetas.
Cuando accedes a los datos de supervisión a través de la API de Cloud Monitoring, incluyes
un proyecto de Google Cloud en la llamada a la API. Solo puedes recuperar los datos que sean
visibles para ese proyecto de Google Cloud . Por ejemplo, si solicitas
los datos de tu proyecto para el tipo de métrica
storage.googleapis.com/api/request_count,
solo verás los recuentos de API de los buckets de Cloud Storage de tu proyecto.
Si tu proyecto no usa ningún buckets de Cloud Storage, no se devuelven datos de métricas.
Tipos de métricas integradas
Los tipos de métricas integradas se definen mediante los servicios de Google Cloud , incluido Cloud Monitoring. Estos tipos de métricas describen mediciones estándar para una amplia variedad de infraestructura común y están disponibles para que cualquiera las use.
En la lista de métricas, se muestra todo el conjunto de tipos de métricas integradas.Etiquetas
Una etiqueta es un par clave-valor que se puede usar para proporcionar información sobre un valor de datos.
Etiquetas de métricas y recursos supervisados
Las definiciones de los tipos de métricas y de recursos supervisados incluyen etiquetas. Las etiquetas son clasificadores de los datos que se recopilan y ayudan a categorizarlos para un análisis más profundo. Por ejemplo:
- El tipo de métrica de Cloud Storage
storage.googleapis.com/api/request_counttiene dos etiquetas,response_codeymethod. - El tipo de recurso supervisado de Cloud Storage
gcs_buckettiene tres etiquetas:project_id,bucket_nameylocation. Las etiquetas identifican instancias específicas del tipo de recurso.
Por lo tanto, todos los datos recopilados para las solicitudes a la API desde un bucket de Cloud Storage se clasifican según el método al que se llamó, el código de respuesta de la llamada y el nombre, la ubicación y el proyecto del bucket involucrado. El conjunto de etiquetas varía según la métrica o el tipo de recurso supervisado. Las etiquetas disponibles se documentan en las páginas Lista de métricas y Lista de recursos supervisados.
Si realizas un seguimiento del código de respuesta, el nombre del método y la ubicación cuando cuentas las llamadas a la API, puedes recuperar la cantidad de llamadas a un método de API en particular, la cantidad de llamadas con errores a cualquier método o la cantidad de llamadas con errores a un método específico en una ubicación determinada.
La cantidad de etiquetas y la cantidad de valores que cada una puede asumir se denomina cardinalidad. La cardinalidad es la cantidad de series temporales posibles que se pueden recopilar para un par de tipos de métricas y recursos supervisados: hay una serie temporal para cada combinación de valores de sus etiquetas. Para obtener más información, consulta Cardinalidad: series temporales y etiquetas.
Serie temporal: datos de un recurso supervisado
En esta sección, se analiza qué son los datos de supervisión y cómo se organizan en series temporales. Aquí es donde los componentes conceptuales del modelo de métricas se convierten en artefactos concretos.
Cloud Monitoring almacena mediciones periódicas a lo largo del tiempo para pares de tipos de métricas y de recursos supervisados. Las mediciones se recopilan en series temporales y cada una de ellas contiene los siguientes elementos:
El nombre del tipo de métrica al que pertenece la serie temporal y una combinación de valores para las etiquetas de la métrica.
Una serie de pares (marca de tiempo, valor). El valor es la medición y la marca de tiempo es la hora en la que se realizó la medición.
El recurso supervisado que es la fuente de los datos de la serie temporal y una combinación de valores para las etiquetas del recurso.
Se crea una serie temporal para cada combinación de etiquetas de métricas y recursos que genera datos.
Ejemplo estilizado: El tipo de métrica storage.googleapis.com/api/request_count
podría tener muchas series temporales para los buckets de Cloud Storage
de tu proyecto. En la siguiente tabla, se muestran algunas series temporales posibles.
En la tabla, el valor bucket: xyz representa el valor de la etiqueta bucket_name en el tipo de recurso supervisado, y response_code y method son etiquetas en el tipo de métrica. Hay una serie temporal para cada
combinación de valores en las etiquetas de recursos y métricas. En la tabla,
se muestran algunas de ellas:
| Etiqueta de recurso supervisado de |
Etiquetas de métricas | Datos de métricas |
|---|---|---|
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: FAIL, |
{ |
bucket: 9876 |
response_code: OK, |
{ |
Cloud Monitoring no registra series temporales “vacías”. En el ejemplo de los buckets de Cloud Storage, si no usas un bucket en particular o nunca llamas a un método de API específico, no se recopilan datos para esa etiqueta y ninguna serie temporal la menciona. Esto significa que, si tu proyecto no tiene datos para una métrica en particular, nunca verás el tipo de métrica.
Los tipos de métricas no indican qué tipos de recursos supervisados
se encuentran en las series temporales de las métricas. Para Cloud Storage, solo hay un tipo de recurso supervisado: gcs_bucket. Algunos tipos de métricas se vinculan con más de un recurso supervisado.
Cardinalidad: series temporales y etiquetas
Cada serie temporal se asocia con un par específico de tipos de métricas y recursos supervisados. Los tipos de métricas y de recursos supervisados proporcionan una cantidad de etiquetas. En Cloud Monitoring, la cantidad de combinaciones únicas de valores para el conjunto de etiquetas es la cardinalidad del tipo de métrica o del tipo de recurso supervisado. Estos valores se conocen como cardinalidad de la métrica y cardinalidad del recurso, y determinan cuántas series temporales posibles, la cardinalidad total, se pueden generar.
Supongamos que tienes un tipo de métrica que especifica dos etiquetas,
color y zone. La cardinalidad de la métrica depende de la cantidad de valores posibles
que tienen esas etiquetas:
- Si solo hay tres colores posibles, “rojo”,
“verde” y “azul”, la etiqueta
colorpuede tener hasta tres valores distintos. - Si solo hay dos zonas posibles, “este” y
“oeste”, la etiqueta
zonepuede tener hasta dos valores distintos.
La cardinalidad de esta métrica es 6 (3 × 2). Si hay 1,000 valores posibles
para la etiqueta color y si cada color puede aparecer en cada zona, la cardinalidad de la métrica es 2,000 (1,000 × 2). Se aplica el mismo cálculo
si estas son etiquetas en un tipo de recurso supervisado en lugar de un tipo de métrica.
Este valor de cardinalidad es un máximo, según la cantidad de combinaciones de valores de etiqueta posibles. El valor real y efectivo puede ser significativamente menor cuando no se producen todas las combinaciones de valores de etiqueta. Por ejemplo, si cada color aparece en una sola zona, no en ambas, la cantidad máxima de series temporales que ves en el sistema en ejecución es de 1,000. Sin embargo, la utilidad de la cardinalidad efectiva depende de los motivos por los que no aparecen ciertas combinaciones y de si podrían aparecer en el futuro.

Cuando se escriben los datos de series temporales, se clasifican por tipos de métricas y recursos supervisados. Para cualquier par de tipos de métricas y recursos, la cardinalidad total es el producto de la cardinalidad de la métrica y la cardinalidad del recurso. Si tienes una métrica con una cardinalidad de 1,000 y un recurso con una cardinalidad de 100, y si aparece cada valor de etiqueta, tienes 100,000 series temporales (1,000 × 100).