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の要件をインストールします:

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

設定

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

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

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

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

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

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

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 の設定方法を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______