Partilhar via

az arcdata dc debug

Note

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

Depurar controlador de dados.

Comandos

Name Description Tipo Status
az arcdata dc debug controldb-cdc

Habilite/desabilite o CDC no banco de dados e tabelas do controlador de dados - apenas para fins de solução de problemas.

 Extension disponibilidade geral
az arcdata dc debug copy-logs

Copie logs.

 Extension disponibilidade geral
az arcdata dc debug dump

Disparar despejo de memória.

 Extension disponibilidade geral
az arcdata dc debug restore-controldb-snapshot

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

 Extension disponibilidade geral

az arcdata dc debug controldb-cdc

Habilite/desabilite o CDC no banco de dados e tabelas do controlador de dados - apenas para fins de solução de problemas.

Ativar/desativar a captura de dados de alteração para o banco de dados 'controlador' e tabelas suportadas com horas de retenção configuráveis.

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

Exemplos

Permite a captura de dados de alteração 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 Obrigatórios

--k8s-namespace -k

Kubernetes namespace 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

Habilite ou desabilite a captura de dados de alteração.

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

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

Propriedade Valor
Default value: 8
--use-k8s

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az arcdata dc debug copy-logs

Copie logs.

Copie os logs de depuração do controlador de dados - a configuração do Kubernetes é necessária no 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 Obrigatórios

--k8s-namespace -k

Kubernetes namespace 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 pode ser especificado várias vezes. Se especificado várias vezes, o último será usado.

--exclude-arcdata-logs

Excluir ou não 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 do arc data services.

Propriedade Valor
Default value: False
--exclude-cluster-info

Excluir ou não as informações do recurso kubernetes da pasta de resultados por namespace. O valor padrão é False que inclui informações de recurso namespaced.

Propriedade Valor
Default value: False
--exclude-controldb

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

Propriedade Valor
Default value: False
--exclude-dumps

Excluir ou não dumps da pasta de resultados. O valor padrão é False que inclui dumps.

Propriedade Valor
Default value: False
--exclude-system-logs

Se os logs de namespace kube-system e azure-arc devem ou não ser excluídos da coleção. O valor padrão é False que inclui logs kube-system e connectedk8s, se acessível.

Propriedade Valor
Default value: False
--pod

Copie os logs para os pods com nome semelhante. Opcional, por padrão, copia logs para todos os pods. Não pode ser especificado 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 pode ser especificado 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
Default value: False
--target-folder -d

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

--timeout -t

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

Propriedade Valor
Default value: 0
--use-k8s

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az arcdata dc debug dump

Disparar despejo de memória.

Acione o despejo de memória e copie-o 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 Obrigatórios

--k8s-namespace -k

Kubernetes namespace 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 acionado para despejar os processos em execução.

Propriedade Valor
Default value: controller
Valores aceites: controller
--target-folder -d

Pasta de destino para copiar o dump out.

Propriedade Valor
Default value: ./output/dump
--use-k8s

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az arcdata dc debug restore-controldb-snapshot

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

Restaura um backup COPY_ONLY do ControlDB sob 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 - Restaure um backup retirado 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 - Restaure um backup retirado 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 Obrigatórios

--backup-file -f

Arquivo de backup do banco de dados do controlador existente - deve terminar em '.bak', será restaurado sob um nome de banco de dados exclusivo com base no carimbo de data/hora de execução.

--k8s-namespace -k

Kubernetes namespace 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 APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False