监控 IBM DataPower
安装 Instana 主机代理后， IBM DataPower 传感器会自动安装，但您需要按照本主题中的说明配置 IBM DataPower 传感器。 然后，您可以在“ Instana ”用户界面中查看与 IBM DataPower 相关的指标。
Instana （ DataPower ）的跟踪功能可监控 API Management 功能，并检查 API 在 DataPower （ API Gateway ）中的启动过程。 要使用 Instana DataPower 跟踪功能，您必须先安装并启用 IBM DataPower 跟踪功能。 如需了解更多信息，请参阅 IBM DataPower Tracing。
支持信息
为确保 IBM DataPower 传感器与您当前的设备配置兼容，请查阅以下支持信息部分：
受支持的操作系统
请参阅 “ IBM DataPower 传感器支持的操作系统 ”。
支持的版本及支持政策
该传感器支持 IBM DataPower、 2018.4、 10.0.1.x、 10.0.x 及更高版本。
下表列出了最新支持的版本及支持政策：
| 技术 | 支持策略 | 最新技术版本 | 最新的受支持版本 |
|---|---|---|---|
| IBM DataPower | 45 天 | 11.0.0 | 10.6.0 |
有关支持政策的更多信息，请参阅《 传感器支持策略》。
其他支持信息
IBM DataPower 该传感器同时支持本地监控和远程监控。
先决条件
要使 Instana 代理程序能够监视 IBM DataPower 设备，需要启用资源监视（例如 REST 管理接口和统计信息）。
正在启用 REST 管理接口。 如需更多信息，请参阅《 启用 REST 管理接口》。
正在启用统计信息。 如需更多信息，请参阅 “启用统计功能 ”。
正在配置
Instana 支持对远程和本地 IBM DataPower 设备的监控。 要收集数据，需要在代理程序配置文件 <agent_install_dir>/etc/instana/configuration.yaml中配置以下字段:
com.instana.plugin.ibmdatapower:
enabled: true
poll_rate: 60 # Default is 60 seconds
instances: # Multiple DataPower instances can be specified
DATAPOWER_INSTANCE_HOST_1: # Remote DataPower Host or IP address
port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
DATAPOWER_INSTANCE_HOST_2: # Remote DataPower Host or IP address
port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
local: # Local monitoring configuration
port: '<INSERT_PORT_HERE>' # Local DataPower REST management interface port
username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
注：
- 该
poll_rate变量指从 IBM DataPower 检索数据的频率。 其值以秒表示。 缺省poll_rate值为 60 秒。 如果配置了多个 DataPower 设备，请增加该值poll_rate，以减少 DataPower 传感器在每次数据检索间隔期间的CPU占用率。 - 如果配置了
cluster，那么远程 DataPower 实例将在指定的可用性区域中显示为单独的框。
配置轮询频率
您可以通过在 configuration.yaml 代理配置文件中使用 poll_rate 该参数，配置 Instana 轮询 IBM DataPower 以收集数据和指标的频率，如下例所示：
com.instana.plugin.ibmdatapower:
poll_rate: 60 # Default is 60 secondsIBM DataPower 监控的支持矩阵
下表概述了 IBM DataPower 监控的支持矩阵：
| 支持矩阵 | Instana 虚拟机中的代理 | Instana Kubernetes 集群中的代理 | Instana Docker 容器中的代理 |
|---|---|---|---|
| 虚拟机中的DataPower | 受支持 | 不受支持 | 受支持 |
| Kubernetes 集群中的 DataPower | 受支持 | 受支持 | 受支持 |
| Docker 容器中的DataPower | 受支持 | 不受支持 | 受支持 |
在虚拟机中监控 IBM DataPower
本地监视
当 Instana 代理和 IBM DataPower 都在同一台虚拟机中运行时，即发生本地监控。 在这种情况下，您不需要配置 DataPower 主机或 IP 地址，而只需要在代理程序配置文件中将其指示为 local 。 随后， IBM DataPower 传感器会自动检测到 DataPower 设备的 IP 地址。 请参阅以下配置示例：
com.instana.plugin.ibmdatapower:
enabled: true
poll_rate: 60
instances:
local:
port: '5554' # DataPower instance REST management interface port (required)
username: 'admin' # User account to connect to DataPower (required)
password: 'admin' # User password to connect to DataPower (required)
远程监控
当 Instana 代理和 IBM DataPower 在不同的虚拟机中运行时，就会发生远程监控。 在这种情况下，您需要配置 DataPower 主机或 IP 地址。 请参阅以下配置示例：
com.instana.plugin.ibmdatapower:
enabled: true
poll_rate: 60
instances: # Multiple DataPower instances can be specified
10.0.0.1: # Remote DataPower Host or IP address
port: '5554' # DataPower instance REST management interface port (required)
username: 'dpUser' # User account to connect to DataPower (required)
password: 'dpPassword' # User password to connect to DataPower (required)
cluster: 'clusterName' # The cluster to group multiple DataPower instances (optional)
datapower-inst.ibm.com: # Remote DataPower Host or IP address
port: '443' # DataPower instance REST management interface port (required)
username: 'dpUser' # User account to connect to DataPower (required)
password: 'dpPassword' # User password to connect to DataPower (required)
cluster: 'clusterName' # The cluster to group multiple DataPower instances (optional)
在 Kubernetes 集群中监控 IBM DataPower
本地监视
当 Instana 代理和 IBM DataPower 都在同一台虚拟机中运行时，即发生本地监控。 在这种情况下，您不需要配置 DataPower 主机或 IP 地址，而只需要在代理程序配置文件中将其指示为 local 。 配置与 本地监视 部分中概述的配置相同。
远程监控
当 IBM DataPower 在 Kubernetes 集群中运行，而 Instana 代理在另一台虚拟机中运行时，就会触发远程监控。 配置与 远程监视 部分中概述的配置相同。
监控 IBM DataPower 中的 Docker
本地监视
当 Instana 代理和 IBM DataPower 在同一台虚拟机中的不同 Docker 容器中运行时，就会发生本地监控。 在这种情况下，您不需要配置 DataPower 主机或 IP 地址，而只需要在代理程序配置文件中将其指示为 local 。 配置与 本地监视 部分中概述的配置相同。
远程监控
当 IBM DataPower 在 Docker 容器中运行，而 Instana 代理在另一台虚拟机中运行时，就会发生远程监控。 配置与 远程监视 部分中概述的配置相同。
监控 IBM DataPower 物理设备
远程监控
您可以通过使用所需的凭据配置代理，来远程监控 IBM Datapower 物理设备。 配置与 远程监视 部分中概述的配置相同。
Instana 监控 Datapower 物理设备 10.5.x 及更高版本。
查看度量值
要查看度量，请完成以下步骤:
- 在 Instana 用户界面的侧边栏中，选择 “基础设施”。
- 单击特定受监视主机。
然后，您可以看到包含所有收集的度量值和受监视流程的主机仪表板。
绩效指标
设备
| 指标 | 描述 |
|---|---|
| 系统负载 | 度量时间间隔内设备上的总负载的百分比。 |
| CPU 使用率 | 受监视 DataPower 设备在过去 10 秒内的平均 CPU 使用率。 |
| 内存使用率 | 瞬时内存使用量占总内存量的百分比。 |
| 加密的文件系统使用情况 | 设备上已加密存储空间的使用率。 |
| 连接被接受 | TCP 接受的连接数。 |
| 工作列表 | 队列中等待设备处理的暂挂工作项数（包括内部通信）。 |
| 停顿域 | 指示域的停顿状态。 |
| 不活动的对象 | 在设备上部署的不活动对象数。 |
| 已建立 TCP 摘要 | 处于“已建立”状态的 TCP 连接的数量。 |
| 同步发送的 TCP 摘要 | 处于“已发送同步”状态的 TCP 连接的数量。 |
| 同步接收的 TCP 摘要 | 处于“已接收同步”状态的 TCP 连接的数量。 |
| TCP 摘要 Fin Wait1 | 处于“fin 等待 1”状态的 TCP 连接的数量。 |
| TCP 摘要 Fin Wait2 | 处于“fin 等待 2”状态的 TCP 连接的数量。 |
| TCP 摘要已关闭 | 处于“已关闭”状态的 TCP 连接的数量。 |
| TCP 摘要关闭等待 | 处于“关闭-等待”状态的 TCP 连接的数量。 |
| TCP 摘要时间等待 | 处于“关闭-等待”状态的 TCP 连接的数量。 |
| TCP 摘要上次确认 | 处于“最近一次应答”状态的 TCP 连接的数量。 |
| TCP 摘要侦听 | 处于“侦听”状态的 TCP 连接的数量。 |
| TCP 摘要正在关闭 | 处于“正在关闭”状态的 TCP 连接的数量。 |
域
| 指标 | 描述 |
|---|---|
| 当前内存使用量 | 此域中的瞬时内存使用率（(占总内存的百分比）。 |
XML 名称
| 指标 | 描述 |
|---|---|
| 已用 | 当前该域名下正在使用的 XML 名称数量。 |
| 可用百分比 | 该域名中目前可用的 XML 名称所占的比例。 |
同级互连状态
| 指标 | 描述 |
|---|---|
| 暂挂更新 | 此成员上未完成的命令数。 如需更多信息，请参阅 show gateway-peering-status。 |
| 复制偏移量 | 成员的复制偏移量。 成员的复制偏移量与主成员共享数据复制时的偏移量相匹配。 |
以太网接口
| 指标 | 描述 |
|---|---|
| RX 字节数 | 接收的流量字节数。 |
| RX 丢失数 | 丢失的接收包数。 |
| TX 字节数 | 传输的流量字节数。 |
| TX 丢失数 | 传输期间丢失的包数。 |
| 每秒接收数 | 在网络接口上每秒接收的包数。 |
| 每秒传输数 | 每秒在已传输接口上接收到的包的数目。 |
MQ 队列管理器（已弃用）
| 指标 | 描述 |
|---|---|
| 后端活动连接数 | 后端的活动连接的数目。 |
| 前端活动连接数 | 前端的活动连接数。 |
| 状态 | MQ 队列管理器对象的运行状态。 |
IBM MQ 队列管理器 V9+
| 指标 | 描述 |
|---|---|
| 后端活跃对话 | MQ 队列管理器与后端系统之间的实时会话数量。 |
| 前端活跃对话 | MQ 队列管理器与客户端之间的实时会话数量。 |
| 状态 | MQ 队列管理器中 V9+ 对象的运行状态。 |
服务
| 指标 | 描述 |
|---|---|
| 当前内存使用量 | 服务在 1 到 5 分钟前的时间间隔内的当前内存使用率。 |
| 平均事务时间 | 过去 10 分钟内的平均事务时间。 |
| 吞吐量 | 过去 10 分钟内的事务速率。 |
SQL 数据源
| 指标 | 描述 |
|---|---|
| 活动连接数 | SQL 数据源的名称。 |
健康指标
故障诊断
DataPower 该实例未在用户界面中显示
在 "监视问题" 列表中，查找与 DataPower 相关的事件，并根据问题类型来检查解决方案。
变量未定义
监控问题类型： ibmdatapower_var_not_defined
配置中缺少一个或多个必需的项。 请确保已在 configuration.yaml 中设置好您的 DataPower 实例端口、用户名和密码。
该变量的值无效
监控问题类型： ibmdatapower_var_invalid_value
一个或多个必需项在配置中具有无效值。 请确保在 configuration.yaml 中正确设置了您的 DataPower 实例端口、用户名和密码。
连接错误
监控问题类型： ibmdatapower_connection_error
在多次重试后，DataPower 传感器无法连接到 DataPower 实例。 请确保在 configuration.yaml 中正确设置了您的 DataPower 实例端口、用户名和密码。
其他例外情况
监控问题类型： ibmdatapower_exception_error
DataPower 传感器遇到了一个不常见的异常，但尚未记录。 这可能意味着 Instana 代理或 DataPower 存在问题。