Welcome to the IBM Community, a place to collaborate, share knowledge, & support one another in everyday challenges. Connect with your fellow members through forums, blogs, files, & face-to-face networking.
Skip to main content (Press Enter).
Skip auxiliary navigation (Press Enter).
Agent and Sensors
Upcoming Instana Events
IBM Tech TV
All IBM Community Events
Post to Forum
Share a Resource
Blogging on the Community
Connect with Instana Users
All IBM Community Users
Community Front Porch
Learn about Instana
IBM Instanauts Community
Untangling the Complexities of Modern Application Visibility.
Join / Log in
Go to Stan's Corner
Skip main navigation (Press Enter).
IBM Z® performance monitoring through Instana sensor
Tue November 09, 2021 08:35 AM
Authors: Priyanka, Shivangi, Bipin
IBM Observability by Instana
provides a comprehensive observability platform for an enterprise to track requests spanning from mobile to mainframe, and from bare metal machines to hybrid multi-cloud deployments.
Mainframe computers play a central role in the daily operations of most of the world’s largest corporations. In banking, finance, health care, insurance, public utilities, government, and a multitude of other public and private enterprises, mainframe computer
continue to form the foundation of modern business. They are most stable, with negligible downtime.
Meet the IBM z15 mainframe
, as with all computing systems, is built on hardware components. At their core,
mainframes are high-performance computers with large amounts of memory and processors that process billions of simple calculations and transactions in real time.
IBM Z® Instana sensor
monitors the availability and performance of hardware systems and subsystem resources across the enterprise having multiple System
mainframes. It can connect to one or many
at the same time and collect the required me
trics. If any deviation occurs from normal behaviour, alerts and events can be created based on these metrics, and the abnormal behaviour can be analysed and diagnosed by using relevant data.
IBM Z® Instana sensor
makes use of the
Web Services API
provided by t
ardware Management Console
or zHMC). zHMC
is an IBM System z feature that provides the end-user interface to control and monitor the status of the system.
zHMC provides the
Web Services API
can be used to
and monitor C
entral Processing Complexes
(CPCs) and its various components.
By default, the Web Services API is disabled on the
and can be enabled.
Once a user is permitted to establish API sessions, the ac
tions within those sessions are subject to the
HMC's access control model
zHMC Instana Sensor Architecture
IBM Z® Instana sensor collects performance metrics, and transforms the information into actionable key performance metrics and reports quickly and efficiently. It monitors the availability and performance indicators of hardware systems and subsystem resources across the enterprise, and provides a single tool for one or many zHMCs. For example, it can connect to one or many zHMCs at the same time, and collects the performance metrics for all of them.
With IBM Z Instana sensor, you can:
Visualise performance metrics with built-in dashboards.
data that is available in near real-time.
Support one or many zHMCs by using only one Instana instance.
Create events and alerts based on any of the performance metrics for the supported
etails of the latest available metrics can be found
Enabling and accessing the API
By default, the Web Services API is disabled on the HMC. The Web Services API can be enabled
and the scope of access to
it can be configured by u
Customize API Setting
s task in the HMC UI.
API User Permissions
By default, this setting is disabled for an HMC user profile
and thus attempts to establish an API session by that user are rejected.
Customize API Settings
tasks of the HMC to set this property for one or more HMC users
and thus allow those users to access the API.
Install Instana Agent
to install Instana agent on any remote host system.
Using the one-liner
to configure the Instana sensor to connect to one or multiple zHMCs
To start the Instana Agent, run the command:
Instana Agent, run the command:
To get the status of
Instana Agent, run the command:
IBM Z - can be found under
section of the navigation pane.
Supported Metric Groups
It provides metrics for the s
ystem resources, such as power consumption, environmental data, processor usage, etc.
he utilization and environment data that is displayed on the user interface is also provided through the Metrics Service
in the following metric groups.
This metric group reports the aggregated processor usage and channel usage, the ambient temperature, and total system power consumption for each system. The cpc-processor-usage is the average of the percentages of processing capacity for all the physical processors in the CPC. The channel-usage is the average of the percentages of I/O capacity for all the channels and adapters in the CPC.
This metric group reports the processor usage and z/VM paging rate for each active logical partition (
Image, LPAR Image, Zone, PR/SM virtual server) on the system.
This metric group reports the channel usage for each channel on the system. An instance of this metric group is created for each channel of a CPC.
This metric group reports the adapter usage for each crypto on the system. An instance of this metric group is created for each crypto adapter. This metric group is not used for a DPM system. For DPM, crypto adapters are reported in the Adapters metric group.
This metric group reports the adapter usage for each Flash memory (Flash Express) adapter on the system. An instance of this metric group is created for each Flash memory adapter of the CPC. If a CPC has no flash memory adapters, then no data will appear in this metric group for that CPC.
This metric group reports the adapter usage for each RoCE (10GbE RoCE) adapter on the system. An instance of this metric group is created for each RoCE adapter of the CPC.
This metric group reports the aggregated processor usage, network usage, storage usage, accelerator usage, crypto usage, power consumption and temperature for each DPM enabled system.
This metric group reports the processor usage, network usage, storage usage, accelerator usage, and crypto usage for each active partition on a DPM enabled system.
This metric group reports the adapter usage for each adapter on the DPM enabled system. An instance of this metric group is created for each adapter.
OSA and RoCE network adapters have up to two physical ports that connect to the network. Metrics are collected from these ports on a DPM enabled system and provided to the user. This metrics group will contain metrics data representing metrics for one physical port. Metrics are collected and provided on an interval, and each metric provided is the total cumulative value, and not a delta.
This metric group reports metrics for NICs on a DPM enabled system. NICs are network resources associated with DPM partitions. Only NICs that are activated will report metric data. This metrics group will contain metrics data representing metrics for one NIC. Metrics are collected and provided on an interval, and each metric provided is the total cumulative value, and not a delta.
This metric group reports environmental data and power consumption for the zCPC.
This metric group reports line cord power information of connected Power Distribution Units (PDU) or BPAs (Bulk Power Assembly) in the system.
This metric group reports the processor usage for each physical zCPC processor on the system. This includes the System Assist Processors (SAPs). An instance of this metric group is created for each processor of a CPC.
means it's available in next release.
C means Classic mode while D means DPM mode.
Alerts and Events Configuration
Based on these performance metrics, we can create alerts and events. Click the following links to get the details about how to create and configure them.
Configure and Manage Alerts
Define Custom Events
Setup Alert Channels
Following is an example of creating a custom event based on Server's Temperature.
system's temperature is more than the specified value for 60 seconds
An alert can be created
using these events
and can be routed through any available alert channels.
API Authentication error
Check if the
access is enabled for this zHMC.
is configured with
correct hmc host name, user id and password.
Check whether the zHMC user has required permissions to collect the metrics.
If you encounter a problem, please report it as an issue
Copyright © 2022 IBM Corporation. All rights reserved.
Powered by Higher Logic