az arcdata dc debug

Note

このリファレンスは、Azure CLI (バージョン 2.3.1 以降) の arcdata 拡張機能の一部です。 拡張機能は、az arcdata dc debug コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

データ コントローラーをデバッグします。

コマンド

名前	説明	型	Status
az arcdata dc debug controldb-cdc	データ コントローラー データベースとテーブルで CDC を有効または無効にする - トラブルシューティングのみを目的としています。	拡張	GA
az arcdata dc debug copy-logs	ログをコピーします。	拡張	GA
az arcdata dc debug dump	メモリ ダンプをトリガーします。	拡張	GA
az arcdata dc debug restore-controldb-snapshot	トラブルシューティングのみを目的として、バックアップから ControlDB の一意のコピーを復元します。	拡張	GA

az arcdata dc debug controldb-cdc

データ コントローラー データベースとテーブルで CDC を有効または無効にする - トラブルシューティングのみを目的としています。

"コントローラー" データベースとサポートされているテーブルの変更データ キャプチャを有効または無効にし、保持時間を構成できます。

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

例

4 時間のリテンション期間で変更データ キャプチャを有効にします。

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

変更データ キャプチャを無効にします。

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

必須のパラメーター

--k8s-namespace -k

既存のデータ コントローラーの Kubernetes 名前空間。

省略可能のパラメーター

--enable

変更データ キャプチャを有効または無効にします。

承認された値: false, true

--retention-hours

CDC 保有期間 (時間単位で指定)。 使用できる値は 1 ~ 24 です。

既定値: 8

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc debug copy-logs

ログをコピーします。

データ コントローラーからデバッグ ログをコピーします。お使いのシステムには、Kubernetes を構成する必要があります。

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]

必須のパラメーター

--k8s-namespace -k

データ コントローラーの Kubernetes 名前空間。

省略可能のパラメーター

--container -c

類似した名前のコンテナーのログをコピーします (省略可能)。既定では、すべてのコンテナーのログがコピーされます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。

--exclude-arcdata-logs

結果フォルダーから Arc データ サービス ログを除外するかどうかを指定します。 既定値は False で、すべての Arc データ サービス コンテナー ログが含まれます。

既定値: False

--exclude-cluster-info

名前空間ごとの結果フォルダーから kubernetes リソース情報を除外するかどうかを指定します。 既定値は False で、名前空間付きリソース情報が含まれます。

既定値: False

--exclude-controldb

controldb のバックアップを結果フォルダーから除外するかどうかを指定します。 既定値は False で、controldb バックアップが含まれています。

既定値: False

--exclude-dumps

結果フォルダーからダンプを除外するかどうかを指定します。 既定値は False で、ダンプを含めます。

既定値: False

--exclude-system-logs

kube-system と azure-arc 名前空間のログをコレクションから除外するかどうか。 既定値は False で、kube-system ログと connectedk8s ログ (アクセス可能な場合) が含まれます。

既定値: False

--pod

類似した名前のポッドのログをコピーします。 省略可能。既定では、すべてのポッドのログがコピーされます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。

--resource-kind

特定の種類のリソースのログをコピーします。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。 指定する場合は、リソースを識別する --resource-name も指定する必要があります。

--resource-name

指定した名前のリソースのログをコピーします。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。 指定する場合は、リソースを識別する --resource-kind も指定する必要があります。

--skip-compress

結果フォルダーの圧縮をスキップするかどうかを指定します。 既定値は False で、結果フォルダーを圧縮します。

既定値: False

--target-folder -d

ログのコピー先となるターゲット フォルダーのパス。 省略可能。既定では、ローカル フォルダー内に結果が作成されます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。

--timeout -t

コマンドが完了するまで待機する秒数。 既定値は 0 で、無制限です。

既定値: 0

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc debug dump

メモリ ダンプをトリガーします。

メモリ ダンプをトリガーし、それをコンテナーからコピーします。システム上に Kubernetes の構成が必要です。

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

必須のパラメーター

--k8s-namespace -k

データ コントローラーの Kubernetes 名前空間。

省略可能のパラメーター

--container -c

実行中のプロセスをダンプするためにトリガーされるターゲット コンテナー。

承認された値: controller

既定値: controller

--target-folder -d

ダンプをコピーするターゲット フォルダー。

既定値: ./output/dump

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc debug restore-controldb-snapshot

トラブルシューティングのみを目的として、バックアップから ControlDB の一意のコピーを復元します。

トラブルシューティングのために一意の名前で ControlDB のCOPY_ONLY バックアップを復元します。Kubernetes 構成はシステムで必要です。

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

例

Linux - 以前に実行した "arcdata dc debug copy-logs" コマンドから取得したバックアップを復元します。

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

Windows - 以前に実行した "arcdata dc debug copy-logs" コマンドから取得したバックアップを復元します。

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

必須のパラメーター

--backup-file -f

既存のコントローラー データベース バックアップ ファイルは、実行タイムスタンプに基づいて一意のデータベース名で復元されます。末尾が '.bak' である必要があります。

--k8s-namespace -k

既存のデータ コントローラーの Kubernetes 名前空間。

省略可能のパラメーター

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。