Written by Mike Wojton, Kyle Roe, and Deirdre Lawton.

Welcome. This cookbook is a working guide to help you with starting your IBM Cloud Application Performance Management trial. Watch this video watch 2:49 mins if you are unfamiliar with the concepts and tasks that you will perform in your trial. Understanding the concepts around Cloud APM will make it easier to do your trial.

This Cookbook Introduction video watch 4:07 mins explains in more detail how the cookbook is organized and how to start your trial. This cookbook guides you in configuring your environment to send data (for one or more of your systems) to your Cloud APM trial instance. In the UI, you can then define what you want from this data in an application and start monitoring. Following these steps, it takes about an hour to get your first application up and monitoring.


book icon

The cookbook is divided into the following sections:

If you are ready, select a topic and let’s go!



dial icon

Preheating your trial


  1. Validate trial communications: Test your systems’ connectivity with the Cloud APM trial. Complete this step first!
  2. Validate trial system prerequisites: Confirm that you can run the agents you want on the servers you have.
  3. Confirm free space requirements (1 GB on each server that you want to monitor).

Click here to return to the cookbook index.



book download icon

Mixing the right ingredients


  1. Download your agents (an example of this step is provided in this Download your agent video watch 3:55 mins):
    • Sign in to your Products and services page in IBM Marketplace.
    • Click Manage > Downloads.
    • Select your OS and agent package and Download

    Click here for the Windows OS agent tutorial. You will need to complete steps 1 and 2 that are in the linked document.

  2. Install the Windows OS agent – An example of this step is provided in this Install Windows OS agent video watch 6:47 mins. Complete steps 3 – 6 in the tutorial.

Click here to return to the cookbook index.



read more icon

Baking your first layer


  1. Getting started – Sign in to your Products and services page in Marketplace. Click the Launch button for your Cloud APM trial. Familiarize yourself with the videos, tour, and demos on the Getting started home page.
    getting started page
  2. Defining your application in Cloud APM. An example of this step is provided in this Building your first PM application video watch 5:42 mins.
    Click here for the tutorial to define your first application and complete step 9.
  3. Configuring email notifications – IBM® Alert Notification is already integrated and enabled for your trial. By default, most alerts about agents are enabled and you will receive a lot of emails notifications. Learn how to modify these notifications to either disable them or reduce the notifications you will receive.

Congratulations, you have started monitoring your first application in your Cloud APM trial. If you have any questions, please reply to the email from your Technical Customer Advocate. You can also ask a question in the Cloud APM forum.

Click here to return to the cookbook index.



redo icon

Baking more layers


  • Install other agents as required.
  • Request add-ons for your trial.
    • If you want to enable the IBM® Operations Analytics – Predictive Insights add-on for your trial, send an email to APMInfo@us.ibm.com.
    • If you want to enable website monitoring, send an email with the URL of your trial subscription to APMInfo@us.ibm.com. To monitor an external website, request access to one of the following locations: Washington, Dallas, San Jose, Amsterdam, Hong Kong, Melbourne, Singapore, Toronto, Paris, Tokyo, Mexico, Frankfurt, Sao Paulo, London, or Chennai. For internal website monitoring, download the synthetic playback agent. Then, install and configure the agent to set up your own location.

Click here to return to the cookbook index.



communications icon

Validating trial communications


An example of this step is provided in this Validate trial communications video watch 4:49 mins.

Usually, machines (servers) that you want to monitor are behind different firewall/security protocols than a user’s machine. There might be different firewall/security protocols for different machines. You must complete this step before doing anything else. If your machine can not communicate to your trial, there is no way for your trial to capture and work with your data. Complete the following steps for each machine that you want to communicate with your trial instance:

  1. To validate communications, run the openssl command with your unique network address. This command is usually included on Linux and Unix systems. For windows systems, download the openssl package from here. To find your unique network address, complete the following steps:
    • Log in to your trial. Click ‘Launch’ in your Cloud APM trial.
    • The Getting Started page is displayed. Your unique network address is in the location bar of your browser. You must replace ‘customers’ with ‘agents’, for example: c904530bcad64777bd440f7998301234.agents.na.apm.ibm.com

    getting started page URL

    Note: Your two letter code after ‘agents’ might not be ‘na’.

  2. Enter the following command:openssl s_client -state -connect :443 -tls1_2 -cipher ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384A connection to your trial server is established and the command returns a connected message:
    WARNING: can’t open config file: /usr/local/ssl/openssl.cnf
    Loading ‘screen’ into random state – done
    CONNECTED(000001C8)
    SSL_connect:before/connect initialization
    SSL_connect:SSLv3 write client hello A
    SSL_connect:SSLv3 read server hello A
    depth=2 C = US, O = IBM, CN = ca_ec_384.ibm.com
    verify error:num=19:self signed certificate in certificate chain
    SSL_connect:SSLv3 read server certificate A
    SSL_connect:SSLv3 read server key exchange A
    SSL_connect:SSLv3 read server certificate request A
    SSL_connect:SSLv3 read server done A
    SSL_connect:SSLv3 write client certificate A
    SSL_connect:SSLv3 write client key exchange A
    SSL_connect:SSLv3 write change cipher spec A
    SSL_connect:SSLv3 write finished A
    SSL_connect:SSLv3 flush data
    SSL_connect:SSLv3 read finished A
  3. If you do not get a connected message, use the additional information to help your network administrator resolve the issue. The following two Knowledge Center topics might be useful to your network administrator, to help them resolve communication issues:

Click here to return to Preheating your trial.



system prerequisites icon

Validate trial system prerequisites


An example of this step is provided in this Validate system prerequisites video watch 2:55 mins.

It is important to validate that the servers/images that you want to monitor are supported by the trial. To confirm that the agent you want to install is supported on the platform you intend to monitor, view the system requirements in Software Product Compatibility Reports (SPCR).

This SPCR link provides a report for all agents. You can select either AIX, Linux, or Windows systems. Under the Detail column you can view a report showing what is supported by that specific version/platform.

For more information about specific agent prerequisites by platform, see the following Knowledge Center topics:

Click here to return to Preheating your trial.

 



mail icon

Starting Alert Notification to configure email notifications


An example of this step is provided in this Configure email notifications video watch 3:44 mins.

Your trial is automatically integrated with Alert Notification. To start Alert Notification and modify your alert notifications, complete the following steps:

  1. Sign in to your Products and services page in MarketPlace. Click the Launch button for your Cloud APM trial.
  2. Place your cursor over the System Configuration icon on the left side and then select Resource Group Manager.
  3. System Configuration options

  4. In the Resource group, select the agent (OS agent if you are following the cookbook), then select the edit icon (pencil).
  5. Scroll down to the end and click ‘Configure email notification’. A new IBM Agile Operations Management – Alert Notification window opens.
  6. Select the Manage Notification Policies tab.
  7. Notification Policy window

  8. A list of policies for your trial is displayed. The default ‘Sample notification policy’ is included in your trial. Select the pencil icon to edit this policy.
  9. To add a rule or recipient, select Change Notification Policy.
  10. Change Notification Policy window

  11. Select the edit icon under ‘Add Rule’. Select which alerts you want to be notified about. Deselect the ‘Match for any…’ option. Select what level you want. For now, only selecting the fatal level is a good place to start.
  12. To turn off notifications, click the delete icon next to your name under ‘Add Recipient’. You can always add yourself as a recipient later. Click ‘Save’.
  13. For more information about IBM® Alert Notification, see the following Knowledge Center topics:

    Click here to return to Baking more layers.



    play video icon

    Cookbook video playlist


    We welcome your feedback.

    3 comments on"Trial cookbook"

    1. Hi team,
      Is there any direct wget URL link to download the product (APMADV_Agent_Install.tar) for Linux OS.

      • There is no direct URL download link. You must log in to Marketplace with your IBMid credentials and download the product files from your trial or paid subscription.

    2. Sridhar Venkatesh January 24, 2018

      For completeness, in step 2 of “Validating trial communications”, the openssl command is missing the unique network address discovered from step 1. The command should be:

      openssl s_client -state -connect ${unique_network_address_from_step1}:443 -tls1_2 -cipher ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384A

    Join The Discussion

    Your email address will not be published. Required fields are marked *