AlloyDB Omni ダンプファイルを生成して診断する

このページでは、AlloyDB Omni システム ダンプファイルを生成して、予期しない問題の原因を分析する方法について説明します。

始める前に

インストールした AlloyDB Omni Docker イメージに含まれている alloydb-sysdump ユーティリティを抽出します。

Docker

  docker run --rm --entrypoint /bin/bash $IMAGE -c "cat /usr/lib/postgresql/15/bin/alloydb-sysdump" > /tmp/alloydb-sysdump
  chmod +x /tmp/alloydb-sysdump

Podman

  podman run --rm --entrypoint /bin/bash $IMAGE -c "cat /usr/lib/postgresql/15/bin/alloydb-sysdump" > /tmp/alloydb-sysdump
  chmod +x /tmp/alloydb-sysdump

AlloyDB Omni ダンプファイルを生成する

AlloyDB Omni ダンプファイルはいつでも手動で生成できます。ダンプファイルを調べることで、ユーザーや Google Cloud のカスタマーケアが、新しい接続をブロックするデッドロック、クエリの遅延、バキュームの遅延、メモリ、CPU、ストレージの高い使用率など、AlloyDB Omni のインストールに関する問題を分析できます。

次のコマンドを実行して、ダンプファイルを生成します。

   sudo /tmp/alloydb-sysdump -D=INSTALL_PATH -U=USERNAME -p=PORT -H=HOSTNAME -c=CONTAINER_NAME

次のように置き換えます。

  • INSTALL_PATH: ホスト ファイル システムからアクセスできる AlloyDB Omni インストール ディレクトリのパス。
  • USERNAME: データベースに接続するユーザーの名前。
  • PORT: AlloyDB Omni が接続を受け入れる TCP ポート。デフォルト値は 5432 です。
  • HOSTNAME: AlloyDB Omni が実行されているマシンのホスト名。値がスラッシュで始まる場合、Unix ドメイン ソケットのディレクトリとして使用されます。デフォルト値は localhost です。

  • CONTAINER_NAME: AlloyDB Omni が実行されるコンテナの名前。

    コマンドの出力には、システム ダンプファイルの場所が表示されます。

    コマンド引数の詳細を確認するには、以下を実行します。

     /tmp/alloydb-sysdump --help

AlloyDB Omni ダンプファイルを確認する

AlloyDB Omni ダンプファイルは、システムの状態のさまざまな側面を要約した通常のテキスト ファイルです。確認するには、テキスト エディタ、less プログラム、またはテキスト ファイルを表示するほかのプログラムで開きます。

AlloyDB Omni はファイルをデータ ディレクトリに保存し、ファイル名に alloydb_system_dump_ とタイムスタンプを追加します。例: alloydb_system_dump_20240614_062953PM

サポートケースを作成してサポートを受ける

AlloyDB Omni の問題のトラブルシューティングにシステム ダンプファイルの解釈に関するサポートが必要な場合は、サポートケースを作成してファイルを添付してください。サポートケースを作成するには、 Google Cloud アカウントが必要です。

AlloyDB チームは、ケースを作成した時点でのケースの優先度およびそれぞれのサポート サービスに基づいて、ケースに対応しています。