---
sourceDocument: Zurich IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/it-operations-management

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Event collection from BMC TrueSight and BMC TrueSight_v2

# Event collection from BMC TrueSight and BMC TrueSight_v2 {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

The MID WebService Event Collector enables you to collect JSON formatted event
messages sent from BMC TrueSight Operations Management (TrueSight), previously known as BMC
ProactiveNet Performance Management (BPPM), utilizing event stream notification
capabilities.

## Before you begin

Ensure that the Event Management Connectors (sn_em_connector) plugin is
installed on the ServiceNow AI Platform instance.  
Ensure that you:

* Deploy and start the MID Server. See [MID Server
  configuration](https://www.servicenow.com/docs/access?context=c_MIDServerConfiguration&version=zurich&pubname=zurich-servicenow-platform&ft:locale=en-US) .
* Configure and start the MID Web Server. See [Configure the MID Web Server extension](https://www.servicenow.com/docs/RPQvfJbpCp6qgI_dATuFRg "The MID Web Server is a MID Server extension that enables developing REST APIs to send events and metrics to the MID Server. The extension is leveraged by other MID Server extensions, such as Metric Intelligence, MID WebService Event Listener, and the Agent Client Collector websocket endpoint extension.").
* Configure and start the MID WebService Event Collector. See [Configure the MID WebService Event Collector Context](https://www.servicenow.com/docs/xz_3EnP5twMrVy9mNuOSIQ "Configure the MID WebService Event Collector Context to provide a URL method to push event messages from an external source to the MID Server.").
{#event-collection-BMCTrueSight__ul_d21_gkf_cy}Role required: evt_mgmt_admin

## About this task

JSON formatted event messages are sent from BMC TrueSight. The MID Server transforms the collected event messages by parsing them
using the TransformEvents_bmcTrueSight script include, located here: Event ManagementIntegrationsListener Transform Scripts. In the Listener Transform Scripts page, click
TransformEvents_bmcTrueSight.

The default format of the URL to push event messages from BMC TrueSight to the MID Server is `http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight`.

The default format of the URL to push event messages from BMC TrueSight_v2 to the MID Server is `http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight_v2`.  
{#event-collection-BMCTrueSight__table_bbq_cmk_k2b__entry__2}

| Variable | Description |
|-|-|
| MID_Server_IP | IP address of the MID Web Server Extension. |
| MID_Web_Server_Port | Listening port of the MID Web Server Extension. |
| MID_Web_Server_User | Username for the MID Web Server Extension. |
| MID_Web_Server_Password | Password of the user of the MID Web Server Extension. However, encode the password in BASE64. For example, if the MID Web Server Extension password is <kbd class="ph userinput">admin</kbd>, in this case use <kbd class="ph userinput">YWRtaW4=</kbd> as the password for MID_Web_Server_Password. To determine the BASE64 value, you can use the utility at this website: <https://www.base64encode.org/> |
[Table 1. Variables in the default URL]

{#event-collection-BMCTrueSight__table_bbq_cmk_k2b}

The following procedure describes the collection of JSON formatted event messages
using basic authentication. For more information about supported authentication
methods, see [Configure the MID Web Server extension](https://www.servicenow.com/docs/RPQvfJbpCp6qgI_dATuFRg "The MID Web Server is a MID Server extension that enables developing REST APIs to send events and metrics to the MID Server. The extension is leveraged by other MID Server extensions, such as Metric Intelligence, MID WebService Event Listener, and the Agent Client Collector websocket endpoint extension.").

## Procedure

1. In BMC TrueSight, set the MID WebService Event Collector as the target for BMC TrueSight notification, using these parameters:  
   {#event-collection-BMCTrueSight__table_x14_2fc_ycb__entry__2}

   | Variable | Description |
   |-|-|
   | serverHost | Name of the BMC TrueSight server. |
   | port | Number of the BMC TrueSight port. |
   [Table 2. Variables in the generic BMC URL]

   {#event-collection-BMCTrueSight__table_x14_2fc_ycb}
2. In the message body and generic BMC URL, replace the parameters with the values in the preceding table and connect to BMC TrueSight.  
   Use the BMC Publish-Subscribe REST approach to create a stream event subscription and send event messages in JSON format. The generic format of the BMC URL to create a stream event subscription is: `http|https://<serverHost>:<port>/bppmws/api/stream/subscribe?dataType=event`. For example: `http://TrueSight1server:40/bppmws/api/stream/subscribe?dataType=event`.
{#event-collection-BMCTrueSight__steps_nd5_flc_bx}

## Result

{#event-collection-BMCTrueSight__table_wrp_fg2_2y__entry__2}

| Event field | Event message |
|-|-|
| node | mc_host |
| type | mc_object_class |
| metric_name | mc_parameter |
| resource | mc_object |
| severity | severity |
| time_of_event | date_reception |
| description | msg |
[Table 3. Example of mapping event messages to event fields in the Event (em_event) table]

{#event-collection-BMCTrueSight__table_wrp_fg2_2y}

## Example

Example, showing the message body.


    {
    "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"
    }

*[\>]: and then