AppliesTo関数リファレンス

最終更新日: 27 年 2023 月 XNUMX 日

注: 使用してください AppliesToスクリプティングの概要 AppliesToスクリプトに関する最も完全な情報についての記事。

絶対関数

false()

構文

false()

計測パラメータ

なし

説明

  false() 関数がリソースに一致しません。 NS false() 関数を使用して、LogicModuleを削除せずにグローバルに無効にすることができます。 NS false() 関数は、開発中のLogicModuleで使用して、リソースに時期尚早に適用されるのを防ぐこともできます。 NS false() 関数はパラメータを受け入れません。

参照

true()

NS()

構文

true()

計測パラメータ

なし

説明

  true() 関数は環境内のすべてのリソースと一致するため、注意して使用する必要があります。 NS true() 関数はパラメータを受け入れません。

参照

false()

便利な機能

LogicMonitorは、リソースの一般的なカテゴリを識別するための多数の組み込み関数を維持しています。 これらの関数のほとんどは、 system.sysinfo プロパティ(WMI(Windowsデバイスの場合)またはSNMP(Linux、NetApp、Netscaler、Ciscoの場合)、または system.categories プロパティ(手動で入力することもできますが、通常はPropertySourcesによって入力されます)。 コンビニエンス関数はパラメーターを受け入れません。

isAWSService()

構文

isAWSService()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.devicetype プロパティは「2」です。

isAzureService()

構文

isAzureService()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.devicetype プロパティは「4」です。

isCisco()

構文

isCisco()

計測パラメータ

なし

説明

「cisco」の値がに含まれている場合はTRUEを返します。 system.sysinfo or system.categories プロパティ。

isCollectorDevice()

構文

isCollectorDevice()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.collector プロパティは「true」です。

isDevice()

構文

isDevice()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.devicetype プロパティが「0」の場合、または「collectorDataSources」の値がに含まれている場合 system.categories プロパティ。

isFreebsd()

構文

isFreebsd()

計測パラメータ

なし

説明

「freebsd」の値がに含まれている場合はTRUEを返します system.sysinfo or system.categories プロパティ。

isF5()

構文

isF5()

計測パラメータ

なし

説明

次の場合にTRUEを返します system.sysoid プロパティは「1.3.6.1.4.1.3375.2.1.3.4.4」で始まるか、「f5」の値がに含まれている場合 system.categories プロパティ。

isGCPService()

構文

isGCPService()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.devicetype プロパティは「7」です。

isK8sPod()

構文

isK8sPod()

計測パラメータ

なし

説明

  isK8sPod() AppliesTo 関数は、モジュールを Kubernetes ポッドにのみ適用します。

isLinux()

構文

isLinux()

計測パラメータ

なし

説明

「linux」の値がに含まれている場合はTRUEを返します system.sysinfo or system.categories プロパティと「CiscoIOS」の値がに存在しない system.sysinfo プロパティ。

isLinux(“excludeK8sPod”)

構文

isLinux("excludeK8sPod")

計測パラメータ

なし

説明

  isLinux(“excludeK8sPod”) AppliesTo 関数は Linux デバイスにのみモジュールを適用します。

isMisc()

構文

isMisc()

計測パラメータ

なし

説明

の基準がない場合はTRUEを返します isWindows(), isLinux(), isNetwork(), isStorage(), isVirtualization() 便利な機能が満たされています。

isNetApp()

構文

isNetApp()

計測パラメータ

なし

説明

「netapp」の値がに含まれている場合はTRUEを返します system.sysinfo or system.categories プロパティ。

isNetflow()

構文

isNetflow()

計測パラメータ

なし

説明

の値がTRUEの場合、TRUEを返します。 system.enablenetflow プロパティは「true」です。

isNetscaler()

構文

isNetscaler()

計測パラメータ

なし

説明

「netscaler」の値がに含まれている場合はTRUEを返します system.sysinfo or system.categories プロパティ。

isNetwork()

構文

isNetwork()

計測パラメータ

なし

説明

次の場合にTRUEを返します system.sysinfo or system.categories プロパティには、ネットワークと見なされるシステムを表す値が含まれています。 多数の値が含まれます。 「isNetwork」AppliesTo関数を参照してください(設定 > AppliesTo関数 > isネットワーク)完全な式の場合。

isSolaris()

構文

isSolaris()

計測パラメータ

なし

説明

「solaris」の値がに含まれている場合はTRUEを返します system.sysinfo or system.categories プロパティ。

isStorage()

構文

isStorage()

計測パラメータ

なし

説明

次の場合にTRUEを返します system.sysinfo or system.categories プロパティには、ストレージと見なされるシステムを表す値が含まれています。 多数の値が含まれます。 完全な式については、「isStorage」AppliesTo関数を参照してください。

isUnix()

構文

isUnix()

計測パラメータ

なし

説明

「solaris」または「linux」または「freebs」の値がに含まれている場合はTRUEを返します。 system.sysinfo or system.categories プロパティ。

isVirtualization()

構文

isVirtualization()

計測パラメータ

なし

説明

「vmware」または「xen」の値がに含まれている場合はTRUEを返します system.virtualization プロパティ、または「hyperv」の値がに含まれている場合 system.categories プロパティ。

isWindows()

構文

isWindows()

計測パラメータ

なし

説明

「windows」または「hyper-v」の値がに含まれている場合はTRUEを返します。 system.sysinfo or system.categories プロパティ。

getCollectorVersion()

構文

getCollectorVersion()

計測パラメータ

なし

説明

の値を返します system.collectorversion プロパティ。

配列を操作する関数

ほとんどのリソースプロパティは文字列型または数値型ですが、配列型には次のようなものがいくつかあります。

  • システム カテゴリ
  • システム.グループ
  • system.staticgroups
  • システム.ips

次のAppliesTo関数は、配列の操作に使用できます。

を含む()

構文

contains(<array>, "<string>")

計測パラメータ

説明

指定された文字列が配列要素と一致する場合、この関数はTRUEを返します。 一致は検索文字列での完全一致であり、大文字と小文字は区別されません。 正規表現はサポートされていません。

contains(system.groups,"network") –「network」、「Network」、「nEtWoRk」などの名前のリソースツリーのルートにあるグループ(動的および静的)に一致します。

注:   system.groups プロパティは、リソースを動的にグループに編成することを目的としたAppliesToスクリプト式では使用できません。 グループメンバーシップに依存する動的グループを作成する場合は、 system.staticgroups 財産。 例えば、 contains(system.staticgroups,"network".

contains(system.staticgroups,"Acme Corp/Prod") –「Prod」または「prod」という名前の「AcmeCorp」の子グループに一致しますが、「production」、「Prod_QA」などの名前の子グループには一致しません。

注: 静的グループメンバーシップ(動的グループメンバーシップではない)のみが照会されます。 system.staticgroups プロパティが参照されます。

contains(system.ips,"192.168.170.1") –IPアドレスが192.168.170.1のリソースを照合します。

注:   contains() 関数は、リソースの完全なIPアドレスを照合するためにのみ使用できます。 部分的なIPアドレスまたは範囲のマッチングには、 join() 機能。

も参照してください

join()

join()

構文

join(<array>, "<separator>")

計測パラメータ

  • (必須)
  • (必須)

説明

この関数は、指定された区切り文字で区切られた配列要素を使用して、配列を文字列にフラット化します。 部分一致と正規表現がサポートされています。 単独で使用すると、指定した配列プロパティに任意の値が設定されているリソースに対してTRUEを返します。

join(system.ips,",")=~"192.168.100." –リソースをサブネット192.168.100.X上のIPアドレスと照合します。 リソースの部分的なIPアドレスを照合する機能は、サブネットまたはIP範囲でデバイスをグループ化する場合に役立ちます。

join(system.groups,",")=~"Prod" –リソースツリーの任意のレベルで、「Prod」、「production」、「Prod1」などの名前を持つグループ内のリソースを照合します。

join(system.staticgroups,",")=~"/.*dev" –名前に「dev」、「Dev」、または「DEV」が含まれる非動的な子グループのリソースに一致します。

!join(system.categories,",")=~"/.*dev" –対象となるすべてのリソースに一致します system.categories 空です。 に相当 !system.categories.

も参照してください

contains()

hasCategory()

構文

hasCategory("<string>")

計測パラメータ

説明

この関数は、 system.categories 指定された文字列に対して大文字と小文字を区別せずに完全に一致する配列要素のプロパティ。 一致する場合はTRUEを返します。 正規表現はサポートされていません。

hasCategory("sonicwallfw")

文字列と数値を操作する関数

次の関数は、文字列型または数値型のプロパティを操作します。

存在する()

構文

exists("<property value>")

計測パラメータ

説明

指定された値がリソースのプロパティのいずれかに割り当てられている場合、この関数はTRUEを返します。

和()

構文

sum(x,y,z)

計測パラメータ

いずれかの番号

説明

この関数は、パラメーターとして渡された数値の合計を返します。

startWith()

構文

startsWith(<property>, "<value>")

計測パラメータ

  • 「「 」

説明

プロパティ値が関数で指定された値で始まる場合、この関数はTRUEを返します。 通常、値は文字列であり、二重引用符で囲む必要があります。 文字列の先頭からの部分一致がサポートされています。 正規表現はサポートされていません。 値を二重引用符なしで数値として渡すことができます。 ただし、数値の部分一致はサポートされていないため、関数がTRUEを返すには、一致が完了している必要があります。

startsWith(system.sysinfo,"Microsoft") –Windowsリソースと一致します。

startsWith(system.collectorversion,"28") –コレクターバージョン28.xxxによって監視されているリソースと一致します。

startsWith(system.collectorversion,"28102") –Collectorバージョン28.102によって監視されるリソースと一致します。 これはと同等であることに注意してください system.collectorversion==23102.

getPropValue()

構文

getPropValue("<property name>")

計測パラメータ

説明

デバイスのプロパティ名に「:」、「/」、「*」、「=」、スペースなどの特殊文字が含まれている場合は、 getPropValue("") 関数。 プロパティ名に特殊文字を含めないことをお勧めしますが、それを避けられない場合は、この関数を使用して、AppliesTo式でプロパティを使用できます。

たとえば、「SiteA:unit」という名前のプロパティがあり、このプロパティの値が10〜19のリソースを返したい場合は、次のことを試してください。 SiteA:unit=~"[10-19]"

ただし、正規表現の文字をエスケープする必要があることを通知する構文エラーが表示されます。 エラーを回避するには、代わりに次の式を使用する必要があります。 getPropValue("SiteA:unit")=~"[10-19]"。 プロパティ名は二重引用符で囲まれていることに注意してください

日時 getPropValue("") 単独で使用すると、指定したプロパティに値が設定されているすべてのリソースに対してTRUEを返します。

記事上で