IBM Cloud Platform Metrics

Technology Preview Code

Note: The IBM Cloud Platform Metrics support in Instana is in technical preview, and we are hard at work to make the IBM Cloud Platform Metrics sensor a first-class citizen.

In the Technical Preview phase, the following IBM Cloud Platform Metrics are integrated with Instana.

  • IBM Load Balancer (classic)
  • IBM Cloud Object Storage
  • IBM Cloud Functions
  • IBM Cloud Databases for etcd
  • IBM Cloudant
  • VPC virtual server instances

Activating IBM Cloud Platform Metrics support

  1. Enable collection of IBM Cloud Platform Metrics
  2. Install Instana agent on a system that has network access to both IBM Cloud and your Instana server
  3. Add the following snippet to your agent's configuration.yaml:

Configuration

Configure agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.ibmcloud:
  enabled: true
  endpoint: "https://xxx.monitoring.cloud.ibm.com/api/"
  apikey: "Bearer yyy"

Where xxx is the IBM Cloud region being monitored and yyy is the api key.

IBM Cloud documentation for access control:

Authentication methods

Granting permissions

Available metrics

IBM Cloud Functions

IBM Load Balancer (classic)

IBM Cloudant

IBM Cloud Object Storage

IBM Cloud Databases for etcd

Health Signatures

For each sensor, there is a curated knowledgebase of health signatures that are evaluated continuously against the incoming metrics and are used to raise issues or incidents depending on user impact.

Built-in events trigger issues or incidents based on failing health signatures on entities, and custom events trigger issues or incidents based on the thresholds of an individual metric of any given entity.

For information about built-events for the IBM Cloud sensor, see the Built-in events reference.

IBM Technology Preview statement

TECHNOLOGY PREVIEW CODE: Technology Preview Code (TPC) may be included or distributed with the Program or updates to it. TPC will be identified as such in the Notices File (or in an updated Notices File accompanying the updates), or in a file or files referenced in such Notices File. Some or all of the TPC may not be made generally available by IBM as or in a product. You are authorized to use the TPC only for internal use for evaluation purposes and not for use in a production environment. The Notices File may limit this evaluation use to an evaluation period. If so, at the end of such evaluation period, You must cease using and uninstall the TPC. No support is provided for TPC and it is provided on an "AS IS" BASIS WITHOUT WARRANTY OF ANY KIND (EXPRESS OR IMPLIED), INCLUDING,WITHOUT LIMITATION, ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. You may not transfer TPC to another party. TPC may contain a disabling device that will prevent it from being used after the evaluation period ends. You will not tamper with this disabling device or the TPC. You should take precautions to avoid any loss of data that might result when the TPC can no longer be used.