个性化推荐-mongolab/dex-行业智能，新时代，新科技，新码农

<h2> Dex，指数机器人</h2>
 <p> DEPRECATED  - 建议将此工具用于MongoDB版本＆lt; = 2.6 </p>
 <p> Dex是一个MongoDB性能调优工具，可将查询与查询集合中的可用索引进行比较，并根据简单的启发式方法生成索引建议。目前，您必须为数据库提供连接URI。 </p>
 <p> Dex使用您提供的URI作为确定何时推荐索引的有用方法。在实际构建理想推荐时，Dex不会考虑现有索引。 </p>
 <p>目前，Dex仅推荐完整索引，而不是部分索引。如果找不到一个索引，Dex会忽略查询可能使用的部分索引，以支持更好的索引。 Dex根据经验建议使用部分排序的索引：</p>
 <p>您的索引字段顺序应首先回答：</p>
 <ol>
 <li>等值检查</li>
 <li>排序条款</li>
 <li>范围值检查（$ in，$ nin，$ lt / gt，$ lte / gte等）</li>
 </ol>
 <p>请注意，您的数据基数可能需要与建议的索引不同的顺序。 </p>
 <p>不支持Windows。 </p>
 <h2>用法</h2>
 <h3> Common </h3>
 <p>在日志文件上运行Dex并向相应的数据库提供URI（具有auth凭证，如果有）。 </p>
 <pre><code>> dex -f my/mongod/data/path/mongodb.log mongodb://myUser:myPass@myHost:12345/myDb
</code></pre>
 <p>或者，在填充的MongoDB system.profile集合上运行Dex。建议您运行db.setProfilingLevel（1），并等待在数据库上运行一组代表性的查询/操作。然后运行db.setProfilingLevel（0）以停止分析。然后，运行Dex：</p>
 <pre><code>> dex -p mongodb://myUser:myPass@myHost:12345/myDb
</code></pre>
 <p>注意：由于Dex主要关注非索引查询，因此Dex输出不应受分析级别2生成的其他数据的影响。但是，Dex可能需要更长时间才能运行。 </p>
 <h3>按db / collection </h3>筛选
 <p> Dex支持按特定集合和数据库过滤分析。请注意，当您打算分析多个数据库时，必须为admin数据库提供连接URI。 </p>
 <pre><code>> dex -f my/mongod/data/path/mongodb.log -n "myFirstDb.collectionOne" mongodb://myUser:myPass@myHost:12345/myFirstDb

> dex -p -n "*.collectionOne" mongodb://myUser:myPass@myHost:12345/admin

> dex -f my/mongod/data/path/mongodb.log -n "myFirstDb.*" -n "mySecondDb.*" mongodb://myUser:myPass@myHost:12345/admin
</code></pre>
 <h3>按查询时间（毫秒）筛选</h3>
 <p> Dex还支持按查询执行时间过滤分析。提供-s /  -  slowms参数以规定最小时间（毫秒）。在不到指定时间内完成的查询将不会被分析。 </p>
 <pre><code>> dex -f my/mongod/data/path/mongodb.log -s 400

> dex -p -n "*.collectionOne" mongodb://myUser:myPass@myHost:12345/admin --slowms 1000
</code></pre>
 <h3>观看模式</h3>
 <p>当您提供-w /  -  watch参数时，Dex不会处理完整日志文件或system.profile集合中的任何现有内容。相反，Dex会在记录/分析条目时评估条目。在监视模式下运行时，使用键盘中断（Ctrl + C）终止Dex。 </p>
 <p>使用监视模式实时获取运行信息。 </p>
 <p>示例：</p>
 <pre><code>> dex -w -f my/mongod/data/path/mongodb.log mongodb://myUser:myPass@myHost:12345/myDb
</code></pre>
 <p>请注意，Dex仍会缓存其建议，因此每个唯一的建议只会打印一次。 </p>
 <p>使用-w /  -  watch with -p /  -  profile来监视system.profile集合时，必须通过提供形式为-n“[db_name]。*的命名空间参数将焦点过滤到一个数据库。 ＆QUOT;例如：</p>
 <pre><code>> dex -w -p -n "myDb.*" mongodb://myUser:myPass@myHost:12345/myDb
</code></pre>
 <p>此外，如果未启用性能分析，Dex将在其操作期间启用配置文件级别1。 </p>
 <h3>其他有用的选项</h3>
 <p> -t /  -  timeout  - 仅限日志文件（-f）模式。用于在几分钟后截断Dex操作。如果您的数据库生成了非常大的日志文件，您可能只需要dex 1-3分钟即可获得可用信息。 </p>
 <p> --nocheck  - 不检查数据库中的现有索引。这意味着Dex将推荐所有查询的索引，甚至索引索引。 </p>
 <h3>帮助内容</h3>
 <pre><code>usage: dex [uri] (-f <logfile_path> | -p) [<options>]

Scans a provided MongoDB log file or profile collection and uses the provided URI
to compare queries found in the logfile or profile collection to the indexes available
in the database, recommending indexes for those queries which are not indexed.
Recommended for MongoDB version 2.2.0 or later.

Options:
  -h, --help            show this help message and exit
  -f LOGFILE_PATH, --file LOGFILE_PATH
                        path to a MongoDB log file. If provided, the file will
                        be searched for queries.
  -p, --profile         flag to examine the MongoDB system.profile collection.
                        If set, the profile collection will be searched for
                        queries. URI is required for profile mode.
  -w, --watch           instructs Dex to watch the system.profile or log
                        (depending on which -p/-f is specified) for entries,
                        rather than processing existing content. Upon keyboard
                        interrupt (Ctrl+C) watch terminates and the
                        accumulated output is provided. When using watch mode
                        and profile mode together, you must target a specific
                        database using -n "dbname.*"
  -n NAMESPACES, --namespace NAMESPACES
                        a MongoDB namespace (db.collection). Can be provided
                        multiple times. This option creates a filter, and
                        queries not in the provided namespace(s) will not be
                        analyzed. Format: -n ('db.collection' | '*' | 'db.*' |
                        'collection'). '*.*' and '*.collection' are redundant
                        but also supported. An asterisk is shorthand for 'all'
                        --actual regexes are not supported. Note that -n '*'
                        is equivalent to not providing a -n argument.
  -s SLOWMS, --slowms SLOWMS
                        minimum query execution time for analysis, in
                        milliseconds. Analogous to MongoDB's SLOW_MS value.
                        Queries that complete in fewer milliseconds than this
                        value will will not be analyzed. Default is 0.
  -t TIMEOUT, --timeout TIMEOUT
                        Maximum Dex time in minutes. Default is 0 (no
                        timeout).Applies to logfile (-f) mode only.
  --nocheck             if provided, Dex will recommend indexes without
                        checkingthe specified database to see if they exist.
                        This meansDex may recommend an index that's already
                        been created
  -v, --verbose         enables provision of additional output information.
</code></pre>
 <h2>要求</h2>
 <p> Dex旨在理解mongod 2.0.4或更高版本的日志和配置文件集合。 </p>
 <p>图书馆：* pyyaml * pymongo * dargparse </p>
 <h2>安装</h2>
 <pre><code>> pip install dex
</code></pre>
 <h2>测试</h2>
 <p>要运行Dex的单元测试套件，必须在27017上启动一个mongodb服务器.Dex将使用创建dex_test数据库并在测试完成时将其删除。 </p>
 <pre><code>> python -m dex.test.test
</code></pre>
 <h2>输出</h2>
 <p>对于每次运行，Dex提供：* runStats  - 已解析日志或配置文件的统计信息* runStats.linesRead  - 发送给Dex的条目数（日志或配置文件）。 * runStats.linesAnalyzed  -  Dex成功提取查询和尝试推荐的条目数。 * runStats.linesWithRecommendations  - 提示并可能从索引建议中获益的行数。 * runStats.dexTime  -  Dex的时间启动。 * runStats.logSource  - 处理日志文件的路径。空-p /  - 配置文件模式。 * runStats.timeRange  - 传递给Dex的时间范围。包括读取的所有行。 * runStats.timedOut  - 如果Dex操作按-t /  -  timeout标志超时，则为True。 * runStats.timeoutInMinutes  - 如果timedOut为true，则包含时间。 Dex以a的形式为每个唯一查询提供信息和统计信息。建议包括：*结果 - 包括索引建议的查询报告列表。 </p>
 <h4>结果输出到STDOUT </h4>
 <p> Dex返回一组查询报告作为结果。每个查询报告都针对由“queryMask”标识的唯一查询。每份报告包括：</p>
 <ul>
 <li> queryMask  - 查询模式，其值已屏蔽（查询组件为$ query，排序组件为$ orderby）</li>
 <li> namespace  - 要在其中创建索引的MongoDB命名空间，格式为“db.collection”。 </li>
 <li> stats  - 从每个查询事件聚合的特定查询统计信息。 </li>
 <li> stats.count  - 发生的查询总数。 </li>
 <li> stats.avgTimeMillis  - 此查询当前的平均时间。 </li>
 <li> stats.totalTimeMillis  - 与queryMask匹配的所有查询所消耗的总时间。 </li>
 <li>推荐 - 完整形成的推荐对象。
 <ul>
 <li> recommendation.index  - 建议的指数。 </li>
 <li> recommendation.namespace  - 推荐命名空间。 </li>
 <li> recommendation.shellCommand  - 一个有用的字符串，用于在MongoDB shell中创建索引。 </li>
 </ul>
 </li>
 </ul>
 <p>样品：</p>
 <pre><code>
</code></pre>
 <h4>监视模式输出到STDERR </h4>
 <p> Dex在监视（-w）模式下提供运行时输出。每隔30秒，将使用更新的统计信息打印完整的建议列表。 </p>
 <h3>有问题吗？ </h3>
 <p>电子邮件support@mongolab.com </p>