文档

ECS Metrics Collector for SAP部署指南

更新时间:
一键部署

版本管理

版本

修订日期

变更类型

生效日期

1.0

初始版本

2018/5/31

1.1

2018/6/11

更新安装准备条件说明

2018/6/12

1.2

2019/1/7

1.更新常见问题

2.更新RAM2.0操作说明

2019/1/7

1.3

2020/3/13

1.Linux平台的版本更新,支持OpenAPI内网调用

2.RAM角色配置更新

3.排版优化等

2020/3/13

1.4

2020/6/23

1.OpenAPI内网访问方式优化

2020/6/23

概述

当SAP系统运行在ECS上时,SAP Host Agent通过Metrics Collector代理调用阿里云的metadata服务和OpenAPI获取需要的信息,用于收集SAP系统监控所需信息(包括硬件、网络、存储、SAP架构方面等),并将其提供给SAP应用程序,用于事物和系统运行性能分析。

对于运行SAP系统的每个ECS实例(包括数据库和应用),都需要安装Metrics Collector for SAP监控代理程序。

说明

下图是Metrics Collector的整体框架

mc-01

安装前准备

创建RAM角色

监控代理程序 ECS Metrics Collector 的运行需要特定的 RAM 服务角色和访问授权。

有关 RAM(访问控制)角色设置的更多信息,请参阅如何通过控制台使用实例 RAM 角色

说明

如果本机已经安装了HBR(云备份)客户端,请直接转至HBR角色授权

1.登录 ECS 控制台

2.在导航窗格中,选择或搜索“访问控制”

3.打开访问控制服务控制台,选择RAM角色管理,单击新建RAM角色

4.选择阿里云服务类型, 云服务器 ,并输入角色名称,例如 ecs-metrics-collector,点击 确定

5.单击添加权限。输入策略 AliyunECSReadOnlyAccessAliyunCloudMonitorReadOnlyAccess 并将其分配给您的 RAM 服务角色

说明

这两个角色是授权Metrics Collector只读访问ECS信息和只读访问云监控资源信息

6.单击确定,完成策略分配。

HBR角色授权

将策略授权给角色“AliyunECSAccessingHBRRole”的示例如下:

编辑RAM角色“AliyunECSAccessingHBRRole”,点击“添加权限”,添加AliyunECSReadOnlyAccessAliyunCloudMonitorReadOnlyAccess这两个权限策略。

RAM角色配置

将您创建的 RAM 服务角色挂载至您的 SAP ECS 实例。

  • 打开 ECS 控制台,转到实例选项卡,找到您的 ECS 实例

  • 更多操作的下拉列表中选择授予/收回 RAM 角色

  • 选择您在开始时创建的 RAM 服务角色。

说明

如果本机已经安装了HBR(云备份)客户端,这里请授予“AliyunECSAccessingHBRRole”角色

  • 点击“确定”以挂载角色。

关于绑定/解绑 RAM 角色的更多信息,请参考如何通过控制台使用实例 RAM 角色

SAP Host Agent的安装

说明

需要SAP market place的服务账号登录

Metrics collector需要结合SAP Host Agent才能正常使用。安装SAP Host Agent请参考 1031096 - Installing Package SAPHOSTAGENT

ECS Metrics Collector的安装和卸载

Linux平台

安装 ECS Metrics Collector

linux

1、使用具有 root 权限的用户帐户登录您的 SAP ECS 实例

为使用 root 权限,您需要使用 sudo,因此您的用户必须属于 sudo 组。

2、通过云助手安装 ECS Metrics Collector

说明

Metrics collector工具需要python的支持,请确保pip已经被正常安装(下载软件时需要连接外网)

wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py
pip -V  #验证pip的安装

安装程序会自动选择当前的最新版本安装,本示例的版本是0.11。

# aliyun_installer -i ecs-metrics-collector

The latest version of ecs-metrics-collector in the software repository is 0.11
Downloading...
Check MD5
Unzip
Installing...
see details in installation log file: /var/log/ecs_metrics_collector/install.log

[DEBUG] prepare_env
[DEBUG] account_check
[DEBUG] distro_check
[DEBUG] init_system_check
[DEBUG] system_restraint_check
[DEBUG] package_check
[DEBUG] python_env_check
[DEBUG] install_collector
[DEBUG] install_watchmen
[DEBUG] install_reaper
[DEBUG] install_service

Installation success !

验证 Metrics Collector 的安装

3、通过以下操作验证 ECS Metrics Collector 服务是否正常

systemctl status ecs_metrics_collector

metrics-2

4、使用以下命令,验证在 crontab 中是否已配置监听任务和自动更新任务,同时也可以通过运行日志检查程序运行状态

cat /etc/cron.d/ecs_metrics_collector
cat /var/log/ecs_metrics_collector/watchmen.log

metrics-3

说明

在 ECS Metrics Collector 安装过程中,这两个任务将自动添加至 crontab。自动更新任务每1小时自动在云助手服务器上检查一次 ECS Metrics Collector 的最新版本,一旦有新版本可用将在后台自动完成升级。

检查收集的监控项数据

5、验证数据的收集

curl localhost:8888 | vim -

curl

卸载ECS Metrics Collector

使用具有 root 权限的用户帐户登录您的 SAP ECS 实例

运行卸载命令: aliyun_installer -u ecs-metrics-collector

curl

更多操作命令

有关metrics collector更多的命令,可以通过aliyun_installer --h查询

Windows平台

windows

1、使用具有管理员(administrators组) 权限的用户帐户登录您的 SAP ECS 实例

2、使用阿里云助手,安装 ECS Metrics Collector开始菜单,右键->命令提示符(管理员),打开CMD窗口

切换到阿里云助手目录,执行安装

说明

当前阿里云助手版本是1.0.0.107,请根据实际情况修改目录名

cd "C:\ProgramData\aliyun\assist\[1.0.0.107]"
aliyun_installer.exe -l
aliyun_installer.exe -i ecs_metrics_collector
说明

当有多个可选择package_id的时候,选择最新的package_id

win_mc_install

验证 ECS Metrics Collector 的安装

3、通过以下操作验证 ECS Metrics Collector 服务是否正常

任务栏,右键->任务管理器->服务,确认服务”Ecs metrics collector”状态是 正在运行ecs_service_status

4、开始菜单,右键->运行,输入 taskschd.msc,确定。打开任务计划程序,点击”任务计划程序库“,确认定时检查更新的任务已经被成功调度

metrics_task

在 ECS Metrics Collector 安装过程中会定义一个计划任务,每1小时自动在云助手服务器上检查一次 ECS Metrics Collector 的最新版本,一旦有新版本可用将自动升级。

检查收集的监控项数据

5、验证收集的数据

打开浏览器,访问

http://localhost:8888

能打开类似的页面,并且所有的value都能取到值,说明配置正确。如果出现value值取数异常,请先检查 RAM角色配置

curl

卸载ECS Metrics Collector

使用具有管理员(administrators组) 权限的用户帐户登录您的 SAP ECS 实例切换到安装目录,双击uninst.exemetrics_uninstall_01

metrics_uninstall_02

更多操作命令

有关metrics collector更多的命令,可以通过aliyun_installer.exe --h查询

常见问题

1.安装完成后,metrics collector服务启动失败 “Failed to start ECS Metrics Collector for SAP”

问题描述:

  • 运行命令systemctl status ecs_metrics_collector,检查服务状态时出现如下报错:

qa_1_01

  • 查看系统日志命令 journalctl -xe,出现如下类似信息 ImportError: No module named pytz

qa_1_02

解决方案:

  • 手工安装pytz

pip install pytz

qa_1_02

  • 重启并验证服务状态

systemctl restart ecs_metrics_collector
systemctl status ecs_metrics_collector

qa_1_02