结论
本页整理了FastGPT日志、指标与追踪相关的所有环境变量配置项。通过修改这些变量可自定义日志输出、OpenTelemetry上报及对话日志推送等功能。
具体怎么做
可通过配置以下环境变量调整对应功能，参数详情如下：
| 变量名 | 默认值 | 说明 |
|---|---|---|
| LOGENABLECONSOLE | true | 是否输出控制台日志 |
| LOGCONSOLELEVEL | debug | 控制台日志等级，可选 trace、debug、info、warning、error、fatal |
| LOG_DEPTH | 3 | 历史模板变量，用于日志对象展开深度；当前新版结构化日志主要使用日志等级配置 |
| LOGENABLEOTEL | false | 是否启用OpenTelemetry日志上报 |
| LOGOTELLEVEL | info | OTEL日志等级 |
| LOGOTELSERVICE_NAME | fastgpt-client | OTEL日志服务名 |
| LOGOTELURL | 空 | OTEL日志上报地址 |
| METRICSENABLEOTEL | false | 是否启用OpenTelemetry指标上报 |
| METRICSEXPORTINTERVAL | 30000 | 指标导出间隔，单位毫秒 |
| METRICSOTELSERVICE_NAME | fastgpt-client | OTEL指标服务名 |
| METRICSOTELURL | 空 | OTEL指标上报地址 |
| TRACINGENABLEOTEL | false | 是否启用OpenTelemetry链路追踪 |
| TRACINGOTELSERVICE_NAME | fastgpt-client | OTEL追踪服务名 |
| TRACINGOTELURL | 空 | OTEL追踪上报地址 |
| TRACINGOTELSAMPLE_RATIO | 空 | 追踪采样比例，范围0到1 |
| CHATLOGURL | 空 | 对话日志推送服务地址；为空时不推送 |
| CHATLOGINTERVAL | 空 | 对话日志批量推送间隔，单位毫秒 |
| CHATLOGSOURCEIDPREFIX | fastgpt- | 对话日志来源ID前缀 |
| TRACKBATCHUPDATE_TIME | 10000 | 事件计数批量写入间隔，单位毫秒 |
注意事项
- LOG_DEPTH为历史模板变量，新版结构化日志主要使用日志等级配置。
- TRACINGOTELSAMPLE_RATIO的取值范围为0到1。
- 当CHATLOGURL为空时，不会推送对话日志。
- 控制台日志等级仅支持trace、debug、info、warning、error、fatal。
- OTEL相关上报功能需配置对应上报地址才能生效。
来源：FastGPT 官方文档