Couchbaseモニタリングの統合

当社のCouchbase 統合は、Couchbaseクラスタからインベントリとメトリックデータを収集してNew Relicプラットフォームに送信し、Couchbase環境の健全性を素早く確認することができます。クラスタ、ノード、クエリエンジン、バケットの各レベルでデータを収集するので、問題の発生源を追跡することができます。

統合をインストールし、収集するデータを確認するために読んでください。

互換性と要件

当社のインテグレーションは、Couchbaseバージョン4.0以上に対応しています。

クイックスタート

Kubernetes または ECS 環境で Couchbase を実行していない場合は、ガイド付きインストールをお勧めします。ガイド付きインストールでは、インフラストラクチャエージェントと CLI を使用して Couchbase 統合をセットアップし、環境内で実行されている他のアプリケーションとログソースを検出して、どのアプリケーションを計測する必要があるかを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。

始める準備はできていますか？使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。

ガイド付きインストール（米国オプション）

ガイド付きインストール（EUオプション）

インストール

Couchbaseインテグレーションをインストールするには、お使いの環境の指示に従ってください。

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数をnri-couchbaseに置き換えます。
ディレクトリを統合フォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```

サンプル構成ファイルのコピー：

sudo cp couchbase-config.yml.sample couchbase-config.yml

構成設定の説明に従って、 couchbase-config.ymlファイルを編集します。

nri-couchbase .MSIインストーラーイメージを以下からダウンロードします。
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-couchbase/nri-couchbase-amd64.msi
Windowsコマンドプロンプトからインストールするには、次のコマンドを実行します。
```
msiexec.exe /qn /i PATH\TO\nri-couchbase-amd64.msi
```
IntegrationsディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、次のコマンドを実行してサンプル構成ファイルのコピーを作成します。
```
copy couchbase-config.yml.sample couchbase-config.yml
```
構成設定の説明に従って、 couchbase-config.ymlファイルを編集します。

統合を更新する

このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インストール後のタスク

インストールが完了したら、設定オプションを設定できます。インテグレーションを機能させるには、設定がいくつか必要ですが、オプションの設定もあります。

統合を構成する

ECSまたはKubernetesインテグレーションからこのインテグレーションを有効にした場合は、以下のドキュメントを参照してください。

標準オンホストインストールの場合、このインテグレーションにはYAML設定ファイル、apache-config.ymlが付属しています。この設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。コピーおよび編集できるサンプル設定ファイルapache-config.yml.sampleが付属しています。

構成ファイルには、 interval 、 timeout 、 inventory_sourceなどのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、構成フォーマットのドキュメントを参照してください。

Couchbase に関連する特定の設定は、構成ファイルのenvセクションを使用して定義されます。これらの設定は、Couchbase インスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、このドキュメントの次のセクションで説明します。

カウチベースの構成オプション

Couchbase 統合は、メトリクスとインベントリ情報の両方を収集します。この表は、各構成オプションの適用対象を示しています。

'' '' '' '' '' '' '' '' '' '' '' '' ''

設定	説明	デフォルト	に適用されます
HOSTNAME	Couchbaseが稼働しているホスト名またはIP。	ローカルホスト	M / I
PORT	Couchbase APIがリスニングしているポート。	8091	M / I
QUERY_PORT	Couchbase N1QLサービスが待ち受けているポート。	8093	M / I
USERNAME	Couchbase APIにアクセスするためのユーザー名です。	該当なし	M / I
PASSWORD	指定されたユーザーのパスワード。	該当なし	M / I
USE_SSL	Couchbaseとの通信にSSLを使用します。	false	M / I
CA_BUNDLE_FILE	ホスト上のSSL証明書の場所。 `USE_SSL`がtrueの場合にのみ必要です。	該当なし	M / I
CA_BUNDLE_DIR	代替認証局バンドルディレクトリ。	該当なし	M / I
TIMEOUT	APIリクエストのタイムアウト（秒単位）。	30	M / I
ENABLE_BUCKETS	trueの場合、バケットのリソースを収集します。	true	M
ENABLE_BUCKET_STATS	trueの場合、追加のバケット統計を収集します。	true	M
ENABLE_CLUSTER_AND_NODES	trueの場合、クラスタとノードのリソースを収集します。	true	M
METRICS	メトリックのみの収集を有効にするには、 `true`に設定します。	false
INVENTORY	インベントリのみの収集を有効にするには、 `true`に設定します。	false

これらの設定の値は、いくつかの方法で定義できます。

設定ファイルに直接値を追加します（最も一般的な方法）。
{{}}表記を使用して、環境変数の値を置き換えます。これには、Infrastructureエージェントバージョン1.14.0以降が必要です。詳細については、Infrastructure設定または環境変数の例を参照してください。
シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。

ラベル

さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、属性（キーや値のペア）をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。

デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、選択したラベルを削除、変更、お好きな設定を新規追加することができます。

labels:
   env: production
   role: load_balancer

構成例

これは、ローカルホストからメトリックとインベントリを収集するために使用される基本構成です。

integrations:
  - name: nri-couchbase
    env:
      HOSTNAME: localhost
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 15s
    labels:
      environment: production
    inventory_source: config/couchbase

この構成では、15秒ごとにメトリックを収集し、60秒ごとにインベントリを収集します。

integrations:
  - name: nri-couchbase
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 15s
    labels:
      environment: production

  - name: nri-couchbase
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 60s
    labels:
      environment: production
    inventory_source: config/couchbase

この構成では、環境変数COUCHBASE_HOSTを使用して、統合のHOSTNAME設定を設定しています。

integrations:
  - name: nri-couchbase
    env:
      METRICS: "true"
      HOSTNAME: {{COUCHBASE_HOST}}
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

この構成では、同じ統合から複数の Couchbase サーバーを監視しています。最初のインスタンス ( HOSTNAME: 1st_couchbase_host ) ではメトリックとインベントリを収集しますが、2 番目のインスタンス ( HOSTNAME: 2nd_couchbase_host ) ではメトリックのみを収集します。

integrations:
  - name: nri-couchbase
    env:
      METRICS: "true"
      HOSTNAME: 1st_couchbase_host
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-couchbase
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_couchbase_host
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/couchbase

  - name: nri-couchbase
    env:
      METRICS: "true"
      HOSTNAME: 2nd_couchbase_host
      PORT: 8091
      QUERY_PORT: 8093
      USERNAME: couchbase_user
      PASSWORD: couchbase_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

データを見つけて使用する

統合データは統合ダッシュボードに報告されます。

Couchbaseのデータは、以下のイベントタイプに添付されています。

CouchbaseBucketSample
CouchbaseClusterSample
CouchbaseNodeSample
CouchbaseQueryEngineSample

トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。

データを検索して使用する方法の詳細については、統合データについてを参照してください。

メトリックデータ

Couchbase 統合は、次のメトリックデータ属性を収集します。cluster.やnode.など、一部のメトリック名には、カテゴリインジケータとピリオドがプレフィックスとして付けられます。

Couchbaseバケットのサンプルメトリクス

これらの属性は、 CouchbaseBucketSampleイベントタイプに関連付けられています。

メトリック	説明
`bucket.activeResidentItemsRatio`	このバケツのRAMにキャッシュされているアクティブなアイテムの割合。
`bucket.averageDiskCommitTimeInMilliseconds`	バケットの平均ディスクコミット時間（単位：ミリ秒）。
`bucket.averageDiskUpdateTimeInMilliseconds`	バケットの平均ディスク更新時間（単位：ミリ秒）。
`bucket.cacheMissRatio`	このバケットの1秒あたりの読み込み回数が、RAMではなくディスクからの場合の割合。
`bucket.currentConnections`	外部のクライアントSDK、プロキシ、TAPリクエスト、内部の統計収集からの接続を含む、このサーバーへの接続数。
`bucket.dataUsedInBytes`	このバケツで使用されたデータの量（バイト）。
`bucket.decrementHitsPerSecond`	バケットの1秒あたりのデクリメントヒット数。
`bucket.decrementMissesPerSecond`	バケットの1秒あたりのデクリメントミスの回数。
`bucket.deleteHitsPerSecond`	このバケツの1秒あたりの削除ヒット数。
`bucket.deleteMissesPerSecond`	このバケットの1秒あたりの削除ミスの数。
`bucket.diskCreateOperationsPerSecond`	このバケットで1秒間にディスク上に作成された新しいアイテムの数。
`bucket.diskFetchesPerSecond`	バケット上のディスクからアイテムを取得するために1秒間に必要な操作回数。
`bucket.diskUpdateOperationsPerSecond`	このバケツの1秒あたりのディスク上の更新アイテム数。
`bucket.diskUsedInBytes`	バケットに使用されているディスク容量をバイト単位で表します。
`bucket.diskWriteQueue`	バケット内でディスクへの書き込みを待っているアイテムの数。
`bucket.ejectionsPerSecond`	このバケットでディスクに排出される1秒あたりの総アイテム数
`bucket.evictionPolicy`	バケットの立ち退きポリシー。
`bucket.evictionsPerSecond`	バケットから退避される1秒あたりのアイテム数です。
`bucket.getHitsPerSecond`	このバケツに入っているデータの、1秒あたりの取得操作回数。
`bucket.getMissesPerSecond`	このバケットに含まれていないデータの1秒あたりの取得操作回数。
`bucket.hitRatio`	このバケツからのデータで提供されたgetリクエストの割合。
`bucket.incrementHitsPerSecond`	バケットの1秒あたりのインクリメントヒットの数。
`bucket.incrementMissesPerSecond`	バケットの1秒あたりのインクリメントミスの回数。
`bucket.itemCount`	バケットに保存されているオブジェクトの数です。
`bucket.memoryHighWaterMarkInBytes`	バケット上の自動消去のハイウォーターマーク（単位：バイト）。
`bucket.memoryLowWaterMarkInBytes`	バケットの自動消去のローウォーターマーク（単位：バイト）。
`bucket.memoryUsedInBytes`	バケットに使用されているRAMの量（バイト単位）です。
`bucket.metadataInRAMInBytes`	このバケットのメタデータに使用されているRAMの量（単位：バイト）。
`bucket.missesPerSecond`	バケットの1秒あたりのミスの数。
`bucket.nodeLocator`	ノードロケーターの種類。
`bucket.outOfMemoryErrorsPerSecond`	このバケツで発生したハードアウトオブメモリーエラーの数。
`bucket.OverheadInBytes`	バケット上の一時的なデータ（パーシステンスキュー、レプリケーションキュー、チェックポイントなど）が使用する余分なメモリの量（単位：バイト）。
`bucket.pendingResidentItemsRatio`	このバケットのRAMにキャッシュされている保留項目の割合。
`bucket.quotaUtilization`	バケットで現在使用されているRAMクオータの割合。
`bucket.readOperationsPerSecond`	このバケットからの1秒あたりの読み込み（取得操作）の回数。
`bucket.readRatePerSecond`	バケットの1秒あたりの読み取りバイト数。
`bucket.replicaIndex`	バケットのレプリカインデックスを有効にするかどうかを定義します。
`bucket.replicaNumber`	このバケットのレプリカの数。
`bucket.replicaResidentItemsRatio`	このバケツのRAMにキャッシュされているレプリカアイテムの割合。
`bucket.residentItemsRatio`	このバケツのRAMにキャッシュされている全アイテムの割合。
`bucket.temporaryOutOfMemoryErrorsPerSecond`	このバケットのメモリ不足のために、クライアントSDKに毎秒送られるバックオフの数。
`bucket.threadsNumber`	データバケットの同時読み取り、同時書き込み数。
`bucket.totalOperationsPerSecond`	バケットの1秒あたりの総操作数。
`bucket.writeOperationsPerSecond`	このバケットへの1秒あたりの書き込み（セット操作）の回数。
`bucket.writeRatePerSecond`	バケットの書き込まれたバイト数です。

カウチベースクラスターサンプルメトリクス

これらの属性は、 CouchbaseClusterSampleイベントタイプに関連付けられています。

メトリック	説明
`cluster.autoFailoverCount`	クラスター上の自動フェイルオーバーの数です。
`cluster.autoFailoverEnabled`	クラスタでフェイルオーバーが有効になっているかどうかを示します。
`cluster.databaseFragmentationThreshold`	コンパクションが発生するデータベース内のパーセンテージレベル。
`cluster.diskFreeInBytes`	このクラスターの空きディスク容量（単位：バイト）。
`cluster.diskQuotaTotalInBytes`	Couchbaseで利用可能なディスクの総容量をバイト単位で表示しています。
`cluster.diskTotalInBytes`	利用可能なディスクの総容量（単位：バイト）。
`cluster.diskUsedbyDataInBytes`	このクラスター上のバケットデータが使用するディスクのサイズ（単位：バイト）。
`cluster.diskUsedInBytes`	このクラスターの使用済みディスク容量（単位：バイト）。
`cluster.indexFragmentationThreshold`	コンパクションが発生するインデックス内のパーセンテージレベル。
`cluster.maximumBucketCount`	このクラスターがサポートするバケットの最大数。
`cluster.memoryQuotaTotalInBytes`	Couchbaseが使用できるRAMの総量（バイト）。
`cluster.memoryQuotaTotalPerNodeInBytes`	ノードごとにCouchbaseが使用できるRAMの総量をバイトで表したものです。
`cluster.memoryQuotaUsedInBytes`	Couchbaseが使用しているRAMの総量（バイト単位）。
`cluster.memoryQuotaUsedPerNodeInBytes`	ノードごとにCouchbaseが使用しているRAMの総量（バイト単位）。
`cluster.memoryTotalInBytes`	このクラスター上の総RAMをバイト単位で表します。
`cluster.memoryUsedByDataInBytes`	このクラスターのバケットデータが使用しているRAMの総量（単位：バイト）。
`cluster.memoryUsedInBytes`	このクラスターで使用されているRAMの総量（バイト）です。
`cluster.viewFragmentationThreshold`	コンパクションのトリガーとなる、すべてのビューインデックスファイル内の断片化の割合です。

Couchbaseノードのサンプルメトリクス

これらの属性は、 CouchbaseNodeSampleイベントタイプに関連付けられています。

メトリック	説明
`node.cpuUtilization`	ノードのCPU使用率です。
`node.memoryFreeInBytes`	ノードの空きメモリ（単位：バイト）。
`node.memoryTotalInBytes`	ノードに割り当てられているメモリの総量（バイト）です。
`node.recoveryType`	ノードのリカバリータイプです。
`node.services`	ノードのサービスです。
`node.status`	ノードのステータス。( `0` = 不健康、 `1` = 健康)
`node.swapTotalInBytes`	ノードのスワップスペースの合計（バイト）です。
`node.swapUsedInBytes`	ノードの使用されているスワップスペース（単位：バイト）。
`node.uptimeInMilliseconds`	ノードのアップタイムをミリ秒単位で表します。

Couchbase クエリエンジンのサンプルメトリクス

これらの属性は、 CouchbaseQueryEngineSampleイベントタイプに関連付けられています。

メトリック	説明
`queryengine.activeRequests`	現在のアクティブなリクエストの数。
`queryengine.averageRequestTimeInMilliseconds`	このクエリエンジンの平均リクエスト時間（単位：ミリ秒）。
`queryengine.completedLimit`	Couchbaseがクエリログに残すクエリの数。
`queryengine.completedRequests`	現在の完了したリクエストの数
`queryengine.completedThresholdInMilliseconds`	クエリがCouchbaseのクエリ・ログに記録されるまでの最小時間をミリ秒単位で指定します。
`queryengine.cores`	このクエリエンジンで利用可能なコアの数。
`queryengine.garbageCollectionNumber`	最後のガベージコレクションの番号。
`queryengine.garbageCollectionPaused`	ガベージコレクションが一時停止している時間の割合。
`queryengine.garbageCollectionTimePausedInMilliseconds`	ガベージコレクションが一時停止している時間をミリ秒単位で指定します。
`queryengine.medianRequestTimeInMilliseconds`	このクエリエンジンのリクエスト時間の中央値（単位：ミリ秒）。
`queryengine.preparedStatementUtilization`	準備されたステートメントであるリクエストの割合
`queryengine.requestsLast15MinutesPerSecond`	過去15分間の1秒あたりのリクエスト数の平均値。
`queryengine.requestsLast1MinutesPerSecond`	過去1分間の1秒あたりのリクエスト数の平均値。
`queryengine.requestsLast5MinutesPerSecond`	過去5分間の1秒あたりのリクエスト数の平均値。
`queryengine.requestTime80thPercentileInMilliseconds`	このクエリエンジンのリクエスト時間の80パーセンタイル（単位：ミリ秒）。
`queryengine.requestTime95thPercentileInMilliseconds`	このクエリエンジンのリクエスト時間の95パーセンタイル（単位：ミリ秒）。
`queryengine.requestTime99thPercentileInMilliseconds`	このクエリエンジンのリクエスト時間の99パーセンタイル（単位：ミリ秒）。
`queryengine.systemCPUUtilization`	このクエリエンジンのCPU使用率
`queryengine.systemMemoryInBytes`	このクエリエンジンで予約されている仮想アドレス空間をバイト単位で表します。
`queryengine.totalMemoryInBytes`	このクエリエンジンでヒープオブジェクトに割り当てられたメモリの累積量（単位：バイト）。
`queryengine.totalThreads`	このクエリエンジンで使用されているスレッドの総数。
`queryengine.uptimeInMilliseconds`	このクエリエンジンの稼働時間（単位：ミリ秒
`queryengine.usedMemoryInBytes`	このクエリエンジンのヒープオブジェクトに割り当てられているメモリの量（単位：バイト）。
`queryengine.userCPUUtilization`	このクエリエンジンのユーザーCPU使用率。

在庫データ

Couchbase インテグレーションは、Couchbase データベースの設定をキャプチャします。データは、インフラストラクチャ UI のインベントリページのconfig/couchbaseソースで確認できます。インベントリデータの詳細については、「データを理解する」を参照してください。

このインテグレーションでは、以下のCouchbase構成パラメータのデータを取得します。

名前	説明
`Node locator`	ノードロケーターの種類。
`Proxy port`	バケットが通信するためのプロキシポート。
`Type`	バケットの種類です。
`UUID`	バケットのUUIDです。

名前	説明
`Collection node`	メトリクスの収集に使用されるノードです。
`Couchbase version`	このクラスターで稼働しているCouchbaseのバージョンです。
`UUID`	クラスターのUUIDです。

名前	説明
`Cluster membership`	ノードのクラスター・メンバーシップです。
`Hostname`	ノードのホスト名です。
`Operating system`	ノードのオペレーティング・システム。
`Port`	ノードのポートです。
`Recovery type`	ノードのリカバリータイプです。
`Services`	ノードのサービスをコンマで区切ったリスト。
`Version`	このノードで稼働しているCouchbaseのバージョンです。

名前	説明
`Node hostname`	このクエリエンジンが動作するノードのホスト名。
`Node port`	このクエリエンジンが動作しているノードのポートです。
`Version`	このクエリエンジンのバージョンです。

ソースコードを確認してください

このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。

この機械翻訳は、参考として提供されています。

互換性と要件

クイックスタート

インストール

ECS

Kubernetes

Linux

ウィンドウズ

統合を更新する

インストール後のタスク

統合を構成する

カウチベースの構成オプション

ラベル

構成例

基本構成

メトリック/在庫間隔が異なる基本構成

環境変数の置換

マルチインスタンスモニタリング

データを見つけて使用する

メトリックデータ

Couchbaseバケットのサンプルメトリクス

カウチベースクラスターサンプルメトリクス

Couchbaseノードのサンプルメトリクス

Couchbase クエリエンジンのサンプルメトリクス

在庫データ

バケットのパラメータ

クラスターパラメータ

ノードパラメータ

クエリエンジンのパラメータ

ソースコードを確認してください

この機械翻訳は、参考として提供されています。

Couchbaseモニタリングの統合

互換性と要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

クイックスタート

インストール

Kubernetes

Linux

ウィンドウズ

統合を更新する

インストール後のタスク

統合を構成する

カウチベースの構成オプション

ラベル

構成例

基本構成

メトリック/在庫間隔が異なる基本構成

環境変数の置換

マルチインスタンスモニタリング

データを見つけて使用する

メトリックデータ

Couchbaseバケットのサンプルメトリクス

カウチベースクラスターサンプルメトリクス

Couchbaseノードのサンプルメトリクス

Couchbase クエリエンジンのサンプルメトリクス

在庫データ

バケットのパラメータ

クラスターパラメータ

ノードパラメータ

クエリエンジンのパラメータ

ソースコードを確認してください

互換性と要件