AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

トップ(データベースコマンド)

top

topは、各コレクションの使用状況統計を返す管理コマンドです。 topメトリクスを使用して、コレクションの相対的なパフォーマンスを相互に比較できます。

重要

topコマンドはmongodインスタンスに対して実行する必要があります。 topmongos インスタンスに対して を実行すると、エラーが返されます。

すべてのコレクションに対して、 topは、各イベントの実行にかかるtimeの量と、各イベントが実行された回数のcountをマイクロ秒単位で返します。 timeメトリクスとcountメトリクスは、 mongodインスタンスを再起動した後にのみリセットされます。

Queryable Encryptionを使用する場合、 topコマンドはコレクション名のみを返します。

このコマンドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

top管理データベース に対して コマンドを発行します。

db.runCommand( { top: 1 })

topコマンドは、次のイベント フィールドの使用状況統計を返します。

フィールド
説明

total

すべてのreadLock操作とwriteLock操作の組み合わせ。

readLock

読み取りロック(read lock) を使用する操作の使用状況統計。 これらの操作には、クエリや集計が含まれますが、これらに限定されません。

writeLock

書込みロック (write lock) を使用する操作の使用状況統計 これらの操作には、ドキュメントの挿入、更新、削除が含まれますが、これらに限定されません。

queries

クエリ操作 の使用状況統計findなど)。 queries.timeフィールドとqueries.countフィールドもreadLock.timeを更新し、 readLock.countを増加させます。

getmore

操作の使用状況統計getMore

insert

insert操作の使用状況統計 insert.timeフィールドとinsert.countフィールドもwriteLock.timeを更新し、 writeLock.countを増加させます。

update

update操作の使用状況統計 update.timeフィールドとupdate.countフィールドもwriteLock.timeを更新し、 writeLock.countを増加させます。

remove

delete操作の使用状況統計 remove.timeフィールドとremove.countフィールドもwriteLock.timeを更新し、 writeLock.countを増加させます。

commands

集計、インデックス作成、インデックス削除などの操作の使用状況統計。 コマンドの種類に応じて、 commands.timeフィールドとcommands.countフィールドはwriteLockフィールドまたはreadLockフィールドを更新します。

たとえば、集計操作ではreadLock.timeとreadLock.countが増加します。 インデックス作成はwriteLock.timeとwriteLock.countを増加させます。

topコマンドの出力は次の出力のようになります。

{ "totals" : { note: "all times in microseconds", "records.users" : { "total" : { "time" : 305277, "count" : 2825 }, "readLock" : { "time" : 305264, "count" : 2824 }, "writeLock" : { "time" : 13, "count" : 1 }, "queries" : { "time" : 305264, "count" : 2824 }, "getmore" : { "time" : 0, "count" : 0 }, "insert" : { "time" : 0, "count" : 0 }, "update" : { "time" : 0, "count" : 0 }, "remove" : { "time" : 0, "count" : 0 }, "commands" : { "time" : 0, "count" : 0 } }}