MongoDB ドライバ 2.x Node.js アプリケーションの監視
MongoDB 2.x Node.js データベース オペレーションに関するメトリック、トランザクション追跡、およびエラー情報を表示することができます。
apmdevops106
MongoDB 2.x Node.js データベース オペレーションに関するメトリック、トランザクション追跡、およびエラー情報を表示することができます。
2
2
MongoDB ドライバ 2.x Node.js メトリックの表示
MongoDB ドライバ Node.js ドライバ API バージョン 2.x の Node.js エージェント プローブは、サマリおよびオペレーション レベルのメトリックをレポートします。
サマリ レベルの MongoDB メトリック
メトリック ブラウザの次の場所で、サマリ レベルのメトリックを表示できます: <probe_name> Agent|Backends|<database_name> (MongoDB)
オペレーション レベルの MongoDB メトリック
オペレーション レベルのメトリックは、読み取りと書き込みという 2 つの論理グループに分けられます。
読み取りオペレーション
MongoDB の読み取りオペレーションでは、MongoDB データベースに格納されているデータを取得します。
MongoDB の読み取りオペレーションでは、モニタリング用に次のメソッドをサポートしています:
find
、next
、toArray
、および forEach
。メトリック ブラウザの以下の場所で、5 つの標準 BlamePoint メトリックを表示できます。
<probe_name> Agent|Backends|<database_name> (MongoDB)|Read Operations|<operation>
書き込みオペレーション
MongoDB の書き込みオペレーションでは、MongoDB データベースに格納されているデータを変更します。
MongoDB の書き込みオペレーションでは、モニタリング用に次のメソッドをサポートしています:
insert
、insertOne
、insertMany
、update
、updateOne
、updateMany
、remove
、deleteOne
、および deleteMany。メトリック ブラウザの以下の場所で、5 つの標準 BlamePoint メトリックを表示できます。
<probe_name> Agent|Backends|<database_name> (MongoDB)|Write Operations|<operation>
MongoDB トランザクション追跡コンポーネント
[追跡ビュー]
タブには、通常、MongoDB 呼び出しトランザクションのトランザクション追跡に 1 つ以上の MongoDB コンポーネントが表示されます。 MongoDB コンポーネント名は、以下のいずれかの[メトリック ブラウザ]ツリーのパスとして表示されます。- Backends|<database_name> (MongoDB)
- Backends|<database_name> (MongoDB)|Read Operations|<operation>
- Backends|<database_name> (MongoDB)|Write Operations|<operation>
各コンポーネントには以下のプロパティがあります。これらは[プロパティ]ボックスの下に一覧表示されています。
- collectionName: オペレーションが実行されたコレクションの名前
- dbName: データベース名
- dbServer: MongoDB サーバのホストおよびポート情報
エージェントがトランザクション エラーのトランザクション追跡を収集する場合は、以下の追加のプロパティが一覧表示されます。
- エラー メッセージ: 完全な詳細 MongoDB エラー メッセージ
- 例外: MongoDB エラー名
MongoDB クエリ プロパティを表示するようにトランザクション追跡を設定
追跡ビューの[プロパティ]ボックスに、MongoDB の
query
プロパティを表示できます。reportRawQuery
プロパティを true
に設定すると、MongoDB データベースに保存されている機密データにアクセスできるようになります。 たとえば、個人識別番号やパスワードなどです。- ca-apm-probe インストール ディレクトリに移動します。
- config.json ファイルをテキスト エディタで開きます。
- reportRawQueryプロパティを true に設定します。
- ファイルを保存して閉じます。
MongoDB エラー スナップショット コンポーネント
MongoDB ドライバ Node.js ドライバの Node.js エージェント プローブは、エラーになった MongoDB トランザクションのエラー スナップショットを収集します。
たとえば、問題切り分け担当者がトランザクション追跡を調査して、エラーに気付きます。 問題切り分け担当者は
[エラー]
タブをクリックし、[スタック ビュー]
を調査します。 問題切り分け担当者は、my_testdb MongoDB
データベースが insertMany
書き込みオペレーションを実行できなかったことを確認します。 関連するエラー メッセージは赤色で表示されます。MongoDB ドライバ 2.x Node.js プローブのトラブルシューティング
問題の状況:
メトリック ブラウザの
[Backends]
ノードの下に、MongoDB のメトリックが表示されません。解決方法:
Node.js プローブのログ ファイルに、MongoDB がロードしている
mongodb
モジュールに関するメッセージがリスト表示されていることを確認します。たとえば、以下のように表示されます。2016/02/22 12:52:44:146-08:00 - info: Noticed module: mongodb-core 2016/02/22 12:52:44:317-08:00 - info: Noticed module: mongodb
これらのメッセージが表示されていない場合
- Node.js アプリケーションで MongoDB パッケージが使用されていることを確認します。パッケージ化された MongoDB が Node.js アプリケーションの依存項目としてインストールされていることを確認します。
- MongoDB プローブが正しくインストールされていることを確認します。
- CA APM Node.js エージェントで MongoDB のバージョンがサポートされていることを確認します。MongoDB ドライバのバージョン 2.x がインストールされていることを確認します。