mongoreplay

mongoreplay record¶

record根据网络流量生成播放文件。record支持直接收集网络流量，或者可以接受pcap文件 来生成播放文件。回放文件包含mongod在记录过程中发送到实例的所有请求 以及在记录过程中发送给客户端的所有响应的列表。回放文件还记录每个请求的元数据，例如连接标识符和时间戳。

以下原型用于mongoreplay在回送网络接口上记录数据，并创建位于的播放文件~/recordings/playback。

mongoreplay record -i=eth0 -e="port 27017" -p=~/recordings/playback

类似地，以下原型用于mongoreplay 从现有的pcap文件中产生一个回放文件：

mongoreplay record -f=traffic.pcap -p=~/recordings/playback

record 支持以下选项：

mongoreplay record¶

record¶

-f=<path>¶

指定record应读取以生成播放文件的pcap文件的路径。

使用-f以替代使用捕获网络流量

-i。您必须指定任一 -f或-i。如果同时包含两个选项，则mongoreplay记录将产生错误。

-b=<number>¶

用于将单独的流合并在一起的堆大小。

--expr=<filter expression>, -e=<filter expression>¶

Berkeley数据包筛选器（BPF）语法中的表达式，适用于要记录的传入流量。如果要使用从网络接口捕获流量，则为必需 -i。

例如，要捕获来自端口27017上运行的MongoDB实例的流量，您可以指定。-e='port 27017'

-i=<interface>¶

指定record应侦听以捕获网络流量的网络接口。

与一起使用-e。

使用-i作为一种替代-f ，用于读取现有的PCAP文件。您必须指定任一 -f或-i。如果同时包含两个选项，则mongoreplay记录将 产生错误。

--gzip=<boolean>¶

如果指定，record则使用gzip压缩播放文件。

--playback-file=<path>, -p=<path>¶

指定写入播放文件的路径。

产生的播放文件是BSON文件。

mongoreplay play¶

play¶

play回放record针对mongod实例创建的回放文件 。

例如，以下示例用于将文件重播 到在上运行的实例 ：mongoreplay play~/recordings/playbackmongod192.168.0.4:27018

• 使用--host选项：

  复制

  mongoreplay play -p=~/recordings/playback --report=~/reports/replay_stats.json --host=mongodb://192.168.0.4:27018
  

• 使用MONGOREPLAY_HOST环境变量（从MongoDB 4.0开始可用）：

  复制

  export MONGOREPLAY_HOST="mongodb://192.168.0.4:27018"
  mongoreplay play -p=~/recordings/playback --report=~/reports/replay_stats.json
  

mongoreplay monitor¶

monitor 检查实时或预先记录的MongoDB网络流量。

以下原型用于mongoreplay根据目录中的playback.bson播放文件生成JSON报告~/recordings：

mongoreplay monitor --collect json --report ~/reports/monitor-report.json -p ~/recordings/playback.bson

monitor 支持以下选项：

mongoreplay monitor¶

monitor¶

--collect=<json|format|none>¶

默认值：格式

指定收集的统计信息的输出格式。

• json：将统计信息输出为json
• format：使用--format选项中指定的格式来生成输出文件。
• none：不提供任何输出

--report=<path>¶

指定写入执行报告的路径。使用--collect指定报表的输出格式。

如果未指定--report，则monitor写入STDOUT。

--no-truncate¶

如果指定，则禁用monitor日志输出中大答复有效载荷数据的截断 。

--format=<format>¶

默认值：%F{blue}%t%f %F{cyan}(Connection: %o:%i)%f %F{yellow}%l%f %F{red}%T %c%f %F{white}%n%f %F{green}%Q{Request:}%f%q%F{green}%R{Response:}%f%r)

指定终端输出的格式。您可以通过将其用大括号括起来，在格式“动词”之后立即指定参数%Q{<arg>}。

如果指定--format，还请指定format作为--collect选项的值。

--format 支持以下动词：

• %n：名称空间
• %l： 潜伏
• %t： 时间。您可以选择使用Go编程语言的时间格式指定日期布局。Go将其用作参考时间。您必须使用参考时间指定时间格式。因此，如果要以格式打印日期，则可以指定。 有关更多信息，请参考Go 时间格式文档。Mon Jan 2 15:04:05 MST 2006yyyy-mm-dd hh:mm%t{2006-01-02 15:04}
• %T：上班时间
• %c：命令
• %o：连接数
• %i：请求ID
• %q：要求。您可以在JSON结构中最终指定一个以点分隔的字段，如中所示%q{command_args.documents}。
• %r：回应。您可以在JSON结构中最终指定一个以点分隔的字段，如中所示%q{command_args.documents}。
• %Q{<arg>}：<arg>在存在请求数据时显示
• %R{<arg>}：<arg>在响应数据存在时显示

另外，--format支持以下开始/结束ANSI转义序列：

• %B/ %b：粗体
• %U/ %u：下划线
• %S/ %s：出色
• %F/ %f：文本颜色（必填arg-单词或数字，8色）
• %K/ %k：背景色（必填arg-与％F /％f相同）

--no-colors¶

设置后，从中删除颜色。default format

-f=<path>¶

指定monitor应读取以生成播放文件的pcap文件的路径。

-f用作使用捕获网络流量的替代方法 -i。您必须指定任一 -f或-i。如果同时包含两个选项，则mongoreplay监视器会产生错误。

-b=<number>¶

用于将单独的流合并在一起的堆大小。

--expr=<filter expression>, -e=<filter expression>¶

Berkeley数据包筛选器（BPF）语法中的表达式，适用于要记录的传入流量。如果要使用从网络接口捕获流量，则为必需 -i。

例如，要捕获来自端口27017上运行的MongoDB实例的流量，您可以指定。-e 'port 27017'

-i=<interface>¶

指定monitor应侦听以捕获网络流量的网络接口。

与一起使用-e。

使用-i作为一种替代-f，用于读取现有的PCAP文件。您必须指定任一 -f或-i。如果同时包含两个选项，则mongoreplay监视器会产生错误。

--paired¶

指定后，monitor为每个请求/答复对记录输出一行。

--gzip=<boolean>¶

如果指定，monitor则使用gzip解压缩播放文件。

--playback-file=<path>, -p=<path>¶

指定从中读取播放文件的路径。

样本记录¶

以下是JSON格式的monitor报告中的示例记录 ：

{
   "order" : 21,
   "op" : "op_msg",
   "command" : "aggregate",
   "ns" : "test",
   "request_data" : {
      "sections" : [
         {
            "payload" : {
               "$db" : "test",
               "aggregate" : "foo",
               "cursor" : {},
               "lsid" : {
                  "id" : {
                     "$binary" : "eBZNIaAbRTiAoWkaNZ0T8Q==",
                     "$type" : "04"
                  }
               },
               "pipeline" : [
                  { "$match" : { "borough" : "Queens" } },
                  { "$group" : { "_id" : "$cuisine", "count" : { "$sum": 1 } } }
               ]
            },
            "payloadType" : 0
         }
      ]
   },
   "connection_num" : 0,
   "seen" : "2018-11-15T14:07:07.136794-05:00",
   "request_id" : 25
}

字段¶

mongoreplay 报告可以包括以下字段：

order

单调递增的键，指示记录和播放操作的顺序。这可以用于重构在连接上执行的一系列操作的顺序，因为它们在报告文件中出现的顺序可能与播放顺序不匹配。

op

请求表示的操作类型：即“查询”，“插入”，“命令”，“ getmore”。

command

执行的数据库命令的名称，例如isMaster或 getLastError。对于非命令的操作（例如查询和插入），此字段保留为空白。

ns

执行请求的名称空间。

request_data

操作的有效负载。

• 查询操作：request_data包含发出的实际查询。
• 插入操作：request_data包含要插入的文档。
• 更新操作：request_data包含查询选择器和更新修饰符。

reply_data

回复请求的有效负载。

nreturned

作为操作结果返回的文档数。

played_at

的时间在该play命令执行的操作。

play_at

该play命令应该执行该操作的时间。

playbacklag_us

played_at 和之间的时间差（以微秒为单位）play_at。较高的值通常表示目标服务器无法跟上根据回放文件执行请求的速率。

connection_num

标识执行请求的连接的键。在同一连接上执行的所有请求/回复的值都相同connection_num。

该connection_num值与服务器端记录的连接ID 不匹配。

latency_us

客户端发送请求与接收到服务器响应之间的时间差（以微秒为单位）。

errors

列出从服务器返回的所有错误。

msg

列出从服务器返回的错误消息。

seen

最初捕获操作的时间。

request_id

MongoDB操作的ID。所述request_id用于请求操作是一样的response_id用于相应的答复。

使用¶进行输出格式化--format