BMC TrueSight と BMC TrueSight_v2 からのイベント収集

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:8分
  • MID Web サービスイベントコネクターを使用すると、イベントストリーム通知機能を利用して、BMC TrueSight Operations Management (TrueSight) (旧称:BMC ProactiveNet Performance Management (BPPM)) から送信された JSON 形式のイベントメッセージを収集できるようになります。

    始める前に

    イベント管理 Connectors (sn_em_connector) プラグインが Now Platform インスタンスにインストールされていることを確認します。

    必ず以下を実行してください。
    必要なロール:evt_mgmt_admin

    このタスクについて

    JSON 形式のイベントメッセージは、BMC TrueSight から送信されます。MID サーバーは、次の場所にあるTransformEvents_bmcTrueSightスクリプトインクルードを使用して解析することにより、収集されたイベントメッセージを変換します。 イベント管理 > 統合 > リスナー変換スクリプト. [リスナー変換スクリプト] ページで、[TransformEvents_bmcTrueSight] をクリックします。

    イベントメッセージを BMC TrueSight から MID サーバー にプッシュするための URL のデフォルト形式は、http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight です。

    イベントメッセージを BMC TrueSight_v2 から MID サーバー にプッシュするための URL のデフォルト形式は、http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight_v2 です。

    表 : 1. デフォルト URL の変数
    変数 説明
    MID_Server_IP MID Web サーバー拡張の IP アドレス。
    MID_Web_Server_Port MID Web サーバー拡張のリスニングポート。
    MID_Web_Server_User MID Web サーバー拡張のユーザー名。
    MID_Web_Server_Password MID Web サーバー拡張のユーザーのパスワード。ただし、パスワードを BASE64 でエンコードします。たとえば、MID Web サーバー拡張のパスワードが「admin」である場合は、 MID_Web_Server_Password のパスワードとして「YWRtaW4=」を使用します。

    BASE64 値を決定するために、Web サイト https://www.base64encode.org/ のユーティリティを使用できます。

    次の手順は、ベーシック認証を使用した、JSON 形式のイベントメッセージの収集について説明しています。サポートされている認証方法の詳細については、「MID Web サーバー 拡張の設定」を参照してください。

    手順

    1. BMC TrueSight で、次のパラメーターを使用して、MID Web サービスイベントコレクターを BMC TrueSight 通知のターゲットとして設定します。
      表 : 2. 汎用の BMC URL の変数
      変数 説明
      serverHost BMC TrueSight サーバーの名前。
      port BMC TrueSight ポートの番号。
    2. メッセージ本文と汎用の BMC URL で、パラメーターを前出のテーブルの値に置き換え、BMC TrueSight に接続します。
      BMC 公開/登録 REST 方式により、ストリームイベントサブスクリプションを作成し、JSON 形式でイベントメッセージを送信します。ストリームイベントサブスクリプションを作成するための BMC URL の汎用形式は http|https://<serverHost>:<port>/bppmws/api/stream/subscribe?dataType=event です。たとえば、http://TrueSight1server:40/bppmws/api/stream/subscribe?dataType=event のようになります。

    タスクの結果

    表 : 3. イベントメッセージをイベント (em_event) テーブルのイベントフィールドにマッピングする例
    イベントフィールド イベントメッセージ
    node mc_host
    type mc_object_class
    metric_name mc_parameter
    resource mc_object
    severity severity
    time_of_event date_reception
    description msg

    例では、メッセージ本文を示しています。

    
    { action: 'create',
      data:
       { mc_abstracted: [],
         itsm_operational_category3: '',
         mc_object_class: 'CPU',
         source: 'MySource',
         adapter_host: '',
         itsm_operational_category2: '',
         itsm_location: '',
         itsm_operational_category1: '',
         mc_abstraction: [],
         mc_tool_id: '',
         mc_original_priority: 'PRIORITY_1',
         event_handle: '3172',
         mc_modhist: [],
         mc_tool_class: '',
         mc_origin: '',
         mc_tool_uri: '',
         mc_service: '',
         mc_smc_type: '',
         mc_object_owner: '',
         mc_object: 'CPU_0',
         mc_notes: [],
         itsm_model_version: '',
         mc_origin_key: '',
         mc_tool_address: '',
         mc_ueid: 'mc.pncell_bmcswetsom96.1829b8ed.0',
         mc_bad_slot_names: [],
         date: '20161114081525.000000-300',
         itsm_item: '',
         mc_timeout: '0',
         mc_priority: 'PRIORITY_1',
         itsm_type: '',
         itsm_manufacturer: '',
         mc_tool_key: '',
         itsm_product_name: '',
         mc_smc_impact: 'NOT_ELECTED',
         mc_parameter: 'MEMFreeMem',
         mc_bad_slot_values: [],
         itsm_incident_id: '',
         mc_incident_report_time: '0',
         mc_event_model_version: '1.1.00',
         mc_relationships: '0/0',
         CLASS: 'EVENT',
         mc_using_organization: '',
         mc_tool_sev: '',
         mc_parameter_threshold: '',
         mc_smc_effects: [],
         mc_smc_priority: '0',
         itsm_company: '',
         date_reception: '1479129325',
         mc_smc_alias: 'bmcswetsom96_2',
         pn_detail_diag_count: '0',
         mc_effects: [],
         mc_object_uri: '',
         mc_date_modification: '1479129325',
         mc_incident_time: '0',
         status: 'OPEN',
         msg: 'Free Memory Low',
         pn_detail_diag: '0',
         mc_host: 'bmcswetsom97',
         repeat_count: '69',
         mc_host_address: '',
         mc_tool_suggestion: '',
         mc_using_organization_id: '',
         mc_collectors: [ '1.1', '3.1.1', '4.1', '5.1' ],
         mc_account: '',
         mc_long_msg: '',
         mc_owner: '',
         mc_history: [ 'pncell_bmcswetsom96:3172' ],
         itsm_category: '',
         mc_host_class: '',
         mc_tool_rule: '',
         mc_local_reception_time: '1479129325',
         mc_associations: [],
         mc_relation_source: '',
         mc_propagations: [],
         mc_client_address: '172.16.173.131',
         itsm_incident_status: '',
         mc_tool_time: '0',
         mc_origin_class: '',
         mc_tool: '',
         mc_action_count: '0',
         mc_cause: '0',
         mc_origin_sev: '',
         mc_host_id: '0',
         mc_event_relations: [],
         mc_operations: [],
         mc_event_category: 'CONFIGURATION_MANAGEMENT',
         pn_device_name: '',
         mc_arrival_time: '1479129325',
         severity: 'OK',
         mc_notification_history: [],
         mc_smc_causes: [],
         mc_acl: [],
         mc_original_severity: 'CRITICAL',
         duration: '0',
         mc_location: 'Unknown',
         mc_smc_id: '',
         mc_parameter_value: '20',
         administrator: '',
         mc_event_subcategory: 'OTHER',
         mc_parameter_unit: '' },
      subscriptionId: 'af18f6ba-a2d3-4574-81c8-7f366ca70ebd',
      type: 'EVENT' }