Share via

Carga de registros a Azure Monitor

  • Artículo

Puede exportar los registros de forma periódica y, a continuación, cargarlos en Azure. La exportación y la carga de los registros también crea y actualiza los recursos del controlador de datos, la instancia administrada de SQL y los recursos del servidor de PostgreSQL en Azure.

Antes de empezar

Antes de poder cargar los registros, debe hacer lo siguiente:

  1. Cree un área de trabajo de Log Analytics
  2. Asignación del identificador y la clave compartida a variables de entorno

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.

Creación de un área de trabajo de Log Analytics

Ejecute estos comandos para crear un área de trabajo de Log Analytics y establecer la información de acceso en variables de entorno.

Nota:

Si ya tiene un área de trabajo, omita este paso.

az monitor log-analytics workspace create --resource-group <resource group name> --workspace-name <some name you choose>

Ejemplo:

{
  "customerId": "d6abb435-2626-4df1-b887-445fe44a4123",
  "eTag": null,
  "id": "/subscriptions/<Subscription ID>/resourcegroups/user-arc-demo/providers/microsoft.operationalinsights/workspaces/user-logworkspace",
  "location": "eastus",
  "name": "user-logworkspace",
  "portalUrl": null,
  "provisioningState": "Succeeded",
  "resourceGroup": "user-arc-demo",
  "retentionInDays": 30,
  "sku": {
    "lastSkuUpdate": "Thu, 30 Jul 2020 22:37:53 GMT",
    "maxCapacityReservationLevel": 3000,
    "name": "pergb2018"
  },
  "source": "Azure",
  "tags": null,
  "type": "Microsoft.OperationalInsights/workspaces"
}

Asignación del identificador y la clave compartida a variables de entorno

Guarde el valor de customerId del área de trabajo de Log Analytics como una variable de entorno que se utilizará más adelante:

SET WORKSPACE_ID=<customerId>

Este comando devuelve las claves de acceso necesarias para conectarse al área de trabajo de Log Analytics:

az monitor log-analytics workspace get-shared-keys --resource-group MyResourceGroup --workspace-name MyLogsWorkpace

Ejemplo:

{
  "primarySharedKey": "JXzQp1RcGgjXFCDS3v0sXoxPvbgCoGaIv35lf11Km2WbdGFvLXqaydpaj1ByWGvKoCghL8hL4BRoypXxkLr123==",
  "secondarySharedKey": "p2XHSxLJ4o9IAqm2zINcEmx0UWU5Z5EZz8PQC0OHpFjdpuVaI0zsPbTv5VyPFgaCUlCZb2yEbkiR4eTuTSF123=="
}

Guarde la clave principal en una variable de entorno para usarla más adelante:

SET WORKSPACE_SHARED_KEY=<primarySharedKey>

Verificación de las variables de entorno

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

echo %WORKSPACE_ID%
echo %WORKSPACE_SHARED_KEY%

Con las variables de entorno establecidas, puede cargar los registros en el área de trabajo de registro.

Configuración de la carga automática de registros en el área de trabajo de Azure Log Analytics en modo directo mediante la CLI de az

En el modo de conexión directa, la carga de registros solo se puede configurar en modo automático. Esta carga automática de métricas se puede configurar durante o después de la implementación del controlador de datos de Azure Arc.

Habilitación de la carga automática de registros en el área de trabajo de Azure Log Analytics

Si la carga automática de registros se deshabilitó durante la implementación del controlador de datos de Azure Arc, ejecute el siguiente comando para habilitarla.

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

Habilitación de la carga automática de registros en el área de trabajo de Azure Log Analytics

Si la carga automática de registros se ha habilitado durante la implementación del controlador de datos de Azure Arc, ejecute el siguiente comando para deshabilitarla.

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

Configuración de la carga automática de registros en el área de trabajo de Azure Log Analytics en modo directo mediante la CLI de kubectl

Habilitación de la carga automática de registros en el área de trabajo de Azure Log Analytics

Para configurar la carga automática de registros mediante kubectl:

  • Asegúrese de que el área de trabajo de Log Analytics se crea como se ha descrito en la sección anterior.
  • Cree un secreto de Kubernetes para el área de trabajo de Log Analytics mediante WorkspaceID y SharedAccessKey como se indica a continuación:
apiVersion: v1
data:
  primaryKey: <base64 encoding of Azure Log Analytics workspace primary key>
  workspaceId: <base64 encoding of Azure Log Analytics workspace Id>
kind: Secret
metadata:
  name: log-workspace-secret
  namespace: <your datacontroller namespace>
type: Opaque

  • Para crear el secreto, ejecute:

    kubectl apply -f <myLogAnalyticssecret.yaml> --namespace <mynamespace>

  • Para abrir la configuración como un archivo yaml en el editor predeterminado, ejecute:

    kubectl edit datacontroller <DC name> --name <namespace>

  • Actualice la propiedad autoUploadLogs a "true"y guarde el archivo.

Habilitación de la carga automática de registros en el área de trabajo de Azure Log Analytics

Para deshabilitar la carga automática de registros, ejecute:

kubectl edit datacontroller <DC name> --name <namespace>
  • Actualice la propiedad autoUploadLogs a "false"y guarde el archivo.

Actualización de registros en Azure Monitor en modo indirecto

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

  1. Se exportan todos los registros 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 logs --path logs.json  --k8s-namespace arc

  2. Cargue los registros en un área de trabajo de Log Analytics en Azure Monitor:

    az arcdata dc upload --path logs.json

Visualización de los registros en Azure Portal

Una vez que se hayan cargado los registros, debería poder consultarlos mediante el explorador de consultas de registros como se indica a continuación:

  1. Abra Azure Portal, busque el área de trabajo por su nombre en la barra de búsqueda de la parte superior y, a continuación, selecciónela.
  2. Seleccione Registros en el panel de la izquierda.
  3. Seleccione Comenzar (o bien los vínculos de la página Comenzar para más información sobre Log Analytics si no está familiarizado con el producto).
  4. Siga el tutorial para más información sobre Log Analytics si es la primera vez que utiliza Log Analytics.
  5. Expanda Registros personalizados en la parte inferior de la lista de tablas y verá una tabla llamada "sql_instance_logs_CL" o "postgresInstances_postgresql_logs_CL".
  6. Seleccione el icono de ojo situado junto al nombre de la tabla.
  7. Seleccione el botón "Ver en el editor de consultas".
  8. Ahora tendrá una consulta en el editor de consultas que mostrará los 10 eventos más recientes del registro.
  9. Desde aquí, puede experimentar con la consulta de los registros mediante el editor de consultas, establecer alertas, etc.

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 bien .ps1 (Windows).

az arcdata dc export --type logs --path logs.json --force --k8s-namespace arc
az arcdata dc upload --path logs.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.

Contenido relacionado

Carga de métricas en 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