NestJS + Opentelemetry(Grafana 云)
文章标签
NestJS
在生产环境中使用 opentelemetry
在应用程序中设置opentelemetry并通过在本地启动otel collector、loki、tempo和grafana查看轨迹的功能已在上一篇文章中完成。
现在剩下的就是不仅要在本地看追踪,还要在实际生产环境中看追踪。
为此,需要的是‘在云端保存日志和痕迹’。
方法
1.部署opentelemetry收集器
你可以在某处浮动一个opentelemetry collector(+ loki、tempo等)并将应用程序发送的oltp地址设置到这个collector。
或者,为了获得更好的可扩展性,有一种方法可以使用网关进行负载平衡,从网关接收oltp,并将其传递给内部收集器。 2.安装和部署grafana alloygrafana alloy 是 grafana 提供的可配置的 opentelemetry 收集器。 如果您使用 docker 或以前使用过 kubernetes 进行部署,可以将其添加为新节点。 3.无需collector直接拍摄这是一种直接将oltp发送到后端(loki、tempo、jaeger等)的方法,无需收集器。好处是grafana cloud的loki和tempo可以作为后端,无需部署即可快速入门反而使用collector所能获得的可扩展性、处理能力等优势消失了。 采用:无收藏家拍摄我想以一种很酷的方式部署和使用 collector,但我认为在不使用 kubernetes 的环境中单独部署和设置 collector 会花费太多时间,所以我选择直接启动它grafana 云.其实我们引入它是为了实验,而且由于它是一个初创公司,可扩展性并不是很重要(因为它是日志记录),最重要的是它可以快速完成,所以它并不花哨,但是这是一个很好的决定。 绳索更改代码很简单。您所需要做的就是正确设置 oltp 端点和协议。 示踪剂import { otlptraceexporter as protootlptraceexporter } from "@opentelemetry/exporter-trace-otlp-proto";const oltptraceexporter = new protootlptraceexporter({ url: process.env.otel_exporter_otlp_endpoint + "/v1/traces", headers: { authorization: process.env.otel_exporter_otlp_headers_authorization, },});
将接收我们要拍摄的trace的端点(grafana cloud)接收http/protobuf协议,因此必须从exporter-trace-otlp-proto导入和使用。 记录器import { otlptraceexporter as protootlptraceexporter } from "@opentelemetry/exporter-trace-otlp-proto";const oltptraceexporter = new protootlptraceexporter({ url: process.env.otel_exporter_otlp_endpoint + "/v1/traces", headers: { authorization: process.env.otel_exporter_otlp_headers_authorization, },});
const logexporter = new otlplogexporter({ url: process.env.otel_exporter_otlp_endpoint + "/v1/logs", headers: { authorization: process.env.otel_exporter_otlp_headers_authorization, },});
logger已经使用http协议,所以otlplogexporter可以直接使用 环境变量请注意,在nestjs中,环境变量是在初始化appmodule时设置的,因此它们不能用于必须在创建appmodule之前完成的跟踪器和记录器设置。如果你使用dotenv,必须先调用const logexporter = new otlplogexporter({ url: process.env.otel_exporter_otlp_endpoint + "/v1/logs", headers: { authorization: process.env.otel_exporter_otlp_headers_authorization, },});
// eslint-disable-next-line import/orderimport { config } from "dotenv";// eslint-disable-next-line import/orderimport { getEnvFilePath } from "@/lib/utils/env-loader";config(); // load env before loading tracer and logger// eslint-disable-next-line import/orderimport otelSDK from "./tracer"; // otelSDK should be imported before any other imports// eslint-disable-next-line import/orderimport createLogger from "./logger";
- 访问grafana
- 点击右上角我的账户
- 点击左侧导航栏中grafana cloud下的堆栈名称(如果不存在,则创建一个新堆栈)
- 在“管理您的堆栈”屏幕上按 opentelmetry 卡的配置
- 您可以在这里获取otel_exporter_otlp_endpoint,
- 通过点击下方密码/api token中的生成密钥来创建密钥
- environment variables字段中otel_exporter_otlp_headers中basic开头的部分是otel_exporter_otlp_headers_authorization变量的值。