調用鏈監控 CAT 之 入門

簡介

CAT 是一個實時和接近全量的監控系統，它側重於對Java應用的監控，基本接入了美團上海全部核心應用。目前在中間件（MVC、RPC、數據庫、緩存等）框架中獲得普遍應用，爲美團各業務線提供系統的性能指標、健康情況、監控告警等。

優點

• 實時處理：信息的價值會隨時間銳減，尤爲是事故處理過程當中。
• 全量數據：全量採集指標數據，便於深度分析故障案例。
• 高可用：故障的還原與問題定位，須要高可用監控來支撐。
• 故障容忍：故障不影響業務正常運轉、對業務透明。
• 高吞吐：海量監控數據的收集，須要高吞吐能力作保證。
• 可擴展：支持分佈式、跨 IDC 部署，橫向擴展的監控系統。

開源產品比較

快速上手

本地部署

步驟1：部署tomcat

準備一個tomcat，修改 tomcat conf 目錄下 server.xml，防中文亂碼。

Connector port="8080" protocol="HTTP/1.1"
           URIEncoding="utf-8"    connectionTimeout="20000"
               redirectPort="8443" />  <!-- 增長 URIEncoding="utf-8" -->
複製代碼

步驟2：程序對於/data/目錄具體讀寫權限（重要）

• Linux

• 要求/data/目錄能進行讀寫操做，若是/data/目錄不能寫，建議使用linux的軟連接連接到一個固定可寫的目錄。

• 此目錄會存一些CAT必要的配置文件以及運行時候的數據存儲目錄。

• CAT支持CAT_HOME環境變量，能夠經過JVM參數修改默認的路徑。

mkdir /data
chmod -R 777 /data/
複製代碼

• Windows

對程序運行盤下的/data/appdatas/cat和/data/applogs/cat有讀寫權限。例如cat服務運行在e盤的tomcat中，則須要對e:/data/appdatas/cat和e:/data/applogs/cat有讀寫權限。

步驟3： 配置/data/appdatas/cat/client.xml ($CAT_HOME/client.xml)

<?xml version="1.0" encoding="utf-8"?>
<config mode="client">
    <servers>
        <server ip="127.0.0.1" port="2280" http-port="8080"/>
    </servers>
</config>
複製代碼

此配置文件的做用是全部的客戶端都須要一個地址指向CAT的服務端。

步驟4： 安裝CAT的數據庫

下載cat源碼包：codeload.github.com/dianping/ca… 解壓後，數據庫的腳本文件爲 script/CatApplication.sql

mysql -uroot -Dcat < CatApplication.sql
複製代碼

步驟5： 配置/data/appdatas/cat/datasources.xml($CAT_HOME/datasources.xml)

<?xml version="1.0" encoding="utf-8"?>

<data-sources>
	<data-source id="cat">
		<maximum-pool-size>3</maximum-pool-size>
		<connection-timeout>1s</connection-timeout>
		<idle-timeout>10m</idle-timeout>
		<statement-cache-size>1000</statement-cache-size>
		<properties>
			<driver>com.mysql.jdbc.Driver</driver>
			<url><![CDATA[jdbc:mysql://127.0.0.1:3306/cat]]></url>  <!-- 請替換爲真實數據庫URL及Port -->
			<user>root</user>  <!-- 請替換爲真實數據庫用戶名 -->
			<password>root</password>  <!-- 請替換爲真實數據庫密碼 -->
			<connectionProperties><![CDATA[useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&socketTimeout=120000]]></connectionProperties>
		</properties>
	</data-source>
</data-sources>
複製代碼

步驟6： war打包

官方下載：unidal.org/nexus/servi…

重命名爲cat.war進行部署，注意此war是用jdk8，服務端請使用jdk8版本

步驟7： war部署

• 將上一步打包的war包部署到本機tomcat的webapps下。
• 啓動tomcat，打開控制檯的URL，http://127.0.0.1:8080/cat/s/config?op=routerConfigUpdate 默認用戶名：admin 默認密碼：admin 。
• 配置客戶端路由。

<?xml version="1.0" encoding="utf-8"?>
<router-config backup-server="你的本機ip（不要用127.0.0.1）" backup-server-port="2280">
   <default-server id="你的本機ip（不要用127.0.0.1）" weight="1.0" port="2280" enable="true"/>
   <network-policy id="default" title="默認" block="false" server-group="default_group">
   </network-policy>
   <server-group id="default_group" title="default-group">
      <group-server id="你的本機ip（不要用127.0.0.1）"/>
   </server-group>
   <domain id="cat">
      <group id="default">
         <server id="你的本機ip（不要用127.0.0.1）" port="2280" weight="1.0"/>
      </group>
   </domain>
</router-config>
複製代碼

提交後，重啓tomcat，訪問http://127.0.0.1:8080/cat，出現以下界面，說明搭建成功。

測試

安裝jar包

進入cat源碼包的 lib/java/jar ，將cat-client-3.0.0.jar 包 安裝到本地maven倉庫。

mvn install:install-file -DgroupId=com.dianping.cat -DartifactId=cat-client Dversion=3.0.0 -Dpackaging=jar -Dfile=cat-client-3.0.0.jar
複製代碼

建立工程

建立一個springboot 工程，關鍵代碼以下。

pom.xml

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>com.dianping.cat</groupId>
    <artifactId>cat-client</artifactId>
    <version>3.0.0</version>
</dependency>
複製代碼

app.properties

須要在你的項目中建立 src/main/resources/META-INF/app.properties 文件, 並添加以下內容:

app.name={appkey}
複製代碼

appkey 只能包含英文字母 (a-z, A-Z)、數字 (0-9)、下劃線 (_) 和中劃線 (-)

application.yml

server:
  port: 8760

spring:
  application:
    name: cat-simple
複製代碼

啓動類

@SpringBootApplication
@RestController
public class CatSimpleApplication {


    public static void main(String[] args) {
        SpringApplication.run( CatSimpleApplication.class, args );
    }

    @PostMapping("/hi")
    public String hi(HttpServletRequest request){
        String url = request.getRequestURL().toString();

        // 建立一個 Transaction
        Transaction transaction = Cat.newTransaction( "URL", url );
        try {
            // 處理業務
            myBusiness();
            // 設置狀態
            transaction.setStatus(Transaction.SUCCESS);
        } catch (Exception e) {
            // 設置錯誤狀態
            transaction.setStatus(e);
            // 記錄錯誤信息
            Cat.logError(e);
        } finally {
            // 結束 Transaction
            transaction.complete();
        }

        return "hello";
    }

    @PostMapping("/error")
    public String error(HttpServletRequest request){
        String url = request.getRequestURL().toString();

        // 建立一個 Transaction
        Transaction transaction = Cat.newTransaction( "URL", url );
        try {
            // 處理業務
            int i = 1 / 0;
            // 設置狀態
            transaction.setStatus(Transaction.SUCCESS);
        } catch (Exception e) {
            // 設置錯誤狀態
            transaction.setStatus(e);
            // 記錄錯誤信息
            Cat.logError(e);
        } finally {
            // 結束 Transaction
            transaction.complete();
        }

        return "500";
    }

    private void myBusiness() {
        //模擬業務處理的時間
        try {
            Thread.sleep( 500 );
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }


}
複製代碼

請求 http://localhost:8760/hi

curl -X POST  http://localhost:8760/hi
複製代碼

請求 http://localhost:8760/error

curl -X POST  http://localhost:8760/error
複製代碼

查看監控信息

進入 cat 控制檯，點擊 Transaction 按鈕 ，以後點擊所有，會看到有哪些客戶端，如圖：

點擊客戶端 cat-simple ，出現如圖：

如上圖，能夠清晰的看到 請求的 總個數（tatal）、均值（avg）、最大/最小（max/min)、標準差（std）等，其餘都比較直觀，標準差稍微複雜一點，你們本身能夠推演一下怎麼作增量計算。那集合運算，好比95線（表示95%請求的完成時間）、999線（表示99.9%請求的完成時間）

點擊 「log View」 能夠查看 錯誤信息，如圖：

源碼

github.com/gf-huanchup…

參考

github.com/dianping/ca…

歡迎掃碼或微信搜索公衆號《程序員果果》關注我，關注有驚喜~