From b5cfdb807369e597102417a56b9d17c11352aa6d Mon Sep 17 00:00:00 2001 From: Wang Date: Wed, 11 May 2022 22:59:01 +0900 Subject: [PATCH] [ja] Translate tasks/debug-application-cluster/monitor-node-health into Japanese (#31108) * done * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * Update content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> * minor change Co-authored-by: Ryota Yamada <42636694+riita10069@users.noreply.github.com> --- .../monitor-node-health.md | 151 ++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md diff --git a/content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md b/content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md new file mode 100644 index 0000000000..518691fd2a --- /dev/null +++ b/content/ja/docs/tasks/debug-application-cluster/monitor-node-health.md @@ -0,0 +1,151 @@ +--- +title: ノードの健全性を監視します +content_type: task +reviewers: +- ptux +--- + + + +*Node Problem Detector*は、ノードの健全性を監視し、報告するためのデーモンです。 +`Node Problem Detector`は`DaemonSet`として、あるいはスタンドアロンデーモンとして実行することができます。 + +`Node Problem Detector`は様々なデーモンからノードの問題に関する情報を収集し、これらの状態を[NodeCondition](/ja/docs/concepts/architecture/nodes/#condition)および[Event](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#event-v1-core)としてAPIサーバーにレポートします。 +`Node Problem Detector`のインストール方法と使用方法については、[Node Problem Detectorプロジェクトドキュメント](https://github.com/kubernetes/node-problem-detector)を参照してください。 + +## {{% heading "prerequisites" %}} + +{{< include "task-tutorial-prereqs.md" >}} + + + +## 制限事項 + +* Node Problem Detectorは、ファイルベースのカーネルログのみをサポートします。 + `journald`のようなログツールはサポートされていません。 + +* Node Problem Detectorは、カーネルの問題を報告するためにカーネルログフォーマットを使用します。 + カーネルログフォーマットを拡張する方法については、[Add support for another log format](#support-other-log-format) を参照してください。 + +## ノード問題検出の有効化 + +クラウドプロバイダーによっては、`Node Problem Detector`を{{< glossary_tooltip text="Addon" term_id="addons" >}}として有効にしている場合があります。 +また、`kubectl`を使って`Node Problem Detector`を有効にするか、`Addon pod`を作成することで有効にできます。 + +### kubectlを使用してNodしますroblem Detectorを有効にします {#using-kubectl} + +`kubectl`は`Node Problem Detector`を最も柔軟に管理することができます。 +デフォルトの設定を上書きして自分の環境に合わせたり、カスタマイズしたノードの問題を検出したりすることができます。 +例えば: + +1. `node-problem-detector.yaml`のような`Node Problem Detector`の設定を作成します: + + {{< codenew file="debug/node-problem-detector.yaml" >}} + + {{< note >}} + システムログのディレクトリが、お使いのOSのディストリビューションに合っていることを確認する必要があります。 + {{< /note >}} + +1. `Node Problem Detector`を`kubectl`で起動します。 + + ```shell + kubectl apply -f https://k8s.io/examples/debug/node-problem-detector.yaml + ``` + +### Addon podを使用してNode Problem Detectorを有効化します {#using-addon-pod} + +カスタムのクラスターブートストラップソリューションを使用していて、デフォルトの設定を上書きする必要がない場合は、`Addon Pod`を利用してデプロイをさらに自動化できます。 +`node-problem-detector.yaml`を作成し、制御プレーンノードの`Addon Pod`のディレクトリ`/etc/kubernetes/addons/node-problem-detector`に設定を保存します。 + +## コンフィギュレーションを上書きします + +`Node Problem Detector`の Dockerイメージをビルドする際に、[default configuration(https://github.com/kubernetes/node-problem-detector/tree/v0.1/config)が埋め込まれます。 + +[`ConfigMap`](/ja/docs/tasks/configure-pod-container/configure-pod-configmap/) を使用することで設定を上書きすることができます。 + + +1. `config/` にある設定ファイルを変更します +1. `ConfigMap` `node-problem-detector-config`を作成します。 + + ```shell + kubectl create configmap node-problem-detector-config --from-file=config/ + ``` + +1. `node-problem-detector.yaml`を変更して、`ConfigMap`を使用するようにします。 + + {{< codenew file="debug/node-problem-detector-configmap.yaml" >}} + +1. 新しい設定ファイルで`Node Problem Detector`を再作成します。 + + ```shell + # If you have a node-problem-detector running, delete before recreating + kubectl delete -f https://k8s.io/examples/debug/node-problem-detector.yaml + kubectl apply -f https://k8s.io/examples/debug/node-problem-detector-configmap.yaml + ``` + +{{< note >}} +この方法は `kubectl` で起動された Node Problem Detector にのみ適用されます。 +{{< /note >}} + +ノード問題検出装置がクラスターアドオンとして実行されている場合、設定の上書きはサポートされていません。 +`Addon Manager`は、`ConfigMap`をサポートしていません。 + +## Kernel Monitor + +*Kernel Monitor*は`Node Problem Detector`でサポートされるシステムログ監視デーモンです。 +*Kernel Monitor*はカーネルログを監視し、事前に定義されたルールに従って既知のカーネル問題を検出します。 +*Kernel Monitor*は[`config/kernel-monitor.json`](https://github.com/kubernetes/node-problem-detector/blob/v0.1/config/kernel-monitor.json)にある一連の定義済みルールリストに従ってカーネルの問題を照合します。 +ルールリストは拡張可能です。設定を上書きすることで、ルールリストを拡張することができます。 + +### 新しいNodeConditionsの追加 + +新しい`NodeCondition`をサポートするには、例えば`config/kernel-monitor.json`の`conditions`フィールド内に条件定義を作成します。 + +```json +{ + "type": "NodeConditionType", + "reason": "CamelCaseDefaultNodeConditionReason", + "message": "arbitrary default node condition message" +} +``` + +### 新たな問題の発見 + +新しい問題を検出するために、`config/kernel-monitor.json`の`rules`フィールドを新しいルール定義で拡張することができます。 + +```json +{ + "type": "temporary/permanent", + "condition": "NodeConditionOfPermanentIssue", + "reason": "CamelCaseShortReason", + "message": "regexp matching the issue in the kernel log" +} +``` + +### カーネルログデバイスのパスの設定 {#kernel-log-device-path} + +ご使用のオペレーティングシステム(OS)ディストリビューションのカーネルログパスをご確認ください。 +Linuxカーネルの[ログデバイス](https://www.kernel.org/doc/Documentation/ABI/testing/dev-kmsg)は通常`/dev/kmsg`として表示されます。 +しかし、OSのディストリビューションによって、ログパスの位置は異なります。 +`config/kernel-monitor.json`の`log`フィールドは、コンテナ内のログパスを表します。 +`log`フィールドは、`Node Problem Detector`で見たデバイスパスと一致するように設定することができます。 + +### 別のログ形式をサポートします {#support-other-log-format} + +Kernel monitorは[`Translator`](https://github.com/kubernetes/node-problem-detector/blob/v0.1/pkg/kernelmonitor/translator/translator.go)プラグインを使用して、カーネルログの内部データ構造を変換します。 +新しいログフォーマット用に新しいトランスレータを実装することができます。 + + + +## 推奨・制限事項 + +ノードの健全性を監視するために、クラスターでNode Problem Detectorを実行することが推奨されます。 +`Node Problem Detector`を実行する場合、各ノードで余分なリソースのオーバーヘッドが発生することが予想されます。 + +通常これは問題ありません。 + +* カーネルログは比較的ゆっくりと成長します。 +* Node Problem Detector にはリソース制限が設定されています。 +* 高負荷時であっても、リソースの使用は許容範囲内です。 + +詳細は`Node Problem Detector`[ベンチマーク結果](https://github.com/kubernetes/node-problem-detector/issues/2#issuecomment-220255629)を参照してください。