版本：1.2

Fluent Bit

Fluent Bit 是一个快速且轻量级的遥测代理，用于 Linux、macOS、Windows 和 BSD 系列操作系统的日志、指标和跟踪。Fluent Bit 专注于性能，允许从不同来源收集和处理遥测数据而不增加复杂性。

你可以将 Fluent Bit 数据转发到 GreptimeDB。本文档介绍如何配置 Fluent Bit 以将日志、指标和跟踪发送到 GreptimeDB。

HTTP

使用 Fluent Bit 的 HTTP 输出插件，你可以将日志发送到 GreptimeDB。Http 接口目前支持日志的写入。在配置 Fluent Bit 之前，请确保你已经了解日志写入流程和如何使用 pipelines。

[OUTPUT]
    Name             http
    Match            *
    Host             greptimedb
    Port             4000
    Uri              /v1/ingest?db=public&table=your_table&pipeline_name=greptime_identity
    Format           json
    Json_date_key    scrape_timestamp
    Json_date_format iso8601
    compress         gzip
    http_User        <username>
    http_Passwd      <password>

uri: 发送日志的端点。
format: 日志的格式，需要是 json。
json_date_key: JSON 对象中包含时间戳的键。
json_date_format: 时间戳的格式。
compress: 使用的压缩方法，例如 gzip。
header: 发送请求时的头部信息，例如用于认证的 Authorization。如果没有，不要增加 Authorization 头部。
http_user 和 http_passwd: GreptimeDB 的认证凭据。

在 uri 参数中：

db 是你要写入日志的数据库名称。
table 是你要写入日志的表名称。
pipeline_name 是你要用于处理日志的管道名称。
custom_time_index 是可选参数。当输入数据中的某个字段需要作为 GreptimeDB 的 time index 时，可以使用它。支持的格式为 <field_name>;epoch;<resolution> 和 <field_name>;datestr;<format>。

greptime_identity pipeline 会直接根据 JSON 字段创建表。如果你希望 scrape_timestamp 这样的字段成为 GreptimeDB 的 time index，而不是普通列，可以在请求 URI 中设置 custom_time_index，也可以使用自定义 pipeline 来解析和映射该字段。

OpenTelemetry

GreptimeDB 也可以配置为 OpenTelemetry 收集器。使用 Fluent Bit 的 OpenTelemetry 输出插件，你可以将指标、日志和跟踪发送到 GreptimeDB。

由于 GreptimeDB 会为不同 signal 使用不同的 header，请为每种 signal 配置独立的 output。在 Fluent Bit input 中为每种 signal 设置不同的 tag，然后在对应的 output 中匹配该 tag：

# 仅用于 metrics
[OUTPUT]
    Name                 opentelemetry
    Alias                opentelemetry_metrics
    Match                <metrics_tag>
    Host                 127.0.0.1
    Port                 4000
    Metrics_uri          /v1/otlp/v1/metrics
    Log_response_payload True
    Tls                  Off
    Tls.verify           Off
    Header X-Greptime-DB-Name "<dbname>"

# 仅用于 logs
[OUTPUT]
    Name                 opentelemetry
    Alias                opentelemetry_logs
    Match                <logs_tag>
    Host                 127.0.0.1
    Port                 4000
    Logs_uri             /v1/otlp/v1/logs
    Log_response_payload True
    Tls                  Off
    Tls.verify           Off
    Header X-Greptime-Log-Table-Name "<log_table_name>"
    Header X-Greptime-Pipeline-Name "<pipeline_name>"
    Header X-Greptime-DB-Name "<dbname>"

# 仅用于 traces
[OUTPUT]
    Name                 opentelemetry
    Alias                opentelemetry_traces
    Match                <traces_tag>
    Host                 127.0.0.1
    Port                 4000
    Traces_uri           /v1/otlp/v1/traces
    Log_response_payload True
    Tls                  Off
    Tls.verify           Off
    Header X-Greptime-Pipeline-Name "greptime_trace_v1"
    Header X-Greptime-DB-Name "<dbname>"

Metrics_uri、Logs_uri 和 Traces_uri：分别用于发送 metrics、logs 和 traces 的端点。
Match：在对应 Fluent Bit input 中配置的 signal tag。
http_user 和 http_passwd：GreptimeDB 的认证凭据。启用鉴权时，请将它们添加到每个 output 中。

本示例使用的是 OpenTelemetry OTLP/HTTP API。不同 signal 支持的 header 和选项不同，具体请分别参考 OpenTelemetry API 的 metrics、logs 和 traces 部分。

Prometheus Remote Write

将 GreptimeDB 配置为远程写入目标：

[OUTPUT]
    Name                 prometheus_remote_write
    Match                internal_metrics
    Host                 127.0.0.1
    Port                 4000
    Uri                  /v1/prometheus/write?db=<dbname>
    Tls                  Off
    http_user            <username>
    http_passwd          <password>

Uri: 发送指标的端点。
http_user 和 http_passwd: GreptimeDB 的认证凭据。

在 Uri 参数中：

db 是你要写入指标的数据库名称。

有关从 Prometheus 到 GreptimeDB 的数据模型转换的详细信息，请参阅 Prometheus Remote Write 指南中的数据模型部分。

Fluent Bit

HTTP​

OpenTelemetry​

Prometheus Remote Write​

HTTP

OpenTelemetry

Prometheus Remote Write