az arcdata dc debug

Nota:

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 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.	Extensión	GA
az arcdata dc debug copy-logs	Copie registros.	Extensión	GA
az arcdata dc debug dump	Volcado de memoria del desencadenador.	Extensión	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.	Extensión	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

--enable

Habilite o deshabilite la captura de datos modificados.

valores aceptados: false, true

--retention-hours

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc debug copy-logs

Copie registros.

Copia los registros de depuración del controlador de datos; es necesario que Kubernetes esté configurado 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

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

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.

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.

valor predeterminado: False

--exclude-dumps

Indica si se excluyen o no los volcados de la carpeta de resultados. El valor predeterminado es False, que incluye los volcados.

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.

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

Copia los registros para el 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

Copia los registros para el 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 omite o no la compresión de la carpeta de resultados. El valor predeterminado es False, que comprime la carpeta de resultados.

valor predeterminado: False

--target-folder -d

Ruta de acceso de la carpeta de destino en la que copiar los 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 debe esperar a que se complete el comando. El valor predeterminado es 0, que es ilimitado.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc debug dump

Volcado de memoria del desencadenador.

Desencadene el volcado de registros y cópielo del contenedor; es necesario que Kubernetes esté configurado 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

--container -c

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

valores aceptados: controller

valor predeterminado: controller

--target-folder -d

Carpeta de destino para copiar el volcado de memoria.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--use-k8s

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.