az arcdata dc debug

  • Referência

Nota

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

 Extensão GA
az arcdata dc debug copy-logs

Copie logs.

 Extensão GA
az arcdata dc debug dump

Disparar despejo de memória.

 Extensão GA
az arcdata dc debug restore-controldb-snapshot

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

 Extensão GA

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

--enable

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

valores aceites: false, true
--retention-hours

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

valor predefinido: 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

valor predefinido: 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.

valor predefinido: 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.

valor predefinido: False
--exclude-dumps

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

valor predefinido: 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.

valor predefinido: False
--pod

Copie os logs para os pods com nome semelhante. Opcional, por padrão, copia os logs de 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.

valor predefinido: 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.

valor predefinido: 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

--container -c

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

valores aceites: controller
valor predefinido: controller
--target-folder -d

Pasta de destino para copiar o dump out.

valor predefinido: ./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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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