AppDynamics Alerting Extension for use with IBM Tivoli Business Service Manager


Use Case

IBM Tivoli Business Service Manager monitors business services and tracks them against business objectives and technology infrastructures.
It shows the operational status of services using prebuilt reports, scorecards and dashboards for fast data analysis.
Tivoli Business Service Manager helps you assess service levels throughout an organization for more effective service management.


- You should have the postemsg executable and the posteifmsg.cfg config file on the controller machine.
- Based on the Operating System, create a cache file.
On UNIX, $TIVOLIHOME/tec/cache where $TIVOLIHOME = /etc/Tivoli
On Windows, $TIVOLIHOME\tec\cache.dat where $TIVOLIHOME= %SystemRoot%\system32\ drivers\etc\Tivoli

Installation Steps

1. Download the IBM TBSM Alerting Extension zip.

2. Unzip the file into <CONTROLLER_HOME_DIR>/custom/actions/ . You should have <CONTROLLER_HOME_DIR>/custom/actions/ibm-tbsm-alert created.

3. Check if you have custom.xml file in <CONTROLLER_HOME_DIR>/custom/actions/ directory. If yes, add the following xml to the <custom-actions> element.

   <!-- For Linux/Unix *.sh -->
   <!-- For windows *.bat -->

 If you don't have custom.xml already, create one with the below xml content

       <!-- For Linux/Unix *.sh -->
       <!-- For windows *.bat -->

 Uncomment the appropriate executable tag based on windows or linux/unix machine.

4. Update the config.yaml file with path to the "postemsg" executable.

Note:Please make sure to not use tab (\t) while editing yaml files. You may want to validate the yaml file using a yaml validator

 #complete path to the binary or exe which includes the binary or exe. Use proper separators for Windows and Unix. For windows, escape the "\" char with another "\"
# For eg. "C:\\IBM\\bin\\postemsg"
pathToExecutable: ""
#IBM TBSM server name or IP address.Either specify server or pathToConfig. Not both
server: ""
#Path to config. Either specify server or pathToConfig.Not both.Use proper separators for Windows and Unix. For windows, escape the "\" char with another "\"
#For eg. "C:\\IBM\\bin\\posteifmsg.cfg"
pathToConfig : ""
#host name of the machine where the extension is installed. You can run "hostname" on the command line and get the hostname of the machine
hostname: ""
#Alert group for IBM Tivoli
alertGroup: "AppDynamics"
#Instance field for IBM Tivoli
instance: "Controller"
# timeout in seconds to execute command
timeout: 10


Below is a sample command that gets generated based on the above config and AppDynamics parameters.

hostname=<hostname> instance=<instance> fault="<SUMMARY>" <alertGroup> <incidentId>

 5. Now you are ready to use this extension as a custom action. In the AppDynamics UI, go to Alert & Respond -> Actions. Click Create Action. Select Custom Action and click OK. In the drop-down menu you can find the action called 'ibm-tbsm-alert'.


Always feel free to fork and contribute any changes directly via Github.


For any questions or feature request, please contact AppDynamics Support.






Last Update:

18th March, 2018


1.0.0 - Release version.

1.0.1 - Refactored code.

1.0.2 - Supprt for controller version 4.x

2.0.3 - Added root logger to log4j.xml

2.0.4 - Changed the path to java, affected entity passed to postemsg command

2.0.5 - Updated Licenses