修改配置最简单的方式，是在 Grafana UI 的插件配置页面中进行，但也可以通过 YAML 文件预配数据源。
本页列出了 ClickHouse 插件中可配置的各项选项，以及通过 YAML 预配数据源时可用的配置片段。
如需快速了解所有选项，请在此处查看完整的配置选项列表。
示例配置界面：
通用设置的 YAML 配置示例：
请注意，从 UI 保存配置时，系统会自动添加一个 version 属性。该属性显示保存此配置时所使用的插件版本。
如果选择通过 HTTP 协议连接，则会显示更多设置选项。
如果 HTTP 服务器通过其他 URL 路径对外提供服务，可以在此处添加。
你可以为发送到服务器的请求添加自定义请求头。
请求头可以是明文，也可以是安全值。
所有请求头键都会以明文形式存储，而安全请求头值会保存在安全配置中 (类似于 password 字段) 。
通过 HTTP 发送安全值虽然安全请求头值会安全地存储在配置中，但如果未启用安全连接，该值仍会通过 HTTP 发送。
otel_logs。
这会自动覆盖默认列，以使用所选的 OTel schema 版本。
虽然日志并不要求必须使用 OpenTelemetry，但使用统一的日志/trace 数据集有助于借助数据链接实现更流畅的可观测性工作流。
日志配置界面示例：
日志配置 YAML 示例：
为加快链路追踪查询构建，你可以为 trace 查询设置默认的数据库/表以及列。这样会为 query builder 预加载一条可直接运行的 trace 搜索查询，从而加快在 Explore 页面中浏览可观测性数据的速度。
如果你使用 OpenTelemetry，建议启用“Use OTel”开关，并将默认 trace 表设置为 otel_traces。
这样会自动覆盖默认列，以使用所选的 OTel schema 版本。
虽然并非必须使用 OpenTelemetry，但如果链路追踪采用其 schema，此功能效果最佳。
链路追踪配置界面示例：
链路追踪配置 YAML 示例：
列别名是一种便捷方式，让你能够使用不同的名称和类型来查询数据。
借助别名，你可以将嵌套的 schema 展平，从而在 Grafana 中更轻松地进行选择。
在以下情况下，别名功能可能对你特别有用：
- 你了解自己的 schema 及其大部分嵌套属性/类型
- 你将数据存储为 Map 类型
- 你将 JSON 以字符串形式存储
- 你经常使用函数来转换所选的列
ClickHouse 内置了列别名功能，并且可开箱即用地与 Grafana 配合使用。
别名列可以直接在表中定义。
在上述示例中，我们创建了一个名为 TimestampDate 的别名，用于将纳秒级时间戳转换为 Date 类型。
这些数据不会像第一列那样存储在磁盘上，而是在查询时计算得出。
表中定义的别名不会随 SELECT * 一起返回，但可以在服务器设置中进行配置。
如需了解更多信息，请参阅 ALIAS 列类型的文档。
默认情况下，Grafana 会根据 DESC table 的返回结果提供列建议。
在某些情况下，你可能希望完全覆盖 Grafana 能看到的列。
这样可以在 Grafana 选择列时隐藏你的 schema；根据表的复杂程度，这可能有助于改善用户体验。
相比在表中直接定义别名，这种方式的好处是你可以轻松更新这些别名，而无需修改表。在某些 schema 中，这类定义可能长达数千项，从而让底层表定义显得杂乱。它还可以隐藏你希望用户忽略的列。
Grafana 要求别名表具有以下列结构：
下面介绍如何使用别名表来复现 ALIAS 列的行为：
然后，我们就可以将此表配置为供 Grafana 使用。请注意，这个名称可以随意指定，甚至可以在单独的数据库中定义：
现在，Grafana 看到的将是别名表的结果，而不是 DESC example_table 的结果：
这两种别名方式都可用于执行复杂的类型转换或提取 JSON 字段。
以下是该插件提供的全部 YAML 配置选项。
部分字段给出了示例值，其他字段则仅显示字段类型。
有关使用 YAML 配置数据源的更多信息，请参阅 Grafana 文档。
