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

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

配列内の要素の総数は、正常性ルールにより評価されるエンティティの数と、評価エンティティごとのトリガーされる条件の数によって異なります。評価エンティティの例としては、アプリケーション、ティア、ノード、ビジネストランザクション、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

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

ACTION_NAME

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

HEALTH_RULE_NAME

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

HEALTH_RULE_ ID

正常性ルール ID。

PVN_TIME_PERIOD_IN_MINUTES

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

AFFECTED_ENTITY_TYPE

APPLICATION、APPLICATION_COMPONENT(別名ティア)、APPLICATION_COMPONENT_NODE、BUSINESS_TRANSACTION、APPLICATION_DIAGNOSTIC_DATA(別名エラー)

AFFECTED_ENTITY_NAME

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

AFFECTED_ENTITY_ID

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

NUMBER_OF_EVALUATION_ENTITIES

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

EVALUATION_ENTITY_TYPE

APPLICATION、APPLICATION_COMPONENT(別名ティア)、APPLICATION_COMPONENT_NODE、BUSINESS_TRANSACTION、APPLICATION_DIAGNOSTIC_DATA(別名エラー)、JMX

EVALUATION_ENTITY_NAME

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

EVALUATION_ENTITY_ID

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

NUMBER_OF_TRIGGERED_CONDITIONS_PER_EVALUATION_ENTITY

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

SCOPE_TYPE_x

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

SCOPE_NAME_x

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

SCOPE_ID_x

スコープ ID。

CONDITION_NAME_x

正常性ルールの条件名。

CONDITION_ID_x

正常性ルールの条件 ID。

OPERATOR_x

許可された演算子:LESS_THAN、LESS_THAN_EQUALS、GREATER_THAN、GREATER_THAN_EQUALS、EQUALS、NOT_EQUALS。

CONDITION_UNIT_TYPE_x

しきい値パラメータの条件: ABSOLUTE、 BASELINE_STANDARD_DEVIATION、 BASELINE_PERCENTAGE、 BASELINE_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_WARNING、POLICY_OPEN_CRITICAL、POLICY_CLOSE_WARNING、POLICY_CLOSE_CRITICAL、POLICY_UPGRADED、POLICY_DOWNGRADED、POLICY_CANCELED_WARNING、POLICY_CANCELED_CRITICAL、POLICY_CONTINUES_CRITICAL、POLICY_CONTINUES_WARNING。

アカウント

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

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

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