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

エヴァ・ウォンテクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

まず、増加しているPlexまたはコンテナのログと、その増加速度を特定してください。プロセスが同じエラーを出力し続けている間は、ログをむやみに削除しないでください。

システムディスクが満杯になると、可観測性だけでなく、データベース、パッケージの更新、コンテナにも空き容量が必要になるため、ほかの機能にも影響します。短い間隔で増加量を測定し、繰り返し発生しているイベントを記録したサンプルを保存してから、保持期間を短くしてください。目標は、ログ量を適切な範囲に抑えつつ根本原因を解消することであり、ログを恒久的に抑制することではありません。

正確な出力元とファイルを特定する

コンテナの標準出力、Plexのアプリケーションログ、プロキシログ、ホストのジャーナルは、それぞれ独立して増加する可能性があります。最も容量を使用しているディレクトリを確認するだけでは不十分です。増加の原因となっているプロセスとメッセージのパターンを特定する必要があります。

Dockerはロギングシステムを通じてコンテナの標準出力と標準エラー出力を取得できます。一方で、アプリケーションが独自のログファイルにも書き込む場合があるため、保持設定を変更する前に両方の出力先を比較してください。

10分間にわたってディスク使用量とファイルの増加を確認し、その後、最も速く増加しているファイルから短いサンプルを取得してください。1つのメッセージが継続的に繰り返されている場合は、ログローテーションをさらに積極的に行う前に、その状態を修正してください。

保持期間を短くする前に繰り返し発生するエラーを修正する

マウント設定の誤り、到達不能な依存サービス、クラッシュループなどによって、通常の動作時を大幅に上回る量のログが生成されることがあります。保持期間を短くしても、書き込み処理自体は減らず、症状が隠れるだけです。

繰り返し表示されるメッセージで言及されている依存先に対して、エラーと飽和状態の確認を行い、修正が有効と思われる状態で一度だけ問題を再現してください。

根本的なエラーを解消した後にログの増加が収まった場合は、適度な診断用保持期間を維持してください。収まらない場合は、保持期間をさらに短くするのではなく、引き続きログの出力元を追跡してください。

運用上の必要性に基づいて保持期間を設定する

最近のトラブルシューティング以外でログをほとんど使用しない場合、保持期間を長くしても自動的に安全性が高まるわけではありません。システムディスクの容量を考慮しながら、通常のインシデントの発見に必要な期間をカバーできるウィンドウを設定してください。

小規模なデプロイでは、ログ保持のトレードオフにより、非常に長い保持期間では運用上の価値が次第に低下することが示されています。無制限のデフォルトではなく、明示的なポリシーを定めることが有効です。

エラー修正後の1日あたりのログ量を見積もり、それに希望するトラブルシューティング期間を掛け、Plexの状態データと更新用に空き容量の余裕を確保してください。コンテナを置き換えても設定が維持されるよう、保持値を永続的なアプリデータの構成のそばに記録しておきます。

ディスク使用量が再び際限なく増加しないことを確認する

保持ルールが本当に機能しているのは、通常の動作時と、意図的に再現した1回のエラー発生時の両方で、使用容量が安定する場合だけです。監視によって、クリーンアップの仕組みが実際に動作していることを確認してください。

少なくとも1回のローテーション周期全体にわたって、空き容量、ログディレクトリのサイズ、保持されている最古のファイルを測定してください。最古のファイルの境界が想定どおりに移動しない場合は、インシデントの終了を宣言する前にローテーションの仕組みを修正してください。

増加量が大きかった元のサンプルは、稼働中のシステムボリューム上ではなく、インシデントの記録とともに保管してください。これにより、証拠を残しながら、本番のログ出力先が際限なく増加することを防げます。

サポートとヒント

もっと読む

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.