1.8.13.3 常见访问日志类型

Envoy访问日志记录的是在一段固定的时间内通过Envoy进行入站的交互，典型场景包括单个请求/响应交互（例如HTTP），流（例如通过HTTP 2/gRPC）或连接代理（例如TCP等）。访问日志包含协议指定的protobuf消息中定义的字段。

除非另有明确声明，否则所有字段都描述Envoy与连接的客户端之间的下游交互。描述上游交互的字段将在其名称中明确包含上游。

• filter.accesslog.AccessLog
• filter.accesslog.AccessLogFilter
• filter.accesslog.ComparisonFilter
• filter.accesslog.ComparisonFilter.Op (Enum)
• filter.accesslog.StatusCodeFilter
• filter.accesslog.DurationFilter
• filter.accesslog.NotHealthCheckFilter
• filter.accesslog.TraceableFilter
• filter.accesslog.RuntimeFilter
• filter.accesslog.AndFilter
• filter.accesslog.OrFilter
• filter.accesslog.FileAccessLog

filter.accesslog.AccessLog

filter.accesslog.AccessLog proto

{
  "name": "...",
  "filter": "{...}",
  "config": "{...}"
}

• name
  (string) 要实例化的访问日志实现的名称。 该名称必须与静态注册的访问日志匹配。当前的内置记录器为：1）“envoy.file_access_log”

• filter
  (filter.accesslog.AccessLogFilter) 在写入访问日志时需要使用的过滤器。

• config
  (Struct) 依赖实例化访问日志的自定义配置。内置的配置包括：1）“envoy.file_access_log”：FileAccessLog

filter.accesslog.AccessLogFilter

filter.accesslog.AccessLogFilter proto

{
  "status_code_filter": "{...}",
  "duration_filter": "{...}",
  "not_health_check_filter": "{...}",
  "traceable_filter": "{...}",
  "runtime_filter": "{...}",
  "and_filter": "{...}",
  "or_filter": "{...}"
}

注意：必须正确设置status_code_filter，duration_filter，not_health_check_filter，traceable_filter，runtime_filter，and_filter，or_filter其中一个。

• status_code_filter
  (filter.accesslog.StatusCodeFilter) 状态码过滤器。

• duration_filter
  (filter.accesslog.DurationFilter) 时长过滤器。

• not_health_check_filter
  (filter.accesslog.NotHealthCheckFilter) 不健康检查过滤器。

• traceable_filter
  (filter.accesslog.TraceableFilter) 可追踪过滤器。

• runtime_filter
  (filter.accesslog.RuntimeFilter) 运行时过滤器。

• and_filter
  (filter.accesslog.AndFilter) 于过滤器。

• or_filter
  (filter.accesslog.OrFilter) 或过滤器。

filter.accesslog.ComparisonFilter

filter.accesslog.ComparisonFilter proto

整数比较过滤器。

{
  "op": "...",
  "value": "{...}"
}

• op
  (filter.accesslog.ComparisonFilter.Op) 比较运算符。

• value
  (RuntimeUInt32) 与之比较的值。

filter.accesslog.ComparisonFilter.Op (Enum)

filter.accesslog.ComparisonFilter.Op proto

• EQ
  (DEFAULT) 相等=

• GE
  大于等于>=

filter.accesslog.StatusCodeFilter

filter.accesslog.StatusCodeFilter proto

HTTP响应/状态代码的过滤器。

{
  "comparison": "{...}"
}

• comparison
  (filter.accesslog.ComparisonFilter, REQUIRED) 对比。

filter.accesslog.DurationFilter

filter.accesslog.DurationFilter proto

请求持续总时间，以毫秒为单位过滤。

{
  "comparison": "{...}"
}

• comparison
  (filter.accesslog.ComparisonFilter, REQUIRED) 对比。

filter.accesslog.NotHealthCheckFilter

filter.accesslog.NotHealthCheckFilter proto

筛选不健康检查请求。由健康检查过滤器标记。

{}

filter.accesslog.TraceableFilter

filter.accesslog.TraceableFilter proto

筛选可追踪的请求。请参阅跟踪概述，以获取有关请求如何可跟踪的更多信息。

{}

filter.accesslog.RuntimeFilter

filter.accesslog.RuntimeFilter proto

过滤器用于随机抽样请求。在x-request-id头部存在的情况下采样抽取。如果存在x-request-id，则过滤器将根据运行时Key/value和从x-request-id提取值并在多个主机上持续采样。如果缺失，过滤器将根据运行时Key/value随机抽样。

{
  "runtime_key": "..."
}

• runtime_key
  (string, REQUIRED) 运行时key，以获取要采样的请求的百分比。此运行时值控制在0-100范围内，默认为0。

filter.accesslog.AndFilter

filter.accesslog.AndFilter proto

对过滤器中每个过滤器的结果执行逻辑“和”运算。过滤器将按顺序进行评估，如果其中一个返回false，则过滤器立即返回false。

{
  "filters": []
}

• filters
  (filter.accesslog.AccessLogFilter, REQUIRED)

filter.accesslog.OrFilter

filter.accesslog.OrFilter proto

对每个单独的过滤器的结果执行逻辑“或”操作。过滤器将按顺序进行评估，如果其中一个返回true，则过滤器立即返回true。

{
  "filters": []
}

• filters
  (filter.accesslog.AccessLogFilter, REQUIRED)

filter.accesslog.FileAccessLog

filter.accesslog.FileAccessLog proto

将日志条目直接写入文件的AccessLog的自定义配置。内置配置为envoy.file_access_log AccessLog。

{
  "path": "...",
  "format": "..."
}

• path
  (string, REQUIRED) 要写入访问日志条目的本地文件的路径。

• format
  (string) 访问日志的格式。Envoy支持自定义访问日志格式以及默认格式。

返回

• 上一级