MongoDB レシーバー 🔗
The MongoDB receiver fetches metrics from standalone MongoDB clusters, including non-Atlas managed MongoDB servers. The supported pipeline type is metrics
. See パイプラインでデータを処理する for more information.
レシーバーはMongoDBの dbStats
と serverStatus
コマンドで統計情報を収集し、golangのmongoドライバーを使います。詳しくは Mongo Go driver documentation を参照ください。
注釈
Use the MongoDB receiver in place of the deprecated SignalFx Smart Agent mongodb
monitor type.
前提条件 🔗
The MongoDB receiver supports MongoDB versions 4.0+ and 5.0.
MongoDB では、clusterMonitor
ロールを持つ最小権限ユーザー (LPU) を設定してメトリクスを収集することを推奨しています。
MongoDB のロールについては、MongoDB 組み込みのロール を参照してください。
For an example of how to configure these permissions, see lpu.sh .
注釈
MongoDB で自動ディスカバリーを使っている場合は、Automatic discovery for MongoDB を参照してください。
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:
Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:
次のセクションで説明するようにレシーバーを設定します。
Collector を再起動します。
サンプル構成 🔗
To activate the MongoDB receiver, add mongodb
to the receivers
section of your configuration file, as shown in the following example:
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 control. By default insecure settings are rejected and certificate verification is on. See more at TLS Configuration Settings .
設定 🔗
The following table shows the configuration options for the MongoDB receiver:
メトリクス 🔗
以下のメトリクス、リソース属性、および属性が使用できます。
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 に送信されません。
Billing 🔗
If you’re in a MTS-based subscription, all metrics count towards metrics usage.
ホストベースのプランに加入している場合、このドキュメントでアクティブ(Active: Yes)と記載されているメトリクスはデフォルトとみなされ、無料で含まれます。
Learn more at Infrastructure Monitoringのサブスクリプション使用状況(ホストとメトリクスのプラン).
トラブルシューティング 🔗
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 マニュアルの チャットグループ を参照してください。