ImmichがCPU、RAM、ストレージ、ネットワークのどれによって制限されているかを見分ける方法

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

一定のアップロード、閲覧、検索、またはバックグラウンドジョブのワークロードを再現し、同じ時間帯の完了速度と、CPU飽和、メモリ圧迫、ストレージのレイテンシ、ネットワークのスループットを照らし合わせて、Immichを制限している要因を見極めましょう。

数値が高いだけではボトルネックとは限りません。機械学習中のCPUフル稼働は正常な場合があり、RAMの大半はファイルシステムキャッシュかもしれません。また、アップロードが遅い原因はスマートフォンやWi-Fiにある可能性もあります。クライアントからコンテナ、ホストまで計測し、キューの進行状況を記録してから、制約と思われる要因を1つだけ変更して再試行してください。同じワークロードで改善が見られるリソースが、支配的な制約です。

再現可能なテストとタイムラインを作成する

改善したい症状を1つ選びます。決まった数のメディアの取り込み、キャッシュされていないオリジナル画像の表示、サムネイルの生成、スマート検索の実行、または動画1本のトランスコードなどです。開始時刻、最初に結果が使えるようになった時刻、完了時刻、失敗、ジョブキューの進行を記録してください。複数のタスクを混ぜると、判断につながらないリソースグラフになってしまいます。

あるユーザーの調査では、異常に遅いImmich環境について、CPU、メモリ、ディスク、ネットワークの状況を調べています。そのリソース横断型の診断アプローチは参考になりますが、原因はサーバーで固定したテストを行って特定する必要があります。

キャッシュが温まった後に、もう一度実行してください。2回目が大幅に速い場合は、ハードウェアに一貫性がないと判断せず、キャッシュの状態によるものとして記録します。両方の実行で同じ段階に停止するなら、その時刻をホストとコンテナのメトリクス、および該当するジョブと照合してください。

CPUとメモリの特徴を見極める

CPU制限の場合、該当コアで実行可能な処理が継続的に発生し、ジョブがそれに応じて進行します。並行数を減らすと操作への応答は改善しても、処理の完了には時間がかかることがあります。合計CPU使用率が低く見えても、1つのスレッドがフル稼働しているなら、余力があると決めつける前にプロセス別・コア別の状況を確認してください。

メモリ制限と判断するには、スワップの増加、メモリ回収、メジャーフォールト、OOMによる強制終了、コンテナの再起動など、圧迫を示す証拠が必要です。キャッシュが安定し、スワップもなく、レイテンシも正常なら、使用メモリが多くてもテスト不合格とはなりません。並行数を1つ減らしたワーカー、または小さいモデルで再実行し、完了までの時間を比較してください。

報告されたImmich v2.5.5のサムネイル処理の事例では、ある環境でメモリを大量に消費しました。特定バージョンに関するメモリの報告は、問題が起きたジョブとリリースを確認する根拠になりますが、通常必要なRAM容量を示すものではありません。

ストレージの遅延とネットワークのスループットを切り分ける

ストレージについては、実際のジョブを実行しながら、デバイスの遅延、キューの深さ、スループット、ファイルシステムの空き容量、inodeの利用可能数を確認します。データベースやサムネイルに関する細かな処理が多数、高遅延のディスクで待機している場合は、MB/秒が低くなくてもストレージがボトルネックになっていることがあります。

ネットワークについては、クライアントとサーバーの両方で測定し、ローカル経路とリモート経路を比較します。転送と同時に発生する回線の飽和、再送、Wi-Fiの再試行、VPNの上限は、ネットワークが制約になっていることを示します。アップロードが終わっても処理が遅い場合は、サーバー側のキューを確認してください。

古いハードウェアで動作するサービスのZimaSpace概要は、システム計画の参考になります。ただし、この診断では機器の古さではなく、観測された遅延と処理速度に基づいて判断してください。

制約を1つ解消して、同じワークロードで確認する

安全な変数を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.