モニタリングのための Kubernetes リソースのフィルタリング
最終更新日: 14 年 2024 月 XNUMX 日Argusは、LogicMonitorによって監視されているすべてのKubernetesリソースを検出します。 さらに、Argusを使用してリソースを監視から除外できます。
フィルター パラメーターの下の Argus 構成ファイルにリソース フィルターを追加できます。 ルール エンジンはルールを順番に評価します。 最初のルールが満たされ、true と評価されると、ルール エンジンはルールの評価を中断し、リソースは除外されます。
ご注意: LM-Container v8.2.0 以降では、LM コンテナ リソースの監視フィルタリングが無効になっています。この機能により、効果的な展開管理が保証されます。
構成例は次のとおりです。
フィルタ | Description |
'type in ("pod", "deployment") && name =~ "nginx"' | ポッドとデプロイメントの名前に含まれる場合 nginx 、それらのポッドとデプロイメントは除外されます。 |
'!(type == "pod" && namespace == "kube-system")' | ホワイトリスト ルールとして単純化するルールを否定します。 kube-system 名前空間のポッドのみが監視され、残りのポッドは除外されます。 |
'namespace == "default"' | のすべてのリソースを除外します default 名前空間 |
'!(type != "replicaset" && ns == "logicmonitor")' | 内のレプリカセットを除外します LogicMonitor 名前空間 – 残りのリソースが含まれます。 さらに、この規則は 'type == "replicaset" && ns == "logicmonitor" |
ご注意: Helm チャートのシークレットのみを除外する場合のルールは次のとおりです。
argus:
filters:
"secret" && jsonGet(object, "type") == "helm.sh/release.v1"'
任意のタイプのすべてのリソースを除外する場合は、ワイルドカード表記「name =~.*」を使用してルールを追加する代わりに、監視無効リストにリソースを追加する必要があります。
例:
argus:
monitoring:
disable:
- "replicasets"
LogicMonitorはオープンソースを使用しています ゴバリュエート フィルタ式を評価するためのライブラリ。 フィルタ式の構文の詳細については、 表現マニュアルを評価する.
ルールエンジン変数
ルールエンジンで使用できるようになっている次の変数を使用して、フィルタールールを記述できます。
変数名 | 値 | 値のデータ型 | コメント |
type | リソースタイプ | string | 次の演算子は、型変数で機能します。 "==", "!=", "in" 注意: (既知の問題): 配列に要素が XNUMX つしかない場合、型変数の in 演算子は機能しません。 |
名 | リソース名 | String | |
名前空間 | リソース名前空間 | String | リソースがネームスペース スコープでない場合は空です。 |
キーを変数名として持つリソースラベル | キーに対するリソースラベルの値 | String | ご注意: 毎回 ゴバリュエート ドキュメンテーションでは、特殊文字を含む変数名をエスケープする必要があります。 ドット (.)、ハイフン (-) などを角かっこで囲みます。 |
キーを変数名とするリソースアノテーション | キーに対するリソース注釈の値 | String | ご注意: 毎回 ゴバリュエート ドキュメンテーションでは、特殊文字を含む変数名をエスケープする必要があります。 ドット (.)、ハイフン (-) などを角かっこで囲みます。 |
ご注意: 注釈とラベルに同じキーが使用されている場合、ラベル値が優先され、評価に使用されます。
ルール作成ガイドライン
- YAML 変換での解析エラーを回避するために、ルールは単一引用符で囲まれた文字列で記述する必要があります。
- 包含ルール、除外ルールなどの区別があってはなりません。 ルールが true と評価された場合、リソースが除外されることを意味します。
ご注意: 場合によっては、ルールを単純化したい場合は、包含ルールを記述し、その値を反転して除外ルールにすることができます。
例:
単一の名前空間フロントエンドのリソースのみを監視する場合、ルールは次のとおりです。
'!(ns == "frontend")'
ご注意: 毎回 ゴバリュエート ドキュメンテーションでは、特殊文字を含む変数名をエスケープする必要があります。 ドット (.)、ハイフン (-) などを角かっこで囲みます。
例:
Web サービス ラベルを追加しました それぞれの価値を持つリソースについて。 残りのすべてのサービスの残りのリソースを除外して、ユーザー Web サービス リソースのみを監視する場合は、ルールを次のように記述できます。 '!([web-service] == "user")'
– ここで角括弧は、ルールの解析中に、その中のすべてを変数名として定義します。 web-service 変数を取り逃した場合、Govaluate はそれを数式 web -(マイナス) service にします。 – 期待どおりにリソースを除外しません。
例
次の例は、クラスター内のリソースを選択的に監視するために使用できるいくつかの可能な構成を示しています。
filters:
# Remove NGINX pods and deployment from monitoring
- 'type in ("pod", "deployment") && name =~ "nginx"'
# Remove pods in kube-system namespace from monitoring
- '(type == "pod" && namespace == "kube-system")'
# Remove resources in the default namespace from monitoring
- 'namespace == "default"'
# Remove relicasets in the logicmonitor namespace from monitoring
- '(type != "replicaset" && ns == "logicmonitor")'
ルールを作成するために利用可能な演算子
演算子 | Description | コメント | 例 |
== | 平等 | 完全一致文字列 | ns == "default" |
!= | 不平等 | 正確な文字列と等しくありません | name != "nginx" |
=~ | 正規表現の一致 | ドットとハイフンを含む正規表現が機能しない場合がある | name =~ "nginx" リソースの名前に Nginx というプレフィックスが含まれている場合、そのリソースは除外されます |
!~ | 逆正規表現パターン | に相当 !( )。 | name !~ “nginx” に相当 !(name =~ “nginx”) 名前に Nginx が含まれていないリソースは除外されます |
&& | 論理積 | 左側の式が偽の場合は短絡 | ns == "default" && name =~ "nginx". これにより、名前に Nginx が含まれるデフォルトの名前空間のリソースが除外されます |
|| | 論理OR | 左側が true と評価された場合、短絡します。 演算子は使用できますが、一連のルールが OR されるため、左側と右側が論理的に接続されていない場合は、別のルールを作成する必要があります。 | |
in | 配列のメンバーシップ | メンバーシップを確認するために等式==を実行します | ns in ("kube-system", "kube-public") これにより、言及された名前空間のリソースが除外されます |
() | グループ化する括弧 |