IBM Cloud Docs
在 Windows 上使用 IBM Metrics Collector for SAP (IMCS)

在 Windows 上使用 IBM Metrics Collector for SAP (IMCS)

只有当 SAP 工作负载在虚拟服务器实例 (VSI) 上运行时,Windows 上的 IBM® Metrics Collector for SAP (IMCS) 才是 SAP Support for IBM Cloud® Virtual Private Cloud Infrastructure 的要求。

获取 IBM Cloud API 密钥

您需要 IBM Cloud API 密钥,以便 IMCS 成功收集所有必要的指标。 API 密钥授予对 IBM Cloud 基础设施服务的视图访问权限。 您可以在没有 API 密钥的情况下安装 IMCS。 但 SAP 不支持某些指标,也不支持虚拟服务器。

有关缺失指标的列表,请参阅 附加信息

每个账户只需创建一个服务 ID 和一个 API 密钥。 您可以对安装在与账户关联的虚拟服务器中的所有度量收集器使用相同的服务 ID 和 API 密钥。

创建服务标识

您需要先创建一个服务 ID,然后再创建相关的 API 密钥。 使用以下步骤创建服务 ID。

  1. 登录 IBM Cloud 控制台,单击管理 > 访问 (IAM)
  2. 单击服务 ID > 创建
  3. 输入服务 ID 的名称描述,然后单击创建。 您可以在创建服务 ID 后分配访问策略。
  4. 单击访问策略 > 分配访问权
  5. 单击 IAM 服务分配服务 ID 额外访问权限
  6. 选择“VPC 基础设施服务”,查看要分配的访问类型?
  7. 选择所有资源组
  8. 保留默认****帐户
  9. 在“资源类型”中留下“所有资源类型”,在“平台访问”中单击“查看器”。
  10. 单击添加 > 分配。 VPC 基础设施服务策略分配给您的服务 ID。

为服务 ID 创建 API 密钥。

使用以下步骤为新服务 ID 创建 API 密钥。

  1. 选择服务 ID 和新创建的服务 ID
  2. 单击“访问策略”选项卡,验证 VPC 基础设施服务是否被列为访问策略。 如果没有,重复步骤 4-9。
  3. 单击下一个选项卡 API keys > Create
  4. 输入密钥的名称描述,然后单击“创建”。
  5. 单击“**复制 **”或“下载 API 密钥”保存。

现在是访问 API 密钥数据的唯一机会。 您无法再次查看此 API 密钥,因此以后也无法检索它。

在 Windows 上安装 IBM Metrics Collector for SAP

IMCS 是一项在安装完成后自动启动的服务,需要一个 API 密钥。 它从虚拟服务器的元数据、IBM Cloud 基础设施服务、CPU、内存、网络和磁盘等资源的运行时数据中收集指标。 这些指标通过网络服务器汇总和显示,供 SAP 客户使用。 SAPOSCOL 使用该网络服务器的 XML 输出。

IMCS 使用 18181 端口显示指标。 确保 18181 端口未被其他应用程序使用。 有关如何检查端口可用性的更多信息,请参阅 故障排除

本节列出的命令在 Windows PowerShell 5.1 中运行。

使用以下步骤下载 IMCS。

  1. 下载 IMCS

  2. 选择相应的.zip。 在大多数情况下,请使用当前版本。 以访客身份连接。

  3. 将文件保存到内部下载文件夹,然后单击“确定”。

  4. 将 IMCS.zip 文件移动或复制到 VPC 虚拟服务器实例。

  5. 解压文件并打开解压后的文件夹。

  6. 运行 install-metric-collector.ps1 文件。 右键单击文件并选择“使用 Powershell 运行”,或在 Power Shell 上运行以下命令:

    .\install-metric-collector.ps1
    
  7. 按提示粘贴 API 密钥。 如果没有 API 密钥,请参阅 获取 IBM Cloud API 密钥

  8. 安装完成后,检查确保综管系统正在运行。 准备就绪时,服务状态显示 Running

    Get-Service Telegraf
    Status   Name               DisplayName
    ------   ----               -----------
    Running  Telegraf           Telegraf Data Collector Service
    

核实数据收集情况

安装完成并启动服务后,综管系统可能需要一段时间才能开始收集指标。 安装后至少等待 2 分钟,然后才能获得完整准确的指标。

  1. 打开您选择的浏览器。

  2. 打开以下链接:http://localhost:18181/sap/metrics

     <metrics>
       <metric category="config" context="vm" device-id="" last-refresh="1607451781" refresh-interval="0" type="string" unit="none">
         <name>Data Provider Version</name>
         <value>1.3</value>
       </metric>
       <metric category="config" context="host" device-id="" last-refresh="1607451781" refresh-interval="0" type="string" unit="none">
         <name>Cloud Provider</name>
          <value>IBM Cloud</value>
       </metric>
       <metric category="config" context="vm" device-id="" last-refresh="1607451781" refresh-interval="0" type="string" unit="none">
         <name>Instance Type</name>
         <value>bx2-8x32</value>
       </metric>
       <metric category="config" context="host" device-id="" last-refresh="1607451781" refresh-interval="0" type="string" unit="none">
         <name>Virtualization Solution</name>
         <value>KVM</value>
       </metric>
       .
       .
       .
     </metrics>
    

在数据可用之前,您可能会遇到延迟。 { :note }

故障诊断

使用以下 IMCS 故障排除提示。

卸载度量收集器

  1. 如果在安装过程中遇到任何问题,请运行以下命令卸载 IMCS。 然后,重新安装。

    .\uninstall-metric-collector.ps1
    
    Are you sure you want to uninstall Metric Collector for SAP? (Default is No)
    ( y / n ) : y
    Continuing uninstalling metric collector...
    Removed scheduled task: IBM Metric Collector for SAP Updator
    Successfully Uninstalled Metric Collector
    

打开链接时没有指标报告

没有报告指标通常是由于端口没有分配给 SAP Metrics Collector。 它需要 18181 端口供 localhost 使用。 如果有其他应用程序使用该端口,则必须关闭应用程序/所有进程。

  1. 使用以下命令查看端口是否已分配给其他应用程序。

    Get-NetTCPConnection -State listen
    

图 1。 应用程序使用的端口
应用程序使用的端口

其他信息

如果您没有 IBM Cloud API 密钥,综管系统就无法收集 SAP 所要求的所有指标,其中包括

  • 网络适配器映射 - 替换为本地 MAC ID。
  • 网络适配器带宽 - 端口速度 - 默认为 0。
  • 磁盘卷映射 - 替换为磁盘卷附件 ID。
  • 磁盘保证 IOPS - 默认为 0。

您必须提供一个 API 密钥,以便收集所有指标。 否则,SAP 不完全支持该虚拟服务器。