PingCAP Clinicクイックスタートガイド

このドキュメントでは、 PingCAP Clinic診断サービス (PingCAP Clinic) を使用して、クラスター診断データを迅速に収集、アップロード、表示する方法について説明します。

PingCAP Clinicは、 Diagクライアント （Diagと略記）とClinic Serverクラウドサービス（Clinic Serverと略記）の2つのコンポーネントで構成されています。これらの2つのコンポーネントの詳細については、 PingCAP Clinicの概要を参照してください。

ユーザーシナリオ

• PingCAP テクニカル サポートからリモートで支援を受ける際にクラスターの問題を正確に特定し、迅速に解決するには、Diag を使用して診断データを収集し、収集したデータを Clinic Server にアップロードして、データ アクセス リンクをテクニカル サポートに提供することができます。
• クラスターが正常に実行されており、クラスターのステータスを確認する必要がある場合は、Diag を使用して診断データを収集し、そのデータを Clinic Server にアップロードして、Health Report の結果を表示できます。

前提条件

PingCAP Clinicを使用する前に、Diag をインストールし、データをアップロードするための環境を準備する必要があります。

1. TiUPがインストールされているコントロール マシンで、次のコマンドを実行して Diag をインストールします。

   tiup install diag
   

2. Clinic Serverにログインします。

   ノート

   TiDB Cloudアカウントは、SSO モードで Clinic Server にログインする場合にのみ使用され、 TiDB Cloudサービスへのアクセスには必須ではありません。

   中国本土のユーザー向けClinic Serverに進み、 「AskTUGを続ける」を選択してAskTUGコミュニティのログインページに進みます。AskTUGアカウントをお持ちでない場合は、このページでアカウントを作成してください。

3. Clinic Server 上に組織を作成します。組織は TiDB クラスターの集合です。作成した組織に診断データをアップロードできます。

4. データをアップロードするには、アクセストークンを取得してください。Diag を通じて収集したデータをアップロードする際は、データが安全に分離されていることを確認するために、ユーザー認証用のトークンが必要です。Clinic Serverから既にトークンを取得している場合は、そのトークンを再利用できます。

   
   ノート

   • データセキュリティのため、TiDBはトークン作成時にのみトークン情報を表示します。トークン情報を紛失した場合は、古いトークンを削除して新しいトークンを作成できます。
   • トークンはデータのアップロードにのみ使用されます。

5. Diag にトークンとregion設定します。

   • clinic.token設定するには、次のコマンドを実行します。

     tiup diag config clinic.token ${token-value}
     

   • clinic.region設定するには、次のコマンドを実行します。

   region 、データの圧縮に使用する暗号化証明書と、データのアップロード時に使用する対象サービスを決定します。例:

   ノート

   • Diag v0.9.0 以降のバージョンでは設定regionサポートされます。
   • Diag v0.9.0より前のバージョンでは、データはデフォルトで中国リージョンのClinic Serverにアップロードされます。これらのバージョンでregion設定するには、 tiup update diagコマンドを実行してDiagを最新バージョンにアップグレードし、その後Diagでregion設定してください。

   国際ユーザー向けに Clinic Server を使用する場合は、次のコマンドを使用してregionをUS設定します。

   tiup diag config clinic.region US
   

   中国本土のユーザー向けに Clinic Server を使用する場合は、次のコマンドを使用してregionをCN設定します。

   tiup diag config clinic.region CN
   

6. (オプション) ログ編集を有効にします。

   TiDBが詳細なログ情報を提供する場合、ログに機密情報（ユーザーデータなど）が出力される可能性があります。ローカルログおよびClinic Serverへの機密情報の漏洩を防ぎたい場合は、TiDB側でログ編集を有効にすることができます。詳細については、 ログ編集ご覧ください。

手順

1. Diag を実行して診断データを収集します。

   たとえば、現在の時刻に基づいて 4 時間前から 2 時間前までの診断データを収集するには、次のコマンドを実行します。

   tiup diag collect ${cluster-name} -f="-4h" -t="-2h"
   

   コマンドを実行しても、Diag はすぐにデータ収集を開始するわけではありません。代わりに、Diag は推定データサイズとターゲットデータストレージパスを出力に表示し、続行するかどうかを確認します。データ収集を開始するには、 Yと入力してください。

   収集が完了すると、Diag は収集されたデータが保存されているフォルダー パスを提供します。

2. 収集したデータをClinic Serverにアップロードします。

   ノート

   アップロードするデータ（収集されたデータを含む圧縮ファイル）のサイズは3GB以下にしてください。3GBを超える場合、データのアップロードは失敗します。

   • クラスターが配置されているネットワークがインターネットにアクセスできる場合は、次のコマンドを使用して、収集されたデータを含むフォルダーを直接アップロードできます。

     tiup diag upload ${filepath}
     

     アップロードが完了すると、出力にDownload URL表示されます。

     ノート

     この方法でデータをアップロードする場合は、Diag v0.9.0以降のバージョンを使用する必要があります。Diagのバージョンは実行時に取得できます。Diagのバージョンが0.9.0より前のバージョンの場合は、 tiup update diagコマンドを使用してDiagを最新バージョンにアップグレードできます。

   • クラスターが設置されているネットワークがインターネットにアクセスできない場合は、収集したデータをパックしてアップロードする必要があります。詳細は方法2. データをパックしてアップロードするご覧ください。

3. アップロードが完了したら、コマンド出力のDownload URLからデータ アクセス リンクを取得します。

   デフォルトでは、診断データには、クラスター名、クラスター トポロジ情報、収集された診断データ内のログ コンテンツ、収集されたデータ内のメトリックに基づいて再構成された Grafana ダッシュボード情報が含まれます。

   データを使用してクラスターの問題を自分でトラブルシューティングすることも、PingCAP テクニカル サポート スタッフにデータ アクセス リンクを提供してリモート トラブルシューティングを容易にすることもできます。

4. ヘルスレポートの結果を表示する

   データがアップロードされると、Clinic Server はバックグラウンドで自動的にデータを処理します。ヘルスレポートは約5～15分で生成されます。診断データリンクを開き、「ヘルスレポート」をクリックすると、レポートをご覧いただけます。

次は何？

• PingCAP Clinicの概要
• PingCAP Clinicを使用したクラスターのトラブルシューティング
• PingCAP Clinic診断データ