Skip to content

Latest commit

 

History

History
83 lines (64 loc) · 3.84 KB

prometheus.md

File metadata and controls

83 lines (64 loc) · 3.84 KB
Raw

Prometheus

GreptimeDB 可以作为 Prometheus 的长期存储。使用 GreptimeDB 作为 Prometheus 的后端存储可以获得无缝体验。由于 Prometheus 支持在配置远程写和读的过程中设置基本的认证信息，用户只需要把配置的用户名和密码添加到配置 YAML 文件中，就可以了。

首先要为存储 Prometheus 的数据创建一个单独的数据库:

CREATE DATABASE prometheus;

请按照 Prometheus configuration (prometheus.yml) 中的设置进行配置：

remote_write:
- url: http://localhost:4000/v1/prometheus/write?db=prometheus
#  basic_auth:
#    username: greptime_user
#    password: greptime_pwd

remote_read:
- url: http://localhost:4000/v1/prometheus/read?db=prometheus
#  basic_auth:
#    username: greptime_user
#    password: greptime_pwd

注意：请将 greptime_user(username), greptime_pwd(password) 替换为用户自己的用户名和密码，详情请参考客户端鉴权认证。

url 中的 db 参数表示我们要写入的数据库，如果没有指定，则默认为 public。

写入数据成功后，使用下面的命令展示 Prometheus 数据库中的表：

use prometheus;
show tables;
+---------------------------------------------------------------+
| Tables                                                        |
+---------------------------------------------------------------+
| go_memstats_heap_inuse_bytes                                  |
| go_memstats_last_gc_time_seconds                              |
| net_conntrack_listener_conn_closed_total                      |
| prometheus_remote_storage_enqueue_retries_total               |
| prometheus_remote_storage_exemplars_pending                   |
| prometheus_remote_storage_read_request_duration_seconds_count |
| prometheus_rule_group_duration_seconds                        |
| prometheus_rule_group_duration_seconds_count                  |
| ......                                                        |
+---------------------------------------------------------------+

GreptimeDB 中的 Prometheus 指标

当指标被远程写入 GreptimeDB 时，它们将被转换为下面这样：

Sample Metrics In GreptimeDB GreptimeDB Data Types
Name Table (Auto-created) Name String
Value Column (greptime_value) Double
Timestamp Column (greptime_timestamp) Timestamp
Label Column String

所有标签列将会被自动创建为主键。当添加新的标签时，它也会自动添加到主键中。

举例: GreptimeDB 表中的 Prometheus 指标

prometheus_remote_storage_samples_total{instance="localhost:9090", job="prometheus",
remote_name="648f0c", url="http://localhost:4000/v1/prometheus/write"} 500

上面这个例子将被转化为表 prometheus_remote_storage_samples_total 中的一行：

Column Value Column Data Type
instance localhost:9090 String
job prometheus String
remote_name 648f0c String
url http://localhost:4000/v1/prometheus/write String
greptime_value 500 Double
greptime_timestamp The sample's unix timestamp Timestamp