• Mongo代理
    • 故障注入
    • 统计
    • 分散GETS
    • 多重GETS
    • 注释解析
    • 按命令统计
    • 查询统计收集
    • 查询的调用点统计收集
    • 运行时
    • 访问日志格式
  • 返回

    Mongo代理

    • MongoDB体系结构概述
    • v1 API 参考
    • v2 API 参考

    故障注入

    Mongo代理过滤器支持故障注入。有关如何配置，请参阅v1和v2 API参考。

    统计

    每个配置的MongoDB代理过滤器的统计信息都以mongo.<stat_prefix>为根。统计如下：

    名称 类型 描述
    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 具有可设置cursor标示的OP_QUERY的数量
    op_query_no_cursor_timeout Counter 没有设置cursor超时标志的OP_QUERY的数量
    op_query_await_data Counter 具有等待数据标志的OP_QUERY的数量
    op_query_exhaust Counter 设置耗尽标志的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标志的OP_REPLY数量
    op_reply_query_failure Counter 设置了查询失败标志的OP_REPLY数量
    op_reply_valid_cursor Counter 具有有效cursor标志的OP_REPLY数量
    cx_destroy_local_with_active_rq Counter 使用在本地销毁查询连接总数
    cx_destroy_remote_with_active_rq Counter 使用远程销毁查询连接总数
    cx_drain_close Counter 在服务退出时，连接被优雅关闭的总数

    分散GETS

    Envoy将 scatter get 定义为任何不使用_id字段作为查询参数的查询。同时在文档以及_id的$query字段中查找。

    多重GETS

    Envoy将 multi get 定义为任何使用_id字段作为查询参数的查询，但其中_id不是标量值（即文档或数组）。同时在文档以及_id的$query字段中查找。

    注释解析

    如果一个查询的顶层有一个$comment字段（通常添加了一个$query字段），Envoy会将其解析为JSON并查找以下结构：

    1. {
    2.   "callingFunction": "..."
    3. }

    callingFunction

    (required, string) 查询功能。如果可用，该函数将用于调用查询点的统计。

    按命令统计

    MongoDB过滤器将收集命名空间为mongo.<stat_prefix>.cmd.<cmd>.中命令的统计信息。

    名称 类型 描述
    total Counter 命令的数量
    reply_num_docs Histogram 应答中的文件数量
    reply_size Histogram 应答的字节数（单位bytes）
    reply_time_ms Histogram 命令的时间（单位毫秒）

    查询统计收集

    MongoDB过滤器将收集mongo中查询的统计信息，命名空间mongo.<stat_prefix>.collection.<collection>.query.。

    名称 类型 描述
    total Counter 查询数量
    scatter_get Counter 分散查询的数量
    multi_get Counter 多重查询的数量
    reply_num_docs Histogram 应答文件的数量
    reply_size Histogram 应答大小（单位：字节）
    reply_time_ms Histogram 查询时间（单位：毫秒）

    查询的调用点统计收集

    如果应用程序在$comment字段中提供调用函数，Envoy将生成每个调用点统计信息。 这些统计信息匹配每个查询信息，匹配的命名空间为
    mongo.<stat_prefix>.collection.<collection>.callsite.<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配置。

    访问日志格式

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

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

    time

    • 完整的消息被解析的系统时间，包括毫秒。

    message

    • 消息的文本扩展。消息是否完全展开取决于上下文。有时会提供汇总数据，以避免超大日志。

    upstream_host

    • 代理连接的上游主机。如果与TCP代理过滤器一起使用，则会填充此项。

    返回

    • 上一级
    • 首页目录