Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.6
    Sv translation
    languageen
    Appd tocbox

    Related Pages:

    This page provides instructions on custom actions in AppDynamics.

    You can set up a custom action on the Controller instance to integrate notification of AppDynamics health rule violations and events with an alerting or ticketing system. Use a push approach by creating custom notifications that pass the information to your alerting system.

    Custom Notifications and Custom Actions

    A custom notification lets you integrate alerts about AppDynamics health rule violations and events into your own alerting system. This integration extension requires:

    • A custom.xml file that provides information about the custom notification.
    • An executable script that accepts parameters from AppDynamics about the events and health rule violations that trigger an alert.
    • Configuring AppDynamics events or policies to trigger the custom notification via a custom action.

    Creating a Custom Action

    Create the script

    For each custom action that you want to implement, create an executable script (.bat extension for Windows, .sh extension for Linux) that can accept and process the parameters passed to it by AppDynamics. See Information Passed to the Custom Action Script from AppDynamics for details on the parameters.

    For each script:

    • Set correct executable permissions for the shell scripts in a Linux environment. For example, chmod 770 script1.sh.
    • Ensure that the script file has the correct character encoding. This is especially important when creating a Unix shell script on a Windows machine.

    Install the script on an On-Premises Controller

    To install the script on an on-premises controller:

    1. At the top level of the Controller installation directory, create a directory named "custom" with a sub-directory named "actions".

      Code Block
      <controller_home>/custom/actions
    2. In the <controller_home>/custom/actions directory, create a subdirectory for each custom action script that you will install. For example, for an action that interfaces with a JIRA system.

      Code Block
      <controller_home>/custom/actions/jira
    3. Move the script to the appropriate subdirectory that you created.

    Create the XML File

    1. Create a custom.xml file that describes the location and name of your custom action script. See Contents of the custom.xml File.
    2. For an on-premises Controller, move the file to the <controller_home>/custom/actions directory. For a SaaS Controller, contact your AppDynamics sales representative for instructions.

    Verify on the Script on an on-premises Controller

    1. After you have installed the script and the custom.xml file, restart the Controller.
    2. Verify the script manually. To verify the script:
       a. Open a command-line console on the Controller host machine.
       b. Execute the script file from the command line console.

    Create the Custom Action

    To arrange how a custom action will be triggered, see Custom Actions.

    Contents of the custom.xml File

    The custom.xml file has an <actions> element for every custom action on the controller. 

    The <type> element contains the subdirectory that contains the script file.

    The <executable> element contains the name of the script.

    Sample Custom.XML File

    Code Block
    <custom-actions>
      <action>
         <type>jira</type>
         <executable>script1.bat</executable>
      </action>
      <action>
        <type>bugzilla</type>
        <executable>script2.sh</executable>
      </action>
    </custom-actions>

    Information Passed to the Custom Action Script from AppDynamics

    The custom action script must handle the parameters that the Controller passes from the health rule violation or other event. The parameter values are passed as an array of strings.

    The parameters are passed as $0 for the script name, then $1, $2, . . . $n.  $1 is the first parameter (application name), $2 is the application id, and so on in the order in which they are documented in the sections below.

    Health rule violations have a different set of parameters from events.

    Parameters passed by a health rule violation

    The parameters describe the violated health rule violation that triggered the action.

    The total number of elements in the array depends on the number of entities evaluated by the health rule and the number of triggered conditions per evaluation entity. Examples of evaluation entities are application, tier, node, business transaction, JMX. For each evaluation entity, the script expects the entity type, entity name, entity id, number of triggered conditions, and for each triggered condition, the set of condition parameters.

    The parameter values are passed in the order in which they are described below.

    Structure of Parameters Sent by a Health Rule Violation

    • APP_NAME
    • APP_ID
    • PVN_ALERT_TIME
    • PRIORITY
    • 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—The following parameters are passed for each evaluation entity:
      • EVALUATION_ENTITY_TYPE
      • EVALUATION_ENTITY_NAME
      • EVALUATION_ENTITY_ID
      • NUMBER_OF_TRIGGERED_CONDITIONS_PER_EVALUATION_ENTITY—The following parameters are passed for each triggered condition for this 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
    • ACCOUNT_ID
    • TAG

    Definitions of Parameters Sent by a Health Rule Violation

    Health Rule Violation Parameter

    Definition

    APP_NAME

    Name of the business application.

    APP_ID

    Application ID number.

    PVN_ALERT_TIME

    Alert time, such as Thu Dec 22 15:03:56 PST 2011.

    PRIORITY

    Integer designating how urgently a health rule violation should be fixed. The lowest number (0) is the most urgent.

    SEVERITY

    INFO, WARN, or ERROR. In the Controller UI, they are called Info, Warning, and Critical.

    ACTION_NAMEName of the action to be invoked post a health rule violation.

    HEALTH_RULE_NAME

    Name of the health rule that was violated.

    HEALTH_RULE_ ID

    Health rule ID.

    PVN_TIME_PERIOD_IN_MINUTES

    Health rule violation time period in minutes.

    AFFECTED_ENTITY_TYPE

    APPLICATION, APPLICATION_COMPONENT (aka Tier), APPLICATION_COMPONENT_NODE, BUSINESS_TRANSACTION, APPLICATION_DIAGNOSTIC_DATA (aka Error).

    AFFECTED_ENTITY_NAME

    The affected entity name.

    AFFECTED_ENTITY_ID

    The affected entityID.

    NUMBER_OF_EVALUATION_ENTITIES

    Number of entities (Business Transactions, Applications, Tiers, Nodes, Errors, JMX counters, and so on) violating the health rule conditions

    EVALUATION_ENTITY_TYPE

    APPLICATION, APPLICATION_COMPONENT (aka Tier), APPLICATION_COMPONENT_NODE, BUSINESS_TRANSACTION, APPLICATION_DIAGNOSTIC_DATA (aka Error), JMX.

    EVALUATION_ENTITY_NAME

    The evaluation entity name (for JMX it is the counter name).

    EVALUATION_ENTITY_ID

    The evaluation entity ID or <NULL> for JMX.

    NUMBER_OF_TRIGGERED_CONDITIONS_PER_EVALUATION_ENTITY 

    Number of times to loop through the triggered condition parameters for each evaluation entity; if more than one condition is triggered, the parameters repeat for each triggered condition, where x is the position of the condition.

    SCOPE_TYPE_x

    The scope of the parameter, whether the scope is the application, tier, or node:
    APPLICATION, APPLICATION_COMPONENT, APPLICATION_COMPONENT_NODE.

    SCOPE_NAME_x

    The name of the scope, such as ACME Book Store Application.

    SCOPE_ID_x

    The scope ID.

    CONDITION_NAME_x

    The health rule condition name.

    CONDITION_ID_x

    The health rule condition ID.

    OPERATOR_x

    Allowed operators: LESS_THAN, LESS_THAN_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, EQUALS, NOT_EQUALS.

    CONDITION_UNIT_TYPE_x

    The condition for the threshold parameter: ABSOLUTE, BASELINE_STANDARD_DEVIATION, BASELINE_PERCENTAGE, BASELINE_PERCENTILE.

    USE_DEFAULT_BASELINE_x

    A Boolean parameter (true or false) applies only when the condition unit type is one of the BASELINE_ types.

    BASELINE_NAME_x

    Applicable only when the condition unit type is one of the BASELINE_ types and the use default baseline parameter is false.

    BASELINE_ID_x

    Applicable only when the condition unit type is one of the BASELINE_ types and the use default baseline parameter is false.

    THRESHOLD_VALUE_x

    Health rule threshold setting.

    OBSERVED_VALUE_x

    Value that violated the health rule threshold.

    SUMMARY_MESSAGE

    Summary of the notification, such as Health rules have been violated.

    INCIDENT_ID

    The incident identifier number for this health rule violation. Incident ID is unique within the Controller. The field is defined as int(11) which means it takes four bytes of space that is 32 bits of space with 2^(31) - 1 = 2147483647 max value and -2147483648 min value. One bit is for sign.

    DEEP_LINK_URL

    Controller deep link URL, such as:

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

    Append the incident ID to the URL to provide a link to the Controller UI for this policy violation.

    EVENT_TYPE

    POLICY_OPEN_WARNING, POLICY_OPEN_CRITICAL, POLICY_CLOSE_WARNING, POLICY_CLOSE_CRITICAL, POLICY_UPGRADED, POLICY_DOWNGRADED, POLICY_CANCELED_WARNING, POLICY_CANCELED_CRITICALPOLICY_CONTINUES_CRITICAL, and POLICY_CONTINUES_WARNING.

    ACCOUNT_NAMEName of the account in which the action was triggered.
    ACCOUNT_IDID of the account in which the action was triggered.
    TAGTag specified by the user or the empty string if no tag was specified.

    Parameters passed by an event

    The parameters describe the event that triggered the action.

    The total number of elements in the array depends on the number of event types and event summaries that triggered the action. 

    The parameter values are passed in the order in which they are described below.

    Structure of Parameters Sent by an Event

    • APP_NAME
    • APP_ID
    • EN_TIME 
    • PRIORITY
    • SEVERITY 
    • EN_NAME
    • EN_ ID
    • EN_INTERVAL_IN_MINUTES
    • NUMBER_OF_EVENT_TYPES
      T
      he following parameters are passed for each event type:
      • EVENT_TYPE_x
      • EVENT_TYPE_NUM_x
    • NUMBER_OF_EVENT_SUMMARIES
      The following parameters are passed for each event summary:
      • EVENT_SUMMARY_ID_x
      • EVENT_SUMMARY_TYPE_x
      • EVENT_SUMMARY_SEVERITY_x
      • EVENT_SUMMARY_STRING _x
    • DEEP_LINK_URL
    • ACCOUNT_NAME
    • ACCOUNT_ID
    • TAG

    Definitions of Parameters Sent by an Event

    Event Notification Parameter

    Definition

    APP_NAME

    Name of the business application.

    APP_ID

    Application ID number.

    EN_TIME

    Event notification time, for example, Wed Jan 04 09:36:55 PST 2012.

    PRIORITY

    Integer designating how urgently a health rule violation should be fixed, with the lowest number (0) the most urgent.

    SEVERITY

    Allowed values: INFO, WARN, or ERROR. In the AppDynamics UI they are called Info, Warning, and Critical.

    EN_NAME

    Name of the event notification.

    EN_ID

    Event notification ID number.

    EN_INTERVAL_IN_MINUTES

    Event notification interval in minutes.

    NUMBER_OF_EVENT_TYPES

    Determines how many times to loop through the event type map parameters.

    EVENT_TYPE_x

    If there is more than one event type, the parameters repeat for each event type, where x increments the number representing the event type.

    EVENT_TYPE_NUM_x

    Number of events of this type.

    NUMBER_OF_EVENT_SUMMARIES

    Number of event summaries in the notification that determines how many times to loop through the event summary parameters.

    EVENT_SUMMARY_ID_x

    Event summary ID number.

    EVENT_SUMMARY_TIME_x

    Event summary time, for example: Wed Jan 04 09:34:13 PST 2012.

    EVENT_SUMMARY_TYPE_x

    Type of event, such as: APPLICATION_CONFIG_CHANGE, APP_SERVER_RESTART, DIAGNOSTIC_SESSION, STALL.

    EVENT_SUMMARY_SEVERITY_x

    Event severity, such as: INFO, WARN or ERROR. In the Controller UI, they are called Info, Warning, and Critical.

    EVENT_SUMMARY_STRING_x

    Event summary string, such as: Application Server environment variables changed.

    DEEP_LINK_URL

    http://<controller-host-url>/#location=APP_EVENT_VIEWER_MODAL&eventSummary=
    Append each event summary ID to the URL to provide a link to the Controller UI for this event.

    ACCOUNT_NAMEName of the account in which the action was triggered.
    ACCOUNT_IDID of the account in which the action was triggered.
    TAGTag specified by the user or the empty string if no tag was specified.

    Sample Custom Action Script

    See the CreateServiceNow script for an example of a script that creates ServiceNow tickets triggered by AppDynamics health rule violations.



    Sv translation
    languageja
    Appd tocbox

    Related pages:

    AppDynamicsの正常性ルール違反およびイベントの通知をアラートまたはチケットシステムと統合するために、コントローラインスタンス上でカスタムアクションをセットアップできます。アラートシステムに情報を渡すカスタム通知を作成することによって、プッシュアプローチを使用します。

    カスタム通知とカスタムアクション

    カスタム通知により、AppDynamicsの正常性ルール違反およびイベントに関するアラートを、お使いのアラートシステムに統合できます。この統合の拡張には次のものが必要です。

    • カスタム通知に関する情報を提供する custom.xml ファイル
    • アラートをトリガーするイベントおよび正常性ルール違反に関するAppDynamicsからのパラメータを受け取る実行可能スクリプト
    • カスタムアクションによってカスタム通知をトリガーするためのAppDynamicsイベントまたはポリシーの構成

    このトピックでは、スクリプトとXMLファイルの作成方法について説明します。アクションのトリガー方法については、上記関連ページのアラートおよび応答機能に関するドキュメントを参照してください。

    カスタムアクションの作成

    スクリプトの作成

    実装するカスタムアクションごとに、AppDynamics から渡されるパラメータを受け取って処理できる実行可能スクリプト(Windows では .bat 拡張子、Linux では .sh 拡張子)を作成します。パラメータに関する詳細は、「Information Passed to the Custom Action Script from AppDynamics」を参照してください。スクリプトごとに、次のようにします。

    • Linux環境でシェルスクリプトの適切な実行権限を設定します。たとえば、chmod 770 script1.sh とします。
    • スクリプトファイルで正しく文字がエンコードされていることを確認します。これは、Windowsマシン上でUnixシェルスクリプトを作成する場合は特に重要です。

    オンプレミスコントローラへのスクリプトのインストール

    To install the script on an on-premises controller:

    1. コントローラのインストールディレクトリの直下に「custom」という名前のディレクトリを作成し、その下に「actions」サブディレクトリを作成します。

      No Format
        <controller_home>/custom/actions
      
    2. <controller_home>/custom/actions ディレクトリで、インストールする各カスタム アクション スクリプトのためのサブディレクトリを作成します(たとえば、JIRA システムと連動するアクション用など)。

      No Format
      <controller_home>/custom/actions/jira
      
    3. ステップ2で作成した適切なサブディレクトリにスクリプトを移動します。

    XMLファイルの作成

    1. カスタム アクション スクリプトの場所と名前を記述した custom.xml ファイルを作成します。「Contents of the custom.xml File」を参照してください。
    2. オンプレミスコントローラの場合は、ファイルを <controller_home>/custom/actions ディレクトリに移動します。SaaSコントローラの場合の手順については、AppDynamicsの営業担当者までお問い合わせください。

    オンプレミスコントローラでのスクリプトの検証

    1. スクリプトとcustom.xmlファイルをインストールしたら、コントローラを再起動します。
    2. スクリプトを手動で検証します。スクリプトの検証方法:
      a. コントローラホストマシンでコマンドラインコンソールを開く。
      b. コマンドラインコンソールからスクリプトファイルを実行。

    カスタムアクションの作成

    AppDynamics UIでカスタムアクションを作成して、カスタムアクションがどのようにトリガーされるかを調整します。詳細については、Custom Actionsを参照してください。

    custom.xmlファイルのコンテンツ

    custom.xml ファイルには、コントローラ上のあらゆるカスタムアクションに対する <actions> 要素があります。 

    <type> 要素にはスクリプトファイルを含むサブディレクトリがあります。 

    <executable> 要素にはスクリプトの名前があります。

    Sample custom.xml file

    No Format
    <custom-actions>
      <action>
         <type>jira</type>
         <executable>script1.bat</executable>
      </action>
      <action>
        <type>bugzilla</type>
        <executable>script2.sh</executable>
      </action>
    </custom-actions>
    

    AppDynamicsからカスタムアクションスクリプトに渡される情報

    カスタムアクションスクリプトは、コントローラが正常性ルール違反またはその他のイベントから渡すパラメータを処理する必要があります。パラメータの値は文字列の配列として伝えられます。

    スクリプト名のパラメータは $0 として伝えられます。$1, $2, . . . $n.  $1 は最初のパラメータ(アプリケーション名)、$2 はアプリケーション ID と順番に続きます。以下のセクションでその順番を確認できます。

    正常性ルール違反には、イベントとは異なるパラメータセットがあります。

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

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

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

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

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

    • APP_NAME
    • APP_ID
    • PVN_ALERT_TIME
    • PRIORITY
    • 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
    • ACCOUNT_ID

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

    正常性ルール違反パラメータ

    定義

    APP_NAME

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

    APP_ID

    アプリケーションID番号

    PVN_ALERT_TIME

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

    PRIORITY

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

    SEVERITY

    INFOWARN、または ERROR— AppDynamics UI では InfoWarning、および Critical

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

    HEALTH_RULE_NAME

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

    HEALTH_RULE_ ID

    正常性ルールID

    PVN_TIME_PERIOD_IN_MINUTES

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

    AFFECTED_ENTITY_TYPE

    APPLICATION, APPLICATION_COMPONENT (別名 Tier)、APPLICATION_COMPONENT_NODE, BUSINESS_TRANSACTION, APPLICATION_DIAGNOSTIC_DATA ( 別名 Error)

    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。例:

    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_CRITICALPOLICY_CONTINUES_CRITICAL、および POLICY_CONTINUES_WARNING

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

    イベントによって渡されるパラメータ

    パラメータにより、アクションをトリガーしたイベントが記述されます。

    配列内の要素の総数は、アクションをトリガーしたイベントタイプおよびイベントサマリーの数によって異なります。 

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

    イベントにより送信されるパラメータの構造

    • APP_NAME
    • APP_ID
    • EN_TIME 
    • PRIORITY
    • SEVERITY 
    • EN_NAME
    • EN_ ID
    • EN_INTERVAL_IN_MINUTES
    • NUMBER_OF_EVENT_TYPES
      T
      次のパラメータが、イベントタイプごとに渡されます。
      • EVENT_TYPE_x
      • EVENT_TYPE_NUM_x
    • NUMBER_OF_EVENT_SUMMARIES
      次のパラメータが、イベントサマリーごとに渡されます。
      • EVENT_SUMMARY_ID_x
      • EVENT_SUMMARY_TYPE_x
      • EVENT_SUMMARY_SEVERITY_x
      • EVENT_SUMMARY_STRING _x
    • DEEP_LINK_URL
    • ACCOUNT_NAME
    • ACCOUNT_ID

    イベントによって送信されるパラメータの定義

    イベント通知パラメータ

    定義

    APP_NAME

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

    APP_ID

    アプリケーションID番号

    EN_TIME

    イベント通知時刻(例:Wed Jan 04 09:36:55 PST 2012)

    PRIORITY

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

    SEVERITY

    許容値:INFOWARN、または ERROR.。AppDynamics UI では Info、Warning、および Critical

    EN_NAME

    イベント通知の名前

    EN_ID

    イベント通知ID番号

    EN_INTERVAL_IN_MINUTES

    分単位のイベント通知間隔

    NUMBER_OF_EVENT_TYPES

    イベントタイプのマップパラメータでループする回数を決定

    EVENT_TYPE_x

    1つ以上のイベントタイプがある場合、パラメータは各イベント タイプで繰り返し(イベント タイプを示す数字がx分増加)

    EVENT_TYPE_NUM_x

    このタイプのイベントの数

    NUMBER_OF_EVENT_SUMMARIES

    通知内のイベントサマリの数(イベントサマリパラメータをループする回数を決定)

    EVENT_SUMMARY_ID_x

    イベントサマリID番号

    EVENT_SUMMARY_TIME_x

    イベントサマリ時刻(例:Wed Jan 04 09:34:13 PST 2012)

    EVENT_SUMMARY_TYPE_x

    次のようなイベントのタイプ。 APPLICATION_CONFIG_CHANGE, APP_SERVER_RESTART, DIAGNOSTIC_SESSION, STALL

    EVENT_SUMMARY_SEVERITY_x

    イベントの重大度:INFOWARN 、または ERROR。AppDynamics UIではInfo、Warning、およびCritical。

    EVENT_SUMMARY_STRING_x

    イベントサマリ文字列(例:Application Server environment variables changed)

    DEEP_LINK_URL

    http://<controller-host-url>/#location=APP_EVENT_VIEWER_MODAL&eventSummary=
    各イベントサマリー ID を URL に追加して、このイベントに対するコントローラ UI へのリンクを提供

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

    カスタムアクションスクリプトのサンプル

    AppDynamics の正常性ルール違反によってトリガーされる ServiceNow チケットを作成するスクリプトの例については、CreateServiceNow スクリプトを参照してください。