网站建设需求方案,广州软件网站开发,郑州男科医院排名最好的医院,软件开发需要什么技术介绍
Alloy是Grafana产品公司旗下的一款新主推遥测数据采集工具#xff0c;Grafana Alloy也是一个开源OpenTelemetry收集器#xff0c;具有内置 Prometheus管道并支持指标、日志、跟踪和配置文件。Alloy支持为OTEL、Prometheus、Pyroscope、Loki等服务提供许多指标、日志、跟…介绍
Alloy是Grafana产品公司旗下的一款新主推遥测数据采集工具Grafana Alloy也是一个开源OpenTelemetry收集器具有内置 Prometheus管道并支持指标、日志、跟踪和配置文件。Alloy支持为OTEL、Prometheus、Pyroscope、Loki等服务提供许多指标、日志、跟踪等原生数据管道以及数据采集功能。Alloy在Grafana产品生态中用于替代Promital、Agent两个采集程序Alloy提供了强大和灵活的模块组件配置功能支持远比原Agent工具更多的数据格式处理功能和更多样的采集来源端、多平台数据转换能力并且支持自定义配置组件、数据过滤、数据管道转发、本地配置、云端配置等官方声明Alloy对更多平台协议数据兼容性更好、安全性和数据配置调试能力更强 注推出Alloy的同时官方也声明不在维护Grafana Agent现有程序后续Grafana Agent已被弃用并将会持续到2025年10月31日为止在2025年11月1日终止使用EOL官方建议迁移到Grafana Alloy因此还在用Grafana Agent的同学也因该尽快迁移到Grafana Alloy采集工具上
官网
官网Grafana Alloy | OpenTelemetry Collector distribution
文档Grafana Alloy | Grafana Alloy documentation
下载
从Github获取已打包的二进制文件支持linux、mac、windows等操作系统按操作系统环境下载即可。
Github发包路径https://github.com/grafana/alloy/releases/tag/v1.4.3 环境说明
为了方便演示本地以windows环境为主因此下载使用alloy-windows-amd64.exe.zip解压包实际windows与linux环境使用配置文件一样可以直接将本地调试好的yml配置文件复制到linux环境下使用
安装Alloy
Alloy需要安装在应用服务所在主机上才能进行抓取下载alloy-windows-amd64.exe.zip解压包后解压到任意目录非中文在alloy-windows-amd64.exe程序同目录下创建config.alloy文件此为启动加载配置文件
Alloy命令启动配置
// 公开或私用组件指标模式默认--stability.levelgenerally-available
alloy-windows-amd64.exe run config.alloy --stability.levelpublic-preview // 实验性模式
alloy-windows-amd64.exe run config.alloy --stability.levelexperimental // linux后台启动
//nohup ./alloy-linux-amd64 run config.alloy log.out 21
需要注意的是--stability.level表示当前启动稳定模式experimental表示开放实验性功能即一些未成熟的可用功能生产不推荐用于配置调试用public-preview表示开放公共可预览特性等功能generally-available表示已经成熟普遍可用的功能默认生产环境因用此配置;
更多详情配置参考官方The run command | Grafana Alloy documentation
关于性能消耗
官方相关资源采集过程中性能消耗说明参考Estimate Grafana Alloy resource usage | Grafana Alloy documentation
Alloy基础配置
采集日志到Loki
// 收集日志
local.file_match default {path_targets [{__path__ /data/log/info-*.log,service systemName,}]
}// 记录采集位置
loki.source.file default {targets local.file_match.default.targetsforward_to [loki.write.default.receiver]
}// 日志发送loki
loki.write default {endpoint {url http://127.0.0.1:3100/loki/api/v1/push}
}
组件说明
local.file_match 本地文件加载路径与K/V类型自定义标签配置path_targets为数组支持多个路径配置__path__支持通配符用法如__path__ /data/log/info-*.log加载以info为前缀的适配log文件loki.source.file从来源目标提取文件日志数据并分发给目标组件loki.write推送日志到Loki服务目标
采集指标到Prometheus
Alloy本身提供了多种平台与服务的指标抓取、处理、分发能力并通过prometheus进行远端收集与分析如kafka、oracle、mysql、postgres、redis、windows、unix等内置功能支持直接配置采集端点即可使用简化了安装各种端点组件来使用使部署与实施变得更容易
// 收集alloy指标
prometheus.exporter.self defalut { }// 收集windows host指标
prometheus.exporter.windows defalut { enabled_collectors [cpu,cs,logical_disk,net,os,service,system]
}// 抓取目标组件指标
prometheus.scrape defalut {targets array.concat(prometheus.exporter.self.defalut.targets, prometheus.exporter.windows.defalut.targets)forward_to [prometheus.remote_write.default.receiver]job_name alloy_otel
}// 指标发送
prometheus.remote_write default {endpoint {url http://127.0.0.1:9090/api/v1/write}
}
组件说明
prometheus.exporter.self 收集alloy自身指标prometheus.exporter.windows收集windows 主机运行指标已启用的采集指标参见enabled_collectors非启用指标名则不采集prometheus.scrape抓取目标组件指标数据并将数据分发给目标组件prometheus.remote_write将指标数据推送给prometheus远程服务
Alloy支持的promethues指标组件如下prometheus | Grafana Alloy documentation
集OTEL协议数据
OTEL开放式遥测是一种用于收集、处理和可视化软件性能和信任度数据的标准和框架,与供应商和工具无关这意味着它可以与各种各样的可观察性后端一起使用。
Alloy支持多种平台和服务的OTEL数据收集、处理、分发如otelhttp、awss3、kafka、loki、prometheus、datadog、zipkin等;
// 接收otel协议转发数据
otelcol.receiver.otlp default {http {}grpc {endpoint 0.0.0.0:4317}output {metrics [otelcol.processor.batch.default.input]logs [otelcol.processor.batch.default.input]traces [otelcol.processor.batch.default.input]}
}
// 批量收集发送用于本地缓冲数据
otelcol.processor.batch default {output {metrics [otelcol.exporter.otlp.default.input]logs [otelcol.exporter.otlp.default.input]traces [otelcol.exporter.otlp.default.input]}
}
// 通过gRPC发送otlp数据
otelcol.exporter.otlp default {client {endpoint 192.168.1.100:4317tls { insecure true}}
}
组件说明
otelcol.receiver.otlp接收otel协议转发数据otelcol.processor.batch 批量收集发送用于本地缓冲数据从而降低数据传输次数提高数据压缩率控制每批数据大小和处理时间提升性能otelcol.exporter.otlp通过gRPC发送otlp数据到目标OTEL接收服务端
OpenTelemetry代理
OpenTelemetry是API、SDK 和工具的集合。使用它来检测、生成、收集和导出遥测数据指标、日志和跟踪以帮助您分析软件的性能和行为。
因此本章演示项目中同样依赖opentelemetry-sdk在程序的JVM启动命令中加入opentelemetry-javaagent代理jar包从而抓取otel协议数据指标、日志、链路推送到endpoint目标服务Collector收集端。
opentelemetry-javaagent.jar从github上下载GitHub - open-telemetry/opentelemetry-java-instrumentation: OpenTelemetry auto-instrumentation and instrumentation libraries for Java
相关JVM参数配置详见官方文档Configure the SDK | OpenTelemetry
注上述示例指向的是本地Alloy采集服务代理端口Alloy支持otel协议数据接收与管道转发功能
SpringBoot全链路追踪
搭建日志链接路平台
由于之前文章中已讲解搭建过《Grafana,Loki,Tempo,Prometheus,Agent搭建日志链路监控平台》本章不在重复搭建过程可点击此访问Grafana,Loki,Tempo,Prometheus,Agent搭建日志链路监控平台_grafana tempo-CSDN博客
略....
SpringBoot项目搭建
同样之前文章中讲解过《SpringBootPrometheus采集Metrics指标数据》该章中的springboot项目做为本章应用程序演示示例可点击此访问SpringBootPrometheus采集Metrics指标数据_prometheus metrics-CSDN博客
注安装Prometheus后无需在配置文件中配置采集springboot的端点参数本章将通过Alloy去分发推送springboot指标数据到Prometheus中
略...
IDEA中配置opentelemetry代理
在右上角 Select Run/Debug Configurations》Edit Configurations》找到对应用主程序入口类 在VM options中填入如下参数
-javaagent:D:\\test\\opentelemetry-javaagent.jar
-Dotel.service.nameotel_test
-Dotel.exporter.otlp.endpointhttp://localhost:4317
-Dotel.traces.exporterotlp
-Dotel.metrics.exporterotlp
-Dotel.logs.exporternone
-Dotel.metric.export.interval30000
-Dotel.exporter.otlp.insecuretrue
注其它-Dotel.logs.exporternone 表示log日志不走otel协议推送因为日志一般会输出到日志文件中从文件中加载日志能记录整个应用程序的启动过程而otel需要在应用服务启动中并且agent代理生效后才能正常抓取otel协议日志数据因此会有部份缺失通过Alloy直接抓取本地日志文件内容能保证日志数据的全生命周期流程完整性
配置SpringBoot项目日志格式输出traceID%X{trace_id}到log文件中通常在logack.xml或log4j2.xml中配置如果没有独立设置日志配置文件或修改springboot本身的application.yml中loggin.pattern.file配置如下
%d{yyyy-MM-dd HH:mm:ss.SSS} %level traceID%X{trace_id} %thread %class{36}:%L - %m%n%wEx
配置springboot监控指标
在pom.xml中添加prometheus指标监控添加springboot端点指标与健康检查模块
dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-actuator/artifactId
/dependency
!-- prometheus依赖 --
dependencygroupIdio.micrometer/groupIdartifactIdmicrometer-registry-prometheus/artifactIdversion1.11.0/version
/dependency
在application.yml添加以下健康服务检测功能以及开放端点
# 启用服务健康检测注册中心将通过http://host:port/actuator/health 检测服务的存活默认10s一次
management:
# server:
# address: 127.0.0.1
# port: 8081endpoints:web:cors:# 跨域配置开放所有CORS默认处于禁用状态allowed-origins: *allowed-methods: *discovery:# 启用一个接口可以返回所有端点信息enabled: trueexposure:include:# 开放所有端点healthinfometrics通过actuator/端点名就可以获取相应的信息。开发用*上生产请取消。默认打开health和info- *# 某些端点除外不做开启exclude:- env- beans- info- configprops- health- heapdump- shutdown- threaddump- loggers- conditionsendpoint:shutdown:enabled: truehealth:# 开启后打印详细信息show-details: always
启动Springboot服务
完成上述流程后在IDEA中启动SpringBoot服务
略...
配置Alloy组件
在Alloy安装目录中修改配置完整的config.alloy配置如下 // Otel配置
// 接收otel协议转发数据
otelcol.receiver.otlp default {http {}grpc {endpoint 0.0.0.0:4317}output {//logs 通过 loki.source.file 采集metrics [otelcol.exporter.prometheus.default.input]traces [otelcol.exporter.otlp.tempo_default.input, otelcol.connector.spanlogs.default.input, otelcol.connector.servicegraph.default.input,]}
}
// 从otel中输出日志loki
otelcol.exporter.loki default {forward_to [loki.write.default.receiver]
}
// 通过gRPC发送otlp链路数据到tempo服务
otelcol.exporter.otlp tempo_default {client {endpoint 192.168.1.100:4317tls { insecure true insecure_skip_verify true}}
}
// 从otel中输出指标数据到prometheus
otelcol.exporter.prometheus default {forward_to [prometheus.remote_write.default.receiver]
}// Loki配置
// 读取指定路径日志文件和配置标签
local.file_match default {path_targets [{__path__ D:/Workspaces/idea_2/TraceCloud/logs/producer-info.log,service_name producer-log-197,system producer,}]
}
// 记录采集位置
loki.source.file default {encoding UTF-8targets local.file_match.default.targetsforward_to [loki.write.default.receiver]
}
// 日志发送loki
loki.write default {endpoint {url http://192.168.1.100:3100/loki/api/v1/push}
}// Span日志记录配置
otelcol.connector.spanlogs default {roots truespan_attributes [http.method, http.target]output {logs [otelcol.exporter.loki.default.input]}
}// 服务图配置
otelcol.connector.servicegraph default {dimensions [http.method, http.target]output {metrics [otelcol.exporter.prometheus.default.input]}
}// Prometheus配置
// 收集alloy指标
prometheus.exporter.self defalut { }
// 收集windows host指标
prometheus.exporter.windows defalut { enabled_collectors [cpu,cs,logical_disk,net,os,service,system]
}
// 指标抓取
prometheus.scrape defalut {targets array.concat(prometheus.exporter.self.defalut.targets, prometheus.exporter.windows.defalut.targets)forward_to [prometheus.remote_write.default.receiver]job_name producer_node
}
// 抓取远程服务指标
prometheus.scrape remote_default {targets [{__address__ localhost:8082}]scheme httpmetrics_path /actuator/prometheusscrape_interval 30sscrape_timeout 10sjob_name producer_samples forward_to [prometheus.remote_write.default.receiver]
}
// 指标发送
prometheus.remote_write default {endpoint {name producerurl http://192.168.1.100:9090/api/v1/write}
}运行Alloy
在通过windows系统的CMD命令行窗口进入到安装目录以本地实际安装目录为准cd D:\test\alloy-windows-amd64
D:\test\alloy-windows-amd64 ./alloy-windows-amd64.exe run ./config.alloy
服务拓扑图
App在运行中产生各种日志、指标、otel数据等通过Agent推送到Alloy或Alloy主动抓取数据最后在本地Alloy处理后根据不同能力的收集服务分发推送到服务端进行存储统一在Grafana端进行应用展示 服务接口测试
SpringBoot健康检查
http://localhost:8082/actuator Prometheus端口数据
http://localhost:8082/actuator/prometheus HTTP测试接口
http://localhost:8082/api/producer 注意本地示例服务启用的8082端口 Loki日志与Tempo链路
向springboot服务发起http请求后后端服务会打印日志并输出到日志文件中opentelemetry-javaagent.jar代理通过探针技术抓取springboot运行过程中的数据、跨度、指标等通过otel协议推送到指定Alloy采集端进行处理并分发到Loki和Tempo中以下是通过Loki查询出打印日志数据通过输出日志行中的所带的TraceID跟踪埋点ID点击关联上Tempo查询该TraceId全链接执行过程展示分析出的每一步耗时与跨度信息等 Dashboards图表展示
通过Alloy抓取各类指标、日志、链路等遥测数据后推送到相关服务后可以很方便的在Grafana已集成的环境中进行分析与展示官方也提供了很多共享Dashboards图表资源可直接导入到本地环境中进行使用
共享Dashboards网址Grafana dashboards | Grafana Labs
JVM指标监控
通过Otel协议获取JVM指标数据后发送到Alloy进行接收并推送到Prometheus中进行存储通过图表进行展示
图表来源于官方共享DashboardsID4071 (JVM (Micrometer))
共享Dashboards网址Grafana dashboards | Grafana Labs Windows主机资源监控图表
通过Alloy抓取windows主机上的指标数据推送到Prometheus中进行存储通过图表进行展示
图表来源于官方共享DashboardsID12422 (Windows Node (fixed for v0.13.0)) SpringBoot监控资源图表
通过Alloy抓取主动抓取SpringBoot上的/actuator/prometheus端点数据推送到Prometheus中进行存储
图表来源于官方共享DashboardsID12900 (SpringBoot APM Dashboard) 总结
Alloy 非常灵活你可以轻松配置它以满足您在本地、仅限云端或两者混合的需求。Alloy 使用 120 多个组件从应用程序、数据库和 OpenTelemetry 收集器收集遥测数据并且 Alloy还支持创建和共享自定义组件。Alloy支持使用多个生态系统进行收集包括 OpenTelemetry 和 Prometheus。遥测数据可以推送至Alloy,或者Alloy可以从您的数据源中提取数据。
虽然Alloy作为一款开源产品推向市场的时间比较新但官方计划约每6周发布一个新或小版本因此做为Grafana Agent替换工具也是后续Grafana生态系例中主力采集终端工具相信会投入更多的资源去完善Alloy使用问题与增加更多Alloy功能对于开发者来说多一个更强大开源全链路遥测数据采集工具是一种新的体验和选择学习撑握Alloy后也是增加自身技术广度的一种最佳体现。 参考文档
Grafana Alloy | Grafana Alloy documentation
https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.105.0/pkg/ottl/contexts/ottlmetric/README.md
prometheus | Grafana Alloy documentation
