📣

TiDB Cloud Serverless が
Starter
に変わりました!このページは自動翻訳されたものです。
原文はこちらからご覧ください。

TiDB Cloudと New Relic の統合(プレビュー)

TiDB CloudはNew Relicとの連携(プレビュー)をサポートしています。TiDB TiDB Cloudを設定して、TiDBクラスターのメトリクスをニューレリックに送信できます。その後、これらのメトリクスをNew Relicダッシュボードで直接確認できるようになります。

New Relic統合バージョン

TiDB Cloud は、 2023 年 4 月 11 日から New Relic 統合 (ベータ版) をサポートしています。2025 年 7 月 31 日から、 TiDB Cloud は統合の拡張プレビュー バージョンを導入します。

  • New Relic 統合 (プレビュー) : 2025 年 7 月 31 日までに組織内に削除されていない Datadog または New Relic 統合がない場合、 TiDB Cloud はNew Relic 統合のプレビュー バージョンを提供して、最新の機能強化を体験できるようにします。
  • New Relic 連携(ベータ版) :2025年7月31日までに組織内で Datadog または New Relic 連携が少なくとも1つ削除されていない場合、 TiDB Cloud は既存の連携と新規の連携の両方をベータ版で保持し、現在のダッシュボードへの影響を回避します。また、適切な移行プランとタイムラインについてご相談させていただきます。

前提条件

  • TiDB Cloud をNew Relic と統合するには、アカウントをニューレリックIngest - LicenseタイプのうちNew Relic APIキーを作成する必要です。

    New Relic アカウントをお持ちでない場合は、サインアップしてくださいここ

  • TiDB Cloudのサードパーティメトリクス統合を設定するには、 TiDB CloudのOrganization OwnerまたはProject Ownerアクセス権が必要です。統合ページを表示したり、提供されているリンクを介して設定済みのダッシュボードにアクセスしたりするには、 TiDB Cloudのプロジェクト内のターゲットクラスターにアクセスするためのProject Viewer以上のロールが必要です。

制限

  • TiDB CloudスターターまたはTiDB Cloudエッセンシャルクラスターでは New Relic 統合を使用できません。

  • クラスターのステータスがCREATINGRESTORINGPAUSED 、またはRESUMINGの場合、New Relic 統合は使用できません。

  • New Relic 統合を備えたクラスターが削除されると、それに関連付けられている統合サービスも削除されます。

手順

ステップ1. New Relic APIキーとの統合

New Relic統合バージョンに応じて、統合ページにアクセスする手順は異なります。

    1. TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。

    2. 左側のナビゲーション ペインで、 [設定] > [統合]をクリックします。

    3. 「統合」ページで、 「New Relic への統合 (プレビュー)」をクリックします。

    4. New Relic の API キーを入力し、New Relic のサイトを選択します。

    5. [統合のテスト]をクリックします。

      • テストが成功すると、 「確認」ボタンが表示されます。
      • テストに失敗した場合はエラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
    6. 「確認」をクリックして統合を完了します。

    1. TiDB Cloudコンソールで、左上隅のコンボ ボックスを使用してターゲット プロジェクトに切り替えます。

    2. 左側のナビゲーション ペインで、 [プロジェクト設定] > [統合]をクリックします。

    3. 「統合」ページで、 「New Relic への統合 (ベータ版)」をクリックします。

    4. New Relic の API キーを入力し、New Relic のサイトを選択します。

    5. [統合のテスト]をクリックします。

      • テストが成功すると、 「確認」ボタンが表示されます。
      • テストに失敗した場合はエラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
    6. 「確認」をクリックして統合を完了します。

    ステップ2. New RelicにTiDB Cloudダッシュボードを追加する

    New Relic統合バージョンに応じて手順は異なります。

      保留中の広報 New Relicにマージされると、新しいTiDB CloudダッシュボードがNew Relicで利用できるようになります。それ以前に、以下の手順でダッシュボードをNew Relicに手動でインポートできます。

      1. 新しいダッシュボード用の JSON ファイルを準備します。

        1. テンプレート JSON ファイルここをダウンロードします。

        2. JSON ファイルで、次のように 4 行目に"permissions": "PUBLIC_READ_WRITE"追加します。

          { "name": "TiDB Cloud Dynamic Tracker", "description": null, "permissions": "PUBLIC_READ_WRITE", ... }
        3. JSON ファイル内のすべての"accountIds": []フィールドに New Relic アカウント ID を追加します。

          例えば:

          "accountIds": [ 1234567 ],

          注記

          統合エラーを回避するには、JSON ファイル内のすべての"accountIds"フィールドにアカウント ID が追加されていることを確認してください。

      2. ニューレリックにログインし、左側のナビゲーション バーで[ダッシュボード]をクリックして、右上隅の[ダッシュボードのインポート]クリックします。

      3. 表示されたダイアログで、準備した JSON ファイルのすべてのコンテンツをテキスト領域に貼り付け、 [ダッシュボードのインポート]をクリックします。

      1. ニューレリックにログインします。
      2. 「データを追加」をクリックし、 TiDB Cloudを検索してTiDB Cloud監視ページに移動します。または、「 リンクをクリックして直接ページにアクセスすることもできます。
      3. アカウント ID を選択し、New Relic でダッシュボードを作成します。

      あらかじめ構築されたダッシュボードをビュー

      1. TiDB Cloudコンソールで、 「統合」ページに移動します。

      2. New Relicセクションのダッシュボードリンクをクリックすると、TiDB クラスターの事前構築されたダッシュボードが表示されます。

      3. New Relic統合バージョンに応じて、次のいずれかを実行します。

        • New Relic 統合 (プレビュー) の場合は、 TiDB Cloud Dynamic Trackerをクリックして新しいダッシュボードを表示します。
        • New Relic 統合 (ベータ版) の場合は、 TiDB Cloud Monitoringをクリックしてレガシー ダッシュボードを表示します。

      New Relicで利用可能なメトリクス

      New Relic は、TiDB クラスターの次のメトリクスを追跡します。

      メトリック名メトリックタイプラベル説明
      tidb_cloud.db_database_timeゲージsql_type: 選択挿入
      tidb_cloud.db_query_per_secondゲージタイプ: 選択挿入
      tidbcloud.db平均クエリ実行時間ゲージsql_type: 選択挿入
      tidb_cloud.db_failed_queriesゲージタイプ: executor:xxxxparser:xxxx
      tidb_cloud.db_total_connectionゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…

      コンポーネント: tidb
      tidb_cloud.db_active_connectionsゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…

      コンポーネント: tidb
      tidb_cloud.db_disconnectionsゲージ結果: OKエラー
      tidb_cloud.db_command_per_secondゲージタイプ: QueryStmtPrepare
      tidb_cloud.db_queries_using_plan_cache_opsゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…

      コンポーネント: tidb
      tidb_cloud.db_transaction_per_secondゲージtxn_mode:悲観的楽観的

      タイプ: 中止
      tidb_cloud.node_storage_used_bytesゲージクラスター名: <cluster name>

      インスタンス: tikv-0
      tikv-1…
      tidb_cloud.node_storage_capacity_bytesゲージクラスター名: <cluster name>

      インスタンス: tikv-0
      tikv-1…
      tidb_cloud.node_cpu_seconds_totalカウントクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…
      tidb_cloud.node_cpu_capacity_coresゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…
      tidb_cloud.node_memory_used_bytesゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…
      tidb_cloud.node_memory_capacity_bytesゲージクラスター名: <cluster name>

      インスタンス: tidb-0
      tidb-1…

      New Relic 統合 (プレビュー) では、次の追加メトリックも利用できます。

      メトリック名メトリックタイプラベル説明
      tidbcloud.node_storage_available_bytesゲージインスタンス: tidb-0\|tidb-1\|...
      コンポーネント: tikv\|tiflash
      クラスター名: <cluster name>
      TiKV またはTiFlashノードで使用可能なディスク容量 (バイト単位)。
      tidbcloud.ディスク読み取りレイテンシーゲージインスタンス: tidb-0\|tidb-1\|...
      コンポーネント: tikv\|tiflash
      クラスター名: <cluster name>
      devicenvme.*\|dm.*
      storageデバイスごとの読み取りレイテンシー(秒単位)。
      tidbcloud.disk_write_latencyゲージインスタンス: tidb-0\|tidb-1\|...
      コンポーネント: tikv\|tiflash
      クラスター名: <cluster name>
      devicenvme.*\|dm.*
      storageデバイスごとの書き込みレイテンシー(秒単位)。
      tidbcloud.kv_request_durationヒストグラムインスタンス: tidb-0\|tidb-1\|...
      コンポーネント: tikv
      クラスター名: <cluster name>
      typeBatchGet\|Commit\|Prewrite\|...
      タイプ別の TiKV リクエストの期間 (秒単位)。
      tidbcloud.コンポーネントの稼働時間ゲージインスタンス: tidb-0\|tidb-1\|...
      コンポーネント: tidb\|tikv\|tiflash
      クラスター名: <cluster name>
      TiDB コンポーネントの稼働時間 (秒単位)。
      tidbcloud.ticdc_owner_checkpoint_ts_lagゲージチェンジフィードID: <changefeed-id>
      クラスター名: <cluster name>
      変更フィード所有者のチェックポイント タイムスタンプの遅延 (秒単位)。
      tidbcloud.ticdc_owner_resolved_ts_lagゲージチェンジフィードID: <changefeed-id>
      クラスター名: <cluster name>
      変更フィード所有者の解決されたタイムスタンプの遅延 (秒単位)。
      tidbcloud.changefeed_statusゲージチェンジフィードID: <changefeed-id>
      クラスター名: <cluster name>
      チェンジフィードステータス:
      -1 :不明
      0 :正常
      1 : 警告
      2 : 失敗
      3 : 停止
      4 :終了
      6 :警告
      7 : その他
      tidbcloud.resource_manager_resource_unit_read_request_unitゲージクラスター名: <cluster name>
      リソースグループ: <group-name>
      リソース マネージャーによって消費される読み取り要求単位 (RU)。
      tidbcloud.resource_manager_resource_unit_write_request_unitゲージクラスター名: <cluster name>
      リソースグループ: <group-name>
      リソース マネージャーによって消費される書き込み要求単位 (RU)。
      tidb_cloud.dm_task_stateゲージインスタンス: instance
      タスク: task
      クラスター名: <cluster name>
      データ移行のタスクの状態:
      0: 無効
      1: 新しい
      2: ランニング
      3: 一時停止
      4: 停止
      5: 完了
      15: エラー
      tidb_cloud.dm_syncer_replication_lag_bucketゲージインスタンス: instance
      クラスター名: <cluster name>
      データ移行の遅延 (バケット) を複製します。
      tidb_cloud.dm_syncer_replication_lag_gaugeゲージインスタンス: instance
      タスク: task
      クラスター名: <cluster name>
      データ移行の遅延 (ゲージ) を複製します。
      tidb_cloud.dm_relay_read_error_countゲージインスタンス: instance
      クラスター名: <cluster name>
      マスターからのbinlogの読み取りに失敗しました。

      このページは役に立ちましたか?