第5章 AlertRelabelConfig [monitoring.openshift.io/v1]
- 説明
- AlertRelabelConfig は、アラートの再ラベル付け設定を定義します。互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
- タイプ
-
object
- 必須
-
spec
-
5.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| spec は、この AlertRelabelConfig オブジェクトの望ましい状態を記述します。 |
|
| Status は、この AlertRelabelConfig オブジェクトの現在の状態を記述します。 |
5.1.1. .spec
- 説明
- spec は、この AlertRelabelConfig オブジェクトの望ましい状態を記述します。
- タイプ
-
object
- 必須
-
configs
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| configs は、順番に評価されるアラート再ラベル付け設定のリストです。 |
|
| RelabelConfig を使用すると、アラートのラベルセットの動的な書き換えが可能になります。Prometheus のドキュメント(https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs)- https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config を参照してください。 |
5.1.2. .spec.configs
- 説明
- configs は、順番に評価されるアラート再ラベル付け設定のリストです。
- タイプ
-
array
5.1.3. .spec.configs[]
- 説明
- RelabelConfig を使用すると、アラートのラベルセットの動的な書き換えが可能になります。Prometheus のドキュメント(https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs)- https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config を参照してください。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| 正規表現のマッチングに基づいて実行するアクション。'Replace'、'Keep'、'Drop'、'HashMod'、'LabelMap'、'LabelDrop'、または 'LabelKeep' のいずれかである必要があります。デフォルト:'Replace' |
|
| ソースラベル値のハッシュを取得する場合は modulus を使用します。これを HashMod アクションと組み合わせて、'target_label' を連結された source_labels のハッシュの 'modulus' に設定できます。これは、sourceLabels が空ではなく、アクションが LabelKeep または LabelDrop ではない場合にのみ有効です。 |
|
| 抽出された値が一致する正規表現。デフォルトは:HashMod を除くすべてのアクションには '(.*)' 正規表現が必要です。 |
|
| 正規表現が一致した場合に正規表現が置換される代替値。これは、アクションが 'Replace' または 'LabelMap' で、'LabelKeep' および 'LabelDrop' アクションの場合に禁止されている場合に必要です。正規表現キャプチャグループが利用可能です。デフォルトは '$1' です。 |
|
| 連結されたソースラベル値の間に配置された区切り文字。省略すると、Prometheus はデフォルト値の ';' を使用します。 |
|
| sourceLabels は、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレーターを使用して連結され、Replace、Keep、および drop アクションに設定された正規表現と照合されます。'LabelKeep' および 'LabelDrop' アクションでは許可されていません。 |
|
| 結果の値が Replace アクションに書き込まれる targetLabel。これは、Replace および HashMod アクションに必要であり、'LabelKeep' および 'LabelDrop' アクションには禁止されています。正規表現キャプチャグループが利用可能です。 |
5.1.4. .status
- 説明
- Status は、この AlertRelabelConfig オブジェクトの現在の状態を記述します。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| 条件には、AlertRelabelConfig の状態の詳細が含まれており、空の場合があります。 |
|
|
条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパス.status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{//foo の現在の状態の監視を表します。//既知の.status.conditions.type は次のとおりです: "Available"、"Progressing"、および "Degraded"//+ patchMergeKey = type//+ patchStrategy = merge//+ listType = map//+ listMapKey = type Conditions metav1.Condition |
5.1.5. .status.conditions
- 説明
- 条件には、AlertRelabelConfig の状態の詳細が含まれており、空の場合があります。
- タイプ
-
array
5.1.6. .status.conditions[]
- 説明
-
条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパス.status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{//foo の現在の状態の監視を表します。//既知の.status.conditions.type は次のとおりです: "Available"、"Progressing"、および "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition
json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"
// その他のフィールド} - タイプ
-
object
- 必須
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。 |
|
| message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。 |
|
| observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。 |
|
| reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。 |
|
| 条件のステータス、True、False、Unknown のいずれか。 |
|
| CamelCase または foo.example.com/CamelCase の条件のタイプ。--- 多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、競合を解消する機能が重要です。一致する正規表現は (dns1123SubdomainFmt/)?(qualifiedNameFmt) です。 |