この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

Kubernetesのアノテーションを介してモニターしきい値の引数を上書きする

概要

SUSE Observabilityは標準でモニターを提供しており、Kubernetesクラスターで発生しうる一般的な問題の監視を行います。これらのモニターは、ほとんどのユースケースに適した特定のデフォルト引数で動作しますが、時には`threshold`や`failureState`などの一部のデフォルト引数を上書きして、動作を調整する必要があります。 上書きを宣言するメカニズムは、どのモニターとコンポーネントに適用されるべきかを示すKubernetesリソースアノテーションを介しています。例えば、特定のサービスに対して`failureState`モニターの`Available service endpoints`を上書きし、失敗したときにデフォルトの`DEVIATING`ではなく`CRITICAL`状態を示すことができます。

ハウツー

例として、手順はKubernetes HTTPサービスの`Available service endpoints`モニターの引数を上書きします。

アノテーションを構築する方法

SUSE Observabilityモニターの上書きアノテーションキーは、以下の規則に従います:

monitor.${owner}.stackstate.io/${monitorShorName}

`owner`プロパティは、誰がそのモニターを作成したかを示し、標準のモニターの場合は`kubernetes-v2`であり、`monitorShorName`プロパティはモニターのIDを表し、モニターをリストまたは検査する際にCLIから読み取ることができる`identifier`プロパティから抽出できます。

sts monitor list

ID              | STATUS  | IDENTIFIER                                                                          | NAME                                        | FUNCTION ID     | TAGS
8051105457030   | ENABLED | urn:stackpack:kubernetes-v2:shared:monitor:kubernetes-v2:service-available-endpoint | Available service endpoints                 | 233276809885571 | [services]

私たちの例では、識別子は`urn:stackpack:kubernetes-v2:shared:monitor:kubernetes-v2:service-available-endpoint`であり、`monitorShorName`は`service-available-endpoint`のように最後のセグメントに対応するため、アノテーションキーは次のようになります:

monitor.kubernetes-v2.stackstate.io/service-available-endpoint

アノテーションペイロードは、以下のオプション引数を定義できるJSONオブジェクトです:

  • threshold: オプション。比較対象となる数値のしきい値です。

  • failureState: オプション。"CRITICAL"または"DEVIATING"のいずれかです。"CRITICAL"はSUSE Observabilityで赤として表示され、"DEVIATING"はオレンジとして表示され、異なる重大度を示します。

  • enabled: オプション。そのコンポーネントのヘルスステートをモニターが生成するかどうかを決定するブール値。

完全なアノテーションは次のようになります:

    monitor.kubernetes-v2.stackstate.io/service-available-endpoint: |-
      {
        "threshold": 0.0,
        "failureState": "CRITICAL",
        "enabled": true
      }

カスタムモニターの上書きを構築する

CLI を使用してコンポーネントにしきい値モニターを追加するのガイドを使用して作成された任意のカスタムしきい値モニターは、引数の上書きに適しています。例が示すように、カスタムモニターの識別子はurn:custom:monitor:{monitorShortName}の形式で構成され、こうした識別子の上書きアノテーションキーは次のようになることが期待されます。

monitor.custom.stackstate.io/${monitorShortName}

この例では識別子`urn:custom:monitor:deployment-has-replicas`を使用しているため、アノテーションキーは次のようになります。

monitor.custom.stackstate.io/deployment-has-replicas

完全なアノテーションは次のようになります。

    monitor.custom.stackstate.io/deployment-has-replicas: |-
      {
        "threshold": 0.0,
        "failureState": "CRITICAL"
        "enabled": true
      }