MongoDB レシーバー 🔗

MongoDBレシーバーは、Atlasが管理していないMongoDBサーバーを含む、スタンドアロンのMongoDBクラスターからメトリクスをフェッチします。サポートされているパイプラインタイプは metrics です。詳細はパイプラインでデータを処理するを参照してください。

レシーバーはMongoDBの dbStats と serverStatus コマンドで統計情報を収集し、golangのmongoドライバーを使います。詳しくは Mongo Go driver documentation を参照ください。

注釈

非推奨のSignalFx Smart Agent mongodb モニタータイプの代わりに MongoDBレシーバーを使用します。

前提条件 🔗

MongoDBレシーバーはMongoDBバージョン4.0+と5.0をサポートしています。

MongoDB では、clusterMonitor ロールを持つ最小権限ユーザー (LPU) を設定してメトリクスを収集することを推奨しています。

MongoDB のロールについては、MongoDB 組み込みのロールを参照してください。
これらのアクセス許可の設定方法の例については、lpu.sh を参照してください。

注釈

MongoDB で自動ディスカバリーを使っている場合は、MongoDBの自動ディスカバリーを参照してください。

はじめに 🔗

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するようにレシーバーを設定します。
Collector を再起動します。

サンプル構成 🔗

MongoDBレシーバーを有効にするには、次の例のように、設定ファイルの mongodb セクションに receivers を追加します：

receivers:
  mongodb:
    hosts:
      - endpoint: localhost:27017
        transport: tcp
    username: otel
    password: ${env:MONGODB_PASSWORD}
    collection_interval: 60s
    initial_delay: 1s
    tls:
      insecure: true
      insecure_skip_verify: true

コンフィギュレーションを完了するには、コンフィギュレーションファイルの service セクションの metrics パイプラインに、レシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers: [mongodb]

設定オプション 🔗

以下の設定はオプションです：

hosts。デフォルトでは [localhost:27017] です。host:port またはUnixドメインソケットエンドポイントのリスト。
- スタンドアロンの MongoDB デプロイの場合は、これは mongod インスタンスのホスト名とポート番号です。
- レプリカセットの場合は、レプリカセット設定にある mongod インスタンスのホスト名とポートを指定します。replica_set フィールドを指定すると、ノードは自動ディスカバリーされます。
- シャーディングされた MongoDB デプロイの場合、mongos ホストのリストを指定します。
username：認証が必要な場合は、clusterMonitor のアクセス許可をここに入力します。
password：認証が必要な場合は、ここにパスワードを入力してください。
collection_interval デフォルトでは 1m です。このレシーバーは、ある間隔でメトリクスを収集します。有効な時間単位は ns、us （または µs ）、ms、s、m、h です。この値は、Golangのtime parseDurationで読める文字列でなければなりません。詳しくは ParseDuration を参照してください。
initial_delay デフォルトでは 1s 。このレシーバーが開始するまでの待ち時間を定義します。
replica_set：MongoDBのデプロイがレプリカセットの場合は、レプリカセット名を指定します。レプリカセット内の他のノードを自動ディスカバリーできるようになります。
timeout。デフォルトでは 1m です。mongo に対してコマンドを実行する際のタイムアウト。
tls：TLSコントロール。デフォルトでは、安全でない設定は拒否され、証明書の検証はオンになっています。詳しくは TLSコンフィギュレーション設定を参照してください。

設定 🔗

次の表にMongoDBレシーバーの設定オプションを示します：

メトリクス 🔗

以下のメトリクス、リソース属性、および属性が使用できます。

mongodb.extent.count は、mmapv1 ストレージエンジンを搭載した 4.4 未満のバージョンで利用可能です。

特定のメトリクスをアクティブまたは非アクティブにする 🔗

各メトリクスの metrics セクションの enabled フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

以下は、アクティブ化されたメトリクスを持つホスト・メトリクス・レシーバーの構成例です：

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true

注釈

無効化されたメトリクスは Splunk Observability Cloud に送信されません。

請求 🔗

MTSベースのサブスクリプションでは、すべてのメトリクスがメトリクスの使用量にカウントされます。
ホストベースのプランに加入している場合、このドキュメントでアクティブ（Active: Yes）と記載されているメトリクスはデフォルトとみなされ、無料で含まれます。

詳しくは Infrastructure Monitoringのサブスクリプション使用状況（ホストとメトリクスのプラン）を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

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

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日に最終更新されました。

Related Topics