官网解析:
在生产环境中使用 Sentinel
监控
Sentinel 会记录资源访问的秒级数据(若没有访问则不进行记录)并保存在本地日志中,具体格式请见 秒级监控日志文档。Sentinel 控制台可以通过 Sentinel 客户端预留的 HTTP API 从秒级监控日志中拉取监控数据,并进行聚合。
目前 Sentinel 控制台中监控数据聚合后直接存在内存中,未进行持久化,且仅保留最近 5 分钟的监控数据。若需要监控数据持久化的功能,可以自行扩展实现 MetricsRepository 接口(0.2.0 版本),然后注册成 Spring Bean 并在相应位置通过 @Qualifier 注解指定对应的 bean name 即可。MetricsRepository 接口定义了以下功能:
-
save 与 saveAll:存储对应的监控数据
-
queryByAppAndResourceBetween:查询某段时间内的某个应用的某个资源的监控数据
-
listResourcesOfApp:查询某个应用下的所有资源
其中默认的监控数据类型为 MetricEntity,包含应用名称、时间戳、资源名称、异常数、请求通过数、请求拒绝数、平均响应时间等信息。对于监控数据的存储,用户需要根据自己的存储精度,来考虑如何存储这些监控数据。部署多个控制台实例时,通常需要仔细设计下监控拉取和写入策略。
同时用户可以自行进行扩展,适配 Grafana 等可视化平台,以便将监控数据更好地进行可视化。
以上为官方解析,现在我们来进行操作。
引入依赖
找到实时监控进行保存和查询的类,具体目录为:/sentinel-dashboard/src/main/java/com/alibaba/csp/sentinel/dashboard/repository/metric/InMemoryMetricsRepository。
熟悉基本逻辑之后,我们开始写将数据持久化到InfluxDB的操作。
引入依赖:
<dependency>
<groupId>org.influxdb</groupId>
<artifactId>influxdb-java</artifactId>
<version>2.15</version>
</dependency>
数据库链接
需要在本地或者是测试环境搭建influxdb数据库,具体见上一个博客。然后开始和数据库建立链接
package com.alibaba.csp.sentinel.dashboard.repository.metric.InfluxDB;
import org.influxdb.InfluxDB;
import org.influxdb.InfluxDBFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.concurrent.TimeUnit;
@Configuration
public class InfluxDBConfig {
@Value("${spring.influx.url:''}")
private String influxDBUrl;
@Value("${spring.influx.user:''}")
private String userName;
@Value("${spring.influx.password:''}")
private String password;
@Value("${spring.influx.database:''}")
private String database;
@Bean
public InfluxDB influxDB(){
InfluxDB influxDB = InfluxDBFactory.connect(influxDBUrl, userName, password);
try {
/**
* 异步插入:
* enableBatch这里第一个是point的个数,第二个是时间,单位毫秒
* point的个数和时间是联合使用的,如果满100条或者2000毫秒
* 满足任何一个条件就会发送一次写的请求。
*/
influxDB.setDatabase(database)
.enableBatch(100,2000, TimeUnit.MILLISECONDS);
} catch (Exception e) {
e.printStackTrace();
} finally {
influxDB.setRetentionPolicy("autogen");
}
influxDB.setLogLevel(InfluxDB.LogLevel.BASIC);
return influxDB;
}
}
建立实体类
package com.alibaba.csp.sentinel.dashboard.repository.metric.InfluxDB;
import org.influxdb.annotation.Column;
import org.influxdb.annotation.Measurement;
import java.time.Instant;
@Measurement(name = "sentinelInfo")
public class InfluxDBMetricEntity {
@Column(name = "time")
private Instant time;
@Column(name = "gmtCreate")
private Long gmtCreate;
@Column(name = "gmtModified")
private Long gmtModified;
/**
* 监控信息的时间戳
*/
@Column(name = "app", tag = true)
private String app;
@Column(name = "resource", tag = true)
private String resource;
@Column(name = "timestamp")
private Long timestamp;
@Column(name = "passQps")
private Long passQps;//通过qps
@Column(name = "successQps")
private Long successQps;//成功qps
@Column(name = "blockQps")
private Long blockQps;//限流qps
@Column(name = "exceptionQps")
private Long exceptionQps;//异常qps
/**
* 所有successQps的rt的和
*/
@Column(name = "rt")
private double rt;
/**
* 本次聚合的总条数
*/
@Column(name = "count")
private int count;
@Column(name = "resourceCode")
private int resourceCode;
public static InfluxDBMetricEntity copyOf(InfluxDBMetricEntity oldEntity) {
InfluxDBMetricEntity entity = new InfluxDBMetricEntity();
entity.setApp(oldEntity.getApp());
entity.setGmtCreate(oldEntity.getGmtCreate());
entity.setGmtModified(oldEntity.getGmtModified());
entity.setTimestamp(oldEntity.getTimestamp());
entity.setResource(oldEntity.getResource());
entity.setPassQps(oldEntity.getPassQps());
entity.setBlockQps(oldEntity.getBlockQps());
entity.setSuccessQps(oldEntity.getSuccessQps());
entity.setExceptionQps(oldEntity.getExceptionQps());
entity.setRt(oldEntity.getRt());
entity.setCount(oldEntity.getCount());
entity.setResource(oldEntity.getResource());
return entity;
}
public synchronized void addPassQps(Long passQps) {
this.passQps += passQps;
}
public synchronized void addBlockQps(Long blockQps) {
this.blockQps += blockQps;
}
public synchronized void addExceptionQps(Long exceptionQps) {
this.exceptionQps += exceptionQps;
}
public synchronized void addCount(int count) {
this.count += count;
}
public synchronized void addRtAndSuccessQps(double avgRt, Long successQps) {
this.rt += avgRt * successQps;
this.successQps += successQps;
}
/**
* {@link #rt} = {@code avgRt * successQps}
*
* @param avgRt average rt of {@code successQps}
* @param successQps
*/
public synchronized void setRtAndSuccessQps(double avgRt, Long successQps) {
this.rt = avgRt * successQps;
this.successQps = successQps;
}
public Long getGmtCreate() {
return gmtCreate;
}
public void setGmtCreate(Long gmtCreate) {
this.gmtCreate = gmtCreate;
}
public Long getGmtModified() {
return gmtModified;
}
public void setGmtModified(Long gmtModified) {
this.gmtModified = gmtModified;
}
public Long getTimestamp() {
return timestamp;
}
public void setTimestamp(Long timestamp) {
this.timestamp = timestamp;
}
public String getResource() {
return resource;
}
public void setResource(String resource) {
this.resource = resource;
this.resourceCode = resource.hashCode();
}
public Long getPassQps() {
return passQps;
}
public void setPassQps(Long passQps) {
this.passQps = passQps;
}
public Long getBlockQps() {
return blockQps;
}
public void setBlockQps(Long blockQps) {
this.blockQps = blockQps;
}
public Long getExceptionQps() {
return exceptionQps;
}
public void setExceptionQps(Long exceptionQps) {
this.exceptionQps = exceptionQps;
}
public double getRt() {
return rt;
}
public void setRt(double rt) {
this.rt = rt;
}
public int getCount() {
return count;
}
public void setCount(int count) {
this.count = count;
}
public int getResourceCode() {
return resourceCode;
}
public Long getSuccessQps() {
return successQps;
}
public void setSuccessQps(Long successQps) {
this.successQps = successQps;
}
public Instant getTime() {
return time;
}
public void setTime(Instant time) {
this.time = time;
}
public String getApp() {
return app;
}
public void setApp(String app) {
this.app = app;
}
@Override
public String toString() {
return "InfluxdbMetricEntity{" +
", gmtCreate=" + gmtCreate +
", gmtModified=" + gmtModified +
", timestamp=" + timestamp +
", resource='" + resource + '\'' +
", passQps=" + passQps +
", blockQps=" + blockQps +
", successQps=" + successQps +
", exceptionQps=" + exceptionQps +
", rt=" + rt +
", count=" + count +
", resourceCode=" + resourceCode +
'}';
}
}
持久化代码
直接将InMemoryMetricsRepository复制一份,更改名字为InfluxDBMetricsRepository,然后将保存和查询内存的代码更改为数据库即可。
package com.alibaba.csp.sentinel.dashboard.repository.metric.InfluxDB;
import com.alibaba.csp.sentinel.dashboard.datasource.entity.MetricEntity;
import com.alibaba.csp.sentinel.dashboard.repository.metric.MetricsRepository;
import com.alibaba.csp.sentinel.util.StringUtil;
import com.alibaba.nacos.client.naming.utils.CollectionUtils;
import org.influxdb.InfluxDB;
import org.influxdb.dto.BatchPoints;
import org.influxdb.dto.Point;
import org.influxdb.dto.Query;
import org.influxdb.dto.QueryResult;
import org.influxdb.impl.InfluxDBResultMapper;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.util.*;
import java.util.concurrent.TimeUnit;
import java.util.stream.Collectors;
@Component("influxDBMetricsRepository")
public class InfluxDBMetricsRepository implements MetricsRepository<MetricEntity> {
@Autowired
public InfluxDB influxDB;
@Override
public synchronized void save(MetricEntity metric) {
#这里我直接建立2张表,因为后期做图表用的grafana,需要用这2张表sentinelInfo和sentinel_app
try {
Point point = Point
.measurement("sentinelInfo")
.time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
.tag("app",metric.getApp())//tag 数据走索引
.tag("resource",metric.getResource())//tag 数据走索引
.addField("gmtCreate", metric.getGmtCreate().getTime())
.addField("gmtModified", metric.getGmtModified().getTime())
.addField("timestamp", metric.getTimestamp().getTime())
.addField("passQps", metric.getPassQps())
.addField("successQps", metric.getSuccessQps())
.addField("blockQps", metric.getBlockQps())
.addField("exceptionQps", metric.getExceptionQps())
.addField("rt", metric.getRt())
.addField("count", metric.getCount())
.addField("resourceCode", metric.getResourceCode())
.build();
influxDB.write(point);
//在grafana中查询app列表中,设置成tag不能使用distinct
Point point1=Point.measurement("sentinel_app")
.time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
.addField("app",metric.getApp())
.addField("resource",metric.getResource()).build();
influxDB.write(point1);
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public synchronized void saveAll(Iterable<MetricEntity> metrics) {
if (metrics == null) {
return;
}
BatchPoints batchPoints = BatchPoints.builder()
.tag("async", "true")
.consistency(InfluxDB.ConsistencyLevel.ALL)
.build();
BatchPoints batchPoint1s = BatchPoints.builder()
.tag("async", "true")
.consistency(InfluxDB.ConsistencyLevel.ALL)
.build();
metrics.forEach(metric->{
Point point = Point
.measurement("sentinelInfo")
.time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
.tag("app",metric.getApp())//tag 数据走索引
.tag("resource",metric.getResource())//tag 数据走索引
.addField("gmtCreate", metric.getGmtCreate().getTime())
.addField("gmtModified", metric.getGmtModified().getTime())
.addField("timestamp", metric.getTimestamp().getTime())
.addField("passQps", metric.getPassQps())
.addField("successQps", metric.getSuccessQps())
.addField("blockQps", metric.getBlockQps())
.addField("exceptionQps", metric.getExceptionQps())
.addField("rt", metric.getRt())
.addField("count", metric.getCount())
.addField("resourceCode", metric.getResourceCode())
.build();
batchPoints.point(point);
//在grafana中查询app列表中,设置成tag不能使用distinct
Point point1=Point.measurement("sentinel_app")
.time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
.addField("app",metric.getApp())
.addField("resource",metric.getResource()).build();
batchPoints.point(point1);
});
influxDB.write(batchPoints);
influxDB.write(batchPoint1s);
}
@Override
public synchronized List<MetricEntity> queryByAppAndResourceBetween(String app, String resource, long startTime, long endTime) {
List<MetricEntity> results = new ArrayList<>();
if (StringUtil.isBlank(app)) {
return results;
}
String command = "SELECT * FROM sentinelInfo WHERE app='"+app+"' AND resource = '"+resource+"' AND gmtCreate>"+startTime+" AND gmtCreate<"+endTime;
Query query = new Query(command);
QueryResult queryResult = influxDB.query(query);
InfluxDBResultMapper resultMapper = new InfluxDBResultMapper(); // thread-safe - can be reused
List<InfluxDBMetricEntity> influxResults = resultMapper.toPOJO(queryResult, InfluxDBMetricEntity.class);
try {
influxResults.forEach(entity->{
MetricEntity metric = new MetricEntity();
BeanUtils.copyProperties(entity,metric);
metric.setTimestamp(new Date(entity.getTimestamp()));
metric.setGmtCreate(new Date(entity.getGmtCreate()));
metric.setGmtModified(new Date(entity.getGmtModified()));
results.add(metric);
});
} catch (Exception e) {
e.printStackTrace();
}
return results;
}
@Override
public synchronized List<String> listResourcesOfApp(String app) {
List<String> results = new ArrayList<>();
if (StringUtil.isBlank(app)) {
return results;
}
//最近一分钟的指标(实时数据)
final long minTimeMs = System.currentTimeMillis() - 1000 * 60;
String command = "SELECT * FROM sentinelInfo WHERE app='"+app+"' AND gmtCreate>"+minTimeMs;
Query query = new Query(command);
QueryResult queryResult = influxDB.query(query);
InfluxDBResultMapper resultMapper = new InfluxDBResultMapper(); // thread-safe - can be reused
List<InfluxDBMetricEntity> influxResults = resultMapper.toPOJO(queryResult, InfluxDBMetricEntity.class);
try {
if (CollectionUtils.isEmpty(influxResults)) {
return results;
}
Map<String, InfluxDBMetricEntity> resourceCount = new HashMap<>(32);
for (InfluxDBMetricEntity metricEntity : influxResults) {
String resource = metricEntity.getResource();
if (resourceCount.containsKey(resource)) {
InfluxDBMetricEntity oldEntity = resourceCount.get(resource);
oldEntity.addPassQps(metricEntity.getPassQps());
oldEntity.addRtAndSuccessQps(metricEntity.getRt(), metricEntity.getSuccessQps());
oldEntity.addBlockQps(metricEntity.getBlockQps());
oldEntity.addExceptionQps(metricEntity.getExceptionQps());
oldEntity.addCount(1);
} else {
resourceCount.put(resource, InfluxDBMetricEntity.copyOf(metricEntity));
}
}
//排序
results = resourceCount.entrySet()
.stream()
.sorted((o1, o2) -> {
InfluxDBMetricEntity e1 = o1.getValue();
InfluxDBMetricEntity e2 = o2.getValue();
int t = e2.getBlockQps().compareTo(e1.getBlockQps());
if (t != 0) {
return t;
}
return e2.getPassQps().compareTo(e1.getPassQps());
})
.map(Map.Entry::getKey)
.collect(Collectors.toList());
} catch (Exception e) {
e.printStackTrace();
}
return results;
}
}
还需要在配置文件中加入influxDB的用户名和密码等信息
spring.influx.url=http://127.0.0.1:8086
spring.influx.user=admin
spring.influx.password=admin
spring.influx.database=sentinel_log
要注册成 Spring Bean 并在相应位置通过 @Qualifier 注解指定对应的 bean name 。所以还需要修改2个注入的bean name
修改注入的具体baen name
以上就是全部的过程,当然了,我们可以对进行根据实际的需要进行再优化。