正常性ルール違反によって渡されるパラメータ

パラメータにより、アクションをトリガーした正常性ルール違反が記述されます。

配列内の要素の総数は、正常性ルールにより評価されるエンティティの数と、評価エンティティごとのトリガーされる条件の数によって異なります。評価エンティティの例としては、アプリケーション、ティア、ノード、ビジネストランザクション、JMX などがあります。スクリプトは、評価エンティティごとにエンティティタイプ、エンティティ名、エンティティID、トリガーされる条件の数を期待し、トリガーされる条件ごとに一連の条件パラメータを期待します。

パラメータの値は、記述する順で渡されます。

正常性ルール違反により送信されるパラメータの構造

  • APP_NAME
  • APP_ID
  • PVN_ALERT_TIME
  • 優先度
  • SEVERITY // INFO, WARN, ERROR
  • ACTION_NAME
  • HEALTH_RULE_NAME
  • HEALTH_RULE_ ID
  • PVN_TIME_PERIOD_IN_MINUTES
  • AFFECTED_ENTITY_TYPE
  • AFFECTED_ENTITY_NAME
  • AFFECTED_ENTITY_ID
  • NUMBER_OF_EVALUATION_ENTITIES:次のパラメータが、評価エンティティごとに渡されます。
    • EVALUATION_ENTITY_TYPE
    • EVALUATION_ENTITY_NAME
    • EVALUATION_ENTITY_ID
    • NUMBER_OF_TRIGGERED_CONDITIONS_PER_EVALUATION_ENTITY:次のパラメータが、この評価エンティティのトリガー条件ごとに渡されます。
      • SCOPE_TYPE_x
      • SCOPE_NAME_x
      • SCOPE_ID_x
      • CONDITION_NAME_x
      • CONDITION_ID_x
      • OPERATOR_x
      • CONDITION_UNIT_TYPE_x
      • USE_DEFAULT_BASELINE_x
      • BASELINE_NAME_x
      • BASELINE_ID_x
      • THRESHOLD_VALUE_x
      • OBSERVED_VALUE_x
  • SUMMARY_MESSAGE
  • INCIDENT_ID
  • DEEP_LINK_URL
  • EVENT_TYPE
  • アカウント
  • ACCOUNT_NAME

正常性ルール違反によって送信されるパラメータの定義

正常性ルール違反パラメータ 定義
APP_NAME

ビジネスアプリケーションの名前。

APP_ID

アプリケーション ID 番号。

PVN_ALERT_TIME

アラート時刻(例:Thu Dec 22 15:03:56 PST 2011)。

優先度

正常性ルール違反の是正の緊急度を指定する整数。最小値(0)が最も高い緊急度を表す。

SEVERITY

INFOWARN、または ERROR コントローラ UI では Info、Warning、および Critical。

ACTION_NAME

正常性ルール違反後に呼び出されるアクションの名前。

HEALTH_RULE_NAME

違反のあった正常性ルールの名前。

HEALTH_RULE_ ID

正常性ルール ID。

PVN_TIME_PERIOD_IN_MINUTES

正常性ルール違反の期間(分単位)。

AFFECTED_ENTITY_TYPE

APPLICATIONAPPLICATION_COMPONENT(別名ティア)、APPLICATION_COMPONENT_NODEBUSINESS_TRANSACTIONAPPLICATION_DIAGNOSTIC_DATA(別名エラー)

AFFECTED_ENTITY_NAME

影響を受けるエンティティ名。

AFFECTED_ENTITY_ID

影響を受けるエンティティ ID。

NUMBER_OF_EVALUATION_ENTITIES

正常性ルールの条件に違反しているエンティティ(ビジネストランザクション、アプリケーション、ティア、ノード、エラー、JMX カウンタなど)の数。

EVALUATION_ENTITY_TYPE

APPLICATIONAPPLICATION_COMPONENT(別名ティア)、APPLICATION_COMPONENT_NODEBUSINESS_TRANSACTIONAPPLICATION_DIAGNOSTIC_DATA(別名エラー)、JMX

EVALUATION_ENTITY_NAME

評価エンティティ名(JMX の場合はカウンタ名)。

EVALUATION_ENTITY_ID

評価エンティティ ID、または JMX の場合は <NULL>。

NUMBER_OF_TRIGGERED_CONDITIONS_PER_EVALUATION_ENTITY

トリガーされる条件パラメータを評価エンティティごとにループする回数。複数の条件がトリガーされる場合、トリガーされる条件ごとにパラメータが複製される(x は条件の位置を示す)。

SCOPE_TYPE_x

パラメータの範囲(範囲がアプリケーション、階層、またはノード):APPLICATIONAPPLICATION_COMPONENTAPPLICATION_COMPONENT_NODE

SCOPE_NAME_x

スコープの名前(例:ACME Book Store Application)。

SCOPE_ID_x

スコープ ID。

CONDITION_NAME_x

正常性ルールの条件名。

CONDITION_ID_x

正常性ルールの条件 ID。

OPERATOR_x

許可された演算子:LESS_THANLESS_THAN_EQUALSGREATER_THANGREATER_THAN_EQUALSEQUALSNOT_EQUALS

CONDITION_UNIT_TYPE_x

しきい値パラメータの条件: ABSOLUTEBASELINE_STANDARD_DEVIATIONBASELINE_PERCENTAGEBASELINE_PERCENTILE

USE_DEFAULT_BASELINE_x

条件のユニットタイプが BASELINE_ タイプのいずれかである場合にのみ該当するブール型パラメータ(true または false

BASELINE_NAME_x

条件ユニットのタイプが BASELINE_ タイプのいずれかであり、デフォルトベースラインの使用パラメータが false の場合にのみ該当

BASELINE_ID_x

条件ユニットのタイプが BASELINE_ タイプのいずれかであり、デフォルトベースラインの使用パラメータが false の場合にのみ該当

THRESHOLD_VALUE_x

正常性ルールのしきい値の設定。

OBSERVED_VALUE_x

正常性ルールのしきい値に違反した値。

SUMMARY_MESSAGE

「正常性ルールに違反しています」のような通知のサマリー。

INCIDENT_ID

この正常性ルール違反のインシデント ID 番号。インシデント ID はコントローラ内で一意。フィールドは int(11)として定義され、4 バイト(32 ビット)の空間を使用し、最大値は 2^(31)- 1 = 2147483647、最小値は -2147483648。1 ビットは符号用。

DEEP_LINK_URL

コントローラのディープリンクURL。例:

CODE
http://<controller-host-url>/#location=APP_INCIDENT_DETAIL&incident=<incident-id>

インシデント ID を URL に追加し、このポリシー違反に対するコントローラ UI へのリンクを提供。

EVENT_TYPE

POLICY_OPEN_WARNINGPOLICY_OPEN_CRITICALPOLICY_CLOSE_WARNINGPOLICY_CLOSE_CRITICALPOLICY_UPGRADEDPOLICY_DOWNGRADEDPOLICY_CANCELED_WARNINGPOLICY_CANCELED_CRITICALPOLICY_CONTINUES_CRITICALPOLICY_CONTINUES_WARNING

アカウント

エンティティタイプ「ACCOUNT」。

注: これは定義済みのテキストです。
ACCOUNT_NAME

アクションがトリガーされたアカウントの名前。