Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

top

項目一覧

  • 定義
  • 互換性
  • 構文
  • イベント フィールド
  • 詳細
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操作の使用状況統計 getmore.timeフィールドとgetmore.countフィールドもreadLock.timeを更新し、 readLock.countを増加させます。
insert
insert操作の使用状況統計 insert.timeフィールドとinsert.countフィールドもreadLock.timeを更新し、 readLock.countを増加させます。
update
update操作の使用状況統計 update.timeフィールドとupdate.countフィールドもreadLock.timeを更新し、 readLock.countを増加させます。
remove
delete操作の使用状況統計 remove.timeフィールドとremove.countフィールドもreadLock.timeを更新し、 readLock.countを増加させます。
commands

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

たとえば、集計操作ではreadLock.timereadLock.countが増加します。 インデックス作成はwriteLock.timewriteLock.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
}
}
}

戻る

shardConnPoolStats