[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>pull/33619/head
Wang
GitHub
parent
3d7ebfcf20
commit
b5cfdb8073
|
|
@ -0,0 +1,151 @@
|
|||
---
|
||||
title: ノードの健全性を監視します
|
||||
content_type: task
|
||||
reviewers:
|
||||
- ptux
|
||||
---
|
||||
|
||||
<!-- overview -->
|
||||
|
||||
*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" >}}
|
||||
|
||||
<!-- steps -->
|
||||
|
||||
## 制限事項
|
||||
|
||||
* 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)プラグインを使用して、カーネルログの内部データ構造を変換します。
|
||||
新しいログフォーマット用に新しいトランスレータを実装することができます。
|
||||
|
||||
<!-- discussion -->
|
||||
|
||||
## 推奨・制限事項
|
||||
|
||||
ノードの健全性を監視するために、クラスターでNode Problem Detectorを実行することが推奨されます。
|
||||
`Node Problem Detector`を実行する場合、各ノードで余分なリソースのオーバーヘッドが発生することが予想されます。
|
||||
|
||||
通常これは問題ありません。
|
||||
|
||||
* カーネルログは比較的ゆっくりと成長します。
|
||||
* Node Problem Detector にはリソース制限が設定されています。
|
||||
* 高負荷時であっても、リソースの使用は許容範囲内です。
|
||||
|
||||
詳細は`Node Problem Detector`[ベンチマーク結果](https://github.com/kubernetes/node-problem-detector/issues/2#issuecomment-220255629)を参照してください。
|
||||
Loading…
Reference in New Issue