点评 CAT

Version-1.9.0 · Experimental

Dianping-cat 简称 Cat， 是一个开源的分布式实时监控系统，主要用于监控系统的性能、容量和业务指标等。它是美团点评公司研发的一款监控系统，目前已经开源并得到了广泛的应用。

Cat 通过采集系统的各种指标数据，如 CPU、内存、网络、磁盘等，进行实时监控和分析，帮助开发人员快速定位和解决系统问题。同时，它还提供了一些常用的监控功能，如告警、统计、日志分析等，方便开发人员进行系统监控和分析。

数据类型¶

数据传输协议：

• plaintext : 纯文本模式， DataKit 目前暂时不支持。
• native ： 以特定符号为分隔符的文本形式，目前 DataKit 已经支持。

数据分类：

客户端的启动模式¶

• 启动 cat server 模式

  • 数据全在 DataKit 中，cat 的 web 页面已经没有数据，所以启动的意义不大，并且页面报错： 出问题 CAT 的服务端[xxx.xxx]
  • 配置客户端行为可以在 client 的启动中做
  • cat server 也会将 transaction 数据发送到 dk，造成观测云页面大量的垃圾数据

• 不启动 cat server： 在 DataKit 中配置

  • startTransactionTypes：用于定义自定义事务类型，指定的事务类型会被 Cat 自动创建。多个事务类型之间使用分号进行分隔。
  • block：指定一个阈值用于阻塞监控，单位为毫秒。当某个事务的执行时间大于该阈值时，会触发 Cat 记录该事务的阻塞情况。
  • routers：指定 Cat 服务端的地址和端口号，多个服务器地址和端口号之间使用分号进行分隔。Cat 会自动将数据发送到这些服务器上，以保证数据的可靠性和容灾性。
  • sample：指定采样率，即只有一部分数据会被发送到 Cat 服务器。取值范围为 0 到 1，其中 1 表示全部数据都会被发送到 Cat 服务器，0 表示不发送任何数据。
  • matchTransactionTypes：用于定义自定义事务类型的匹配规则，通常用于 Api 服务监控中，指定需要监控哪些接口的性能。

所以： 不建议去开启一个 cat_home（cat server） 服务。相应的配置可以在 client.xml 中配置，请看下文。

配置¶

客户端配置¶

<?xml version="1.0" encoding="utf-8"?>
<config mode="client">
    <servers>
        <!-- datakit ip, cat port , http port -->
        <server ip="10.200.6.16" port="2280" http-port="9529"/>
    </servers>
</config>

注意：配置中的 9529 端口是 DataKit 的 http 端口。2280 是 cat 采集器开通的 2280 端口。

采集器配置¶

[[inputs.cat]]
  ## tcp port
  tcp_port = "2280"

  ##native or plaintext, datakit only support native(NT1) !!!
  decode = "native"

  ## This is default cat-client Kvs configs.
  startTransactionTypes = "Cache.;Squirrel."
  MatchTransactionTypes = "SQL"
  block = "false"
  routers = "127.0.0.1:2280;"
  sample = "1.0"

  ## global tags.
  # [inputs.cat.tags]
    # key1 = "value1"
    # key2 = "value2"
    # ...

配置文件注意的地方：

1. startTransactionTypes MatchTransactionTypes block routers sample 是返回给 client 端的数据
2. routers 是 DataKit 的 ip 或者域名
3. tcp_port 对应的是 client 端配置 servers ip 地址

Tracing¶

cat¶

Following is tags/fields of tracing data

Metric¶

Metric cat¶

CAT heartbeat runtime, operating system, disk, memory, and thread metrics emitted from application heartbeat XML payloads.