• /
  • ログイン
  • 無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

MongoDBモニタリングの統合

当社のMongoDB 統合 は、お客様のMongoDBクラスターからインベントリとメトリクスを収集して当社のプラットフォームに送信し、主要なパフォーマンスメトリクスを集約して可視化することができます。モンゴ、モンゴッド、コンフィグサーバー、データベース、コレクションのデータを収集し、パフォーマンスのボトルネックを特定します。

インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。

互換性および要件

当社のインテグレーションは、MongoDB v3.0+に対応しています。MongoDB Atlasは、M10以上の階層でサポートされています。

インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。

クイックスタート

ガイド付きインストールで、MongoDB クラスタをすばやくインスツルメンテーションし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。 ガイド付きインストールCLIのスクリーンショット。 始める準備はできていますか?ボタンの1つをクリックし、試行してください。

ガイド付きインストール

このガイド付きインストールでは、インフラストラクチャエージェントを使用してMongoDBの統合を設定します。それだけでなく、環境で稼働している他のアプリケーションやログソースを検出し、どのアプリケーションを導入すべきかを推奨してくれます。ガイド付きのインストールは、ほとんどのセットアップに対応しています。しかし、ニーズに合わない場合は、以下の他の方法でMongoDBデータベースの監視を始めることができます。## インストールと有効化 [#install]MongoDBインテグレーションをインストールするには、お使いの環境に応じた指示に従ってください。

追加の注: アドバンスト:インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。

オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新Infrastructureエージェントの更新を定期的に実施してください。## 設定 [#configuration]### MongoDBサーバーの有効化 [#enable-instance][MongoDB シェル](https://docs.mongodb.com/manual/mongo/) で以下のコマンドを実行して、 listCollections ロールと新しいユーザーを作成し、 clusterMonitorlistCollections ロールを新しいユーザーに割り当てます。注: username, password, および同様のユーザー固有の値を置き換える必要があります。ユーザーの作成ロールの作成 の詳細については、MongoDB のドキュメントを参照してください。

ヒント

監視対象のモンゴでこれらの手順を完了します。ホストやレプリカ・セットの統計など、mongodレベルのメトリクスを収集する場合は、各mongodでもロールとユーザーを作成します。
1. MongoDB のシェルで、 use admin と入力します。

  1. 次のコマンドを使用して、 listCollections ロールを作成します。

    db.createRole({
    role: "listCollections",
    privileges: [{
    resource: {db:"",collection:""},
    actions: ["listCollections"]
    }],
    roles: []
    })
  2. 以下のコマンドを使用して新しいユーザーを作成し、 clusterMonitorlistCollections のロールをユーザーに割り当てます。

    db.createUser({
        user: "username",
        pwd: "password",
        roles: [
            "clusterMonitor",
            "listCollections"
        ]
    })

インテグレーションの設定

インストールの方法により、インテグレーションの設定方法はいくつかあります。* Kubernetesで有効化した場合:Kubernetes上で実行中のサービスの監視を参照してください。

  • Amazon ECSで有効化した場合:ECS上で実行中のサービスの監視を参照してください。
  • オンホストでインストールした場合:インテグレーションのYAML設定ファイルのコンフィグを編集する mongodb-config.yml.インテグレーションのYAML形式設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。設定ファイルには、 intervaltimeoutinventory_source など、すべての統合に適用される共通の設定があります。これらの共通設定については、 Configuration Format のドキュメントを参照してください。

重要

従来の設定/定義ファイルをまだお使いの場合は、こちらの ドキュメント を参考にしてください。

MongoDBに関連する特定の設定は、設定ファイルの env セクションで定義します。これらの設定は、MongoDB インスタンスへの接続を制御するだけでなく、その他のセキュリティ設定や機能も制御します。有効な設定のリストは、このドキュメントの次のセクションで説明します。

ヒント

MongoDBインテグレーションでは、MongoDBのフルクラスタを監視するようにも、スタンドアロンのMongoDBインスタンスを監視するようにも設定できます。クラスタを監視するには、 ホストポート 引数 がクラスタ内の mongos インスタンスの一つを指している必要があります。

代わりにスタンドアロンのインスタンスを監視したい場合は、 ホストポート が、データベースを実行している mongod を指すようにします。

MongoDB インスタンスの設定

MongoDBインテグレーションでは、メトリクス情報とインベントリ情報の両方を収集します。表の中で、 Applies To カラムを使って、各コレクションで利用できる設定を確認してください。

設定

説明

デフォルト

適用対象

mongodb_cluster_name

監視対象のクラスターを一意に識別するためのユーザー定義名。 必須.

該当なし

メトリクス/インベントリ

HOST

MongoDBが稼働しているホスト名またはIP。

localhost

メトリクス/インベントリ

ポート

MongoDBが待ち受けているポート。

27017

メトリクス/インベントリ

ユーザー名

MongoDBサーバーにアクセスするためのユーザー名。

該当なし

メトリクス/インベントリ

パスワード

指定ユーザーのパスワード。

該当なし

メトリクス/インベントリ

AUTH_SOURCE

認証を行うデータベースです。

admin

メトリクス/インベントリ

SSL

MongoDBサーバーとの通信にSSLを使用します。

false

メトリクス/インベントリ

SSL_CA_CERTS

ホスト上のSSL証明書の位置。 SSL がtrueの場合のみ必要です。

該当なし

メトリクス/インベントリ

SSL_INSECURE_SKIP_VERIFY

サーバーの証明書チェーンとホスト名の検証をスキップします。

false

メトリクス/インベントリ

PEM_KEY_FILE

秘密鍵とクライアント証明書を含むPEMファイルの場所。

該当なし

メトリクス/インベントリ

PASSPHRASE

PEMKeyFileファイルを復号化するためのパスフレーズ。

該当なし

メトリクス/インベントリ

コンカレント・コレクティング

並行してメトリクスを収集するエンティティの数。

50

メトリクス

FILTERS

データベース名からコレクション名の配列へのJSONマップです。空の場合は、デフォルトですべてのデータベースとコレクションになります。

該当なし

メトリクス

メトリクス

trueに設定すると、メトリクスのみの収集が有効になります。

false

インベントリ

trueに設定すると、インベントリのみの収集が有効になります。

false

これらの設定値は、いくつかの方法で定義できます。* コンフィグファイルに直接値を追加する。これが最も一般的な方法です。

  • {{}} 表記を使用して環境変数から値を置き換えます。これには、インフラストラクチャ・エージェント v1.14.0+が必要です。詳しくはこちら または、以下の例をご覧ください .
  • シークレット管理を使用する。設定ファイル上で平文で公開されてしまうようなパスワードなどの機密情報を保護するために使用します。詳細については、 Secrets management を参照してください。

ラベル/カスタム属性

メトリクスは、ラベルを使ってさらに装飾することができます。

デフォルトのサンプル・コンフィグ・ファイルにはラベルの例が含まれていますが、これらは必須ではありませんので、お好きなものを削除、変更、または新たに追加することができます。

labels:
env: production
role: load_balancer

設定の例

データの検索と使用

このサービスからのデータは、インテグレーションダッシュボードにレポートされます。メトリクスは、これらの イベントタイプ に付けられています。* MongoCollectionSample

  • MongoConfigServerSample
  • MongoDatabaseSample
  • MongodTopSample
  • MongoSample
  • MongodSample
  • MongosSample

トラブルシューティング目的で、またはカスタムのチャートとダッシュボードを作成するために、このデータのクエリを行えます。データの検索・使用方法の詳細については、 インテグレーションデータを理解するを参照してください。## メトリックデータ [#metrics]MongoDBインテグレーションでは、以下のメトリックデータ属性を収集します。 asserts. または collection. のように、メトリック名の前にカテゴリー指標とピリオドが付くものがあります。

ヒント

クラスタとスタンドアロンのどちらのインスタンスを監視しているかで、異なるメトリクスが利用できます。スタンドアロンインスタンスの場合は、 MongodSample, MongoDatabaseSample, MongodTopSampleMongoCollectionSample だけが収集されます。クラスタの場合は、すべてのイベントタイプが収集されます。

インベントリデータ

MongoDBインテグレーションでは、クラスタ内の各ホストから、すべてのコマンドラインオプションとランタイム設定パラメータを取得します。このデータは、 Inventoryページconfig/mongodb ソースの下で利用できます。在庫データについては、 Understand integration data を参照してください。## ソースコードのチェック [#source-code]このインテグレーションは、オープンソース・ソフトウェアです。つまり、 そのソースコードを閲覧して 改良を送ったり、独自のフォークを作成して構築することができます。

問題を作成する
Copyright © 2022 New Relic Inc.