同時稼働するコンテナ向けにHome Assistantのデータベース接続を最適化する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

Home Assistantのデータベース接続を最適化するには、1つのプールを最大化するのではなく、すべてのコンテナを対象に総数の予算を組みます。データベース管理とバックグラウンド処理用の余裕を確保したうえで、複数のコンテナが同時に起動するときと、通常の書き込みが最も多い時間帯にRecorderを検証してください。

MariaDBまたはPostgreSQLを共有ホストで運用する場合、重要なのは各サービスで可能な接続数に稼働中のインスタンス数を掛けた値を合計し、さらにメンテナンス用と緊急アクセス用の分を加えた数です。アクティブ、アイドル、待機中、失敗した接続を、クエリ遅延やストレージ負荷と合わせて測定してください。SQLiteを使用している場合はここで終了してください。同じデータベースファイルにコンテナを追加しても、接続プールの調整にはなりません。

データベースの構成と現在の接続需要を確認する

データベースエンジンとバージョン、Home Assistant RecorderのURL、ほかのすべてのクライアントコンテナ、レプリカ数、設定済みのプール、タイムアウト、再試行の動作、再起動ポリシーを記録します。アクティブなセッションを正しく特定できるよう、各サービスに専用のデータベースユーザーがあることを確認してください。

データベースの最大接続数、ユーザーと状態別の現在のセッション数、起動時および通常負荷時のピークセッション数、待機、クエリ遅延、CPU、メモリ、ストレージ遅延を測定します。接続数の多さは、原因ではなく処理の遅さによる症状かもしれません。飽和したディスクにセッションを追加すると、通常は競合が増えます。

同時接続数を調整する前に、ZimaSpaceのHome Assistantの外部データベースの信頼性ガイドを参照して、バックアップ、スキーマ権限、エンジンのサポート状況、アップグレード時の制約を確認してください。

すべてのコンテナを対象に接続予算を組む

データベース管理、監視、マイグレーション、バックアップ、エンジン内部の処理用に接続を確保してください。残りのアプリケーション用接続数は、搭載RAMやコピーしたmax-connectionsの値ではなく、実測した同時処理量に応じてサービス間で割り当てます。

複数インスタンスで動作するサービスの接続プールに関する指針では、重要な計算式が明示されています。データベースが対応できる必要があるのは、プールサイズとインスタンス数の積です。この考え方は広く当てはまりますが、Home Assistantとデータベースの各バージョンで、個別にサポート対象の設定を確認する必要があります。

まずはプールとキューの上限を設定します。需要が一時的にプールを超える場合、無制限にセッションを開くより待機させるほうが安全です。待ち時間がユーザーに認識されるようになったら、プールを拡大する前にクエリとストレージの遅延を調べてください。障害が無期限にハングせず表面化するよう、接続と取得に明示的なタイムアウトを設定します。

再起動、リトライ、アイドル接続を制御する

コンテナの起動をずらし、Home Assistant、ダッシュボード、分析、バックアップ、インポート処理が一斉に再接続やマイグレーションを行わないようにしてください。実際のデータベースの準備完了を確認するヘルスチェックを使用しつつ、データベースの復旧中に接続が殺到するような短い間隔のリトライループは避けてください。

アイドル接続の有効期間と再利用の動作は、データベース、ドライバー、プロキシ、ネットワークのタイムアウトを考慮して設定してください。プールが切断済みのセッションを長く保持するとエラーが発生し、接続を頻繁に作り直しすぎると認証や初期化の負荷が増えます。タイムアウトの層は一度に1つずつ変更してください。

接続プロキシを導入する場合は、テスト環境でトランザクションのセマンティクス、マイグレーション、プリペアドステートメント、Home Assistantとの互換性を確認してください。プロキシは、スロークエリ、ロック、メモリ、ストレージの診断の代わりにはなりません。

同時接続数を増やす前にデータベースの処理負荷を減らす

Recorderのデータ保持期間、高頻度エンティティの除外設定、パージ動作、データベースのサイズ、スロークエリを確認してください。Home Assistantのクエリが接続を長時間占有している場合は、不要なデータの削減やストレージのレイテンシ改善のほうが、セッションを追加するより安全にスループットを向上できます。

新しいパイプラインの所有権とデータ保持モデルが明確な場合に限り、負荷の大きい分析や長期メトリクスをRecorderから分離してください。無関係なコンテナをHome Assistantのスキーマに接続したり、Recorderのテーブルに書き込ませたりしないでください。サポートされているAPIまたは独立したデータベースを使用してください。

データベースサーバーの上限を引き上げる前に、接続あたりのメモリ、バッファ設定、ロック待ち、ストレージのレイテンシを再確認してください。計画したピーク時にもサーバーが応答性を保ち、復旧と管理に十分な容量が必要です。

同時起動とRecorderのピーク負荷のもとで検証する

計画した順序でデータベースとクライアントのコンテナを再起動し、次に安全に再現できる最も負荷の高い重複タイミングでテストします。Home Assistantの起動、履歴クエリ、インポート、バックアップ、別サービスのピークを同時に発生させます。接続数、接続取得の待ち時間、失敗、クエリのレイテンシ、ロック、ホストのI/Oを監視してください。

適切な設定では、Home Assistantの操作と履歴表示が快適で、接続数の上限を守り、管理者アクセスを維持し、ピーク後に一時的なキューが解消されます。再起動を2回行い、次回の定期メンテナンス時間帯も観察して、設定が維持されることを確認してください。

タイムアウト、接続数超過エラー、データベースのメモリ逼迫、またはRecorderのバックログが悪化した場合は、設定を元に戻してください。最大接続数だけでなく、トポロジー、ユーザーごとのセッション数、プール設定、スロークエリの証拠、ストレージ指標を添えてエスカレーションしてください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.