Apache CouchDB

Apache CouchDB モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collectorは、インスタンス用の _stats エンドポイントを呼び出すことで、CouchDBインスタンスからのメトリクスを監視するために、Apache CouchDBモニタータイプでSmart Agentレシーバーを使用します。

このインテグレーションはKubernetesとLinuxでのみ利用可能です。

メリット

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

インストール

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

  2. GitHubでcollectd-couchdbをダウンロードします。

  3. couchdb_plugin.py ファイルを /usr/share/collectd/collectd-couchdb に移動します。

  4. /etc/collectd/managed_config のプラグイン用サンプル設定ファイルを、設定セクションに従って修正します。

  5. Pythonの要件をインストールします:

    DEFAULT
    $ sudo pip install -r requirements.txt
  6. OpenTelemetry コレクタを再起動します。

設定

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

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

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

YAML
receivers:
  smartagent/couchdb:
    type: couchdb
    ...  # Additional config

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

YAML
service:
  pipelines:
    metrics:
      receivers: [smartagent/couchdb]

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

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

オプション

定義

値の例

ModulePath

collectd がこのモジュールを見つけられるディスク上のパス。

"/usr/share/collectd/collectd-couchdb/"

ホスト

CouchDBメンバーのホスト名

"localhost"

ポート

メンバーに到達できるポート

“5984”

ノード

クラスター内のCouchDBノードの名前

couchdb@test_node

EnhancedMetrics

ブール値。コメントされていないcouchdb_metrics.pyを拡張するには true

メトリクスが必要かどうかを示します。

"false"

ユーザー名

CouchDBの認証に必要なユーザー名

「admin」

パスワード

CouchDBの認証に必要なパスワード

「admin」

IncludeMetric

アクティブにする _stats apiに発行されたメトリクス。

"ドキュメントに記載されているメトリクス"

ExcludeMetric

非アクティブにする _stats apiに発行されたメトリクス。

"ドキュメントに記載されているメトリクス"

ディメンション

ユーザー定義ディメンションのスペースで区切られたキーと値のペア。

dimension_name dimension_value

インターバル

CouchDB APIを呼び出す間の秒数。

10

ssl_keyfile

keyfile へのパス

“path/to/file”

ssl_certificate

証明書へのパス

“path/to/file”

ssl_ca_certs

caファイルへのパス

“path/to/file”

メトリクス

このインテグレーションでは、以下のメトリクスを使用できます:

https://raw.githubusercontent.com/signalfx/integrations/main/collectd-couchdb/metrics.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.