Carga de datos de uso en Azure en el modo indirecto
Puede exportar la información de uso de forma periódica. La exportación y la carga de esta información crea y actualiza los recursos del controlador de datos, la instancia administrada de SQL y los recursos de PostgreSQL en Azure.
Nota:
La información de uso se carga automáticamente en el caso del controlador de datos de Azure Arc implementado en el modo de conexión directa. Las instrucciones de este artículo solo se aplican a la carga de información de uso en el caso del controlador de datos de Azure Arc implementado en el modo de conexión indirecta.
Espere al menos 24 horas después de crear el controlador de datos de Azure Arc antes de cargar los datos de uso.
Creación de una entidad de servicio y asignación de roles
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:
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.
Carga de datos de uso
La información de uso, como el inventario y el uso de recursos, se puede cargar en Azure con el siguiente método de dos pasos:
- Exporte los datos de uso mediante comando
az arcdata dc export, como se indica a continuación:
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 usage --path usage.json --k8s-namespace <namespace> --use-k8s
Este comando crea un archivo usage.json con todos los recursos de datos habilitados para Azure Arc, como instancias administradas de SQL e instancias de PostgreSQL, etc., que se crean en el controlador de datos.
Por ahora, el archivo no está cifrado para que pueda ver el contenido. No dude en abrirlo en un editor de texto y ver el aspecto del contenido.
Observará que hay dos conjuntos de datos: resources y data. resources son el controlador de datos, PostgreSQL y las instancias administradas de SQL. Los registros resources de los datos capturan los eventos pertinentes en el historial de un recurso: cuándo se ha creado, actualizado y eliminado. Los registros data capturan el número de núcleos disponibles para que los use una instancia determinada cada hora.
Ejemplo de una entrada de resource:
{
"customObjectName": "<resource type>-2020-29-5-23-13-17-164711",
"uid": "4bc3dc6b-9148-4c7a-b7dc-01afc1ef5373",
"instanceName": "sqlInstance001",
"instanceNamespace": "arc",
"instanceType": "<resource>",
"location": "eastus",
"resourceGroupName": "production-resources",
"subscriptionId": "482c901a-129a-4f5d-86e3-cc6b294590b2",
"isDeleted": false,
"externalEndpoint": "32.191.39.83:1433",
"vCores": "2",
"createTimestamp": "05/29/2020 23:13:17",
"updateTimestamp": "05/29/2020 23:13:17"
}
Ejemplo de una entrada de data:
{
"requestType": "usageUpload",
"clusterId": "4b0917dd-e003-480e-ae74-1a8bb5e36b5d",
"name": "DataControllerTestName",
"subscriptionId": "482c901a-129a-4f5d-86e3-cc6b294590b2",
"resourceGroup": "production-resources",
"location": "eastus",
"uploadRequest": {
"exportType": "usages",
"dataTimestamp": "2020-06-17T22:32:24Z",
"data": "[{\"name\":\"sqlInstance001\",
\"namespace\":\"arc\",
\"type\":\"<resource type>\",
\"eventSequence\":1,
\"eventId\":\"50DF90E8-FC2C-4BBF-B245-CB20DC97FF24\",
\"startTime\":\"2020-06-17T19:11:47.7533333\",
\"endTime\":\"2020-06-17T19:59:00\",
\"quantity\":1,
\"id\":\"4BC3DC6B-9148-4C7A-B7DC-01AFC1EF5373\"}]",
"signature":"MIIE7gYJKoZIhvcNAQ...2xXqkK"
}
}
Cargue los datos de uso mediante el comando
upload.az arcdata dc upload --path usage.json
Frecuencia de carga
En el modo indirecto, la información de uso debe cargarse en Azure al menos una vez en cada 30 días. Se recomienda encarecidamente efectuar la carga con más frecuencia, por ejemplo, diariamente. Si la información de uso no se carga después de 32 días, observará degradación en el servicio, como no poder aprovisionar ningún nuevo recurso.
Habrá dos tipos de notificaciones para cargas de uso retrasadas: la fase de advertencia y la fase degradada. En la fase de advertencia recibirá un mensaje como Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Please upload billing data as soon as possible..
En la fase degradada, el mensaje tendrá un aspecto similar a Billing data for the Azure Arc data controller has not been uploaded in {0} hours. Some functionality will not be available until the billing data is uploaded..
Nota:
Verá el mensaje de advertencia si el uso no se ha cargado durante más de 48 horas.
La página de información general de Azure Portal para el controlador de datos y el estado del recurso personalizado del controlador de datos en el clúster de Kubernetes indicarán la fecha de la última carga y los mensajes de estado.
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) o bien .cmd, .bat o .ps1.
az arcdata dc export --type usage --path usage.json --force --k8s-namespace <namespace> --use-k8s
az arcdata dc upload --path usage.json
Conversión del archivo de script en ejecutable
chmod +x myuploadscript.sh
Ejecute el script todos los días para su uso:
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.
Contenido relacionado
Carga de métricas en Azure Monitor
Carga de registros a 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