CockroachDB の統合

Cockroach Database は、トランザクショナルで強力な一貫性のあるキーと値のストア上に構築された分散 SQL データベースです。

Cockroach データベースには次の特徴があります。

• 水平にスケーリング
• ディスク、マシン、ラック、さらにはデータセンターの障害が発生しても、待ち時間の中断を最小限に抑え、手動による介入なしで存続します
• 強力な一貫性のある ACID トランザクションをサポート
• データの構造化、操作、およびクエリのための使い慣れた SQL API を提供します

CockroachDB は、クラスター内の各ノードの詳細な時系列メトリックを生成します。Prometheus で CockroachDB を監視すると、これらのメトリクスを Prometheus に取り込む方法が示されます。

New Relic を使用して以下を監視します。

• クラスタの健全性
• ノードの健全性
• ストアとディスク容量
• SQL クエリのパフォーマンス
• 開いているファイル記述子の数が多い
• 証明書の有効期限

統合を有効にする

統合を有効にするには、次の手順に従います。

1. Prometheus のCockroachDB ドキュメントに従って、CockroachDB メトリクス エンドポイントを見つけます。

2. Prometheus モニタリングをセットアップします。Prometheus メトリクスは New Relic と統合する必要があります。Prometheus Agent または Remote Write 統合を使用できます。Prometheus メトリクスの送信方法を参照してください。

   重要

   Prometheus Agent は、デフォルトで一連の統合からメトリックのみをスクレイピングします。

   この場合、ポッドまたはエンドポイントを、文字列cockroachdbを含むラベルapp.kubernetes.io/name 、 app.newrelic.io/name 、 k8s-appのいずれかで識別する必要があります。

3. 次のクエリを使用して、メトリクスが期待どおりに取り込まれていることを確認します。

   SELECT * from Metric where metricName='rocksdb_num_sstables'

   コピー

4. 組み込みにアクセスするには、 CockroachDB クイックスタート をインストールします ダッシュボードと アラート。

   重要

   ダッシュボードの一部のグラフには、ポッドまたはエンドポイントの識別を必要とする条件付きのクエリが含まれており、これらのラベルapp.kubernetes.io/name 、 app.newrelic.io/name 、 k8s-appのいずれかに文字列cockroachdbが含まれています。

   インポートしたら、アセットを編集または複製して、特定の要件に適合させることができます。

   リモート書き込みの統合

   デフォルトでは、Prometheus エージェントのデフォルト設定には対応するルールが含まれています。リモート書き込み統合を使用する場合、CockroachDB メトリックの命名が原因で、タイプを適切に推測することはできません。この場合、次のルールを含めてメトリック タイプをオーバーライドする必要があります。

   - source_labels: [__name__]
       separator: ;
       regex: timeseries_write_(.*)
       target_label: newrelic_metric_type
       replacement: counter
       action: replace
   - source_labels: [__name__]
       separator: ;
       regex: sql_byte(.*)
       target_label: newrelic_metric_type
       replacement: counter
       action: replace

   コピー

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

指標

Prometheus メトリックは、ディメンション メトリックとして格納されます。NRQL を使用してクエリを実行するか、データ エクスプローラーを使用して、使用可能なメトリック、ファセット、および関連付けられたディメンションによるフィルターを参照できます。

この統合によって公開されるさまざまなメトリックのセットは、 CockroachDB のドキュメントで定義されています。

次の NRQL クエリを使用して、New Relic に取り込まれている CockroachDB メトリクスを理解します。

トラブルシューティング

CockroachDB ドキュメントのトラブルシューティングのヒントに従って、メトリックがクラスターで期待どおりに構成されていることを確認してください。

Prometheus 統合の特定のトラブルシューティング ガイドラインを確認することもできます。