envoy 中文参考文档
  • 首页
  • 简介
    • Envoy是什么
    • 架构介绍
      • 术语
      • 线程模型
      • 监听器
      • L3/L4网络过滤器
      • HTTP连接管理
      • HTTP过滤器
      • HTTP路由
      • gRPC
      • WebSocket支持
      • 集群管理
      • 服务发现
      • 健康检查
      • 连接池
      • 负载均衡
      • 异常检测
      • 熔断
      • 全局限速
      • TLS
      • 统计
      • 运行时配置
      • 跟踪
      • TCP代理
      • 访问日志
      • MongoDB
      • DynamoDB
      • Redis
      • 热重启
      • 动态配置
      • 初始化
      • 逐出
      • 脚本
    • 部署
    • 业界对比
    • 获得帮助
    • 历史版本
  • 编译安装
    • 编译
    • 参考配置
    • 演示沙箱
      • 前端代理
      • Zipkin跟踪
      • Jaeger跟踪
      • gRPC桥接
      • 构建Envoy Docker镜像
    • 工具
  • 配置参考
    • V1 API 概述
    • V2 API 概述
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP连接管理器
      • 路由匹配
      • 流量转移/分流
      • HTTP头部操作
      • HTTP头部清理
      • 统计
      • 运行时设置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • 故障注入
      • DynamoDB
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • 速率限制
      • 路由
      • Lua
    • 集群管理
      • 统计
      • 运行时设置
      • 集群发现服务
      • 健康检查
      • 熔断
    • 访问日志
    • 限速服务
    • 运行时配置
    • 路由表检查工具
  • 运维管理
    • 命令行选项
    • 热重启
    • 管理接口
    • 统计概述
    • 运行时配置
    • 文件系统
  • 自定义扩展示例
  • V1 API参考
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • HTTP连接管理
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP路由配置
      • 虚拟主机
      • 路由
      • 虚拟集群
      • 速率限制配置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • DynamoDB
      • 故障注入
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • Lua
      • 速率限制
      • 路由
    • 集群管理
      • 集群
        • 健康检查
        • 熔断
        • TLS上下文
        • 异常值检测
        • HASH环负载均衡配置
      • 异常检测
      • 集群发现服务
      • 服务发现服务
    • 访问日志
    • 管理接口
    • 限速服务
    • 运行时配置
    • 跟踪
  • V2 API参考
    • 启动引导
    • 监听&监听发现
    • 集群&集群发现
    • 服务发现
    • 健康检查
    • HTTP路由管理&发现
    • TLS配置
    • 通用的类型
    • 网络地址
    • 协议选项
    • 发现API
    • 限速组件
    • 过滤器
      • 网络过滤器
        • TLS客户端身份认证
        • HTTP连接管理
        • Mongo代理
        • 速率限制
        • Redis代理
        • TCP代理
      • HTTP过滤器
        • 缓存
        • 故障注入
        • 健康检查
        • Lua
        • 速率限制
        • 路由
        • gRPC-JSON转码器
      • 常见访问日志类型
      • 常见故障注入类型
  • FAQ
    • Envoy有多快?
    • 我在哪里获得二进制文件?
    • 我如何设置SNI?
    • 如何设置区域感知路由?
    • 我如何设置Zipkin跟踪?
Powered by GitBook
On this page
  • 访问日志
  • 配置项
  • 过滤器
  • Status code
  • Duration
  • Not health check
  • Traceable
  • Runtime
  • And
  • Or
  • 返回

Was this helpful?

  1. V1 API参考

访问日志

Previous服务发现服务Next管理接口

Last updated 5 years ago

Was this helpful?

访问日志

配置项

{
  "access_log": [
    {
      "path": "...",
      "format": "...",
      "filter": "{...}",
    },
  ]
}
  • path (required, string) 写入访问日志的路径。

  • format (optional, string) 访问日志格式。Envoy支持以及。

  • filter (optional, object) 用于明确是否需要写入的访问日志过滤器。

过滤器

Envoy支持以下访问日志过滤器:

Status code

{
  "filter": {
    "type": "status_code",
    "op": "...",
    "value": "...",
    "runtime_key": "..."
  }
}

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

  • op (required, string) 比较运算符。目前仅支持>=和=运算符。

  • value (required, integer) 如果运行时值不可用,则使用默认值进行比较。

  • runtime_key (optional, string) 运行时的key,用于获取比较值。如果定义,则使用此值。

Duration

{
  "filter": {
    "type": "duration",
    "op": "..",
    "value": "...",
    "runtime_key": "..."
  }
}

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

  • op (required, string) 比较运算符。目前仅支持>=和=运算符。

  • value (required, integer) 如果运行时值不可用,则使用默认值进行比较。

  • runtime_key (optional, string) 运行时的key,用于获取比较值。如果定义,则使用此值。

Not health check

{
  "filter": {
    "type": "not_healthcheck"
  }
}

筛选健康检查失败的请求。健康检查的请求由健康检查过滤器进行标记。

Traceable

{
  "filter": {
    "type": "traceable_request"
  }
}

Runtime

{
  "filter": {
    "type": "runtime",
    "key" : "..."
  }
}

使用随机采样请求。在x-request-id头存在的情况下进行采样。如果存在x-request-id,则过滤器将根据运行时键值和从x-request-id提取的值在多个主机上持续采样。如果缺失,过滤器将根据运行时键值随机采样。

  • key

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

And

{
  "filter": {
    "type": "logical_and",
    "filters": []
  }
}

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

Or

{
  "filter": {
    "type": "logical_or",
    "filters": []
  }
}

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

返回

筛选可跟踪的请求。请参阅,以获取有关请求如何使能跟踪的详细信息。

自定义访问日志格式
默认格式
跟踪概述
上一级
首页目录
Status code
Duration
Not health check
Traceable
Runtime
And
Or