Compartilhar via

az arcdata dc debug

Note

Essa referência faz parte da extensão arcdata da CLI do Azure (versão 2.3.1 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az arcdata dc debug. Saiba mais sobre extensões.

Controlador de dados de depuração.

Comandos

Nome Description Tipo Status
az arcdata dc debug controldb-cdc

Habilitar/desabilitar o CDC no Banco de Dados e nas Tabelas do Controlador de Dados – somente para fins de solução de problemas.

 Extension GA
az arcdata dc debug copy-logs

Copiar logs.

 Extension GA
az arcdata dc debug dump

Disparar despejo de memória.

 Extension GA
az arcdata dc debug restore-controldb-snapshot

Restaura uma cópia exclusiva do ControlDB do backup – somente para fins de solução de problemas.

 Extension GA

az arcdata dc debug controldb-cdc

Habilitar/desabilitar o CDC no Banco de Dados e nas Tabelas do Controlador de Dados – somente para fins de solução de problemas.

Habilitar/desabilitar a Captura de Dados de Alteração para o Banco de Dados 'controlador' e tabelas com suporte com horas de retenção configuráveis.

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

Exemplos

Habilita o Change Data Capture com 4 horas de retenção.

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

Desabilita a captura de dados de alteração.

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

Parâmetros Exigidos

--k8s-namespace -k

Namespace do Kubernetes do controlador de dados existente.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enable

Habilitar ou desabilitar a captura de dados de alteração.

Propriedade Valor
Valores aceitos: false, true
--retention-hours

Período de retenção CDC, especificado em horas. Os valores permitidos são de 1 a 24.

Propriedade Valor
Valor padrão: 8
--use-k8s

Use as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az arcdata dc debug copy-logs

Copiar logs.

Copie os logs de depuração do controlador de dados – a configuração do Kubernetes é necessária em seu 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 Exigidos

--k8s-namespace -k

Namespace do Kubernetes do controlador de dados.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container -c

Copie os logs para os contêineres com nome semelhante, Opcional, por padrão copia logs para todos os contêineres. Não é possível especificar várias vezes. Se especificado várias vezes, o último será usado.

--exclude-arcdata-logs

Se deseja ou não excluir os logs dos serviços de dados arc da pasta de resultados. O valor padrão é False, que inclui todos os logs de contêiner dos serviços de dados arc.

Propriedade Valor
Valor padrão: False
--exclude-cluster-info

Se deseja ou não excluir informações de recurso do kubernetes da pasta de resultados por namespace. O valor padrão é False, que inclui informações de recurso com espaçamento de nomes.

Propriedade Valor
Valor padrão: False
--exclude-controldb

Se deseja ou não excluir um backup do controldb da pasta de resultados. O valor padrão é False, que inclui um backup de controldb.

Propriedade Valor
Valor padrão: False
--exclude-dumps

Se deseja ou não excluir despejos da pasta de resultados. O valor padrão é False, que inclui despejos.

Propriedade Valor
Valor padrão: False
--exclude-system-logs

Se deseja ou não excluir logs de namespace do kube-system e do azure-arc da coleção. O valor padrão é False, que inclui logs do sistema kube e connectedk8s, se acessível.

Propriedade Valor
Valor padrão: False
--pod

Copie os logs para os pods com nome semelhante. Opcional, por padrão copia logs para todos os pods. Não é possível especificar várias vezes. Se especificado várias vezes, o último será usado.

--resource-kind

Copie os logs para o recurso de um tipo específico. Não é possível especificar várias vezes. Se especificado várias vezes, o último será usado. Se especificado, --resource-name também deve ser especificado para identificar o recurso.

--resource-name

Copie os logs para o recurso do nome especificado. Não é possível especificar várias vezes. Se especificado várias vezes, o último será usado. Se especificado, --resource-kind também deve ser especificado para identificar o recurso.

--skip-compress

Se deve ou não ignorar a compactação da pasta de resultados. O valor padrão é False, que compacta a pasta de resultados.

Propriedade Valor
Valor padrão: False
--target-folder -d

Caminho da pasta de destino para o qual copiar logs. Opcional, por padrão cria o resultado na pasta local. Não é possível especificar várias vezes. Se especificado várias vezes, o último será usado.

--timeout -t

O número de segundos a aguardar a conclusão do comando. O valor padrão é 0, que é ilimitado.

Propriedade Valor
Valor padrão: 0
--use-k8s

Use as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az arcdata dc debug dump

Disparar despejo de memória.

Disparar despejo de memória e copiá-lo do contêiner – a configuração do Kubernetes é necessária em seu sistema.

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

Parâmetros Exigidos

--k8s-namespace -k

Namespace do Kubernetes do controlador de dados.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container -c

O contêiner de destino a ser disparado para despejar os processos em execução.

Propriedade Valor
Valor padrão: controller
Valores aceitos: controller
--target-folder -d

Pasta de destino para copiar o despejo.

Propriedade Valor
Valor padrão: ./output/dump
--use-k8s

Use as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az arcdata dc debug restore-controldb-snapshot

Restaura uma cópia exclusiva do ControlDB do backup – somente para fins de solução de problemas.

Restaura um backup COPY_ONLY do ControlDB em um nome exclusivo para solução de problemas – a configuração do Kubernetes é necessária em seu sistema.

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

Exemplos

Linux – Restaurar um backup obtido de um comando 'arcdata dc debug copy-logs' executado anteriormente.

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

Windows – Restaurar um backup obtido de um comando 'arcdata dc debug copy-logs' executado anteriormente.

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

Parâmetros Exigidos

--backup-file -f

O arquivo de backup do Banco de Dados do Controlador existente - deve terminar em '.bak', será restaurado em um nome de banco de dados exclusivo com base no carimbo de data/hora de execução.

--k8s-namespace -k

Namespace do Kubernetes do controlador de dados existente.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--use-k8s

Use as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False