点评 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 端口。

采集器配置¶

进入 DataKit 安装目录下的 `conf.d/cat` 目录，复制 `cat.conf.sample` 并命名为 `cat.conf`。示例如下：

```toml

[[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"
    # ...


```

配置好后，[重启 DataKit](datakit-service-how-to.md#manage-service) 即可。

配置文件注意的地方：

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

观测云链路和指标¶

观测云链路¶

登录观测云，点击 应用性能检测 -> 链路 查看链路详情。

观测云指标¶

先下载仪表板

在观测云，点击 场景 -> 仪表板 -> 新建仪表板。 导入下载好的 JSON 文件即可。

效果展示：

数据字段说明¶

指标类型¶

• 指标的标签

• 指标列表

链路字段说明¶

• 标签（String 类型）

• 指标列表（非 String 类型，或者长 String 类型）