Share:|

For those users who work with the API, we have a new Knowledge Article regarding the valid conditions when creating a REST stream event subscription. These are updated in the documentation and we are sharing the details here with you via The Pulse! I know we have done a quick look at the REST API in the past, but as we had new information to share, we wanted to broaden the audience to the Community!

 

 

What are the valid conditions when creating a REST stream event subscription?
https://docs.bmc.com/docs/display/public/proactivenet96/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/public/tsim10/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/public/tsim105/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/tsim107/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/TSInfrastructure/110/using-the-publish-subscribe-rest-approach-to-receive-events-719680260.html

 


Slot Value DataType : STRING

Slot Value DataType : INTEGER

Slot Value DataType : LIST OF STRINGS

Data Type : STRING
SLOT LIST :

mc_ueid
mc_client_address
mc_location
mc_service
mc_host_class
mc_host
mc_host_address
mc_account
mc_object_class
mc_object
mc_object_uri
mc_object_owner
mc_tool_class
mc_tool
mc_tool_id
mc_tool_rule
mc_tool_key
mc_tool_sev
mc_tool_address
mc_tool_uri
mc_tool_suggestion
mc_origin_class
mc_origin
mc_origin_key
mc_origin_sev
mc_parameter
mc_parameter_value
mc_parameter_unit
mc_parameter_threshold
mc_event_model_version
mc_owner
mc_long_msg
msg
administrator
mc_relationships
mc_relation_source
mc_smc_id
mc_smc_alias
mc_smc_type
itsm_category
itsm_type
itsm_item
itsm_product_name
itsm_model_version
itsm_manufacturer
itsm_operational_category1
itsm_operational_category2
itsm_operational_category3
itsm_company
itsm_location
itsm_incident_id
itsm_incident_status
pn_device_name
mc_using_organization
mc_using_organization_id



Supported Filter Conditions :

CONTAINS
CONTAINS_IGNORECASE
WITHIN
CONTAINS_ALL
CONTAINED_IN
CONTAINS_ONE_OF
STARTS_WITH
ENDS_WITH
HASSUBSTRING
SUPERCLASS_OF
SUBCLASS_OF
NOT_EQUALS
STARTS_WITH_IGNORE_CASE
ENDS_WITH_IGNORE_CASE
NOT_EQUALS_IGNORE_CASE
MATCHES
AND
OR
NOT
EQUALS
EQUALS_IGNORE_CASE

Data Type : INTEGER
SLOT LIST :

mc_incident_time
mc_incident_report_time
mc_arrival_time
mc_local_reception_time
date_reception
duration
mc_timeout
repeat_count
mc_action_count
mc_date_modification
mc_cause
pn_detail_diag
pn_detail_diag_count



Supported Filter Conditions :

WITHIN
OUTSIDE
GREATER_THAN
GREATER_OR_EQUALS
SMALLER_THAN
SMALLER_OR_EQUALS
EQUALS
NOT_EQUALS
AGELIMIT
IN_RANGE
AND
OR
NOT

Data Type : LIST OF STRINGS
SLOT LIST :

mc_smc_impact
mc_priority
mc_original_priority
status
severity
mc_original_severity
mc_event_category
mc_event_subcategory



Supported Filter Conditions :

LIST_CONTAINS
AND
OR
NOT

Slots of type ENUMERATION are treated as a list of strings
The enumerations contain individual values as strings. So, to filter values LIST_CONTAINS can be used and for identifying individual values, any desired sting filter condition can be used.


SINGLE : essentially and INTEGER value. Never used external to the logic of cell itself.


REAL : Floating point or Decimal value. All the filters which apply on Integer values also apply on REAL values.

Enum : Enumerations of primarily string values

LIST_OF INTEGER : If a SINGLE/Integer value is not sufficient then a list of values can be used. The filter LIST_CONTAINS applies here as well owing to the data type being a list. The filtering on individual values on a list of integers will follow the filter conditions mentioned for numeric values.

LIST_OF REAL : If a REAL/Floating Point value is not sufficient then a list of values can be used. The filter LIST_CONTAINS applies here as well owing to the data type being a list. The filtering on individual values on a list of integers will follow the filter conditions mentioned for numeric values.

LIST_OF Enum : A LIST_CONTAINS condition can be used to find out individual enumerations in the list. Once an enumeration is fetched, LIST_CONTAINS can be again used to find out if enumeration contains a given STRING value. On individual values of an enumeration filter conditions of STRING data type can be applied.

 

Want to learn even more about REST API - check these links out

 

 

TSIM/BPPM - Examples of Event Enrichment using REST API and VMWare PowerCLI

This is a BMC Communities provided and supported example of configuring get_external which is a function (rule) which can run an external program and wait for its termination to continue to process the current event, using data retrieved through an interface object. The purpose of this posting is to show examples of how to use the get_external function within a cell (e.g. pncell, service or any remote event cell) to enrich events by running external an ETL (Extract, Transform and Load) using Pentaho's Communities Edition (PDI - OpenSource ETL).

https://communities.bmc.com/docs/DOC-39107

TrueSight Operations Management REST API for Event Management
BMC TrueSight 10 features a rich set of APIs that allow to interact with all the main aspects of the solution: Data, Events, Cis, Configuration.
https://communities.bmc.com/community/bmcdn/service_assurance/application_performance_and_analytics/blog/2015/10/15/truesight-operations-management-rest-api-event-management

 

TrueSight Operations Management REST API for Central Monitoring Administration
https://communities.bmc.com/community/bmcdn/service_assurance/blog/2016/03/31/truesight-operations-management-rest-api-for-central-monitoring-administration

 

TSIM/BPPM Create Technical Cockpit Reports in MS Excel using REST API - Example using JBoss Metrics
This is a BMC Communities provided and supported example of configuring an ETL which will query BPPM or TSIM via REST API and  collect aggregrate monitoring metric values for any number of days up to 1 month (maximum) and dump to a Pivot Table within an MS Excel workbook
https://communities.bmc.com/docs/DOC-39488

SIM/BPPM - Create vBlock Reports in MS Excel using REST API – Example
This is a BMC Communities provided and supported example of configuring an ETL which will query BPPM or TSIM via
REST API  and  collect aggregrate monitoring metric values for any number of days up to 1 month (maximum) and dump to a Pivot Table within an MS Excel workbook
https://communities.bmc.com/docs/DOC-39532

 

Rest API setup – Setting up a REST API environment - Video

 

If you are not familiar with REST API, here is a good link to get you started -https://communities.bmc.com/docs/DOC-44797

 

Any questions about REST API? Please open a ticket with Support and we will be glad to assist!

 

AMIGO.jpg

 

 

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

https://docs.bmc.com/docs/TSOperations/110/amigo-checklist-for-truesight-operations-management-724138985.html?src=search

 

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

Computer.png

NEW Knowledge Articles for TrueSight! Check out these new articles available today!

 

 

000147069      How to use the API to list details for all the policies in TrueSight

 

000147076      ISN consuming high virtual memory, but resident memory value is as expected

 

000147485      "Make Global" is greyed out in the Edit Events Table View

 

000147541      Any action needed for TrueSight or BPPM with Meltdown and Spectre vulnerabilities?

 

000147961      "Unable to retrieve user policies" seen when attempting to login to the BPPM Administrator Console

 

000148035       Is it possible to run the command pw ha enable more than once?

 

000148107       Staging Adapter port cannot be empty


000148215       Cannot add some slots to Table View in TSPS

 

000148286       Is it possible to trigger BPPM/TrueSight remote action with timer?

 

000148311        How to stop TrueSight Self Monitoring alarms

 

 

 

 

 

Feedback.jpg

We want to hear from you.. what to do you want to see in our monthly blog post? What types of topics do you want to learn more about? Any feedback is appreciated.

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs