Compartir a través de

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) de la recopilación de estas métricas estándar incluidas. Sin embargo, los usuarios pueden controlar la recopilació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 recopilació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, solo se puede crear un recurso MetricsConfiguration como máximo.
  • Los usuarios deben crear un recurso MetricsConfiguration para comprobar la lista de métricas opcionales que se pueden controlar.
  • Si se elimina el recurso MetricsConfiguration, se restablece el conjunto estándar de métricas.

Cómo administrar 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 comando az network cluster metricsconfiguration create para crear la configuración de métricas para el clúster. Si tiene varias suscripciones de Azure, debe especificar el identificador de suscripción mediante la marca --subscription <SUBSCRIPTION_ID> en el comando de la CLI o seleccionando el identificador de suscripción adecuado con 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 campo collection-interval es un campo obligatorio, mientras que el campo enabled-metrics es opcional.

Como alternativa, los operadores pueden proporcionar la lista de métricas habilitadas a través de un 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 enabled-metrics json/yaml:

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 (coloque el archivo en el directorio de trabajo actual) antes de realizar la acción.

Para ver todos los parámetros disponibles y sus descripciones, ejecute el siguiente 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 en la que se implementa el clúster.
CLUSTER_EXTENDED_LOCATION_ID Ubicación extendida del clúster desde Azure Portal
COLLECTION_INTERVAL Frecuencia de recopilación de las métricas estándar predeterminadas
RESOURCE_GROUP Nombre del grupo de recursos del clúster
TAG_KEY1 Tag1 opcional para pasar a MetricsConfiguration create
TAG_VALUE1 Valor tag1 opcional para pasar a MetricsConfiguration create
TAG_KEY2 Tag2 opcional para pasar a MetricsConfiguration create
TAG_VALUE2 Valor 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. Cambiar el collectionInterval también afectará a la frecuencia de recopilación de 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 comando az networkcloud cluster metricsconfiguration list:

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

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

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

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 con 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 actualizar collection-interval independientemente de la lista enabled-metrics. Omita los campos que no se vayan a cambiar.

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 siguiente 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.