Grafana Loki笔记04: Promtail简介和配置详解

1server:
2  http_listen_address: 127.0.0.1
3  http_listen_port: 9080

 1# 配置Promtail服务器。
 2[server: <server_config>]
 3
 4# 描述Promtail如何连接到多个Loki实例，并将日志发送到每个实例。
 5# 警告：如果其中一个远程Loki服务器无法响应或响应任何可重试的错误，这将影响发送日志到任何其他配置的远程Loki服务器。发送操作在单个线程上执行！
 6# 通常建议同时运行多个Promtail客户端，以并行发送到多个远程Loki实例。
 7clients:
 8  - [<client_config>]
 9
10# 描述如何将读取的文件偏移保存到磁盘上。
11[positions: <position_config>]
12
13scrape_configs:
14  - [<scrape_config>]
15
16# 为此Promtail实例配置全局限制。
17[limits_config: <limits_config>]
18
19# 配置如何监视监控目标。
20[target_config: <target_config>]
21
22# Promtail的其他配置。
23[options: <options_config>]
24
25# 配置追踪支持
26[tracing: <tracing_config>]

 1# 禁用 HTTP 和 GRPC 服务器。
 2[disable: <boolean> | 默认值 = false]
 3
 4# 启用用于性能分析的 /debug/fgprof 和 /debug/pprof 端点。
 5[profiling_enabled: <boolean> | 默认值 = false]
 6
 7# HTTP 服务器监听主机
 8[http_listen_address: <string>]
 9
10# HTTP 服务器监听端口（0 表示随机端口）
11[http_listen_port: <int> | 默认值 = 80]
12
13# gRPC 服务器监听主机
14[grpc_listen_address: <string>]
15
16# gRPC 服务器监听端口（0 表示随机端口）
17[grpc_listen_port: <int> | 默认值 = 9095]
18
19# 注册instrumentation处理程序（/metrics 等）
20[register_instrumentation: <boolean> | 默认值 = true]
21
22# 优雅关闭的超时时间
23[graceful_shutdown_timeout: <duration> | 默认值 = 30s]
24
25# HTTP 服务器读取超时时间
26[http_server_read_timeout: <duration> | 默认值 = 30s]
27
28# HTTP 服务器写入超时时间
29[http_server_write_timeout: <duration> | 默认值 = 30s]
30
31# HTTP 服务器空闲超时时间
32[http_server_idle_timeout: <duration> | 默认值 = 120s]
33
34# 可接收的最大 gRPC 消息大小
35[grpc_server_max_recv_msg_size: <int> | 默认值 = 4194304]
36
37# 可发送的最大 gRPC 消息大小
38[grpc_server_max_send_msg_size: <int> | 默认值 = 4194304]
39
40# gRPC 调用的并发流的限制数量（0 表示无限制）
41[grpc_server_max_concurrent_streams: <int> | 默认值 = 100]
42
43# 仅记录给定严重性或更高严重性的消息。支持的值 [debug, info, warn, error]
44[log_level: <string> | 默认值 = "info"]
45
46# 所有API路由的基本路径（例如，/v1/）。
47[http_path_prefix: <string>]
48
49# Promtail就绪状态的目标管理器检查标志，如果设置为 false，则忽略检查
50[health_check_target: <bool> | 默认值 = true]
51
52# 通过HTTP请求启用运行时重新加载。
53[enable_runtime_reload: <bool> | 默认值 = false]

  1# Loki监听的URL，在Loki中表示为http_listen_address和http_listen_port。
  2# 如果Loki运行在微服务模式下，这是Distributor的HTTP URL。
  3# 需要包含推送API的路径。
  4# 示例：http://example.com:3100/loki/api/v1/push
  5url: <string>
  6
  7# 每个推送请求发送时要附带的自定义HTTP标头。
  8# 请注意，Promtail本身设置的标头（如 X-Scope-OrgID）无法被覆盖。
  9headers:
 10  # 示例：CF-Access-Client-Id: xxx
 11  [ <labelname>: <labelvalue> ... ]
 12
 13# 用于默认推送日志到Loki的租户ID。
 14# 如果省略或为空，则假定Loki运行在单租户模式下，不会发送X-Scope-OrgID标头。
 15[tenant_id: <string>]
 16
 17# 发送批次之前等待的最大时间，即使批次不满也会发送。
 18[batchwait: <duration> | 默认值 = 1s]
 19
 20# 积累日志的最大批次大小（以字节为单位），在发送给Loki之前。
 21[batchsize: <int> | 默认值 = 1048576]
 22
 23# 如果使用基本身份验证，配置要发送的用户名和密码。
 24basic_auth:
 25  # 用于基本身份验证的用户名
 26  [username: <string>]
 27
 28  # 用于基本身份验证的密码
 29  [password: <string>]
 30
 31  # 包含基本身份验证密码的文件
 32  [password_file: <filename>]
 33
 34# 可选的 OAuth 2.0 配置
 35# 不能与 basic_auth 或 authorization 同时使用
 36oauth2:
 37  # OAuth2的客户端ID和密钥
 38  [client_id: <string>]
 39  [client_secret: <secret>]
 40
 41  # 从文件中读取客户端密钥
 42  # 与`client_secret`互斥
 43  [client_secret_file: <filename>]
 44
 45  # 用于令牌请求的可选范围
 46  scopes:
 47    [ - <string> ... ]
 48
 49  # 用于获取令牌的URL
 50  token_url: <string>
 51
 52  # 追加到令牌URL的可选参数
 53  endpoint_params:
 54    [ <string>: <string> ... ]
 55
 56# 发送到服务器的Bearer令牌。
 57[bearer_token: <secret>]
 58
 59# 包含要发送到服务器的Bearer令牌的文件。
 60[bearer_token_file: <filename>]
 61
 62# 用于连接服务器的HTTP代理服务器。
 63[proxy_url: <string>]
 64
 65# 如果连接到TLS服务器，配置TLS验证握手的操作方式。
 66tls_config:
 67  # 用于验证服务器的CA文件
 68  [ca_file: <string>]
 69
 70  # 发送到服务器用于客户端身份验证的证书文件
 71  [cert_file: <filename>]
 72
 73  # 发送到服务器用于客户端身份验证的密钥文件
 74 
 75  [key_file: <filename>]
 76
 77  # 验证服务器证书中的服务器名称是否与此值匹配。
 78  [server_name: <string>]
 79
 80  # 如果为true，则忽略服务器证书由未知CA签名的情况。
 81  [insecure_skip_verify: <boolean> | 默认值 = false]
 82
 83# 配置请求失败时如何重试向Loki发送请求。
 84# 默认的退避(backoff)时间表：
 85# 0.5s、1s、2s、4s、8s、16s、32s、64s、128s、256s（4.267m）
 86# 共计 511.5s（8.5m）的时间，超过该时间将丢失日志。
 87backoff_config:
 88  # 重试之间的初始退避时间
 89  [min_period: <duration> | 默认值 = 500ms]
 90
 91  # 重试之间的最大退避时间
 92  [max_period: <duration> | 默认值 = 5m]
 93
 94  # 最大重试次数
 95  [max_retries: <int> | 默认值 = 10]
 96
 97# 禁用对Loki响应状态码为429（TooManyRequests）的批次的重试。
 98# 这减少了来自其他租户的批次的影响，因为由于指数退避可能会导致这些批次被延迟或丢失。
 99[drop_rate_limited_batches: <boolean> | 默认值 = false]
100
101# 添加到发送到Loki的所有日志的静态标签。
102# 使用类似 {"foo": "bar"} 的映射添加标签foo和值bar。
103# 这些也可以从命令行指定：
104# -client.external-labels=k1=v1,k2=v2
105# （或 --client.external-labels，取决于您的操作系统）
106# 命令行提供的标签将应用于 `clients` 部分中配置的所有客户端。
107# 注意：配置文件中定义的值将替换命令行中针对给定客户端相同标签键的值。
108external_labels:
109  [ <labelname>: <labelvalue> ... ]
110
111# 等待服务器响应请求的最大时间。
112[timeout: <duration> | 默认值 = 10s]

1# 位置文件的路径
2[filename: <string> | default = "/var/log/positions.yaml"]
3
4# 更新位置文件的频率
5[sync_period: <duration> | default = 10s]
6
7# 是否忽略并在后续覆盖损坏的位置文件
8[ignore_invalid_yaml: <boolean> | default = false]

 1# 在Promtail UI中用于标识此抓取配置的名称。
 2job_name: <string>
 3
 4# 描述如何转换来自目标的日志。
 5[pipeline_stages: <pipeline_stages>]
 6
 7# 定义给定抓取目标的解压行为。
 8decompression:
 9  # 是否尝试解压缩。
10  [enabled: <boolean> | default = false]
11
12  # 开始解压缩前等待的初始延迟时间。
13  # 在发现压缩文件在压缩完成之前就存在的情况下非常有用。
14  [initial_delay: <duration> | default = 0s]
15
16  # 压缩格式。支持的格式有：'gz'、'bz2' 和 'z'。
17  [format: <string> | default = ""]
18
19# 描述如何从journal日志记录中抓取日志。
20[journal: <journal_config>]
21
22# 描述要将抓取的文件从哪种编码转换为。
23[encoding: <iana_encoding_name>]
24
25# 描述如何从syslog接收日志。
26[syslog: <syslog_config>]
27
28# 描述如何通过Loki推送API接收日志，（例如从其他Promtails或Docker Logging Driver）。
29[loki_push_api: <loki_push_api_config>]
30
31# 描述如何从Windows事件日志抓取日志。
32[windows_events: <windows_events_config>]
33
34# 描述如何拉取/接收Google Cloud Platform (GCP)日志。
35[gcplog: <gcplog_config>]
36
37# 描述如何通过Consumer组从Kafka抓取日志。
38[kafka: <kafka_config>]
39
40# 描述如何从gelf客户端接收日志。
41[gelf: <gelf_config>]
42
43# 描述如何拉取Cloudflare的日志。
44[cloudflare: <cloudflare>]
45
46# 描述如何拉取来自Heroku LogPlex drain的日志。
47[heroku_drain: <heroku_drain>]
48
49# 描述如何重新标记目标以确定是否应处理它们。
50relabel_configs:
51  - [<relabel_config>]
52
53# 静态目标进行抓取。
54static_configs:
55  - [<static_config>]
56
57# 包含要抓取的目标的文件。
58file_sd_configs:
59  - [<file_sd_configs>]
60
61# 描述如何发现运行在相同主机上的Kubernetes服务。
62kubernetes_sd_configs:
63  - [<kubernetes_sd_config>]
64
65# 描述如何使用Consul Catalog API 发现在consul集群中注册的服务。
66consul_sd_configs:
67  [ - <consul_sd_config> ... ]
68
69# 描述如何使用Consul Agent API 发现与Promtail在同一主机上运行的consul agent注册的服务。
70consulagent_sd_configs:
71  [ - <consulagent_sd_config> ... ]
72
73# 描述如何使用Docker 守护程序API发现在与Promtail相同的主机上运行的容器。
74docker_sd_configs:
75  [ - <docker_sd_config> ... ]

 1- [
 2    <docker> |
 3    <cri> |
 4    <regex> |
 5    <json> |
 6    <template> |
 7    <match> |
 8    <timestamp> |
 9    <output> |
10    <labels> |
11    <metrics> |
12    <tenant> |
13    <replace>
14  ]

1docker: {}

1{"log":"level=info ts=2019-04-30T02:12:41.844179Z caller=filetargetmanager.go:180 msg=\"Adding target\"\n","stream":"stderr","time":"2019-04-30T02:12:41.8443515Z"}

 1- json:
 2    expressions:
 3      output: log
 4      stream: stream
 5      timestamp: time
 6- labels:
 7    stream:
 8- timestamp:
 9    source: timestamp
10    format: RFC3339Nano
11- output:
12    source: output

1cri: {}

12019-01-01T01:00:00.000000001Z stderr P some log message

1- regex:
2    expression: "^(?s)(?P<time>\\S+?) (?P<stream>stdout|stderr) (?P<flags>\\S+?) (?P<content>.*)$"
3- labels:
4    stream:
5- timestamp:
6    source: time
7    format: RFC3339Nano
8- output:
9    source: content

1regex:
2  # RE2正则表达式。每个捕获组必须具有名称。
3  expression: <字符串>
4
5  # 从提取的数据中解析的名称。如果为空，则使用日志消息。
6  [source: <字符串>]

1json:
2  # 一组JMESPath表达式的键值对。键将成为提取数据中的键，而表达式将作为值从源数据中进行JMESPath评估。
3  expressions:
4    [ <字符串>: <字符串> ... ]
5
6  # 从提取的数据中解析的名称。如果为空，则使用日志消息。
7  [source: <字符串>]

1template:
2  # 从提取的数据中解析的名称。如果提取数据中的键不存在，将创建一个条目。
3  source: <字符串>
4
5  # 要使用的Go模板字符串。除了常规模板函数外，还可以使用ToLower、ToUpper、Replace、Trim、TrimLeft、TrimRight、TrimPrefix、TrimSuffix和TrimSpace作为函数。
6  template: <字符串>

1template:
2  source: level
3  template: '{{ if eq .Value "WARN" }}{{ Replace .Value "WARN" "OK" -1 }}{{ else }}{{ .Value }}{{ end }}'

 1match:
 2  # LogQL流选择器。
 3  selector: <字符串>
 4
 5  # 为管道命名。当定义时，会在pipeline_duration_seconds直方图中创建一个额外的标签，其中的值与job_name使用下划线连接。
 6  [pipeline_name: <字符串>]
 7
 8  # 如果选择器匹配日志条目的标签，则嵌套一组管道阶段：
 9  stages:
10    - [
11        <docker> |
12        <cri> |
13        <regex> |
14        <json> |
15        <template> |
16        <match> |
17        <timestamp> |
18        <output> |
19        <labels> |
20        <metrics>
21      ]

1timestamp:
2  # 从提取的数据中用于时间戳的名称。
3  source: <字符串>
4
5  # 确定如何解析时间字符串。可以使用预定义的格式名称：[ANSIC UnixDate RubyDate RFC822 RFC822Z RFC850 RFC1123 RFC1123Z RFC3339 RFC3339Nano Unix UnixMs UnixUs UnixNs]。
6  format: <字符串>
7
8  # IANA时区数据库字符串。
9  [location: <字符串>]

1output:
2  # 从提取的数据中用于日志条目的名称。
3  source: <字符串>

1labels:
2  # 键是必需的，是将创建的标签的名称。
3  # 值是可选的，将是提取数据中的名称，其值将用作标签的值。
4  # 如果为空，则值将被推断为与键相同。
5  [ <字符串>: [<字符串>] ... ]

1# 一个map，其中键是度量指标的名称，值是特定的度量指标类型。
2metrics:
3  [ <字符串>: [ <counter> | <gauge> | <histogram> ] ...]

 1# 度量指标类型。必须为Counter。
 2type: Counter
 3
 4# 描述度量指标。
 5[description: <字符串>]
 6
 7# 从提取的数据映射中用于度量指标的键，如果不存在，默认为度量指标的名称。
 8[source: <字符串>]
 9
10config:
11  # 过滤源数据，并仅在目标值与提供的字符串完全匹配时更改度量指标。
12  # 如果不存在，所有数据都将匹配。
13  [value: <字符串>]
14
15  # 必须是"inc"或"add"（不区分大小写）。如果选择inc，每个通过过滤器的日志行接收到时，度量指标值将递增1。如果选择add，提取的值必须可转换为正浮点数，并将其值添加到度量指标中。
16  action: <字符串>

 1# 度量指标类型。必须为Gauge。
 2type: Gauge
 3
 4# 描述度量指标。
 5[description: <字符串>]
 6
 7# 从提取的数据映射中用于度量指标的键，如果不存在，默认为度量指标的名称。
 8[source: <字符串>]
 9
10config:
11  # 过滤源数据，并仅在目标值与提供的字符串完全匹配时更改度量指标。
12  # 如果不存在，所有数据都将匹配。
13  [value: <字符串>]
14
15  # 必须是"set"、"inc"、"dec"、"add"或"sub"之一。如果选择add、set或sub，提取的值必须可转换为正浮点数。inc和dec分别将度量指标的值递增或递减1。
16  action: <字符串>

 1# 度量指标类型。必须为Histogram。
 2type: Histogram
 3
 4# 描述度量指标。
 5[description: <字符串>]
 6
 7# 从提取的数据映射中用于度量指标的键，如果不存在，默认为度量指标的名称。
 8[source: <字符串>]
 9
10config:
11  # 过滤源数据，并仅在目标值与提供的字符串完全匹配时更改度量指标。
12  # 如果不存在，所有数据都将匹配。
13  [value: <字符串>]
14
15  # 必须是"inc"或"add"（不区分大小写）。如果选择inc，每个通过过滤器的日志行接收到时，度量指标值将递增1。如果选择add，提取的值必须可转换为正浮点数，并将其值添加到度量指标中。
16  action: <字符串>
17
18  # 用于分桶度量指标的所有数字。
19  buckets:
20    - <整数>

1tenant:
2  # 从提取的数据中选择其值作为租户ID的字段的名称。
3  # source或value配置选项是必需的，但不能同时存在（它们是互斥的）。
4  [source: <字符串>]
5
6  # 当执行此阶段时，用于设置租户ID的值。在包含条件管道（"match"）中使用此阶段时很有用。
7  [value: <字符串>]

 1replace:
 2  # RE2正则表达式。每个命名捕获组将添加到提取的数据中。
 3  # 每个捕获组和命名捕获组将被替换为`replace`中给定的值。
 4  expression: <字符串>
 5
 6  # 从提取的数据中用于解析的名称。如果为空，则使用日志消息。
 7  # 替换后的值将被重新分配给源键。
 8  [source: <字符串>]
 9
10  # 捕获组将被替换为的值。捕获组或命名捕获组将被替换为此值，
11  # 并且日志行将被替换为新的替换值。空值将从日志行中删除捕获组。
12  [replace: <字符串>]

 1# 要监听的TCP地址，格式为“主机:端口”。
 2listen_address: <string>
 3
 4# 配置接收器使用TLS。
 5tls_config:
 6  # 由服务器发送的证书和密钥文件（必需）
 7  cert_file: <string>
 8  key_file: <string>
 9
10  # 用于验证客户端证书的CA证书。当指定时启用客户端证书验证。
11  [ ca_file: <string> ]
12
13# TCP syslog连接的空闲超时时间，默认为120秒。
14idle_timeout: <duration>
15
16# 是否将syslog结构化数据转换为标签。
17# 结构化数据条目 [example@99999 test="yes"] 将变为标签 "__syslog_message_sd_example_99999_test"，其值为 "yes"。
18label_structured_data: <bool>
19
20# 每个日志消息要添加的标签映射。
21labels:
22  [ <labelname>: <labelvalue> ... ]
23
24# Promtail是否应该传递来自传入syslog消息的时间戳。
25# 当为false时，或者如果syslog消息上没有时间戳，Promtail将在处理日志时分配当前时间戳。
26# 默认为false。
27use_incoming_timestamp: <bool>
28
29# 设置syslog消息的最大长度限制
30max_message_length: <int>

 1# 推送服务器的配置选项
 2[server: <server_config>]
 3
 4# 添加到发送到推送API的每个日志行的标签映射
 5labels:
 6  [ <labelname>: <labelvalue> ... ]
 7
 8# 指定Promtail是否应将传入日志的时间戳传递给下游处理程序
 9# 当为false时，Promtail会在处理日志时将当前时间戳分配给日志。
10# 不适用于`/promtail/api/v1/raw`上的明文端点。
11[use_incoming_timestamp: <bool> | default = false]

 1# 用于事件渲染的LCID（区域设置ID）
 2# - 1033 强制使用英语语言
 3# -  0 使用默认的Windows区域设置
 4[locale: <int> | default = 0]
 5
 6# 事件日志的名称，仅在xpath_query为空时使用
 7# 示例："Application"
 8[eventlog_name: <string> | default = ""]
 9
10# xpath_query可以使用定义的简短形式，例如"Event/System[EventID=999]"
11# 或者您可以构建一个XML查询。请参阅“消耗事件”文章：
12# https://docs.microsoft.com/en-us/windows/win32/wes/consuming-events
13# XML查询是推荐的形式，因为它最灵活
14# 您可以通过在Windows事件查看器中创建自定义视图，然后将结果XML复制到这里来创建或调试XML查询
15[xpath_query: <string> | default = "*"]
16
17# 设置文件系统上的书签位置。
18# 书签包含目标在XML中的当前位置。
19# 当重新启动或升级Promtail时，基于书签位置，目标将继续从上次离开的位置抓取事件。
20# 每处理一个条目后，位置都会更新。
21[bookmark_path: <string> | default = ""]
22
23# PollInterval是我们检查是否有新事件可用的间隔。默认情况下，目标每3秒钟检查一次。
24[poll_interval: <duration> | default = 3s]
25
26# 允许排除XML事件数据。
27[exclude_event_data: <bool> | default = false]
28
29# 允许排除人类可读的事件消息。
30[exclude_event_message: <bool> | default = false]
31
32# 允许排除每个Windows事件的用户数据。
33[exclude_user_data: <bool> | default = false]
34
35# 添加到从Windows事件日志读取的每个日志行的标签映射
36labels:
37  [ <labelname>: <labelvalue> ... ]
38
39# 如果Promtail应传递传入日志的时间戳，则为true；否则为false。
40# 当为false时，Promtail会在处理日志时将当前时间戳分配给日志
41[use_incoming_timestamp: <bool> | default = false]

 1# 源标签从现有标签中选择值。它们的内容使用配置的分隔符连接起来，
 2# 并与配置的正则表达式进行替换、保留和删除操作进行匹配。
 3[ source_labels: '[' <labelname> [, ...] ']' ]
 4
 5# 用于连接源标签值的分隔符。
 6[ separator: <string> | default = ";" ]
 7
 8# 在替换操作中将结果值写入的标签。
 9# 对于替换操作，此项为必填项。可以使用正则表达式捕获组。
10[ target_label: <labelname> ]
11
12# 用于匹配提取的值的正则表达式。
13[ regex: <regex> | default = "(.*)" ]
14
15# 哈希源标签值后取模的值。
16[ modulus: <uint64> ]
17
18# 如果正则表达式匹配，执行基于替换的替换值。
19# 可以使用正则表达式捕获组。
20[ replacement: <string> | default = "$1" ]
21
22# 基于正则表达式匹配执行的操作。
23[ action: <relabel_action> | default = "replace" ]

 1# 配置在当前机器上查找发现目标。
 2# 这是Prometheus服务发现代码所需的，但对于只能查看本地机器上的文件的Promtail来说并不适用。
 3# 因此，它只应该具有localhost的值，或者可以完全排除它，Promtail将应用localhost的默认值。
 4
 5targets:
 6  - localhost
 7
 8# 定义要抓取的文件和要应用于__path__文件定义的所有流的可选附加标签集合。
 9
10labels:
11  # 从中加载日志的路径。可以使用通配符模式（例如，/var/log/*.log）。
12  __path__: <string>
13
14  # 用于排除要加载的文件。也可以使用通配符模式。
15  __path_exclude__: <string>
16
17  # 分配给日志的附加标签
18  [ <labelname>: <labelvalue> ... ]

 1[
 2  {
 3    "targets": [ "localhost" ],
 4    "labels": {
 5      "__path__": "<string>", ...
 6      "<labelname>": "<labelvalue>", ...
 7    }
 8  },
 9  ...
10]

1# 用于提取目标组的文件模式。
2files:
3  [ - <filename_pattern> ... ]
4
5# 重新读取文件的刷新间隔。
6[ refresh_interval: <duration> | default = 5m ]

 1# 访问Kubernetes API的信息。
 2
 3# API服务器地址。如果留空，假定Prometheus在集群内部运行，
 4# 将自动发现API服务器，并使用位于/var/run/secrets/kubernetes.io/serviceaccount/的Pod的CA证书和Bearer令牌文件。
 5[ api_server: <host> ]
 6
 7# 需要发现的实体的Kubernetes角色。
 8role: <role>
 9
10# 用于身份验证到API服务器的可选身份验证信息。
11# 请注意，`basic_auth`，`bearer_token`和`bearer_token_file`选项是
12# 互斥的。
13# password和password_file是互斥的。
14
15# 可选的HTTP基本身份验证信息。
16basic_auth:
17  [ username: <string> ]
18  [ password: <secret> ]
19  [ password_file: <string> ]
20
21# 可选的Bearer令牌身份验证信息。
22[ bearer_token: <secret> ]
23
24# 可选的Bearer令牌文件身份验证信息。
25[ bearer_token_file: <filename> ]
26
27# 可选的代理URL。
28[ proxy_url: <string> ]
29
30# TLS配置。
31tls_config:
32  [ <tls_config> ]
33
34# 可选的命名空间发现。如果省略，将使用所有命名空间。
35namespaces:
36  names:
37    [ - <string> ]
38
39# 可选的标签和字段选择器，用于将发现过程限制为可用资源的子集。
40# 请参阅
41# https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
42# 和 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
43# 了解可用的过滤器。endpoints角色支持pod、service和endpoint选择器。
44# 仅支持与角色本身匹配的选择器；
45# 例如，节点角色只能包含节点选择器。
46# 注意：在决定使用字段/标签选择器时，请确保这是最佳方法。
47# 它将阻止Promtail为所有抓取配置重用单个列表/监视。
48# 这可能会导致对Kubernetes API的更大负载，因为对于每个选择器组合，将有额外的LIST/WATCH。
49# 另一方面，如果您想监视大型集群的一小部分Pod，
50# 我们建议使用选择器。选择是否使用选择器取决于具体情况。
51[ selectors:
52          [ - role: <string>
53                  [ label: <string> ]
54                  [ field: <string> ] ]]

 1# 当为true时，在此Promtail实例上强制执行速率限制。
 2[readline_rate_enabled: <bool> | 默认值 = false]
 3
 4# 每秒允许此Promtail实例推送到Loki的日志行数限制。
 5[readline_rate: <int> | 默认值 = 10000]
 6
 7# 允许此Promtail实例推送到Loki的突发行数限制。
 8[readline_burst: <int> | 默认值 = 10000]
 9
10# 当为true时，超过速率限制会导致此Promtail实例丢弃日志行，而不是发送到Loki。当为false时，超过速率限制会导致此Promtail实例暂时推迟发送日志行，并稍后重试。
11[readline_rate_drop: <bool> | 默认值 = true]
12
13# 限制最大活动流的数量。
14# 通过限制流的数量，可以有效控制Promtail的内存使用，避免OOM情况。
15# 0表示禁用。
16[max_streams: <int> | 默认值 = 0]
17
18# 允许的最大日志行字节大小，超过此大小将会被丢弃。示例：256kb，2M。设置为0禁用此限制。
19[max_line_size: <int> | 默认值 = 0]
20# 是否截断超过最大行大小的行。如果max_line_size未启用，则无效。
21[max_line_size_truncate: <bool> | 默认值 = false]

1# 同步周期，重新同步正在监视的目录和正在尾随的文件以发现新文件或停止监视已删除的文件。
2sync_period: "10s"

1# 已弃用。
2# 逗号分隔的标签列表，包含在流滞后度量中的标签“promtail_stream_lag_seconds”中。
3# 默认值为“filename”。始终包含一个“host”标签。
4# 流滞后度量指示哪些流在向Loki写入时滞后。请注意不要使用过多的标签，
5# 因为这可能会增加基数。
6[stream_lag_labels: <string> | default = "filename"]

1[enabled: <boolean> | default = false]