[{"data":1,"prerenderedAt":412},["ShallowReactive",2],{"blog-ja-k3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral":3,"blog-related-ja-k3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral":369,"blog-ja-k3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral-alt":357},{"id":4,"title":5,"author":6,"body":7,"date":351,"description":352,"extension":353,"image":354,"locale":355,"meta":356,"navigation":357,"path":358,"seo":359,"stem":360,"tags":361,"__hash__":368},"blog\u002Fblog\u002Fja\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral.md","HPAの設定は合っている。なのにPodが増えない。K3sで起きる『メトリクス不明』の正体とHPA\u002FVPAの死のスパイラル","Kubo Team",{"type":8,"value":9,"toc":340},"minimark",[10,15,29,36,58,62,79,92,98,102,115,122,128,137,141,144,152,160,166,170,183,246,252,256,259,303,309,316,320,326],[11,12,14],"h2",{"id":13},"hpaのyamlは正しいのにpodが1つも増えない","HPAのYAMLは正しいのに、Podが1つも増えない",[16,17,18,19,23,24,28],"p",{},"K3sクラスタにHorizontalPodAutoscaler（HPA）を設定した。",[20,21,22],"code",{},"kubectl apply","は成功した。CPU使用率のしきい値も、min\u002Fmaxレプリカ数も、マニフェストを何度読み返しても間違っていない。それなのに、負荷が上がってもPodは1つも増えない。",[25,26,27],"strong",{},"K3sでHPAがスケールしない","という相談は、実は原因の9割が「HPA自体のバグ」ではなく、その手前の層——リソース設定とメトリクスパイプライン——に潜んでいます。",[16,30,31],{},[32,33],"img",{"alt":34,"src":35},"section01","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection01.webp",[16,37,38,41,42,45,46,49,50,57],{},[20,39,40],{},"kubectl get hpa","を実行して",[20,43,44],{},"TARGETS","列が",[20,47,48],{},"\u003Cunknown>\u002F50%","のまま張り付いているなら、それはHPAが壊れているのではなく、HPAが必要な情報を受け取れていないサインです。この記事では、K3s運用で頻発する3つの根本原因と、3分で層を切り分ける診断手順、そして再発させない設計を解説します。オートスケールの挙動を可視化する監視基盤（",[51,52,56],"a",{"href":53,"rel":54},"https:\u002F\u002Fkubo.hexabase.io\u002F",[55],"nofollow","Kubo","にはPrometheus + Grafanaが標準搭載されている）があるかどうかで、原因特定にかかる時間は大きく変わります。",[11,59,61],{"id":60},"原因1-リソースリクエスト未設定というサイレントな無効化","原因1: リソースリクエスト未設定という「サイレントな無効化」",[16,63,64,65,68,69,74,75,78],{},"最も見落とされがちな原因が、コンテナの",[20,66,67],{},"resources.requests","未設定です。",[51,70,73],{"href":71,"rel":72},"https:\u002F\u002Fkubernetes.io\u002Fdocs\u002Ftasks\u002Frun-application\u002Fhorizontal-pod-autoscale-walkthrough\u002F",[55],"Kubernetesの公式HorizontalPodAutoscalerウォークスルー","では、対象Deploymentに必ず",[20,76,77],{},"requests.cpu","を明示した例が示されており、HPAはこの値を分母にして使用率（utilization）を計算します。",[16,80,81,82,87,88,91],{},"厄介なのは、リクエストが未設定でもHPAコントローラーはエラーを吐かないという点です。ある解説記事は「HPAはリソースリクエストが定義されていることを前提としており、リクエストがなければ使用率を計算できない」と指摘しています（",[51,83,86],{"href":84,"rel":85},"https:\u002F\u002Foneuptime.com\u002Fblog\u002Fpost\u002F2026-02-09-hpa-not-scaling-missing-metrics\u002Fview",[55],"oneuptime.comの解説","）。つまり設定ミスとして表面化せず、",[25,89,90],{},"該当メトリクスが黙ってスキップされ、HPAは「何もすべきことがない」状態のまま動き続けます","。監視しているつもりで、実は何も監視できていない——このサイレントな無効化が、K3s本番環境で最も多いHPA不発の原因です。",[16,93,94],{},[32,95],{"alt":96,"src":97},"section02","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection02.webp",[11,99,101],{"id":100},"原因2-メトリクスパイプラインの遅延kubeletmetrics-serverhpa","原因2: メトリクスパイプラインの遅延（kubelet→metrics-server→HPA）",[16,103,104,105,110,111,114],{},"リクエストが正しく設定されていても、まだ油断はできません。HPAが参照する使用率データは、kubelet → Metrics Server → HPAコントローラー → スケジューラ → Pod起動 → readinessプローブという経路を通って初めて反映されます。",[51,106,109],{"href":107,"rel":108},"https:\u002F\u002Fgithub.com\u002Fkubernetes-sigs\u002Fmetrics-server\u002Fblob\u002Fmaster\u002FFAQ.md",[55],"kubernetes-sigs\u002Fmetrics-serverのFAQ","によれば、metrics-serverのデフォルトのスクレイプ間隔は",[25,112,113],{},"60秒","で、15秒未満に設定することは推奨されていません（kubeletが計算するメトリクス自体の解像度がそれ以上細かくならないため）。",[16,116,117,118,121],{},"この収集間隔に加えて、HPAコントローラーの評価サイクル、Podのスケジューリング、コンテナ起動、readinessプローブの通過時間が積み重なり、",[25,119,120],{},"トラフィック急増から実際にスケール完了するまで数十秒〜数分のラグが生じるのが構造上の前提","です。「HPAが遅い」と感じたら、それは故障ではなくパイプラインの物理的な特性であるケースが多く、まずこの遅延を前提にアラート閾値や負荷試験のシナリオを設計する必要があります。",[16,123,124],{},[32,125],{"alt":126,"src":127},"section03","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection03.webp",[16,129,130,131,136],{},"小規模なK3sクラスタでも同じ経路が使われるため、",[51,132,135],{"href":133,"rel":134},"https:\u002F\u002Fgithub.com\u002Fkubernetes-sigs\u002Fmetrics-server",[55],"metrics-serverのGitHubリポジトリ","が案内する構成要件（アグリゲーションレイヤーの有効化、kubelet証明書の検証設定など）を満たしていないと、パイプラインの入口でメトリクス自体が取得できません。K3sは軽量ディストリビューションゆえに一部コンポーネントが省略構成になっていることがあり、metrics-serverの正常デプロイ確認は診断の初手になります。",[11,138,140],{"id":139},"原因3-hpaとvpaの死のスパイラル","原因3: HPAとVPAの「死のスパイラル」",[16,142,143],{},"リクエストも設定済み、メトリクスも取得できている。それでもスケール挙動が不安定——Pod数が増減を繰り返す、あるいは想定より過剰にスケールアウトする——場合、VerticalPodAutoscaler（VPA）との併用を疑うべきです。",[16,145,146,151],{},[51,147,150],{"href":148,"rel":149},"https:\u002F\u002Fscaleops.com\u002Fblog\u002Fhpas-three-architectural-flaws-and-why-your-autoscaling-keeps-failing\u002F",[55],"ScaleOpsの分析記事","は、HPAとVPAが同一メトリクスを対象にしたときに起きる自己強化ループを次のように説明しています。HPAが水平にスケールすると1Pod当たりの負荷が下がり、VPAはこれを「リクエストを下げてよい」根拠として学習します。VPAがリクエストを下げると、HPAの使用率計算の分母（リクエスト値）が小さくなるため、同じ絶対使用量でも使用率が跳ね上がったように見え、HPAはさらにスケールアウトしようとします。この繰り返しがいわゆる**「HPA\u002FVPAの死のスパイラル」**です。",[16,153,154,159],{},[51,155,158],{"href":156,"rel":157},"https:\u002F\u002Fgithub.com\u002Fkubernetes\u002Fautoscaler\u002Ftree\u002Fmaster\u002Fvertical-pod-autoscaler",[55],"VPAのCRD設計","はリクエスト自動調整を前提としており、HPAとの役割分担を意識せず両方をAutoモードで同一ワークロードに適用すると、この構造的な不整合が顕在化します。",[16,161,162],{},[32,163],{"alt":164,"src":165},"section04","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection04.webp",[11,167,169],{"id":168},"診断手順-3分でボトルネックの層を切り分ける","診断手順: 3分でボトルネックの層を切り分ける",[16,171,172,173,178,179,182],{},"原因が3層に分かれる以上、闇雲にYAMLを読み直すより、順序立てた切り分けの方が速く解決します。",[51,174,177],{"href":175,"rel":176},"https:\u002F\u002Fwww.codewithkarani.com\u002Fblog\u002Fkubernetes-hpa-not-scaling-describe-conditions",[55],"codewithkaraniの診断ガイド","が整理する",[20,180,181],{},"kubectl describe hpa","のConditions確認フローが有効です。",[184,185,186,207,220,232],"ol",{},[187,188,189,195,198,199,202,203,206],"li",{},[25,190,191,194],{},[20,192,193],{},"kubectl describe hpa \u003Cname> -n \u003Cnamespace>","を実行し、Conditionsを上から順に確認する",[20,196,197],{},"AbleToScale: False","ならスケール対象の参照設定やRBAC権限の問題、",[20,200,201],{},"ScalingActive: False","なら「no metrics returned」（metrics-server側の問題）か「missing request for cpu」（リクエスト未設定）かをメッセージで判別できます。",[20,204,205],{},"ScalingLimited: True","はmin\u002Fmaxの境界に到達しているだけで、故障ではありません。",[187,208,209,219],{},[25,210,211,214,215,218],{},[20,212,213],{},"kubectl top pods","と",[20,216,217],{},"kubectl top nodes","でmetrics-server自体が値を返せているか確認する","\nここで値が取れなければ、原因はHPAではなくmetrics-serverの構成不備です。",[187,221,222,228,231],{},[25,223,224,227],{},[20,225,226],{},"kubectl get deployment \u003Cname> -o jsonpath='{.spec.template.spec.containers[0].resources}'","でリクエスト設定を直接確認する",[20,229,230],{},"requests","が空であれば、原因1が確定します。",[187,233,234,237,238,241,242,245],{},[25,235,236],{},"同一ワークロードにVPAが適用されていないか確認する","\nVPAオブジェクトの",[20,239,240],{},"updateMode","が",[20,243,244],{},"Auto","かつHPAと同一メトリクスを見ている場合、原因3の死のスパイラルを疑います。",[16,247,248],{},[32,249],{"alt":250,"src":251},"section05","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection05.webp",[11,253,255],{"id":254},"対策設計-リクエスト設定stabilizationwindowkedaへの移行判断","対策設計: リクエスト設定・stabilizationWindow・KEDAへの移行判断",[16,257,258],{},"診断で原因が特定できたら、再発させない設計に落とし込みます。",[260,261,262,271,285,291],"ul",{},[187,263,264,267,268,270],{},[25,265,266],{},"リクエストは実測値ベースで設定する",": プレースホルダー的な低い値ではなく、通常負荷時の実測CPU\u002Fメモリ消費に基づいて",[20,269,230],{},"を設定します。",[187,272,273,276,277,280,281,284],{},[25,274,275],{},"HPAとVPAは同一メトリクスで併用しない",": CPUでHPAを使うなら、VPAはメモリのみを対象にするか、",[20,278,279],{},"updateMode: \"Off\"","または",[20,282,283],{},"\"Initial\"","にして自動調整を無効化し、推奨値の参考表示に留めます。",[187,286,287,290],{},[25,288,289],{},"スケールダウンのstabilizationWindowを調整する",": 頻繁な増減（フラッピング）を防ぐため、スケールダウン側に十分な安定化ウィンドウを設定し、急な負荷低下で即座にPodを減らさないようにします。",[187,292,293,296,297,302],{},[25,294,295],{},"キュー長やイベント数が先行指標になる場合はKEDAへの移行を検討する",": CPU\u002Fメモリだけでは負荷の予兆を捉えきれないワークロード（メッセージキュー処理など）には、",[51,298,301],{"href":299,"rel":300},"https:\u002F\u002Fkeda.sh\u002F",[55],"KEDA公式サイト","が提供するイベント駆動型のスケーリングが適しています。KEDAはHPAを置き換えるのではなく、その上位でスケーリングトリガーを拡張する形で共存できる設計です。",[16,304,305],{},[32,306],{"alt":307,"src":308},"section06","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Fsection06.webp",[16,310,311,312,315],{},"これらの設計変更は、いずれも「メトリクスが正しく見えている」ことが前提です。設定を書いた時点では安心できず、実際にPrometheusやGrafanaでリクエスト値・使用率・スケール履歴を可視化して初めて、設計が機能しているかを検証できます。",[51,313,56],{"href":53,"rel":314},[55],"はPrometheus + Grafanaを標準搭載しており、metrics-serverの遅延やHPA\u002FVPAのスケール挙動をダッシュボードで即座に確認できます。",[11,317,319],{"id":318},"まとめ-オートスケールは入れて終わりではなく観測して終わり","まとめ: オートスケールは「入れて終わり」ではなく「観測して終わり」",[16,321,322,323,325],{},"K3sでHPAがスケールしない場合、多くはHPA自体の不具合ではなく、リソースリクエストの未設定、metrics-serverの構成不備や収集間隔による遅延、そしてHPA\u002FVPAの設計不整合という3つの層のどこかに原因があります。",[20,324,181],{},"のConditionsを起点に層を切り分ければ、闇雲な試行錯誤を避けられます。",[16,327,328,329,333,334,339],{},"もう一つ重要なのは、オートスケールは設定して終わりではなく、継続的に観測して初めて機能を保証できるという点です。監視基盤をゼロから構築する負荷が高いなら、",[51,330,332],{"href":53,"rel":331},[55],"Kubo Cloud","のようにK3sベースでPrometheus + Grafanaが標準搭載されたマネージドK8sを検討する価値があります。AWSのEKSやAzureのAKSに比べて低コストでありながら標準Kubernetesとの互換性を保ち、この記事で紹介した診断作業をダッシュボード上で完結できます。オートスケールの設計に自信が持てないなら、まずは",[51,335,338],{"href":336,"rel":337},"https:\u002F\u002Fwww.hexabase.com\u002Fcontact-us\u002F",[55],"お問い合わせ","から相談してみてください。",{"title":341,"searchDepth":342,"depth":342,"links":343},"",2,[344,345,346,347,348,349,350],{"id":13,"depth":342,"text":14},{"id":60,"depth":342,"text":61},{"id":100,"depth":342,"text":101},{"id":139,"depth":342,"text":140},{"id":168,"depth":342,"text":169},{"id":254,"depth":342,"text":255},{"id":318,"depth":342,"text":319},"2026-09-02","K3sでHPAを設定したのにPodが増えない。原因はリソースリクエスト未設定によるメトリクス不明化と、HPA\u002FVPAの死のスパイラルにあることが多い。診断手順と対策を解説する。","md","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral\u002Feyecatch.webp","ja",{},true,"\u002Fblog\u002Fja\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral",{"title":5,"description":352},"blog\u002Fja\u002Fk3s-hpa-not-scaling-metrics-unknown-vpa-death-spiral",[362,363,364,365,366,367],"k3s","kubernetes","hpa","vpa","autoscaling","metrics-server","yINQq0zUxSXClGJNOVXqz_vZP-VnTFC3d8z5GrbUXUs",[370,376,382,389,397,404],{"path":371,"title":372,"description":373,"date":374,"tags":375},"\u002Fblog\u002Fja\u002Fhpa-vpa-aep-5342-multidimensional-pod-autoscaler","HPAとVPAの併用問題、Kubernetes本体がAEP-5342で解決しようとしている。GKE版MPAとの違いとKuboで今できること","HPAとVPAの併用は長年危険とされてきたが、GKEのMultidimensional Pod AutoscalerとKubernetes本体のAEP-5342提案が解決の方向性を示し始めている。K3s\u002FKuboで今日から実践できる設計も解説する。","2026-10-27",[362,363,364,365,366],{"path":377,"title":378,"description":379,"date":380,"tags":381},"\u002Fblog\u002Fja\u002Fkubernetes-hpa-vpa-autoscaling-conflict-design","\"両方入れれば安心\"が一番危ない。KubernetesでHPAとVPAを併用するとスケーリングが暴走する理由","KubernetesでHPAとVPAを両方有効にすると、良かれと思った自動化同士が干渉し、スケーリングが際限なく暴走することがある。衝突が起きる仕組みと、updateModeやメトリクス分離による安全な併用設計を解説する。","2026-10-07",[362,363,364,365,366],{"path":383,"title":384,"description":385,"date":386,"tags":387},"\u002Fblog\u002Fja\u002Fk3s-metrics-server-default-kubeadm-hpa-kubectl-top","kubectl topが無反応だった。原因はmetrics-server未導入、K3sでは起きない理由","kubectl topやHPAが突然動かなくなった時、まず疑うべきはmetrics-serverの有無だ。K3sに標準搭載されている理由と、標準Kubernetes(kubeadm)環境で必ず手動導入が必要になる技術的背景、障害発生時の切り分け手順までを公式ドキュメントベースで解説する。","2026-10-24",[362,363,367,364,388],"kubeadm",{"path":390,"title":391,"description":392,"date":393,"tags":394},"\u002Fblog\u002Fja\u002Fk3s-hpa-containerresource-sidecar-utilization-dilution","HPAがサイドカーの分まで合算してスケールしていた。KubernetesのContainerResourceという盲点","KubernetesのHPAはPod内の全コンテナの使用量を合算して利用率を計算するため、Istioサイドカーやログエージェントの負荷が判定を薄める。ContainerResourceメトリクスで解決する方法をK3s\u002FKubo文脈で解説する。","2026-10-21",[362,363,364,395,366,396],"containerresource","service-mesh",{"path":398,"title":399,"description":400,"date":401,"tags":402},"\u002Fblog\u002Fja\u002Fk3s-vpa-inplaceorrecreate-pod-resize-cgroup","VPAをInPlaceOrRecreateにしたのに、Podはまだ再起動していた。K3sでInPlacePodVerticalScalingの\"無停止\"を検証する","VPAのInPlaceOrRecreateモードとIn-Place Pod ResizeでPodは本当に再起動しないのか。K3s環境でQoSクラス制約とcgroup v1の罠を実際の設定例とkubectlコマンドで検証する。","2026-10-17",[362,363,365,366,403],"cgroup",{"path":405,"title":406,"description":407,"date":408,"tags":409},"\u002Fblog\u002Fja\u002Fk3s-hpa-prometheus-adapter-discovery-interval-stale-metrics","discoveryIntervalを疑え。K3sのHPAがPrometheus Adapter経由で\"古いメトリクス\"を掴み続ける設定ミス","K3sのHPAがCPU使用率は正常なのにスケールしない。原因はPrometheus Adapterのmetrics-relist-interval\u002Fmetrics-max-ageとHPA sync-periodが噛み合っていない設定ミスだった。3層の遅延構造と診断コマンドを解説する。","2026-10-12",[362,363,364,410,366,411],"prometheus-adapter","observability",1794902461139]