Componentes del modelo de métricas

El modelo de Cloud Monitoring para monitorizar datos consta de tres conceptos principales:

• Tipos de recursos monitorizados
• Tipos de métricas
• Series temporales

En el documento Modelo de métricas se describen estos conceptos de Cloud Monitoring en términos generales. Si no conoces estos conceptos, lee primero esa página.

En esta página se describen con más detalle los tipos de métricas, los recursos monitorizados y las series temporales, así como algunos conceptos relacionados. Estos conceptos son la base de todas las métricas de monitorización.

Debes leer la información de esta página antes de intentar obtener datos de monitorización sin procesar o agregados mediante la API Monitoring, tal como se describe en Obtener datos de serie temporal. Para obtener más información sobre estos conceptos y cómo se asignan a la API Cloud Monitoring, consulta Estructura de las series temporales, sobre todo si tienes previsto usar la API Monitoring.

Información sobre las etiquetas

Los tipos de recursos monitorizados y los tipos de métricas admiten etiquetas, que permiten clasificar los datos durante el análisis. Por ejemplo:

• Un tipo de recurso monitorizado de una máquina virtual puede incluir etiquetas para la ubicación de la máquina y el ID de proyecto asociado a la máquina. Cuando se registra información sobre el recurso monitorizado, esta incluye los valores de las etiquetas.

• Un tipo de métrica que cuenta las solicitudes de la API puede tener etiquetas para registrar el nombre del método invocado y el estado de la solicitud.

El uso de etiquetas se explica con más detalle en el artículo Etiquetas.

Tipos de recursos monitorizados

Un recurso monitorizado es un recurso del que se obtienen datos de métricas. Cloud Monitoring admite aproximadamente 270 tipos de recursos monitorizados.

Entre los tipos de recursos monitorizados se incluyen nodos y tareas genéricos, componentes de arquitectura en Google Kubernetes Engine y muchos más.

Cada tipo de recurso monitorizado se describe formalmente en una estructura de datos llamada descriptor de recurso monitorizado. Para obtener más información, consulta Descriptores de recursos monitorizados.

Cada uno de los tipos de recursos monitorizados admitidos tiene una entrada en la lista de recursos monitorizados. Las entradas de la lista se crean a partir de los descriptores de recursos monitorizados. En esta sección se describe la información que se registra en un descriptor de recurso monitorizado y se muestra cómo se presenta en la lista.

Un tipo de recurso monitorizado de ejemplo

En la siguiente imagen se muestra la entrada de la lista de un segmento de Cloud Storage:

Todas las entradas de la lista incluyen la siguiente información:

• Tipo: el encabezado de la entrada indica el tipo de recurso monitorizado. En el ejemplo, es gcs_bucket.
• Nombre visible: una breve descripción del recurso monitorizado.
• Descripción: descripción más larga del recurso monitorizado.
• Etiquetas: conjunto de dimensiones para clasificar los datos. Para obtener más información, consulta el artículo sobre etiquetas.

Tipos de métricas

Un tipo de métrica describe las mediciones que se pueden recoger de un recurso monitorizado. Un tipo de métrica incluye una descripción de lo que se está midiendo y de cómo se interpretan las mediciones.

Entre los tipos de métricas se incluyen los recuentos de llamadas a APIs, las estadísticas de uso del disco y el consumo de almacenamiento, entre otros.

Cada tipo de métrica se describe formalmente en una estructura de datos denominada descriptor de métrica. Para obtener más información, consulta Descriptores de métricas.

Cada uno de los tipos de métricas integradas 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 que se registra en un tipo de métrica y se muestra cómo se presenta en el material de referencia.

Un tipo de métrica de ejemplo

En la siguiente imagen se muestra una entrada de un tipo de métrica de Cloud Storage:

Los tipos de métrica se muestran en una tabla, cuyo encabezado explica el diseño de la información. En esta sección se usa una entrada como ejemplo, pero todas las tablas tienen el mismo formato.

La entrada de ejemplo de la tabla de Cloud Storage te proporciona la siguiente información sobre un tipo de métrica:

• Tipo de métrica: identificador del tipo de métrica, como storage.googleapis.com/api/request_count en el ejemplo.

  El prefijo storage.googleapis.com actúa como espacio de nombres de Cloud Storage. Todos los tipos de métricas asociados a un tipo de recurso monitorizado concreto usan el mismo espacio de nombres.

  Los espacios de nombres se omiten de las entradas de las tablas.

  Todos los tipos de métricas asociados a Cloud Storage se enumeran en la tabla de métricas de Cloud Storage.

• Fase de lanzamiento: bloque de color que indica la fase de lanzamiento del tipo de métrica con un valor como Alfa, Beta y GA.

• Nombre visible: una cadena breve que describe el tipo de métrica. En el ejemplo, es "Número de solicitudes".

• Tipo, unidad y clase: esta línea proporciona información para interpretar los valores de los datos. En el ejemplo, se muestra una métrica delta registrada como un entero de 64 bits sin unidad (es el valor 1).

  • Tipo: este ejemplo es una métrica delta, que registra un cambio a lo largo de un periodo. Es decir, cada punto de datos registra el número de llamadas a la API desde que se escribió el punto de datos anterior. Para obtener más información sobre los tipos, consulta Tipos de valores y tipos de métricas.

  • Tipo: en este ejemplo, los valores se registran como números enteros de 64 bits. Para obtener más información sobre los tipos, consulta el artículo Tipos de valores y tipos de métricas.

  • Unidad: esta métrica no necesita una unidad explícita porque representa un recuento. Se usa el dígito 1 para indicar que no se necesita ninguna unidad.

• Recursos monitorizados: los recursos monitorizados para los que está disponible este tipo de métrica. Los valores que se indican aquí son los mismos que los que se describen en Tipos de recursos monitorizados.

• Descripción: información más detallada sobre lo que se graba y cómo. Se muestra en cursiva para distinguirlo de las etiquetas.

• Etiquetas: conjunto de dimensiones para clasificar los datos. Para obtener más información, consulta el artículo sobre etiquetas.

Cuando accedes a los datos de monitorización a través de la API Cloud Monitoring, incluyes un Cloud de Confiance proyecto en la llamada a la API. Solo puedes recuperar los datos que sean visibles para ese proyecto de Cloud de Confiance . Por ejemplo, si solicitas los datos de tu proyecto para el tipo de métrica storage.googleapis.com/api/request_count, verás los recuentos de la API solo para los segmentos de Cloud Storage de tu proyecto. Si tu proyecto no usa ningún segmento de Cloud Storage, no se devolverán datos de métricas.

Tipos de métricas integradas

Los tipos de métricas integradas se definen mediante Cloud de Confiance by S3NS servicios, incluido Cloud Monitoring. Estos tipos de métricas describen mediciones estándar de una amplia gama de infraestructuras comunes y están disponibles para cualquier usuario.

En la lista 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 monitorizados

Las definiciones de los tipos de métricas y de recursos monitorizados incluyen etiquetas. Las etiquetas son clasificadores de los datos que se recogen. Ayudan a categorizar los datos para analizarlos en profundidad. Por ejemplo:

• El tipo de métrica de Cloud Storage storage.googleapis.com/api/request_count tiene dos etiquetas, response_code y method.
• El tipo de recurso monitorizado de Cloud Storage gcs_bucket tiene tres etiquetas: project_id, bucket_name y location. Las etiquetas identifican instancias específicas del tipo de recurso.

Por lo tanto, todos los datos recogidos para las solicitudes de API de un segmento de Cloud Storage se clasifican según el método que se haya llamado, el código de respuesta de la llamada, el nombre, la ubicación y el proyecto del segmento en cuestión. El conjunto de etiquetas varía en función del tipo de métrica o de recurso monitorizado. Las etiquetas disponibles se documentan en las páginas Lista de métricas y Lista de recursos monitorizados.

Si monitorizas el código de respuesta, el nombre del método y la ubicación al contabilizar las llamadas a la API, puedes obtener el número de llamadas a un método de la API concreto, el número de llamadas fallidas a cualquier método o el número de llamadas fallidas a un método específico en una ubicación concreta.

El número de etiquetas y el número de valores que puede adoptar cada una se denomina cardinalidad. La cardinalidad es el número de series temporales que se pueden recoger para un par de tipos de métricas y de recursos monitorizados. 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: los datos de un recurso monitorizado

En esta sección se explica qué son los datos de monitorizació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 de pares de métricas y tipos de recursos monitorizados. Las mediciones se recogen en series temporales y cada serie temporal 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 ha tomado la medición.

• El recurso monitorizado 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 por cada combinación de etiquetas de métrica y de recurso que genere datos.

Ejemplo estilizado: el tipo de métrica storage.googleapis.com/api/request_count podría tener muchas series temporales para los segmentos de Cloud Storage de tu proyecto. En la siguiente ilustración se muestran algunas series temporales posibles.

En la ilustración, el valor bucket: xxxx representa el valor de la etiqueta bucket_name en el tipo de recurso monitorizado, mientras que response_code y method son etiquetas del tipo de métrica. Hay una serie temporal por cada combinación de valores de las etiquetas de recursos y de métricas. En las ilustraciones se muestran algunas de ellas:

Cloud Monitoring no registra series temporales "vacías". En el ejemplo de los contenedores de Cloud Storage, si no usas un contenedor concreto o nunca llamas a un método de API concreto, no se recogerán datos de esa etiqueta y no se mencionará en ninguna serie temporal. Esto significa que, si tu proyecto no tiene ningún dato de una métrica concreta, nunca verás el tipo de métrica.

Los tipos de métricas no indican qué tipos de recursos monitorizados se encuentran en las series temporales de las métricas. En Cloud Storage, solo hay un tipo de recurso supervisado: gcs_bucket. Algunos tipos de métricas se emparejan con más de un recurso supervisado.

Cardinalidad: series temporales y etiquetas

Cada serie temporal se asocia a un par específico de métrica y tipos de recursos monitorizados. Los tipos de métrica y de recurso monitorizado proporcionan un número de etiquetas. En Cloud Monitoring, el número de combinaciones únicas de valores del conjunto de etiquetas es la cardinalidad del tipo de métrica o del tipo de recurso monitorizado. Estos valores se denominan cardinalidad de la métrica y cardinalidad del recurso, y determinan cuántas series temporales posibles, la cardinalidad total, se pueden generar.

Supongamos que tiene un tipo de métrica que especifica dos etiquetas: color y zone. La cardinalidad de la métrica depende del número de valores posibles que tengan esas etiquetas:

• Si solo hay tres colores posibles ("rojo", "verde" y "azul"), la etiqueta color puede tener hasta tres valores distintos.
• Si solo hay dos zonas posibles, "este" y "oeste", la etiqueta zone puede tener hasta dos valores distintos.

La cardinalidad de esta métrica es 6 (3×2). Si hay 1000 valores posibles para la etiqueta color y cada color puede aparecer en cada zona, la cardinalidad de la métrica es 2000 (1000×2). El cálculo es el mismo si se trata de etiquetas de un tipo de recurso monitorizado en lugar de un tipo de métrica.

Este valor de cardinalidad es un máximo basado en el número de combinaciones de valores de etiqueta posibles. El valor real efectivo puede ser significativamente inferior si no se dan todas las combinaciones de valores de etiqueta. Por ejemplo, si cada color aparece en una sola zona, no en ambas, el número máximo de series temporales que verás en el sistema en ejecución es de 1000. Sin embargo, la utilidad de la cardinalidad efectiva depende de los motivos por los que no aparecen determinadas combinaciones y de si podrían aparecer en el futuro.

Cuando se escriben datos de series temporales, se clasifican por métrica y por tipos de recursos monitorizados. En cualquier par de tipos de métrica y de recurso, 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 1000 y un recurso con una cardinalidad de 100, y si aparece cada valor de etiqueta, tendrás 100.000 series temporales (1000 × 100).