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

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

   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 チームは、ケースの優先度とケースを作成した時点でのそれぞれのサポート サービスに基づいて、ケースに対応します。