• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

Couchbaseモニタリングの統合

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

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

互換性と要件

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

クイックスタート

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

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

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

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

インストール

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

''

統合を更新する

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

インストール後のタスク

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

統合を構成する

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

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

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

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

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

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

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

設定

説明

デフォルト

に適用されます

ホスト名

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証明書の場所。 USE_SSLがtrueの場合にのみ必要です。

該当なし

M / I

CA_BUNDLE_DIR

代替認証局バンドルディレクトリ。

該当なし

M / I

タイムアウト

APIリクエストのタイムアウト(秒単位)。

30

M / I

ENABLE_BUCKETS

trueの場合、バケットのリソースを収集します。

true

M

バケット統計の有効化

trueの場合、追加のバケット統計を収集します。

true

M

クラスタとノードの有効化

trueの場合、クラスタとノードのリソースを収集します。

true

M

METRICS

メトリックのみの収集を有効にするには、 trueに設定します。

false

在庫

インベントリのみの収集を有効にするには、 trueに設定します。

false

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

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

ラベル

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

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

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構成パラメータのデータを取得します。

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

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

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.