接続テストを管理する

MySQL   |  PostgreSQL   |  SQL Server

接続テストは、ネットワーク エンドポイント間の接続を確認できる診断ツールです。構成を分析し、場合によってはエンドポイント間でライブ データプレーン分析を行います。エンドポイントは、Cloud SQL インスタンスなどのネットワーク トラフィックの送信元または宛先です。

次のいずれかの目的で接続テストツールを使用します。

• Cloud SQL インスタンスと別のリソース（仮想マシン（VM）など）間の接続、またはリードレプリカ インスタンスとプライマリ インスタンス間の接続を確認する。
• さまざまな種類の送信元と宛先の設定に関連する接続の問題のトラブルシューティングを行う。
• VPC ネットワーク内に Cloud SQL 関連のリソースで使用されている問題があるかどうかを判断する。

ツールで診断できる構成エラーには、Cloud SQL インスタンスへの接続が以下によってブロックされている場合などがあります。

• VPC ファイアウォール ルール、階層型ファイアウォール ポリシー、グローバル ネットワーク ファイアウォール ポリシー
• ルーティングの問題（宛先ネットワークへの誤ったルートが使用されている、動的ルートが利用できないなど）
• VPC ネットワークと Google マネージド サービス ネットワーク間の VPC ピアリングに関連する問題
• インスタンスが実行されていない
• Cloud SQL Auth Proxy がインスタンスにアクセスする際に使用するポートまたはプロトコルが正しくない
• インスタンスに対して設定された承認済みネットワークでエラーが発生する

接続テストツールの詳細については、接続テストの概要をご覧ください。

注: 接続テストツールは、ネットワークの問題を手動でトラブルシューティングし、デバッグするために使用されます。自動ネットワーク接続のトラブルシューティングが必要な場合は、ネットワーク アナライザを使用します。ネットワーク アナライザの詳細については、ネットワーク アナライザの概要をご覧ください。ネットワーク アナライザに関連する分析情報の詳細については、Cloud SQL 接続の分析情報をご覧ください。

始める前に

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Network Management API を有効にします。 この API を有効にして、接続テストを実行できるようにする必要があります。
7. ユーザー アカウントに Network Management 管理者のロールと関連する権限を割り当てます。

   IAM ページに移動

接続テストを作成する

接続テストを作成する手順は以下のとおりです。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. 接続テストを作成する Cloud SQL インスタンスをクリックします。

   ページにインスタンスが表示されない場合は、インスタンスを作成します。

3. サイド ナビゲーション メニューで [接続] をクリックします。
4. [接続テスト] タブをクリックして [作成] をクリックします。

5. [テスト名] フィールドにテストの名前を入力します。

   テスト名に使用できるのは、小文字、数字、ハイフンのみです。

6. [プロトコル] リストから、テストのプロトコルを選択します。
7. この Cloud SQL インスタンスがテストの送信元である場合は、次の操作を行います。
   1. [ソース] リージョンで、[現在の Cloud SQL インスタンス] オプションをクリックします。
   2. [宛先] リージョンで [その他] をクリックし、宛先のエンドポイントに関する情報を指定します。
8. インスタンスがテストの宛先の場合は、次の操作を行います。
   1. [ソース] リージョンで、[その他] をクリックして、送信元のエンドポイントに関する情報を指定します。
   2. [宛先] リージョンで、[現在の Cloud SQL インスタンス] オプションをクリックします。
9. [宛先ポート] フィールドに、宛先のポートを入力します。
10. [作成] をクリックします。

テストが終了すると、[接続テスト] タブが読み込まれ、構成されたテストのリストが表示されます。

接続テストに関する情報を表示する

表示できる接続テストの概要情報は、次のとおりです。

• テストの名前、プロトコル、送信元、宛先。
• 送信元と宛先に関連付けられた Google Cloud プロジェクト。
• 宛先用に予約されたポート。
• テストが最後に実行された日時。
• 送信元から宛先に送信されたデータのパケット数を示すデータプレーン分析チェックの結果。
• データのパケットを宛先に転送できるように、送信元と宛先の間で接続が確立されたかどうかを示す構成分析チェックの結果。
• テストの詳細。

接続テストの概要情報を表示するだけでなく、テストをクリックすると次のようなテスト結果に関する追加情報を表示することもできます。

• ライブ データプレーン分析チェックに関連する片道レイテンシ値。
• 構成分析のチェックに関する詳細情報。この情報には、チェックのステータスや Cloud SQL インスタンスなどが含まれます。
• 実行中の接続テストに対する REST API レスポンス。

概要と詳細情報を表示する

接続テストの概要と詳細情報を表示する手順は次のとおりです。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. Cloud SQL インスタンスをクリックして、接続テストに関する情報を表示します。

3. サイド ナビゲーション メニューで [接続] をクリックします。
4. [接続テスト] タブをクリックします。そのインスタンスに関連するすべてのテストの概要が表示されます。

5. 詳細情報を表示するテストをクリックします。

   [接続テストの詳細] ページが表示されます。このページでは、そのテストパスの各 Google Cloud リソースの全体的な結果と結果カードを確認できます。VM インスタンスやルートなど、一部の Google Cloud リソースの詳細ページへのリンクをクリックできます。テストに複数のトレースが含まれている場合は、トレースの結果リストからトレースを選択できます。

   データプレーン分析がテスト可能な場合、パケットロスとレイテンシの指標を表示できます。

   テスト結果を解釈するには、構成分析の状態をご覧ください。

6. 構成分析のチェックに関する詳細情報を表示するには、[前回の構成分析の結果] セクションで [表示] をクリックします。
7. テストの REST API レスポンスを表示するには、ページの一番下までスクロールして [同等の REST] をクリックします。

接続テストを変更する

接続テストを変更する手順は次のとおりです。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. 接続テストを変更する Cloud SQL インスタンスをクリックします。
3. サイド ナビゲーション メニューで [接続] をクリックします。
4. [接続テスト] タブをクリックします。
5. 変更するテストをクリックします。
6. [接続テストの詳細] ページで [編集] をクリックします。
7. テストを変更します。プロトコル、送信元エンドポイント、宛先エンドポイント、宛先ポートは変更できます。
8. [保存] をクリックします。

接続テストを再実行する

接続テストに関連するリソースのネットワーク構成を変更して、最新の構成の結果を確認したい場合は、テストを再実行できます。1 つ以上のテストを同時に再実行できます。

接続テストは、テスト実行時のネットワーク構成のスナップショットに基づきます。テストを再実行すると、前回のテストの結果は上書きされます。古い結果を保持する場合は、新たにテストを作成します。

1 つ以上の接続テストを再実行する手順は次のとおりです。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. 接続テストを再実行する Cloud SQL インスタンスをクリックします。
3. サイド ナビゲーション メニューで [接続] をクリックします。
4. [接続テスト] タブをクリックします。
5. 再実行する各テストの横にあるチェックボックスをオンにします。
6. [再実行] をクリックします。
7. ダイアログ ボックスで [再実行] をクリックします。

接続テストの削除

接続テストが不要になった場合は削除します。1 つ以上のテストを同時に削除できます。

接続テストを削除する手順は次のとおりです。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. 接続テストを削除する Cloud SQL インスタンスをクリックします。
3. サイド ナビゲーション メニューで [接続] をクリックします。
4. [接続テスト] タブをクリックします。
5. 削除する各テストの横にあるチェックボックスをオンにします。
6. [削除] をクリックします。
7. ダイアログ ボックスで [削除] をクリックします。

接続テストを削除すると、割り当てを消費しなくなり、今後は課金されなくなります。

トラブルシューティング

接続テストに関する一般的な問題のトラブルシューティングについては、接続テストのトラブルシューティングをご覧ください。

次のステップ

• 接続テストの概要
• Cloud SQL 接続の分析情報
• 接続テストを作成して実行する
• ネットワーク アナライザの概要