Mongo 代理

故障注入

Mongo 代理过滤器支持故障注入。可以查看 V1 以及 V2 的 API 参考文档以了解如何进行相关配置。

每一个配置的 MongoDB 代理过滤器的统计信息都以 mongo.. 开头，其统计信息如下：

名称	类型	描述
decoding_error	Counter	MongoDB 协议解码错误的数量
delay_injected	Counter	延迟被注入的次数
op_get_more	Counter	OP_GET_MORE 消息的数量
op_insert	Counter	OP_INSERT 消息的数量
op_kill_cursors	Counter	OP_KILL_CURSORS 消息的数量
op_query	Counter	OP_QUERY 消息的数量
op_query_tailable_cursor	Counter	设置了 tailable cursor flag 的 OP_QUERY 消息的数量
op_query_no_cursor_timeout	Counter	没有设置 cursor timeout flag 的 OP_QUERY 消息的数量
op_query_await_data	Counter	设置了 await data flag 的 OP_QUERY 消息的数量
op_query_exhaust	Counter	设置了 exhaust flag 的 OP_QUERY 消息的数量
op_query_no_max_time	Counter	没有设置 maxTimeMS 的查询数量
op_query_scatter_get	Counter	分散获取查询的数量
op_query_multi_get	Counter	多重查询的次数
op_query_active	Gauge	活跃查询的数量
op_reply	Counter	OP_REPLY 消息的数量
op_reply_cursor_not_found	Counter	设置了 cursor not found flag 的 OP_REPLY 消息的数量
op_reply_query_failure	Counter	设置了 query failure flag 的 OP_REPLY 消息的数量
op_reply_valid_cursor	Counter	拥有有效的游标的 OP_REPLY 消息的数量
cx_destroy_local_with_active_rq	Counter	拥有一个活跃查询并被本地破坏的连接总数
cx_destroy_remote_with_active_rq	Counter	拥有一个活跃查询并被远程破坏的连接总数
cx_drain_close	Counter	在服务器关闭期间，在回复边界被优雅关闭的连接总数

任何不使用 _id 作为查询参数的查询，Envoy 将其定义为一个分散获取查询 。Envoy 同时在最顶级文档以及 _id 的 $query 中查找。

任何使用 _id 作为查询参数的查询，且 _id 不是一个标量值（如文档或数组）， Envoy 定义其为 多重查询。 Envoy 同时在最顶级文档以及 _id 的 $query 中查找。

如果一个查询具有顶级的 $comment 字段（通常在 $query 字段的基础上添加），Envoy 会将其解析为 JSON 格式并查找以下结构：

{
  "callingFunction": "..."
}

MongoDB 过滤器将在 mongo..cmd.. 命名空间为命令收集相应的统计信息。

MongoDB 过滤器将在 mongo..collection..query. 命名空间为查询收集相应的统计信息。

如果应用程序在 $comment 字段中提供调用函数，Envoy 将相应生成按调用站点为维度的统计信息。这些统计信息与按集合统计相匹配，可在 mongo..collection..callsite..query. 命名空间中找到相关信息。

Mongo 代理过滤器支持如下运行时设置：

mongo.connection_logging_enabled

启用日志记录的连接百分比。默认为100。这将只允许将指定百分比的连接做日志记录, 但这些连接上的所有信息将会做日志记录。
mongo.proxy_enabled

启用代理的连接百分比。默认为100。
mongo.logging_enabled

启用日志记录的消息的百分比。默认值为100。如果小于100，部分查询可能会在无回复的情况下被记录。
mongo.mongo.drain_close_enabled

当服务器正在被删除或尝试做强制关闭时，将被关闭的连接百分比。默认为100。
mongo.fault.fixed_delay.percent

当没有活跃故障时，一个合格的 MongoDB 操作受到注入故障影响的可能性。默认为配置中指定的 percent 。
mongo.fault.fixed_delay.duration_ms

以毫秒为单位的延迟时间。默认为配置中指定的 duration_ms。

访问日志格式不可定制，并具有以下布局：

{"time": "...", "message": "...", "upstream_host": "..."}