当社のCouchbase 統合 は、Couchbaseクラスタからインベントリとメトリックデータを収集してNew Relicプラットフォームに送信し、Couchbase環境の健全性を素早く確認することができます。クラスタ、ノード、クエリエンジン、バケットの各レベルでデータを収集するので、問題の発生源を追跡することができます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社のインテグレーションは、Couchbaseバージョン4.0以上に対応しています。
統合をインストールする前に、次の要件を満たしていることを確認してください。
CouchbaseがKubernetesで実行されていない場合は、Couchbaseを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。さもないと:
クイックスタート
ガイド付きインストールで、Couchbaseクラスタを迅速にインスツルメントし、遠隔測定データを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズしたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。
始める準備はできましたか?これらのボタンのいずれかをクリックして試してください。
ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してCouchbaseの統合を設定します。それだけでなく、あなたの環境で稼働している他のアプリケーションやログ・ソースを発見し、どのようなものを導入すべきかを推奨します。
ガイド付きインストールは、ほとんどのセットアップで動作します。しかし、それがあなたのニーズに合わない場合は、あなたのCouchbaseクラスタの監視を開始するために以下の他の方法を見つけることができます。
インストールしてアクティブ化する
Couchbaseインテグレーションをインストールするには、お使いの環境の指示に従ってください。
''
その他の注意事項:
- 高度:統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
- オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。
このドキュメントはインストールで役立ちましたか。
構成
統合を構成する
インストール方法に応じて、統合を構成する方法はいくつかあります。
- Kubernetes経由で有効になっている場合: Kubernetesで実行されているサービスの監視をご覧ください。
- Amazon ECSを介して有効になっている場合: ECSで実行されている監視サービスを参照してください。
- ホストにインストールされている場合:統合のYAML構成ファイル
couchbase-config.yml
の構成を編集します。
統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。
構成ファイルには、 interval
、 timeout
、 inventory_source
などのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。
重要
従来の構成/定義ファイルをまだ使用している場合は、このドキュメントを参照してください。
Couchbase に関連する特定の設定は、構成ファイルのenv
セクションを使用して定義されます。これらの設定は、Couchbase インスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、このドキュメントの次のセクションで説明します。
Couchbase インスタンスの設定
Couchbaseインテグレーションは、メトリクス(M)とインベントリ(I)の両方の情報を収集します。表の中で、 Applies To 列を使って、各コレクションで利用できる設定を確認してください。
'' '' '' '' '' '' '' '' '' '' '' '' ''
設定 | 説明 | デフォルト | に適用されます |
---|---|---|---|
ホスト名 | Couchbaseが稼働しているホスト名またはIP。 | ローカルホスト | M / I |
ポート | Couchbase APIがリスニングしているポート。 | 8091 | M / I |
QUERY_PORT | Couchbase N1QLサービスが待ち受けているポート。 | 8093 | M / I |
ユーザー名 | Couchbase APIにアクセスするためのユーザー名です。 | 該当なし | M / I |
パスワード | 指定されたユーザーのパスワード。 | 該当なし | M / I |
USE_SSL | Couchbaseとの通信にSSLを使用します。 | false | M / I |
CA_BUNDLE_FILE | ホスト上のSSL証明書の場所。 | 該当なし | M / I |
CA_BUNDLE_DIR | 代替認証局バンドルディレクトリ。 | 該当なし | M / I |
タイムアウト | APIリクエストのタイムアウト(秒単位)。 | 30 | M / I |
ENABLE_BUCKETS | trueの場合、バケットのリソースを収集します。 | true | M |
バケット統計の有効化 | trueの場合、追加のバケット統計を収集します。 | true | M |
クラスタとノードの有効化 | trueの場合、クラスタとノードのリソースを収集します。 | true | M |
METRICS | メトリックのみの収集を有効にするには、 | false | |
在庫 | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
- 設定ファイルに直接値を追加します。これが最も一般的な方法です。
{{}}
表記を使用して環境変数の値を置き換えます。これには、インフラストラクチャエージェントv1.14.0以降が必要です。詳細については、 こちらをご覧になるか、以下の例をご覧ください。- シークレット管理を使用します。これを使用して、構成ファイルにプレーンテキストで公開されるパスワードなどの機密情報を保護します。詳細については、シークレット管理を参照してください。
ラベル/カスタム属性
ラベルを使用して、メトリックをさらに装飾できます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加できます。これを使用して、メトリックをクエリ、フィルタリング、またはグループ化できます。
デフォルトのサンプル構成ファイルには、ラベルの例が含まれています。ただし、必須ではないため、選択した新しいものを削除、変更、または追加できます。
labels: env: production role: load_balancer
構成例
データを見つけて使用する
統合データは 統合ダッシュボード に報告されます。
Couchbaseのデータは、以下の イベントタイプに添付されています 。
CouchbaseBucketSample
CouchbaseClusterSample
CouchbaseNodeSample
CouchbaseQueryEngineSample
トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
データを検索して使用する方法の詳細については、統合データについてを参照してください。
メトリックデータ
Couchbase 統合は、次のメトリック データ属性を収集します。cluster.
やnode.
など、一部のメトリック名には、カテゴリ インジケータとピリオドがプレフィックスとして付けられます。
Couchbaseバケットのサンプルメトリクス
これらの属性は、 CouchbaseBucketSample
イベント タイプに関連付けられています。
メトリック | 説明 |
---|---|
| このバケツのRAMにキャッシュされているアクティブなアイテムの割合。 |
| バケットの平均ディスクコミット時間(単位:ミリ秒)。 |
| バケットの平均ディスク更新時間(単位:ミリ秒)。 |
| このバケットの1秒あたりの読み込み回数が、RAMではなくディスクからの場合の割合。 |
| 外部のクライアントSDK、プロキシ、TAPリクエスト、内部の統計収集からの接続を含む、このサーバーへの接続数。 |
| このバケツで使用されたデータの量(バイト)。 |
| バケットの1秒あたりのデクリメントヒット数。 |
| バケットの1秒あたりのデクリメントミスの回数。 |
| このバケツの1秒あたりの削除ヒット数。 |
| このバケットの1秒あたりの削除ミスの数。 |
| このバケットで1秒間にディスク上に作成された新しいアイテムの数。 |
| バケット上のディスクからアイテムを取得するために1秒間に必要な操作回数。 |
| このバケツの1秒あたりのディスク上の更新アイテム数。 |
| バケットに使用されているディスク容量をバイト単位で表します。 |
| バケット内でディスクへの書き込みを待っているアイテムの数。 |
| このバケットでディスクに排出される1秒あたりの総アイテム数 |
| バケットの立ち退きポリシー。 |
| バケットから退避される1秒あたりのアイテム数です。 |
| このバケツに入っているデータの、1秒あたりの取得操作回数。 |
| このバケットに含まれていないデータの1秒あたりの取得操作回数。 |
| このバケツからのデータで提供されたgetリクエストの割合。 |
| バケットの1秒あたりのインクリメントヒットの数。 |
| バケットの1秒あたりのインクリメントミスの回数。 |
| バケットに保存されているオブジェクトの数です。 |
| バケット上の自動消去のハイウォーターマーク(単位:バイト)。 |
| バケットの自動消去のローウォーターマーク(単位:バイト)。 |
| バケットに使用されているRAMの量(バイト単位)です。 |
| このバケットのメタデータに使用されているRAMの量(単位:バイト)。 |
| バケットの1秒あたりのミスの数。 |
| ノードロケーターの種類。 |
| このバケツで発生したハードアウトオブメモリーエラーの数。 |
| バケット上の一時的なデータ(パーシステンスキュー、レプリケーションキュー、チェックポイントなど)が使用する余分なメモリの量(単位:バイト)。 |
| このバケットのRAMにキャッシュされている保留項目の割合。 |
| バケットで現在使用されているRAMクオータの割合。 |
| このバケットからの1秒あたりの読み込み(取得操作)の回数。 |
| バケットの1秒あたりの読み取りバイト数。 |
| バケットのレプリカインデックスを有効にするかどうかを定義します。 |
| このバケットのレプリカの数。 |
| このバケツのRAMにキャッシュされているレプリカアイテムの割合。 |
| このバケツのRAMにキャッシュされている全アイテムの割合。 |
| このバケットのメモリ不足のために、クライアントSDKに毎秒送られるバックオフの数。 |
| データバケットの同時読み取り、同時書き込み数。 |
| バケットの1秒あたりの総操作数。 |
| このバケットへの1秒あたりの書き込み(セット操作)の回数。 |
| バケットの書き込まれたバイト数です。 |
カウチベースクラスターサンプルメトリクス
これらの属性は、 CouchbaseClusterSample
イベント タイプに関連付けられています。
メトリック | 説明 |
---|---|
| クラスター上の自動フェイルオーバーの数です。 |
| クラスタでフェイルオーバーが有効になっているかどうかを示します。 |
| コンパクションが発生するデータベース内のパーセンテージレベル。 |
| このクラスターの空きディスク容量(単位:バイト)。 |
| Couchbaseで利用可能なディスクの総容量をバイト単位で表示しています。 |
| 利用可能なディスクの総容量(単位:バイト)。 |
| このクラスター上のバケットデータが使用するディスクのサイズ(単位:バイト)。 |
| このクラスターの使用済みディスク容量(単位:バイト)。 |
| コンパクションが発生するインデックス内のパーセンテージレベル。 |
| このクラスターがサポートするバケットの最大数。 |
| Couchbaseが使用できるRAMの総量(バイト)。 |
| ノードごとにCouchbaseが使用できるRAMの総量をバイトで表したものです。 |
| Couchbaseが使用しているRAMの総量(バイト単位)。 |
| ノードごとにCouchbaseが使用しているRAMの総量(バイト単位)。 |
| このクラスター上の総RAMをバイト単位で表します。 |
| このクラスターのバケットデータが使用しているRAMの総量(単位:バイト)。 |
| このクラスターで使用されているRAMの総量(バイト)です。 |
| コンパクションのトリガーとなる、すべてのビューインデックスファイル内の断片化の割合です。 |
Couchbaseノードのサンプルメトリクス
これらの属性は、 CouchbaseNodeSample
イベント タイプに関連付けられています。
メトリック | 説明 |
---|---|
| ノードのCPU使用率です。 |
| ノードの空きメモリ(単位:バイト)。 |
| ノードに割り当てられているメモリの総量(バイト)です。 |
| ノードのリカバリータイプです。 |
| ノードのサービスです。 |
| ノードのステータス。( |
| ノードのスワップスペースの合計(バイト)です。 |
| ノードの使用されているスワップスペース(単位:バイト)。 |
| ノードのアップタイムをミリ秒単位で表します。 |
Couchbase クエリエンジンのサンプルメトリクス
これらの属性は、 CouchbaseQueryEngineSample
イベント タイプに関連付けられています。
メトリック | 説明 |
---|---|
| 現在のアクティブなリクエストの数。 |
| このクエリエンジンの平均リクエスト時間(単位:ミリ秒)。 |
| Couchbaseがクエリログに残すクエリの数。 |
| 現在の完了したリクエストの数 |
| クエリがCouchbaseのクエリ・ログに記録されるまでの最小時間をミリ秒単位で指定します。 |
| このクエリエンジンで利用可能なコアの数。 |
| 最後のガベージコレクションの番号。 |
| ガベージコレクションが一時停止している時間の割合。 |
| ガベージコレクションが一時停止している時間をミリ秒単位で指定します。 |
| このクエリエンジンのリクエスト時間の中央値(単位:ミリ秒)。 |
| 準備されたステートメントであるリクエストの割合 |
| 過去15分間の1秒あたりのリクエスト数の平均値。 |
| 過去1分間の1秒あたりのリクエスト数の平均値。 |
| 過去5分間の1秒あたりのリクエスト数の平均値。 |
| このクエリエンジンのリクエスト時間の80パーセンタイル(単位:ミリ秒)。 |
| このクエリエンジンのリクエスト時間の95パーセンタイル(単位:ミリ秒)。 |
| このクエリエンジンのリクエスト時間の99パーセンタイル(単位:ミリ秒)。 |
| このクエリエンジンのCPU使用率 |
| このクエリエンジンで予約されている仮想アドレス空間をバイト単位で表します。 |
| このクエリエンジンでヒープオブジェクトに割り当てられたメモリの累積量(単位:バイト)。 |
| このクエリエンジンで使用されているスレッドの総数。 |
| このクエリエンジンの稼働時間(単位:ミリ秒 |
| このクエリエンジンのヒープオブジェクトに割り当てられているメモリの量(単位:バイト)。 |
| このクエリエンジンのユーザーCPU使用率。 |
在庫データ
Couchbaseインテグレーションでは、Couchbaseデータベースの構成パラメータを取得します。このデータは、Infrastructure Inventoryページ 、 config/couchbase ソースの下で利用できます。インベントリデータの詳細については、 Understand data を参照してください。
このインテグレーションでは、以下のCouchbase構成パラメータのデータを取得します。
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。