文档中心 V3.0
OneAPM AI(Application Insight)

MoPaaS提供的OneAPM AI(Application Insight)服务能够监控和优化应用程序的代码性能、错误及SQL语句性能,支持Java、php、node.js、python、Ruby(目前仅支持Rails应用)。
使用OneAPM AI服务,您首先需要登录OneAPM服务控制台,如您是首次使用,可点此完成快速注册
请根据您应用的类型,参考下列相应的文档,开启您的应用监控之旅。

一、Java

1、登录OneAPM服务控制台,选择“Application Insight”服务;
2、点击“添加”按钮,并选择“Java”语言,获取您的授权编号(License Key)备用;
3、点此下载OneAPM Java Agent 3.x,或使用wget下载:

wget https://user.oneapm.com/account/b5b371bd89e3ee9ab1e6910923042438/agent/java/OneAPM_java_Agent_latest.zip

4、将步骤3下载的Agent解压至应用根目录;
5、打开“应用根目录/OneAPM/oneapm.properties”文件,修改appname(可选)并写入步骤2获取的授权编号(License Key),保存文件;
6、在应用根目录下选中所有文件并打包成zip格式的压缩包;
7、在MoPaaS新建Java应用,进入应用控制台新建环境变量;
变量名:JAVA_OPTS ,变量值:-javaagent:/home/vcap/app/OneAPM/oneapm.jar;
8、在应用控制台选择“代码管理”,上传步骤6生成的zip压缩包;
9、应用启动成功后稍候几分钟,刷新OneAPM控制台页面,查看应用监控信息。

二、PHP

1、登录OneAPM服务控制台,选择“Application Insight”服务;
2、点击“添加”按钮,并选择“php”语言,获取您的授权编号(License Key)备用;
3、点此下载OneAPM PHP Agent,或使用wget下载:

wget https://user.oneapm.com/account/b5b371bd89e3ee9ab1e6910923042438/agent/php/OneAPM_php_Agent_latest.tar.gz

4、将步骤3下载的Agent解压至应用根目录;
5、在应用根目录下选中所有文件并打包成zip格式的压缩包;
6、在MoPaaS新建php应用,并添加启动命令:

./htdocs/oneapm-php-install/oneapm-install install --php-path=php/bin --php-ini-file=php/etc/php.ini --appname=您的应用名 --license=步骤2获取的授权编号 (License Key) && .bp/bin/start

如果应用程序根目录下已经存在htdocs目录,则启动命令为:

./oneapm-php-install/oneapm-install install --php-path=php/bin --php-ini-file=php/etc/php.ini --appname=您的应用名 --license=步骤2获取的授权编号 (License Key) && .bp/bin/start;

7、在应用控制台选择”代码管理“,上传步骤5生成的zip压缩包;
8、应用启动成功后稍候几分钟,刷新OneAPM控制台页面,查看应用监控信息。

三、node.js

1、登录OneAPM服务控制台,选择“Application Insight”服务;
2、点击“添加”按钮,并选择“node.js”语言,获取您的授权编号(License Key)备用;
3、在应用根目录下执行命令”npm install oneapm“;
4、将node_modules/oneapm目录下的oneapm.js文件复制到应用程序根目录下,并配置oneapm.js文件,写入app_name及授权编号(License Key);
5、在应用程序主模块文件首行添加

require('oneapm');

6、在package.json文件的dependencies中添加

 "oneapm":"~1.2.20"

7、在应用根目录下选中所有文件并打包成zip格式的压缩包;
8、新建node.js应用并上传步骤7生成的代码包;
9、应用启动成功后稍候几分钟,刷新OneAPM控制台页面,查看应用监控信息。

四、Python

1、登录OneAPM服务控制台,选择“Application Insight”服务;
2、点击“添加”按钮,并选择“Python”语言,获取您的授权编号(License Key)备用;
3、安装OneAPM Python Agent
在应用根目录下执行

pip install -i http://pypi.oneapm.com/simple --upgrade blueware -d vendor

若使用新版本pip,需添加

--trusted-host pypi.oneapm.com

4、在应用程序根目录下,执行配置文件生成命令

blueware-admin generate-config 您的授权编号 (License Key) blueware.ini

打开生成的配置文件blueware.ini修改app name为您的应用名称;
5、在应用根目录下的requirements.txt文件中添加blueware==1.0.11
6、在应用根目录新建Procfile文件,添加WSGI服务器启动命令

web: BLUEWARE_CONFIG_FILE=blueware.ini blueware-admin run-program 您的应用启动命令

7、在应用根目录下选中所有文件并打包成zip格式的压缩包;
8、新建python应用并上传步骤7生成的代码包。
9、应用启动成功后稍候几分钟,刷新OneAPM控制台页面,查看应用监控信息。

五、Ruby(目前仅支持Rails应用)

1、登录OneAPM服务控制台,选择“Application Insight”服务;
2、点击“添加”按钮,并选择“Ruby”语言,获取您的授权编号(License Key)备用;
3、点此下载OneAPMRuby配置文件至应用工程config目录下或使用wget下载:

wget https://user.oneapm.com/account/b5b371bd89e3ee9ab1e6910923042438/agent/ruby/oneapm.yml

4、将您的授权编号(License Key)写入至oneapme.yml中
5、在Gemfile中添加

gem 'oneapm_rpm', '1.3.7'

6、在应用根目录下执行

bundle install

7、在应用根目录下选中所有文件并打包成zip格式的压缩包;
8、新建Ruby应用并上传步骤7生成的代码包。
9、应用启动成功后稍候几分钟,刷新OneAPM控制台页面,查看应用监控信息。