MongoDB (deprecated) 🔗

注釈

The MongoDB monitor is deprecated and will reach end of support on January 15, 2025. During this period, only critical security and bug fixes are provided. When the monitor reaches end of support, you won’t be able to use it to send data to Splunk Observability Cloud. To monitor your MongoDB databases, you can instead use the native OpenTelemetry MongoDB receiver. See MongoDB レシーバー to learn more.

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the MongoDB monitor type to capture the following metrics about MongoDB:

メモリ
ネットワーク入出力バイト数
ヒープ使用量
DB接続
オペレーション数
アクティブなクライアント接続
キュー登録済みオペレーション

このプラグインは、以下のDB固有のメトリクスもキャプチャします：

DBサイズ
DBカウンター

前提条件 🔗

以下が該当します：

このインテグレーションはKubernetesとLinuxでのみ利用可能です。
このインテグレーションにはMongoDB 2.6以上が必要です。
This integration is not supported for Splunk OTel Collector versions 0.99.0 or higher. Use the MongoDB レシーバー instead.

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索するを参照してください。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetesにインストールする
- Linuxにインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

認証 🔗

セキュリティで保護されたMongoDBデプロイメントを監視している場合は、次のように最小限の読み取り専用ロールを持つMongoDBユーザーを作成します：

db.createUser( {
  user: "<username>",
  pwd: "<password>",
  roles: [ { role: "readAnyDatabase", db: "admin" }, { role: "clusterMonitor", db: "admin" } ]
});

注釈

SCRAM-SHA-1認証のみがサポートされています。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/mongodb:
    type: collectd/mongodb
    ...  # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/mongodb]

コンフィギュレーション設定 🔗

次の表に MongoDB モニターの設定オプションを示します：

オプション	必須	タイプ	説明
`pythonBinary`	いいえ	`string`	Pythonバイナリへのパス。設定されていない場合、組み込みのランタイムが使用されます。この設定ではバイナリに引数を含めることができます。
`host`	はい	`string`	MongoDB インスタンスのホスト名または IP アドレス。
`port`	はい	`integer`	MongoDB インスタンスのポート。デフォルト値は `27017` です。
`databases`	はい	`list of strings`	監視したいデータベースの名前。このリストの最初のデータベースは `serverStatus()` の呼び出しに使用されるため、`admin` でなければなりません。
`username`	いいえ	`string`	MongoDBユーザー。
`password`	いいえ	`string`	`username` で定義されたユーザーのパスワード。
`useTLS`	いいえ	`bool`	`true` の場合、モニターはTLSを使ってMongoDBに接続します。デフォルト値は `false` です。
`caCerts`	いいえ	`string`	パス。MongoDB が提示する証明書を検証するために使用されます。TLS を使っていない場合や、MongoDB 証明書がグローバルに信頼されている発行元によって署名されていて、システムのデフォルトの場所にすでにインストールされている場合は不要です。
`tlsClientCert`	いいえ	`string`	クライアント証明書へのパス。MongoDB インスタンスが x509 クライアント検証を必要とする場合を除き、不要です。
`tlsClientKey`	いいえ	`string`	クライアント証明書キーへのパス。MongoDB インスタンスがインスタンスがx509クライアント検証を必要としないか、`tlsClientCert` で定義されたクライアント証明書にキーが含まれている場合は、不要です。
`tlsClientKeyPassPhrase`	いいえ	`string`	`tlsClientKey` で定義されているTLSクライアント鍵のパスフレーズ。
`sendCollectionMetrics`	いいえ	`bool`	コレクション・レベルのメトリクスを送信するかどうか。デフォルト値は `false` です。
`sendCollectionTopMetrics`	いいえ	`bool`	コレクション・レベルのトップ・タイミング・メトリクスを送信するかどうか。デフォルト値は `false` です。

注釈

TLS認証を使用する場合、SCRAM-SHA-256はサポートされません。SCRAM-SHA-1認証を使用してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

This page was last updated on 2024年10月07日.

Related Topics