Compartir a través de

az arcdata dc debug

Note

Esta referencia forma parte de la extensión arcdata para la CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az arcdata dc debug. Obtenga más información sobre las extensiones.

Depurar el controlador de datos.

Comandos

Nombre Description Tipo Estado
az arcdata dc debug controldb-cdc

Habilite o deshabilite CDC en las tablas y la base de datos del controlador de datos, solo con fines de solución de problemas.

 Extension GA
az arcdata dc debug copy-logs

Copiar registros.

 Extension GA
az arcdata dc debug dump

Desencadene el volcado de memoria.

 Extension GA
az arcdata dc debug restore-controldb-snapshot

Restaura una copia única de ControlDB a partir de la copia de seguridad, solo con fines de solución de problemas.

 Extension GA

az arcdata dc debug controldb-cdc

Habilite o deshabilite CDC en las tablas y la base de datos del controlador de datos, solo con fines de solución de problemas.

Habilite o deshabilite la captura de datos modificados para la base de datos "controlador" y las tablas admitidas con horas de retención configurables.

az arcdata dc debug controldb-cdc --k8s-namespace
                                  [--enable {false, true}]
                                  [--retention-hours]
                                  [--use-k8s]

Ejemplos

Habilita la captura de datos modificados con 4 horas de retención.

az arcdata dc debug controldb-cdc -k arc-data-services --enable true --retention-hours 4

Deshabilita la captura de datos modificados.

az arcdata dc debug controldb-cdc -k arc-data-services --enable false

Parámetros requeridos

--k8s-namespace -k

Espacio de nombres de Kubernetes del controlador de datos existente.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--enable

Habilite o deshabilite la captura de datos modificados.

Propiedad Valor
Valores aceptados: false, true
--retention-hours

Período de retención CDC, especificado en horas. Los valores permitidos son de 1 a 24.

Propiedad Valor
Valor predeterminado: 8
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc debug copy-logs

Copiar registros.

Copie los registros de depuración del controlador de datos: se requiere la configuración de Kubernetes en el sistema.

az arcdata dc debug copy-logs --k8s-namespace
                              [--container]
                              [--exclude-arcdata-logs]
                              [--exclude-cluster-info]
                              [--exclude-controldb]
                              [--exclude-dumps]
                              [--exclude-system-logs]
                              [--pod]
                              [--resource-kind]
                              [--resource-name]
                              [--skip-compress]
                              [--target-folder]
                              [--timeout]
                              [--use-k8s]

Parámetros requeridos

--k8s-namespace -k

Espacio de nombres de Kubernetes del controlador de datos.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--container -c

Copie los registros de los contenedores con un nombre similar, Opcional, de forma predeterminada copia los registros de todos los contenedores. No se puede especificar varias veces. Si se especifica varias veces, se usará la última.

--exclude-arcdata-logs

Si se van a excluir o no registros de servicios de datos de arco de la carpeta de resultados. El valor predeterminado es False, que incluye todos los registros de contenedor de servicios de datos de arco.

Propiedad Valor
Valor predeterminado: False
--exclude-cluster-info

Si se va a excluir o no la información de recursos de Kubernetes de la carpeta de resultados por espacio de nombres. El valor predeterminado es False, que incluye información de recursos con espacio de nombres.

Propiedad Valor
Valor predeterminado: False
--exclude-controldb

Si se va a excluir o no una copia de seguridad de controldb de la carpeta de resultados. El valor predeterminado es False, que incluye una copia de seguridad de controldb.

Propiedad Valor
Valor predeterminado: False
--exclude-dumps

Si se van a excluir o no volcados de la carpeta de resultados. El valor predeterminado es False, que incluye volcados de memoria.

Propiedad Valor
Valor predeterminado: False
--exclude-system-logs

Indica si se van a excluir los registros de espacio de nombres kube-system y azure-arc de la colección. El valor predeterminado es False, que incluye los registros kube-system y connectedk8s, si es accesible.

Propiedad Valor
Valor predeterminado: False
--pod

Copie los registros de los pods con un nombre similar. Opcional, de forma predeterminada copia los registros de todos los pods. No se puede especificar varias veces. Si se especifica varias veces, se usará la última.

--resource-kind

Copie los registros del recurso de un tipo determinado. No se puede especificar varias veces. Si se especifica varias veces, se usará la última. Si se especifica, también se debe especificar --resource-name para identificar el recurso.

--resource-name

Copie los registros del recurso del nombre especificado. No se puede especificar varias veces. Si se especifica varias veces, se usará la última. Si se especifica, también se debe especificar --resource-kind para identificar el recurso.

--skip-compress

Indica si se va a omitir la compresión de la carpeta de resultados. El valor predeterminado es False, que comprime la carpeta de resultados.

Propiedad Valor
Valor predeterminado: False
--target-folder -d

Ruta de acceso de carpeta de destino a la que copiar registros. Opcional, de forma predeterminada crea el resultado en la carpeta local. No se puede especificar varias veces. Si se especifica varias veces, se usará la última.

--timeout -t

Número de segundos que se va a esperar a que se complete el comando. El valor predeterminado es 0, que es ilimitado.

Propiedad Valor
Valor predeterminado: 0
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc debug dump

Desencadene el volcado de memoria.

Desencadene el volcado de memoria y cópielo desde el contenedor: se requiere la configuración de Kubernetes en el sistema.

az arcdata dc debug dump --k8s-namespace
                         [--container {controller}]
                         [--target-folder]
                         [--use-k8s]

Parámetros requeridos

--k8s-namespace -k

Espacio de nombres de Kubernetes del controlador de datos.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--container -c

Contenedor de destino que se va a desencadenar para volcar los procesos en ejecución.

Propiedad Valor
Valor predeterminado: controller
Valores aceptados: controller
--target-folder -d

Carpeta de destino para copiar el volcado de memoria.

Propiedad Valor
Valor predeterminado: ./output/dump
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc debug restore-controldb-snapshot

Restaura una copia única de ControlDB a partir de la copia de seguridad, solo con fines de solución de problemas.

Restaura una COPY_ONLY copia de seguridad de ControlDB con un nombre único para solucionar problemas: se requiere la configuración de Kubernetes en el sistema.

az arcdata dc debug restore-controldb-snapshot --backup-file
                                               --k8s-namespace
                                               [--use-k8s]

Ejemplos

Linux: restaure una copia de seguridad tomada de un comando "arcdata dc debug copy-logs".

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f /path/to/backup/controller-1675653451.bak

Windows: restaure una copia de seguridad tomada de un comando "arcdata dc debug copy-logs".

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f C:\path\to\backup\controller-1675653451.bak

Parámetros requeridos

--backup-file -f

Archivo de copia de seguridad de base de datos de controlador existente: debe terminar en ".bak", se restaurará en un nombre de base de datos único basado en la marca de tiempo de ejecución.

--k8s-namespace -k

Espacio de nombres de Kubernetes del controlador de datos existente.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False