MongoDB レシーバー

前提条件

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

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

• MongoDB のロールについては「MongoDB built-in roles」を参照してください。

• これらのアクセス許可の設定方法の例については、「lpu.sh」を参照してください。

はじめに

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

1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するようにレシーバーを設定します。

3. Collector を再起動します。

サンプル構成

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

receivers:
  mongodb:
    hosts:
      - endpoint: localhost:27017
    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 ドメイン ソケット エンドポイントのリスト。transport オプションが使用できなくなりました。

  • スタンドアロンの 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 Configuration Settings」を参照してください。

• direct_connectionします。true の場合、ドライバは他のノードを自動検出しようとせず、代わりにホストへの直接接続を実行します。

設定

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

メトリクス

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

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

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

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

トラブルシューティング