Share via

Carga de métricas a Azure Monitor

  • Artículo

Puede exportar las métricas de supervisión de forma periódica y, a continuación, cargarlas en Azure. La exportación y la carga de datos crea y actualiza los recursos del controlador de datos, la instancia administrada de SQL y el servidor de PostgreSQL en Azure.

Con los servicios de datos de Azure Arc, opcionalmente puede cargar las métricas en Azure Monitor a fin de agregar y analizar métricas, generar alertas, enviar notificaciones o desencadenar acciones automatizadas.

El envío de los datos a Azure Monitor también permite almacenar los datos de las métricas fuera del sitio y a gran escala, lo que permite el almacenamiento a largo plazo de los datos para realizar análisis avanzados.

Si tiene varios sitios con servicios de datos de Azure Arc, puede usar Azure Monitor como ubicación central para recopilar todos los registros y las métricas de todos los sitios.

Carga de métrics del controlador de datos de Azure Arc en el modo directo

En el modo de conexión directa, la carga de métricas solo se puede configurar en modo automático. Esta carga automática de métricas se puede configurar durante la implementación del controlador de datos de Azure Arc, o después de ella. La identidad administrada de la extensión de servicios de datos de Arc se usa para cargar métricas. La identidad administrada debe tener asignado el rol Publicador de métricas de supervisión.

Nota:

Si la carga automática de métricas se deshabilitó durante la implementación del controlador de datos de Azure Arc, primero debe recuperar la identidad administrada de la extensión del controlador de datos de Arc y conceder el rol Publicador de métricas de supervisión antes de habilitar la carga automática. Siga estos pasos para recuperar la identidad administrada y conceder los roles necesarios.

En los ejemplos de este artículo se usan corchetes angulares < ... > para identificar los valores que hay que reemplazar antes de ejecutar el script. Reemplace los corchetes y los valores incluidos en ellos.

(1) Recuperación de la identidad administrada de la extensión del controlador de datos de Arc

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Asignación de un rol a la identidad administrada

Ejecute el siguiente comando para asignar el rol Publicador de métricas de supervisión:

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

La carga automática de las métricas se puede habilitar de la siguiente manera:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Para deshabilitar la carga automática de las métricas en Azure Monitor, ejecute el siguiente comando:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Carga de métricas para el controlador de datos de Azure Arc en modo indirecto

En el modo de conexión indirecto, la entidad de servicio se usa para cargar métricas.

Requisitos previos

Antes de continuar, asegúrese de que ha creado la entidad de servicio necesaria y de que le ha asignado un rol adecuado. Para obtener detalles, consulte:

Establecimiento de las variables de entorno finales y confirmación

Establezca la dirección URL de la autoridad de SPN en una variable de entorno:

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Si quiere, asegúrese de que se hayan establecido todas las variables de entorno necesarias:

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Carga de métricas a Azure Monitor

Para cargar métricas para SQL Managed Instance habilitado para Azure Arc y PostgreSQL habilitado para Azure Arc, ejecute los siguientes comandos de la CLI:

  1. Exporte todas las métricas al archivo especificado:

Nota:

La exportación de información de uso o facturación, métricas y registros mediante el comando az arcdata dc export requiere omitir la comprobación de SSL por ahora. Se le pedirá que omita la comprobación de SSL, o bien puede establecer la variable de entorno AZDATA_VERIFY_SSL=no para evitar que se le solicite. Actualmente no hay ninguna manera de configurar un certificado SSL para la API de exportación del controlador de datos.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Cargue las métricas en Azure Monitor:

    az arcdata dc upload --path metrics.json

    Nota:

    Espere al menos 30 minutos después de que se creen las instancias de datos habilitadas para Azure Arc para la primera carga.

    Asegúrese de upload las métricas inmediatamente después de export ya que Azure Monitor solo acepta métricas para los últimos 30 minutos. Más información.

Si ve un error que indica "Error al obtener métricas" durante la exportación, compruebe si la recopilación de datos está establecida en true, ejecutando el comando siguiente:

az arcdata dc config show  --k8s-namespace arc --use-k8s

Consulte la "sección de seguridad".

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Compruebe que las propiedades allowNodeMetricsCollection y allowPodMetricsCollection estén establecidas en true.

Visualización de las métricas en el portal

Una vez que se carguen las métricas, puede verlas en Azure Portal.

Nota:

Tenga en cuenta que los datos cargados pueden tardar un par de minutos en procesarse antes de que pueda ver las métricas en el portal.

Para ver las métricas, vaya a Azure Portal. Después, busque la instancia de la base de datos por nombre en la barra de búsqueda:

Puede ver el uso de la CPU en la página Información general o bien, si quiere métricas más detalladas, puede hacer clic en Métricas en el panel de navegación de la izquierda.

Elija SQL Server como el espacio de nombres de la métrica:

Seleccione la métrica que quiera visualizar (también puede seleccionar varias):

Cambie la frecuencia a los últimos 30 minutos:

Nota:

Solo puede cargar las métricas de los últimos 30 minutos. Azure Monitor rechaza las métricas de más de 30 minutos.

Automatización de cargas (opcional)

Si quiere cargar métricas y registros de forma programada, puede crear un script y ejecutarlo en un temporizador cada pocos minutos. A continuación se muestra un ejemplo de cómo automatizar las cargas mediante un script de shell de Linux.

En el editor de código o texto que prefiera, agregue el siguiente script al archivo y guárdelo como un archivo ejecutable de script como .sh (Linux o Mac) .cmd.bat o .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Conversión del archivo de script en ejecutable

chmod +x myuploadscript.sh

Ejecute el script cada 20 minutos:

watch -n 1200 ./myuploadscript.sh

También puede usar un programador de trabajos como cron o el Programador de tareas de Windows, o bien un orquestador como Ansible, Puppet o Chef.

Instrucciones generales sobre cómo exportar y cargar el uso, métricas

Las operaciones de creación, lectura, actualización y eliminación (CRUD) en los servicios de datos habilitados para Azure Arc se registran con fines de facturación y supervisión. Hay servicios en segundo plano que supervisan para estas operaciones CRUD y calculan el consumo adecuadamente. El cálculo real del uso o del consumo tiene lugar de forma programada y se realiza en segundo plano.

Cargue el uso solo una vez al día. Cuando la información de uso se exporta y se carga varias veces dentro del mismo período de 24 horas, solo se actualiza el inventario de recursos en Azure Portal, pero no en el uso de recursos.

En el caso de la carga de métricas, Azure Monitor solo acepta los últimos 30 minutos de datos (Más información). Las instrucciones para cargar métricas es cargar las métricas inmediatamente después de crear el archivo de exportación para que pueda ver todo el conjunto de datos en Azure Portal. Por ejemplo, si exportó las métricas a las 14:00 horas y ejecutó el comando de carga a las 14:50. Como Azure Monitor solo acepta datos de los últimos 30 minutos, es posible que no vea ningún dato en el portal.

Contenido relacionado

Carga de registros a Azure Monitor

Carga de datos de uso, métricas y registros en Azure Monitor

Carga de datos de facturación en Azure y visualización en Azure Portal

Visualización del recurso de controlador de datos de Azure Arc en Azure Portal