Share via

Configuración de métricas de clúster

  • Artículo

Cuando el usuario implementa un clúster, se habilita un conjunto estándar de métricas para la recopilación. Para obtener la lista de métricas, consulte Lista de métricas recopiladas.

Los usuarios no pueden controlar el comportamiento (habilitar o deshabilitar) para la recopilación de estas métricas estándar incluidas. Sin embargo, los usuarios pueden controlar la colección de algunas métricas opcionales que no forman parte del vínculo a la lista. Para habilitar esta experiencia, los usuarios tienen que crear y actualizar un recurso MetricsConfiguration para un clúster. De forma predeterminada, la creación de este recurso MetricsConfiguration no cambia la colección de métricas. El usuario tiene que actualizar el recurso para habilitar o deshabilitar esta recopilación de métricas opcional.

Nota:

  • En el caso de un clúster, como máximo, solo se puede crear un recurso MetricsConfiguration.
  • Los usuarios deben crear un recurso MetricsConfiguration para comprobar una lista de métricas opcionales que se pueden controlar.
  • La eliminación del recurso MetricsConfiguration da como resultado el conjunto estándar de métricas que se va a restaurar.

Administración de la configuración de métricas de clúster

Para admitir el ciclo de vida de las configuraciones de métricas de clúster, las siguientes interacciones permiten la creación y administración de las configuraciones de métricas de un clúster.

Creación de una configuración de métricas

Use el az network cluster metricsconfiguration create comando para crear la configuración de métricas para el clúster. Si tiene varias suscripciones de Azure, el usuario debe pasar el identificador de suscripción mediante una marca --subscription <SUBSCRIPTION_ID> al comando de la CLI o seleccionar el identificador de suscripción adecuado mediante el comando az account set .

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"
  • Reemplace los valores de por <> su información específica.
  • Consulte el recurso de clúster y busque el valor de <CLUSTER-EXTENDED-LOCATION-ID> en . properties.clusterExtendedLocation
  • El collection-interval campo es un campo obligatorio y enabled-metrics es un campo opcional.

Como alternativa, los operadores pueden proporcionar la lista de métricas habilitadas a través del archivo json o yaml.

Ejemplo: archivo enabled-metrics.json

[
   "metric_1",
   "metric_2"
]

Ejemplo: archivo enabled-metrics.yaml

- "metric_1"
- "metric_2"

Comando de ejemplo para usar el archivo json/yaml enabled-metrics:

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics <path-to-yaml-or-json-file> \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

Aquí, <path-to-yaml-or-json-file> puede ser ./enabled-metrics.json o ./enabled-metrics.yaml (colocar el archivo en el directorio de trabajo actual) antes de realizar la acción.

Para ver todos los parámetros disponibles y su descripción, ejecute el comando :

az networkcloud cluster metricsconfiguration create --help

Elementos de configuración de métricas

Nombre de parámetro Descripción
CLUSTER Nombre del recurso del clúster
LOCATION Región de Azure donde se implementa el clúster
CLUSTER_EXTENDED_LOCATION_ID Ubicación extendida del clúster desde Azure Portal
COLLECTION_INTERVAL Frecuencia de recopilación para las métricas estándar predeterminadas
RESOURCE_GROUP Nombre del grupo de recursos del clúster
TAG_KEY1 Etiqueta opcional1 para pasar a MetricsConfiguration create
TAG_VALUE1 Valor tag1 opcional para pasar a MetricsConfiguration create
TAG_KEY2 Etiqueta opcional2 para pasar a MetricsConfiguration create
TAG_VALUE2 Valor de tag2 opcional para pasar a MetricsConfiguration create
METRIC_TO_ENABLE_1 Métrica opcional "METRIC_TO_ENABLE_1" habilitada además de las métricas predeterminadas
METRIC_TO_ENABLE_2 Métrica opcional "METRIC_TO_ENABLE_2" habilitada además de las métricas predeterminadas

La especificación de --no-wait --debug opciones en el comando az da como resultado la ejecución de este comando de forma asincrónica. Para obtener más información, consulte cómo realizar un seguimiento de las operaciones asincrónicas.

Nota:

  • El intervalo de recopilación de métricas predeterminado para el conjunto estándar de métricas se establece en cada 5 minutos. collectionInterval El cambio de también afectará a la frecuencia de recopilación para las métricas estándar predeterminadas.
  • Solo puede haber un conjunto de configuración de métricas definida por clúster. El recurso se crea con el nombre default.

Enumeración de la configuración de métricas

Puede comprobar el recurso de configuración de métricas de un clúster específico mediante el az networkcloud cluster metricsconfiguration list comando :

az networkcloud cluster metricsconfiguration list \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

Recuperación de una configuración de métricas

Una vez creada una configuración de métricas, los operadores pueden comprobar los detalles del recurso mediante az networkcloud cluster metricsconfiguration show el comando :

az networkcloud cluster metricsconfiguration show \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

Este comando devuelve una representación JSON de la configuración de métricas. Puede observar la lista de métricas habilitadas y deshabilitadas además de la frecuencia de recopilación como salida para este comando.

Actualización de una configuración de métricas

Al igual que la creación de una configuración de métricas, los operadores pueden realizar una acción de actualización para cambiar la configuración o actualizar las etiquetas asignadas a la configuración de métricas.

az networkcloud cluster metricsconfiguration update \
 --cluster-name "<CLUSTER>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

Los operadores pueden actualizarse collection-interval independientemente de la enabled-metrics lista. Omita los campos que no se cambian.

La especificación de --no-wait --debug opciones en el comando az da como resultado la ejecución de este comando de forma asincrónica. Para obtener más información, consulte cómo realizar un seguimiento de las operaciones asincrónicas.

Eliminación de una configuración de métricas

La eliminación de la configuración de métricas devuelve el clúster a una configuración no modificada. Para eliminar una configuración de métricas, use el comando :

az networkcloud cluster metricsconfiguration delete \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

La especificación de --no-wait --debug opciones en el comando az da como resultado la ejecución de este comando de forma asincrónica. Para obtener más información, consulte cómo realizar un seguimiento de las operaciones asincrónicas.