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
必須のパラメーター
既存のデータ コントローラーの Kubernetes 名前空間。
省略可能のパラメーター
変更データ キャプチャを有効または無効にします。
CDC 保有期間 (時間単位で指定)。 使用できる値は 1 ~ 24 です。
このアクションを実行するには、ローカルの Kubernetes API を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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]
必須のパラメーター
データ コントローラーの Kubernetes 名前空間。
省略可能のパラメーター
類似した名前のコンテナーのログをコピーします (省略可能)。既定では、すべてのコンテナーのログがコピーされます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。
結果フォルダーから Arc データ サービス ログを除外するかどうかを指定します。 既定値は False で、すべての Arc データ サービス コンテナー ログが含まれます。
名前空間ごとの結果フォルダーから kubernetes リソース情報を除外するかどうかを指定します。 既定値は False で、名前空間付きリソース情報が含まれます。
controldb のバックアップを結果フォルダーから除外するかどうかを指定します。 既定値は False で、controldb バックアップが含まれています。
結果フォルダーからダンプを除外するかどうかを指定します。 既定値は False で、ダンプを含めます。
kube-system と azure-arc 名前空間のログをコレクションから除外するかどうか。 既定値は False で、kube-system ログと connectedk8s ログ (アクセス可能な場合) が含まれます。
類似した名前のポッドのログをコピーします。 省略可能。既定では、すべてのポッドのログがコピーされます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。
特定の種類のリソースのログをコピーします。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。 指定する場合は、リソースを識別する --resource-name も指定する必要があります。
指定した名前のリソースのログをコピーします。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。 指定する場合は、リソースを識別する --resource-kind も指定する必要があります。
結果フォルダーの圧縮をスキップするかどうかを指定します。 既定値は False で、結果フォルダーを圧縮します。
ログのコピー先となるターゲット フォルダーのパス。 省略可能。既定では、ローカル フォルダー内に結果が作成されます。 複数回指定することはできません。 複数回指定した場合は、最後のものが使用されます。
コマンドが完了するまで待機する秒数。 既定値は 0 で、無制限です。
このアクションを実行するには、ローカルの Kubernetes API を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az arcdata dc debug dump
メモリ ダンプをトリガーします。
メモリ ダンプをトリガーし、それをコンテナーからコピーします。システム上に Kubernetes の構成が必要です。
az arcdata dc debug dump --k8s-namespace
[--container {controller}]
[--target-folder]
[--use-k8s]
必須のパラメーター
データ コントローラーの Kubernetes 名前空間。
省略可能のパラメーター
実行中のプロセスをダンプするためにトリガーされるターゲット コンテナー。
ダンプをコピーするターゲット フォルダー。
このアクションを実行するには、ローカルの Kubernetes API を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
既存のコントローラー データベース バックアップ ファイルは、実行タイムスタンプに基づいて一意のデータベース名で復元されます。末尾が '.bak' である必要があります。
既存のデータ コントローラーの Kubernetes 名前空間。
省略可能のパラメーター
このアクションを実行するには、ローカルの Kubernetes API を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI