Home Assistantのログでシステムディスクがいっぱいになるのを防ぐ方法

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

Home Assistantのログでディスクがいっぱいになるのを防ぐには、まず正確に増え続けているファイルを特定し、繰り返し発生するイベントを修正したうえで、そのログを管理する層で保持期間を設定します。

小規模なホームサーバーでは、Home Assistant Coreのログ、Dockerログ、Supervisorやアドオンのログ、ホストのジャーナルが、いずれも同じシステムディスクを消費する可能性がありますが、それぞれ必要な対処は異なります。短時間の管理された計測で増加量を測り、出力元を特定するのに十分な証拠を残し、元に戻せる制限を適用してください。残り容量が安全な再起動やバックアップに足りない場合は、不要不急の書き込みを停止してください。

容量を消費しているログを特定する

まず空き容量全体を記録し、影響を受けているファイルシステム上の最大サイズのファイルとディレクトリを、何も削除せずに一覧表示します。Home Assistantを通常どおり動かしたまま、5〜10分後に再びサイズを比較します。古くて大きなファイルの静的な一覧より、サイズが変化したファイルのほうが有用です。

Home Assistantの事例から、ディスク容量の不足はRecorderデータベースだけでなく、システムログなど複数の層で発生することが分かります。解決済みのある議論では、容量増加の原因がsystemdジャーナルだと特定されました。まず確認すべきなのは、Home Assistantが忙しそうかどうかではなく、「どのディレクトリが増え続けているか」です。

Coreのログが増える場合は、繰り返されるコンポーネントとメッセージを調べます。DockerのJSONログが増える場合は、コンテナのログドライバーを調べます。ジャーナルが増える場合は、ログを出力しているサービスを調べます。空き容量がすでに危険なほど少ない場合は、書き込みが増えて復旧が難しくなる前に、最もログを出力している不要不急のコンテナ、またはHome Assistant自体を停止してください。

表示を減らす前に、繰り返し発生するエラーを修正する

最も多いメッセージを数え、そのタイムスタンプをデバイス、インテグレーション、自動化、アドオン、またはネットワークイベントと照合します。何千回も繰り返される警告は、関連のない一度限りの記録が何十件もある場合より、再発防止に役立つことがよくあります。設定を変更する前に、バージョンと発生条件を添えて短いサンプルを保存してください。

Home Assistant Coreの問題では、Tradfriのエラーによってログが10 GBを超えて肥大化し、システムディスクの空き容量がなくなった事例が報告されています。これは「1つのインテグレーションがログを大量に出力する」バージョン限定の事例であり、出力元を特定すべきことを示しています。Tradfriやログローテーションが常に原因だと決めつけるべきではありません。

ログの取得が完了したら、デバッグログを無効にしてから、原因と確認できたノイズの多いインテグレーションのみを再読み込みまたは無効化し、元のトリガーを再実行します。メッセージの発生率が大幅に下がれば、そのインテグレーションまたは依存関係を修正します。下がらない場合は設定を元に戻し、すべての警告を抑制するのではなく、次に発生元を確認できたコンポーネントを調べます。

ログを管理するレイヤーで保持ポリシーを設定する

ホストのジャーナル、Dockerのログドライバー、リバースプロキシ、その他のアドオンには、それぞれ個別に上限付きのポリシーを設定します。Coreのロガーレベルではsystemdジャーナルの保存容量は制限できません。また、Dockerのサイズ設定では、マウントされた設定ディレクトリ内に直接書き込まれるファイルはローテーションされません。

確認の間隔をカバーするのに十分な履歴を保持しながら、バックアップ、更新、データベース処理、復旧のための容量を残せる制限を設定します。関連するZimaSpaceの記事Home Assistantの空き容量では、一時的に追加のディスク容量を必要とする処理が、最後の余裕を使い切ると失敗することがある理由を説明しています。

サービスの再作成後も維持される設定で各ポリシーを記録します。影響を受けるサービスのみを再起動または再作成し、設定が有効であることを確認して、元に戻せるよう以前の値を控えておきます。異常な書き込み元を特定する代わりに、定期的な一括削除を行わないでください。

元のトリガーで増加が上限内に収まることを確認する

デバイスのオフライン化、インテグレーションの再試行、バックアップ、ネットワーク障害など、ログ急増の原因となったイベントを再現します。前回の増加時間を超える期間、同じファイルのサイズ、メッセージの発生率、空き容量、サービスの健全性、自動化の応答を追跡します。

合格と判断できるのは、ログの占有量が安定またはローテーションされ、必要な診断情報が失われず、履歴が正常に記録され、次のバックアップと更新に十分な空き容量がある状態です。ホストを一度再起動し、トリガーを再実行して、サービス再作成後も制限が適用されることを確認します。

保持期間を変更した結果、継続中の障害の診断に必要な証拠が失われる場合は、変更を元に戻します。原因の発生元を特定した後もログが増え続ける場合は、繰り返されるメッセージ、出力元のコンポーネント、バージョン、増加率、保存先のパスを添えてエスカレーションします。ディスクの空き容量が枯渇に近づいた場合は、再び書き込みを停止してください。

サポートとヒント

続きを読む

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.