Examples of using the REST API to manage events
You can use the REST API to manage events for the following integrations with TrueSight Infrastructure Management:
- Remedy Change Management
- TrueSight Capacity Optimization
Integration of Remedy Change Management with TrueSight Infrastructure Management
Remedy Change Management communicates change requests (both change and task requests) to TrueSight Infrastructure Management through the REST API. Using the REST API, you can create or modify events. TrueSight Infrastructure Management receives these events as notification of change requests.
Example URL to create an event for Remedy Change Management integration
An example URL to create an event for Remedy Change Management integration is as follows:
Example input parameters in the JSON format to create an event for Remedy Change Management integration
Input parameters in the JSON format to create an event lists the input parameters that you can provide to create an event. The list of attributes varies as per the application type you select. The following table lists the attributes that are specific to integration of Remedy Change Management with TrueSight Infrastructure Management.
List of attributes for the REST API to create an event for Remedy Change Management integration with TrueSight Infrastructure Management
Attributes | Description |
---|---|
Change event | |
changeCategory | Type of change request. The supported categories are as follows:
|
CIAssociationDateEpoch | Date and time at which the CI is associated with the change request. The value must be in the epoch format. |
changeID | Unique identifier for the change request |
changeLocationServer | Location of the server on which Remedy Change Management application is installed |
changeModifiedDateEpoch | Date and time at which the change request was last modified. The value must be in the epoch format. |
changeOwner | Owner of the change request |
changeCoordinator | Coordinator of the change request |
changeCustomerName | Name of the customer for the change request |
changeSummary | A brief summary about the change request |
scheduledStartDateEpoch | Date and time for the scheduled change request to start. The value must be in the epoch format. |
scheduledEndDateEpoch | Date and time for the scheduled change request to end. The value must be in the epoch format. |
actualStartDateEpoch | Actual date and time at which the change request started. The value must be in the epoch format. |
actualEndDateEpoch | Actual date and time at which the change request ended. The value must be in the epoch format. |
completionDateEpoch | Date and time at which the change request is completed. The value must be in the epoch format. |
changeNotes | Notes added to the change request |
changeReason | Reasons for the change request |
changeStatus | Status of the change request. The supported statuses are as follows:
|
CIReconcilationID | Unique identifier for CI reconciliation |
CIName | Alias name of the CI |
CIClass | Class to which the CI belongs |
changeStatusReason | Reason for the change request's status |
CIDataSetID | Unique identifier for the CI data set |
CIAssociationType | Association type to which the CI belongs |
changeImpact | Impact of the change request. The supported impact types are as follows:
|
changeUrgency | Urgency of the change request. The supported urgency types are as follows:
|
changePriority | Priority of the change request. The supported priorities are as follows:
|
changeRiskLevel | Risk level of the change request. The supported risk levels are as follows:
|
Task event | |
parentChangeID | Unique identifier of the change request to which the task is associated |
taskName | Name of the task |
taskSummary | A brief summary of the task |
taskNotes | Notes associated with the task |
taskPriority | Priority of the task. The supported priorities are as follows:
|
taskID | Unique identifier for the task |
taskType | Type of task. The supported types are as follows:
|
taskStatus | Status of the task. The supported statuses are as follows:
|
taskStatusReason | Reason for the status of the task |
taskAssigneeCompany | Company to which the task is assigned |
taskAssigneeGroup | Group to which the task is assigned |
taskAssignee | Individual to which the task is assigned |
actualStartDateEpoch | Actual date and time when the task started. The value must be in the epoch format. |
actualEndDateEpoch | Actual date and time when the task ended. The value must be in the epoch format. |
taskModifiedDateEpoch | Date and time when the task was last modified. The value must be in the epoch format. |
CIAssociationDateEpoch | Date and time when the task was associated with CI. The value must be in the epoch format. |
CIReconcilationID | Unique identifier for the CI reconciliation |
CIName | Name of the CI |
CIClass | Class to which the CI belongs |
CIDataSetID | Unique identifier for the CI data set |
CIAssociationType | Association type to which the CI belongs |
Sample input parameters in the JSON format to create a change event for integration of Remedy Change Management with TrueSight Infrastructure Management
{
"applicationType": "CHANGE_MANAGEMENT",
"eventSourceHostName": "itsmServer.calbro.com",
"eventSourceIPAddress": "123.456.78.999",
"eventId": "testevent.unique.id",
"transactionId": "sample.trasantion.id",
"correlationId": "",
"routingInfo": "",
"eventType": "CM_CHANGE_EVENT",
"eventDate": 1314276082,
"attributes": {
"changeImpact": "4-Minor/Localized",
"changeModifiedDateEpoch": "1314276082",
"changePriority": "Low",
"actualStartDateEpoch": "",
"changeRiskLevel": "Risk Level 5",
"actualEndDateEpoch": "",
"changeStatus": "Scheduled",
"CIDataSetID": "IMPACT.ASSET",
"changeStatusReason": "Change Schedule",
"scheduledEndDateEpoch": "1314283282",
"changeLocationServer": "ITSMServer.calbro.com",
"CIClass": "BMC_ComputerSystem",
"changeCategory": "NORMAL",
"changeUrgency": "4-Low",
"CIAssociationType": "Impact",
"changeNotes": "Sample Event Creation Note",
"completionDateEpoch": "",
"changeOwner": "ChangeUser",
"changeID": "sample.change.unique.id",
"changeCoordinator": "ChangeCo-Ordinator",
"CIReconcilationID": "SAMPLE.RECON.ID",
"changeReason": "Maintenance",
"changeCompany": "MyCompany",
"scheduledStartDateEpoch": "1314279682",
"CIName": "sampleCI-name",
"CIAssociationDateEpoch": "1314279682",
"changeCustomerName": "Sample App Team",
"CICellName": "pncell_cellName",
"changeSummary": "Sample Change Event Creation"
}
}
Response for creating an event for Remedy Change Management integration
A change event is created for Remedy Change Management integration with TrueSight Infrastructure Management.
Integration of TrueSight Capacity Optimization with TrueSight Infrastructure Management
TrueSight Capacity Optimization communicates events to TrueSight Infrastructure Management through the REST API. Using the REST API, you can create or modify events.
For more information about the integration of TrueSight Capacity Optimization with TrueSight Infrastructure Management, see
Integrating events from TrueSight Capacity Optimization
Example URL to create an event for TrueSight Capacity Optimization integration
An example URL to create an event for TrueSight Capacity Optimization integration is as follows:
Example input parameters in the JSON format to create an event for TrueSight Capacity Optimization integration
Input parameters in the JSON format to create an event lists the input parameters that you can provide to create an event. The list of attributes varies depending on the application type you select. The following table lists the attributes that are specific to integration of TrueSight Capacity Optimization with TrueSight Infrastructure Management.
List of attributes for the REST API to create an event for TrueSight Capacity Optimization integration with TrueSight Infrastructure Management
Attributes | Description |
---|---|
CLASS | Class of the event. The supported class is BCO_EV. |
utilization_measurment_unit | Unit to measure the utilization |
mc_object_uri | Address used to cross-launch |
is_predictive | Indicates whether the event has a predictive severity |
entity | Type of BCO monitored object for which TrueSight Infrastructure Management receives an event |
event_type | Type of the event |
severity | Severity of the event |
host_name | Fully qualified name of the host on which the event is created |
msg | Textual description of the event |
days_to_reach_threshold | Number of days required to reach the threshold |
cluster_name | Name of the cluster |
metric_utilization | Utilization of the metric such as CPU, FILESYSTEM, and so on |
file_system_name | Name of the file system entity type |
threshold_measurment_unit | Unit to measure the threshold value |
metric | Name of the metric. For example, FILESYSTEM |
mc_smc_alias | Alias of the event description |
threshold_value | Value of the threshold |
partition_name | Name of the file system partition |
unique_identifier | Universal event identifier |
Sample input parameters in the JSON format to create an event for integration of TrueSight Capacity Optimization with TrueSight Infrastructure Management
{
"applicationType": "CAPACITY_MANAGEMENT",
"eventSourceHostName": "source.server.com",
"eventSourceIPAddress": "192.168.123.46",
"attributes": {
"CLASS": "BCO_EV",
"utilization_measurment_unit": "PCT",
"mc_object_uri": "http://sample.server.com",
"is_predictive": "true",
"entity": "LPAR",
"event_type": "LPAR_FS_EXCEEDS_THRESHOLD",
"severity": "WARNING",
"host_name": "",
"msg": "Sample BMC Capacity Event",
"days_to_reach_threshold": "10",
"cluster_name": "",
"metric_utilization": "50",
"file_system_name": "/TMP",
"datastore_name": "",
"threshold_measurment_unit": "PCT",
"metric": "FILESYSTEM",
"mc_smc_alias": "relatedDeviceAlias",
"VM_name": "",
"threshold_value": "100",
"partition_name": "pbpa9lp3",
"unique_identifier": "bco_unique_identifier"
}
}
Response for creating an event for TrueSight Capacity Optimization integration
An event is created for TrueSight Capacity Optimization integration with TrueSight Infrastructure Management.
Comments
What happened to the event API docs we had in previous versions e.g., https://docs.bmc.com/docs/display/tsim107/Managing+events+with+web+services
They were much clearer, there's a lot missing in this section now.
Any updates?
Log in or register to comment.