MongoDB のモニター
MongoDB センサーは、Instana エージェントのインストール後、自動的に展開され、インストールされます。
サポート情報
MongoDB センサーが現在のセットアップと互換性があることを確認するには、以下のサポート情報セクションをチェックしてください:
サポート対象のオペレーティング・システム
このセンサーは、Instanaホストエージェントと同じオペレーティングシステムをサポートします。 詳細は、各ホストエージェントの「 サポート対象オペレーティングシステム」 セクションを参照してください。例:
対応バージョンとサポートポリシー
このセンサーは、 MongoDB および MongoDB Atlas の以下のバージョンをサポートしています:
- MongoDB 3.2.x
- MongoDB 3.4.x
- MongoDB 3.6.x
- MongoDB 4.0.x
- MongoDB および MongoDB アトラス 4.2.x
- MongoDB および MongoDB アトラス 4.4.x
- MongoDB および MongoDB アトラス 5.0.x
- MongoDB および MongoDB アトラス 6.0.x
- MongoDB および MongoDB アトラス 7.0.x
- MongoDB および MongoDB アトラス 8.0.4
以下の表は、最新のサポートバージョンとサポートポリシーを示しています:
| テクノロジー | サポート・ポリシー | 最新技術バージョン | サポートされる最新バージョン |
|---|---|---|---|
| MongoDB | 45 日間 | 8.2.2 | 8.2.2 |
| MongoDB Atlas | 45 日間 | 8.2.2 | 8.2.2 |
サポートポリシーの詳細については、 「センサーのサポート戦略」 を参照してください。
クライアントサイド・トレース対応
構成
MongoDB 認証を無効にした場合
アクションは不要です。 認証が無効になっている MongoDB のモニターは、 configuration.yaml ファイルに構成を指定しなくても自動的に行われます。
MongoDB 認証を有効にした場合
MongoDBをモニターするには、以下の最小限の役割を持つユーザーを作成する必要があります。
read-adminデータベース上clusterMonitoer-adminデータベース上read-localデータベース上
mongo シェルで、 admin データベース内に Instana エージェントのユーザーを作成します。
adminユーザーとして認証します。use admin db.auth("admin", "YOUR_MONGODB_ADMIN_PASSWORD")- MongoDB 3.x 以降のバージョンの場合は、
createUserコマンドを実行します。db.createUser({ "user":"stan", "pwd": "UNIQUEPASSWORD", "roles" : [ {role: 'read', db: 'admin' }, {role: 'clusterMonitor', db: 'admin'}, {role: 'read', db: 'local' } ] })
注
MongoDB Atlas を使用している場合、ユーザー (割り当てられたすべての役割を持つ) は、MongoDB Atlas 管理コンソールを介してのみ作成できます。
ユーザーが作成された後、エージェント構成ファイルでそのユーザーを構成できます。
com.instana.plugin.mongodb: user: 'stan' source: 'admin' password: 'UNIQUEPASSWORD' poll_rate: general_metrics: 1 # general MongoDB metrics (connections, ops, etc.) replicaset_metrics: 30 # replica set state metrics
sourceは、ユーザーが定義されているデータベースまたは認証ソースを参照します。 詳細は MongoDB のドキュメントを参照。
--bind_ip を特定の IP アドレスで設定するか、デフォルト値 127.0.0.1 に設定しないでください。 bind_ip_all 。MongoDB Atlas サポート
Instana エージェントは、さまざまなプロジェクトおよび組織に存在する MongoDB Atlas クラスターのリモート・モニターをサポートします。 Instana エージェントが MongoDB Atlas 組織をモニターできるようにするには、 <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があります。
com.instana.plugin.mongodb:
user: 'stan'
source: 'admin'
password: 'UNIQUEPASSWORD'
poll_rate:
general_metrics: 1 # general MongoDB metrics (connections, ops, etc.)
replicaset_metrics: 30 # replica set state metrics
atlas:
- publicKey: 'your public key'
privateKey: 'your private key'
- publicKey: 'your public key'
privateKey: 'your private key'
注
- 公開鍵と秘密鍵で構成される API 鍵は、MongoDB Atlas 組織レベルで定義する必要があります。 最低限必要な組織権限は
Organization Read Onlyです。 - MongoDB Atlas を使用している場合、割り当てられたすべての役割を持つユーザーは、MongoDB Atlas 管理コンソールを介してのみ作成できます。
SSL/TLS サポート
Instana エージェントを MongoDB サーバーに安全に接続するには、 <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があります。
com.instana.plugin.mongodb:
...
sslTrustStore: '/path/to/truststore.jks'
sslTrustStorePassword: 'mongoTsPassword'
sslKeyStore: '/path/to/sslKeyStoreFile.jks'
sslKeyStorePassword: 'mongoKsPassword'
SSL/TLS サポート機能を有効にするには、鍵が Java 鍵ストアの形式 (JKS) でなければなりません。 keytoolは、これらのキーを作成するために使用することができます。
注
この機能により、Instana エージェントが SSL/TLS を使用して MongoDB サーバーに接続できるようになります。 接続後、資格情報 (ユーザー/パスワード) が auth-database へのアクセスに使用されます。
メトリック収集
メトリクスを表示するには、Instana ユーザーインターフェイスのサイドバーでインフラストラクチャを選択し、特定の監視ホストをクリックします。
構成データ
- バージョン
- ポート
- ストレージ・エンジン
- データベース
パフォーマンス・メトリック
データベース・アクティビティー
| メトリック | 説明 |
|---|---|
| 読み取り | 読み取られた文書の数 |
| 挿入済み | 挿入された文書の数 |
| アップロード済み | アップロードされた文書の数 |
| 削除済み | 削除された文書の数 |
操作カウンタ
| メトリック | 説明 |
|---|---|
| Update | mongodインスタンスが最後に起動してから受け取った更新操作の総数。 |
| 挿入 | mongodインスタンスが最後に起動してから受け取ったインサート操作の総数。 |
| 照会 | mongodインスタンスが最後に起動した後に受け取ったクエリの総数。 |
| 削除 | mongodインスタンスが最後に起動してからの削除操作の総数。 |
| getMore | mongodインスタンスが最後に起動してからの getMore 操作の総数。 |
メモリー
| メトリック | 説明 |
|---|---|
| 仮想 | これには、MongoDB プロセス全体の仮想メモリーが含まれます。 ジャーナリングをオンにした場合、これは通常、マップされたメモリーのサイズの 2 倍になります。 |
| マップ済み | これは、データベースをメモリーにマップするために MongoDB の進行で使用される仮想メモリーの量です。 これは通常、データベースのサイズです。 |
クライアント
| メトリック | 説明 |
|---|---|
| 接続数 | MongoDB サーバーに接続している現在のアクティブクライアント数。 |
| ActiveClients 作家 | 書き込み操作を行うアクティブなクライアント接続の数。 |
| ActiveClients 読者 | 読み取り操作を行うアクティブなクライアント接続の数。 |
データベース (データベースごと)
| メトリック | 説明 |
|---|---|
| データベースのサイズ | データベース・サイズ |
レプリカ・セット (存在する場合)
| メトリック | 説明 |
|---|---|
| 適用操作数 | 内部適用操作の数 |
| 適用バッチ | 内部適用バッチの数 |
| 合計適用バッチ (ミリ秒) | 適用バッチの期間 (ミリ秒) |
| バッファー・カウント | バッファーの数 |
| バッファー・サイズ | バッファーのサイズ |
| ネットワーク操作 | ネットワーク操作数 |
| ネットワーク・バイト数 | ネットワーク操作のサイズ |
| 文書プリロード | 文書プリロード操作の数 |
| 合計文書プリロード (ミリ秒) | 文書プリロードの期間 (ミリ秒) |
| Idx プリロード | Idx プリロード操作の数 |
| 合計 Idx プリロード (ミリ秒) | Idx プリロードの期間 (ミリ秒) |
| レプリケーション・ラグ | 1 次上の書き込み操作と 2 次へのコピーとの間の遅延 (ミリ秒) |
Atlas クラスター (存在する場合)
| メトリック | 説明 |
|---|---|
| 読み取り | 読み取られた文書の数 |
| 挿入済み | 挿入された文書の数 |
| アップロード済み | アップロードされた文書の数 |
| 削除済み | 削除された文書の数 |
| 接続数 | 現在接続されているクライアントの数 |
| ネットワーク操作 | ネットワーク操作数 |
| ネットワーク・バイト数 | ネットワーク操作のサイズ |
正常性シグニチャー
センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。
組み込みイベントはエンティティのヘルスシグネチャの失敗に基づいて問題やインシデントをトリガーし、 カスタムイベントは任意のエンティティの個々のメトリックのしきい値に基づいて問題やインシデントをトリガーします。
MongoDB センサーの内蔵イベントについては、 内蔵イベントリファレンスを参照。