{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":30418,"path":"it-operations-management/event-management/event-collection-BMCTrueSight.md","title":"Event collection from BMC TrueSight and BMC TrueSight\\_v2","bundle":null,"doc_type":null,"release":"australia","body":"\n# Event collection from BMC TrueSight and BMC TrueSight\\_v2\n\nThe 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\\). The collector uses event stream notification capabilities.\n\n## Before you begin\n\nEnsure that the Event Management Connectors \\(sn\\_em\\_connector\\) plugin is installed on the ServiceNow AI Platform instance.\n\nEnsure that you:\n\n- Deploy and start the MID Server. See [MID Server configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/c_MIDServerConfiguration.md) .\n- Configure and start the MID Web Server. See [Configure the MID Web Server extension](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-mid-web-server-extension.md).\n- Configure and start the MID WebService Event Collector. See [Configure the MID WebService Event Collector Context](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-em-context-extension.md).\n\nRole required: evt\\_mgmt\\_admin\n\n## About this task\n\nJSON 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 Management** > **Integrations** > **Listener Transform Scripts**. In the Listener Transform Scripts page, click **TransformEvents\\_bmcTrueSight**.\n\nThe default format of the URL to push event messages from BMC TrueSight to the MID Server is `http://:/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight`.\n\nThe default format of the URL to push event messages from BMC TrueSight\\_v2 to the MID Server is `http://:/api/mid/em/inbound_event?Transform=TransformEvents_bmcTrueSight_v2`.\n\n\n
\n\nVariable\n\n\n\nDescription\n\n
\n\nMID\\_Server\\_IP\n\n\n\nIP address of the MID Web Server Extension.\n\n
\n\nMID\\_Web\\_Server\\_Port\n\n\n\nListening port of the MID Web Server Extension.\n\n
\n\nMID\\_Web\\_Server\\_User\n\n\n\nUsername for the MID Web Server Extension.\n\n
\n\nMID\\_Web\\_Server\\_Password\n\n\n\nPassword 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 `admin`, in this case use `YWRtaW4=` 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/](https://www.base64encode.org/)\n\n
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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-mid-web-server-extension.md).\n\n## Procedure\n\n1. In BMC TrueSight, set the MID WebService Event Collector as the target for BMC TrueSight notification, using these parameters:\n\n |Variable|Description|\n |--------|-----------|\n |serverHost|Name of the BMC TrueSight server.|\n |port|Number of the BMC TrueSight port.|\n\n2. In the message body and generic BMC URL, replace the parameters with the values in the preceding table and connect to BMC TrueSight.\n\n 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://:/bppmws/api/stream/subscribe?dataType=event`. For example: `http://TrueSight1server:40/bppmws/api/stream/subscribe?dataType=event`.\n\n\n## Result\n\n|Event field|Event message|\n|-----------|-------------|\n|node|mc\\_host|\n|type|mc\\_object\\_class|\n|metric\\_name|mc\\_parameter|\n|resource|mc\\_object|\n|severity|severity|\n|time\\_of\\_event|date\\_reception|\n|description|msg|\n\n## Example\n\nExample, showing the message body.\n\n```\n\n{\n\"action\": \"create\",\n\"data\": {\n\"mc_abstracted\": [],\n\"itsm_operational_category3\": \"\",\n\"mc_object_class\": \"CPU\",\n\"source\": \"MySource\",\n\"adapter_host\": \"\",\n\"itsm_operational_category2\": \"\",\n\"itsm_location\": \"\",\n\"itsm_operational_category1\": \"\",\n\"mc_abstraction\": [],\n\"mc_tool_id\": \"\",\n\"mc_original_priority\": \"PRIORITY_1\",\n\"event_handle\": \"3172\",\n\"mc_modhist\": [],\n\"mc_tool_class\": \"\",\n\"mc_origin\": \"\",\n\"mc_tool_uri\": \"\",\n\"mc_service\": \"\",\n\"mc_smc_type\": \"\",\n\"mc_object_owner\": \"\",\n\"mc_object\": \"CPU_0\",\n\"mc_notes\": [],\n\"itsm_model_version\": \"\",\n\"mc_origin_key\": \"\",\n\"mc_tool_address\": \"\",\n\"mc_ueid\": \"mc.pncell_bmcswetsom96.1829b8ed.0\",\n\"mc_bad_slot_names\": [],\n\"date\": \"20161114081525.000000-300\",\n\"itsm_item\": \"\",\n\"mc_timeout\": \"0\",\n\"mc_priority\": \"PRIORITY_1\",\n\"itsm_type\": \"\",\n\"itsm_manufacturer\": \"\",\n\"mc_tool_key\": \"\",\n\"itsm_product_name\": \"\",\n\"mc_smc_impact\": \"NOT_ELECTED\",\n\"mc_parameter\": \"MEMFreeMem\",\n\"mc_bad_slot_values\": [],\n\"itsm_incident_id\": \"\",\n\"mc_incident_report_time\": \"0\",\n\"mc_event_model_version\": \"1.1.00\",\n\"mc_relationships\": \"0/0\",\n\"CLASS\": \"EVENT\",\n\"mc_using_organization\": \"\",\n\"mc_tool_sev\": \"\",\n\"mc_parameter_threshold\": \"\",\n\"mc_smc_effects\": [],\n\"mc_smc_priority\": \"0\",\n\"itsm_company\": \"\",\n\"date_reception\": \"1479129325\",\n\"mc_smc_alias\": \"bmcswetsom96_2\",\n\"pn_detail_diag_count\": \"0\",\n\"mc_effects\": [],\n\"mc_object_uri\": \"\",\n\"mc_date_modification\": \"1479129325\",\n\"mc_incident_time\": \"0\",\n\"status\": \"OPEN\",\n\"msg\": \"Free Memory Low\",\n\"pn_detail_diag\": \"0\",\n\"mc_host\": \"bmcswetsom97\",\n\"repeat_count\": \"69\",\n\"mc_host_address\": \"\",\n\"mc_tool_suggestion\": \"\",\n\"mc_using_organization_id\": \"\",\n\"mc_collectors\": [\"1.1\", \"3.1.1\", \"4.1\", \"5.1\"],\n\"mc_account\": \"\",\n\"mc_long_msg\": \"\",\n\"mc_owner\": \"\",\n\"mc_history\": [\"pncell_bmcswetsom96:3172\"],\n\"itsm_category\": \"\",\n\"mc_host_class\": \"\",\n\"mc_tool_rule\": \"\",\n\"mc_local_reception_time\": \"1479129325\",\n\"mc_associations\": [],\n\"mc_relation_source\": \"\",\n\"mc_propagations\": [],\n\"mc_client_address\": \"172.16.173.131\",\n\"itsm_incident_status\": \"\",\n\"mc_tool_time\": \"0\",\n\"mc_origin_class\": \"\",\n\"mc_tool\": \"\",\n\"mc_action_count\": \"0\",\n\"mc_cause\": \"0\",\n\"mc_origin_sev\": \"\",\n\"mc_host_id\": \"0\",\n\"mc_event_relations\": [],\n\"mc_operations\": [],\n\"mc_event_category\": \"CONFIGURATION_MANAGEMENT\",\n\"pn_device_name\": \"\",\n\"mc_arrival_time\": \"1479129325\",\n\"severity\": \"OK\",\n\"mc_notification_history\": [],\n\"mc_smc_causes\": [],\n\"mc_acl\": [],\n\"mc_original_severity\": \"CRITICAL\",\n\"duration\": \"0\",\n\"mc_location\": \"Unknown\",\n\"mc_smc_id\": \"\",\n\"mc_parameter_value\": \"20\",\n\"administrator\": \"\",\n\"mc_event_subcategory\": \"OTHER\",\n\"mc_parameter_unit\": \"\"\n},\n\"subscriptionId\": \"af18f6ba-a2d3-4574-81c8-7f366ca70ebd\",\n\"type\": \"EVENT\"\n}\n```\n\n**Parent Topic:**[Integrate with push connectors](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-listener-transform-script.md)\n\n"}}