メインコンテンツまでスキップ

設定する

1. サポートバージョン​

  • MongoDB 4.0.0以上 のバージョンをサポートします。

参考: Cloud環境でのMongoDBモニタリングのサポート有無は別途確認が必要です。


2. 必須権限​

基本モニタリング権限​

モニタリングアカウント(例: exemone)に clusterAdmin ロールを付与する必要があります。

use admin
db.createUser({
user: "exemone",
pwd: "password",
roles: [
{ role: "clusterAdmin", db: "admin" }
]
})

clusterAdmin ロールには、以下のような主な機能が含まれます。

  • クラスター状態の照会
  • Replica SetおよびShard Clusterの管理・モニタリング
  • サーバー統計の照会(serverStatus、currentOp など)
  • Active Sessionの照会およびKill Sessionの実行

3. 事前設定事項​

Slow Query収集設定​

サポートバージョン: exemone-db-agent v3.0.508.37 以上

Slow Query収集のためには、以下の2段階の設定が必要です。

Step 1) MongoDBプロファイリングの有効化

// プロファイリングレベルの設定(level 1: slow queryのみ記録)
db.setProfilingLevel(1)

// または特定のthreshold値と併せて設定
db.setProfilingLevel(1, { slowms: 100 })
プロファイリングレベル説明
0プロファイリング無効化
1slowms基準を超えるクエリのみ記録
2すべてのクエリを記録

Step 2) Slow Query基準時間(slowms)の設定

MongoDBのslow query基準時間(slowms)を状況に合わせて設定します。

// slowms値の変更(単位: ミリ秒)
db.setProfilingLevel(1, { slowms: 200 })

exemONEモニタリングオプション設定​

MongoDBインスタンスは、Setting > Database のInstance登録/編集画面の Custom Configuration に以下のキー値を設定することで、収集方式を細かく調整できます。

パス: Setting > Database > Edit Instance > Custom Configuration

オプション説明
mongodb.slow_query_limitSlow Query収集limitの設定値です。

参考: mongodb.slow_query_limit オプションは以下のバージョン以上で使用できます。

モジュールバージョン
exemone-db-agentv3.0.508.37
exemone-cloud-agentv3.0.508.1
exemone-receiverv3.0.508.10
exemone-ingesterv3.0.508.24
exemone-alerterv3.0.508.38
exemone-corev3.0.508.34
exemone-apiv3.0.508.87
exemone-gatewayv3.0.508.3
exemone-frontv3.0.508.69