部署应用

ServiceStage方式

ServiceStage是面向企业及开发者的一站式DevOps平台服务。通过ServiceStage创建应用时或在应用部署好要上线时勾选探针，则APM会自动接入到应用。在应用运行3分钟左右后，您只需要登录APM即可在拓扑、事务界面上查看应用情况。

AOS方式

AOS是应用编排服务，您在编写模板的时候将设计器Pinpoint添加到模板中，即表示您已经将APM的采集探针放在堆栈中了。编排好堆栈后创建堆栈，APM已自动接入到堆栈应用中了。当堆栈运行3分钟左右后，您只需要登录APM即可在拓扑、事务界面上查看堆栈应用情况。

CCE方式

CCE是云容器引擎，提供容器应用管理服务。在您创建或者是升级应用时勾选探针，即表示您已经将APM的采集探针安装在应用中了。启动应用3分钟左右后，您只需要登录APM即可在拓扑、事务界面上查看应用情况。

虚机方式

当您未使用AOS、ServiceStage、CCE部署应用，而是直接将应用部署在弹性云服务或裸金属服务器上时，则需要进行以下操作。在操作前，您需要了解操作流程及操作前提。

-操作流程

1. 环境准备：创建虚机并确保被监控应用运行正常。
2. 安装ICAgent：安装采集代理ICAgent（用于实时采集应用数据）。

3. 开启应用性能监控：修改应用的启动脚本来确保ICAgent可采集应用数据。

4. 在APM上进行管理：应用启动后，需等待3分钟产生数据，APM会自动发现应用拓扑和性能数据。此时，您可以在APM上查看拓扑、调用链等数据。

-操作前提

您的应用已经上了云，那么您已经拥有弹性云服务器了。要使用APM，您还需要确保以下条件：

1. 弹性云服务器满足APM支持的操作系统，应用满足APM支持的类型。
2. 安装了应用的弹性云服务器绑定了弹性IP地址。如果您是集群，拥有多台弹性云服务器，则只需要确保其中一台已经绑定弹性IP即可。
3. 已获取了AK/SK。AK/SK用于安装应用性能管理服务的采集插件，获取AK/SK请参考如何获取AK/SK。
4. 确保本地浏览器的时间与弹性云服务器的时区、时间一致。

-操作步骤

1. 安装ICAgent。
   1. 登录APM，进入“Agent管理”界面，单击“安装ICAgent”。
   2. 生成ICAgent安装命令，并复制该命令。
      1. 在文本框中输入已获取的AK/SK，生成ICAgent安装命令。
         说明：

         请确保以上参数输入正确，否则将无法安装ICAgent。

      2. 单击“复制命令”。

         

      3. 使用远程登录工具，以root用户登录弹性云服务器（用弹性IP登录），执行已复制的命令进行安装。

         当显示“ICAgent install success”时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。

   3. （可选）当您拥有多台弹性云服务器时，在安装好其中一台后，可以通过继承安装方式安装剩余需要安装的服务器，具体操作详见继承安装。

2. 开启应用性能监控。

   以vmall应用、应用层名称vmall-product-service为例。

   ICAgent安装完成后，需通过如下操作开启应用性能监控功能，开启该功能后会为Java应用安装上非侵入式采集探针。

   • 当未使用JBoss部署Java应用时，您需在Java应用服务器的启动脚本中增加如下配置。配置完成后，您启动应用，即可开启应用性能管理功能。
     -javaagent:/opt/oss/servicemgr/ICAgent/pinpoint/pinpoint-bootstrap.jar -Dapm_application=vmall -Dapm_tier=vmall-product-service

     表1 配置说明

     参数	说明	是否必须配置	配置
     -javaagent	采集探针依赖的jar包。	是	参数值固定，均取值为：/opt/oss/servicemgr/ICAgent/pinpoint/pinpoint-bootstrap.jar 说明： 如果使用非root用户启动Java应用，请确保该用户具有“/opt/oss/servicemgr/ICAgent/pinpoint/”路径的读写执行权限。
     -Dapm_application	应用名称。	是	用户结合应用名称配置。例如，vmall中账单系统可构成一个应用，则其应用名称为vmall。 说明： 命名规则 支持字符： 小写字母、数字、中划线（-）、下划线（_）。起始字符只能为小写字母或下划线（_）。 字符串长度：1~64位。
     -Dapm_tier	应用层名称，指组成该应用的微服务名称。	是	用户结合组成应用的应用层名称配置。例如，在vmall账单系统中，应用层名称分别为vmall-product-service、vmall-api-service。 说明： 命名规则 支持字符： 小写字母、数字、中划线（-）、下划线（_）。起始字符只能为小写字母或下划线（_）。 字符串长度：1~64位。
     -Xbootclasspath	JBoss安装包路径。	是	格式为：-Xbootclasspath/p:/JBoss安装包路径，例如，-Xbootclasspath/p:/opt/jboss/jboss-as-7.1.0.Final

     示例

     配置前脚本：

     

     配置后脚本：

     

   • 当使用JBoss部署Java应用时，如果使用独立启动方式（APM仅支持JBoss的独立启动方式即Standalone Mode）启动JBoss，启动JBoss前，您需在配置文件“standalone.conf”的相应代码段中增加如下加粗配置。增加的配置内容中，变量使用倾斜字体标识，请参考表1设置变量。配置完成后，您启动应用，即可开启应用性能管理功能。
     修改示例如下：

     if [ "x$JBOSS_MODULES_SYSTEM_PKGS" = "x" ]; then
     JBOSS_MODULES_SYSTEM_PKGS="org.jboss.byteman,org.jboss.logmanager,com.navercorp.pinpoint.bootstrap,com.navercorp.pinpoint.common,com.navercorp.pinpoint.exception"
     fi
     # Uncomment the following line to prevent manipulation of JVM options
     # by shell scripts.
     #
     #PRESERVE_JAVA_OPTS=true
     #
     # Specify options to pass to the Java VM.
     #
     if [ "x$JAVA_OPTS" = "x" ]; then
     JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
     JAVA_OPTS="$JAVA_OPTS -Djboss.modules.system.pkgs=$JBOSS_MODULES_SYSTEM_PKGS -Djava.awt.headless=true"
     JAVA_OPTS="$JAVA_OPTS -Djboss.server.default.config=standalone.xml"
     JAVA_OPTS="$JAVA_OPTS -javaagent:/opt/oss/servicemgr/ICAgent/pinpoint/pinpoint-bootstrap.jar -Dapm_application=vmall -Dapm_tier=vmall-product-service"
     JAVA_OPTS="$JAVA_OPTS -Xbootclasspath/p:/opt/jboss/jboss-as-7.1.0.Final/modules/org/jboss/logmanager/log4j/main/jboss-logmanager-log4j-1.0.0.GA.jar -Xbootclasspath/p:/opt/jboss/jboss-as-7.1.0.Final/modules/org/jboss/logmanager/main/jboss-logmanager-1.2.2.GA.jar -Xbootclasspath/p:/opt/jboss/jboss-as-7.1.0.Final/modules/org/apache/log4j/main/log4j-1.2.16.jar"
     JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.jboss.logmanager.LogManager"
     else
     echo "JAVA_OPTS already set in environment; overriding default settings with values: $JAVA_OPTS"
     fi

3. 完成开启后启动应用，等待3分钟左右应用数据就会呈现在应用性能管理服务界面中，此时登录APM，即可看到应用数据。您可以在拓扑、事务界面上查看应用情况。