Apache CouchDB
Apache CouchDB モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください
Splunk Distribution of OpenTelemetry Collectorは、インスタンス用の _stats エンドポイントを呼び出すことで、CouchDBインスタンスからのメトリクスを監視するために、Apache CouchDBモニタータイプでSmart Agentレシーバーを使用します。
このインテグレーションはKubernetesとLinuxでのみ利用可能です。
メリット
インテグレーションを設定すると、これらの機能にアクセスできるようになります:
-
メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
-
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
-
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。
インストール
-
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします。
-
GitHubでcollectd-couchdbをダウンロードします。
-
couchdb_plugin.pyファイルを/usr/share/collectd/collectd-couchdbに移動します。 -
/etc/collectd/managed_configのプラグイン用サンプル設定ファイルを、設定セクションに従って修正します。 -
Pythonの要件をインストールします:
$ sudo pip install -r requirements.txt -
OpenTelemetry コレクタを再起動します。
設定
Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います:
-
Smart Agent レシーバーを設定ファイルに含めます。
-
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
-
「Collector でSmart Agent モニターを使用する」を参照してください。
-
Smart Agent レシーバーの設定方法を参照してください。
-
一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
-
Collector の詳細については、「はじめに: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ノードの名前 |
|
|
EnhancedMetrics | ブール値。コメントされていないcouchdb_metrics.pyを拡張するには trueメトリクスが必要かどうかを示します。 |
"false" |
|
ユーザー名 |
CouchDBの認証に必要なユーザー名 |
「admin」 |
|
パスワード |
CouchDBの認証に必要なパスワード |
「admin」 |
|
IncludeMetric |
アクティブにする |
"ドキュメントに記載されているメトリクス" |
|
ExcludeMetric |
非アクティブにする |
"ドキュメントに記載されているメトリクス" |
|
ディメンション |
ユーザー定義ディメンションのスペースで区切られたキーと値のペア。 |
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の設定方法を参照してください。
トラブルシューティング
__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____
_________ __ ______ _____________ _____ _________
-
______ _ ____ __ ___ ______ _______ _______
-
_______ ______ ________
_________ __ ___________ _________ ___ ____ _____ _____
-
___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
-
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______