1. 收集连接信息
| Parameters | Description |
|---|---|
HOST and PORT | 通常,使用 TLS 时端口为 9440;不使用 TLS 时端口为 9000。 |
DATABASE NAME | 默认会有一个名为 default 的数据库,请使用你要连接的数据库名称。 |
USERNAME and PASSWORD | 默认用户名为 default。请根据你的使用场景使用相应的用户名。 |
clickhouse-client 命令中看到详细信息。
如果你使用的是自管理 ClickHouse,连接详细信息由你的 ClickHouse 管理员设置。
2. 创建只读用户
DELETE 和 INSERT。
要配置只读用户,请按以下步骤操作:
- 按照在 ClickHouse 中创建用户和角色指南创建一个
readonly用户 profile。 - 确保
readonly用户拥有足够的权限,以修改底层 clickhouse-go client 所需的max_execution_time设置。 - 如果您使用的是公共 ClickHouse 实例,不建议在
readonlyprofile 中设置readonly=2。请改为保留readonly=1,并将max_execution_time的约束类型设置为 changeable_in_readonly,以允许修改此设置。
3. 安装 Grafana 的 ClickHouse 插件
- 在侧边栏的 Connections 页面中,选择 Add new connection 选项卡。
- 搜索 ClickHouse,然后点击由 Grafana Labs 签名的插件:
- 在下一个页面中,点击 Install 按钮:
4. 定义 ClickHouse 数据源
- 安装完成后,点击 Add new data source 按钮。 (您也可以在 Connections 页面的 Data sources 选项卡中添加数据源。)
- 向下滚动并找到 ClickHouse 数据源类型,或者在 Add data source 页面的搜索栏中直接搜索。选择 ClickHouse 数据源后,将显示以下页面:
- 输入服务器设置和凭据。关键设置包括:
- Server host address: 您的 ClickHouse 服务的主机名。
- Server port: 您的 ClickHouse 服务使用的端口。具体端口取决于服务器配置和所用协议。
- Protocol:用于连接到您的 ClickHouse 服务的协议。
- Secure connection:如果您的服务器要求安全连接,请启用此项。
- Username 和 Password:输入您的 ClickHouse 用户凭据。如果您尚未配置任何用户,可尝试使用
default作为用户名。建议配置只读用户。
- 点击 Save & test 按钮,验证 Grafana 能否连接到您的 ClickHouse 服务。如果连接成功,您将看到 Data source is working 消息: