复古 护眼 海天 深邃 暗黑 默认

可观察性

Agent

源码编译

从 Github 下载 Apache ShardingSphere 源码,对源码进行编译,操作命令如下。

git clone --depth 1 https://github.com/apache/shardingsphere.git
cd shardingsphere
mvn clean install -Dmaven.javadoc.skip=true -Dcheckstyle.skip=true -Drat.skip=true -Djacoco.skip=true -DskipITs -DskipTests -Prelease

agent 包输出目录为 distribution/agent/target/apache-shardingsphere-${latest.release.version}-shardingsphere-agent-bin.tar.gz

目录说明

创建 agent 目录,解压 agent 二进制包到 agent 目录。

mkdir agent
tar -zxvf apache-shardingsphere-${latest.release.version}-shardingsphere-agent-bin.tar.gz -C agent
cd agent
tree 
├── LICENSE
├── NOTICE
├── conf
│   └── agent.yaml
├── plugins
│   ├── lib
│   │   ├── shardingsphere-agent-metrics-core-${latest.release.version}.jar
│   │   └── shardingsphere-agent-plugin-core-${latest.release.version}.jar
│   ├── logging
│   │   └── shardingsphere-agent-logging-file-${latest.release.version}.jar
│   ├── metrics
│   │   └── shardingsphere-agent-metrics-prometheus-${latest.release.version}.jar
│   └── tracing
│       ├── shardingsphere-agent-tracing-opentelemetry-${latest.release.version}.jar
│       └── shardingsphere-agent-tracing-opentracing-${latest.release.version}.jar
└── shardingsphere-agent-${latest.release.version}.jar

Agent 日志输出位置在 agent/logs/stdout.log

配置说明

conf/agent.yaml 用于管理 agent 配置。内置插件包括 File、Prometheus、OpenTelemetry、OpenTracing。

plugins:
#  logging:
#    File:
#      props:
#        level: "INFO"
#  metrics:
#    Prometheus:
#      host:  "localhost"
#      port: 9090
#      props:
#        jvm-information-collector-enabled: "true"
#  tracing:
#    OpenTelemetry:
#      props:
#        otel.service.name: "shardingsphere"
#        otel.traces.exporter: "jaeger"
#        otel.exporter.otlp.traces.endpoint: "http://localhost:14250"
#        otel.traces.sampler: "always_on"
#    OpenTracing:
#      props:
#        opentracing-tracer-class-name: "org.apache.skywalking.apm.toolkit.opentracing.SkywalkingTracer"

插件说明

File

目前 File 插件只有构建元数据耗时日志输出,暂无其他日志输出。

Prometheus

用于暴露监控指标

  • 参数说明
名称 说明
host 主机
port 端口
jvm-information-collector-enabled 是否采集 JVM 指标信息

OpenTelemetry

OpenTelemetry 可以导出 tracing 数据到 Jaeger,Zipkin。

  • 参数说明
名称 说明
otel.service.name 服务名称
otel.traces.exporter traces exporter
otel.exporter.otlp.traces.endpoint traces endpoint
otel.traces.sampler traces sampler

参数参考 OpenTelemetry SDK Autoconfigure

ShardingSphere-JDBC 使用

  • 1 准备好已集成 ShardingSphere-JDBCSpringBoot 项目,test-project.jar
  • 2 启动项目
java -javaagent:/agent/shardingsphere-agent-${latest.release.version}.jar -jar test-project.jar
  • 3 访问启动的服务
  • 4 查看对应的插件是否生效

Metrics

指标名称 指标类型 指标描述
build_info GAUGE 构建信息
parsed_sql_total COUNTER 按类型(INSERT、UPDATE、DELETE、SELECT、DDL、DCL、DAL、TCL、RQL、RDL、RAL、RUL)分类的解析总数
routed_sql_total COUNTER 按类型(INSERT、UPDATE、DELETE、SELECT)分类的路由总数
routed_result_total COUNTER 路由结果总数(数据源路由结果、表路由结果)
jdbc_state GAUGE ShardingSphere-JDBC 状态信息。0 表示正常状态;1 表示熔断状态;2 锁定状态
jdbc_meta_data_info GAUGE ShardingSphere-JDBC 元数据信息
jdbc_statement_execute_total COUNTER 语句执行总数
jdbc_statement_execute_errors_total COUNTER 语句执行错误总数
jdbc_statement_execute_latency_millis HISTOGRAM 语句执行耗时
jdbc_transactions_total COUNTER 事务总数,按 commit,rollback 分类