Proses debug konektivitas

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Men-debug konektivitas

Anda telah menyiapkan konektivitas antara database sumber dan tujuan, tetapi bagaimana cara mengetahui bahwa database tersebut terhubung? Jika komunikasi Anda gagal di antara keduanya, bagaimana cara Anda mengetahui masalahnya dan di mana?

Alat yang paling dasar adalah ping dan traceroute.

Ping

Ping melakukan pengujian dasar untuk menentukan apakah tujuan ("host jarak jauh") tersedia dari sumber. Ping mengirim paket ICMP Echo Request ke host jarak jauh, dan mengharapkan ICMP Echo Reply sebagai balasannya. Jika ping tidak berhasil, tidak ada rute dari sumber ke tujuan. Namun, keberhasilan tidak berarti paket Anda dapat melewatinya, hanya bahwa secara umum, host jarak jauh dapat dijangkau.

Meskipun ping dapat mengetahui apakah host aktif dan merespons, hal ini tidak dijamin dapat diandalkan. Beberapa penyedia jaringan memblokir ICMP sebagai langkah pengamanan, yang dapat mempersulit proses debug konektivitas.

Traceroute

Traceroute menguji rute lengkap yang diambil paket jaringan dari satu host ke host lainnya. Diagram ini menunjukkan semua langkah ("hop") yang dilakukan paket sepanjang perjalanan, dan berapa lama setiap langkah tersebut. Jika paket tidak sampai ke tujuan, traceroute tidak akan selesai, tetapi berakhir dengan serangkaian tanda bintang. Dalam hal ini, cari alamat IP terakhir yang berhasil dijangkau di sepanjang jalan. Di sinilah konektivitas mengalami gangguan.

Traceroute dapat habis waktunya. Proses ini juga dapat gagal diselesaikan jika gateway di sepanjang jalan tidak dikonfigurasi dengan benar untuk meneruskan paket ke hop berikutnya.

Jika traceroute gagal diselesaikan, Anda mungkin dapat mengetahui tempatnya berhenti. Temukan alamat IP terakhir yang tercantum dalam output traceroute, lalu lakukan penelusuran browser untuk who owns [IP_ADDRESS]. Hasilnya mungkin menampilkan atau tidak menampilkan pemilik alamat, tetapi tidak ada salahnya untuk mencoba.

mtr

Alat mtr adalah bentuk traceroute yang tetap aktif dan terus diperbarui, mirip dengan cara kerja perintah top untuk proses lokal.

Menemukan alamat IP lokal Anda

Jika Anda tidak mengetahui alamat lokal host, jalankan perintah ip -br address show. Di Linux, hal ini menunjukkan antarmuka jaringan, status antarmuka, IP lokal, dan alamat MAC. Contoh: eth0 UP 10.128.0.7/32 fe80::4001:aff:fe80:7/64.

Atau, Anda dapat menjalankan ipconfig atau ifconfig untuk melihat status antarmuka jaringan.

Menemukan alamat IP keluar

Jika Anda tidak mengetahui alamat IP yang digunakan database sumber dan tujuan untuk berkomunikasi satu sama lain (alamat IP keluar), selesaikan langkah-langkah berikut:

1. Buka halaman cluster AlloyDB di konsol Google Cloud.

   Buka halaman cluster AlloyDB

2. Temukan cluster yang terkait dengan tugas migrasi yang Anda debug.

3. IP keluar akan muncul di samping nama instance utama cluster.

Buka port lokal

Untuk memverifikasi bahwa host memproses port yang menurut Anda benar, jalankan perintah ss -tunlp4. Ini memberitahu Anda port apa yang terbuka dan mendengarkan. Misalnya, jika Anda memiliki database PostgreSQL yang berjalan, port 5432 harus aktif dan memproses. Untuk SSH, Anda akan melihat port 22.

Semua aktivitas port lokal

Gunakan perintah netstat untuk melihat semua aktivitas port lokal. Misalnya, netstat -lt menampilkan semua port yang saat ini aktif.

Menghubungkan ke host jarak jauh menggunakan telnet

Untuk memverifikasi bahwa Anda dapat terhubung ke host jarak jauh menggunakan TCP, jalankan perintah telnet. Telnet mencoba terhubung ke alamat IP dan port yang Anda berikan.

Misalnya, jika host jarak jauh Anda menjalankan database PostgreSQL, Anda seharusnya dapat melakukan telnet ke database tersebut di port 5432: telnet 35.193.198.159 5432.

Jika berhasil, Anda akan melihat hal berikut:

Trying 35.193.198.159...

Connected to 35.193.198.159. .

Jika gagal, Anda akan melihat telnet berhenti merespons hingga Anda menutup percobaan tersebut secara paksa:

Trying 35.193.198.159...

^C. .

Autentikasi klien

Autentikasi klien dikontrol oleh file konfigurasi, yang diberi nama pg_hba.conf (HBA adalah singkatan dari host-based authentication).

Pastikan bagian koneksi replikasi file pg_hba.conf pada database sumber telah diupdate untuk menerima koneksi dari rentang alamat IP VPC AlloyDB.

Cloud Logging

Database Migration Service dan AlloyDB menggunakan Cloud Logging. Lihat dokumentasi Cloud Logging untuk mengetahui informasi selengkapnya dan tinjau contoh kueri Cloud SQL.

Lihat log

Anda dapat melihat log untuk instance AlloyDB dan project Google Cloud lainnya seperti instance Cloud VPN atau Compute Engine. Untuk melihat log yang berisi entri log instance AlloyDB Anda:

Konsol

1. Buka Logs Explorer
2. Pilih project AlloyDB yang ada di bagian atas halaman.
3. Di Builder kueri, tambahkan hal berikut:
• Resource: Pilih Database AlloyDB. Pada dialog, pilih instance AlloyDB.
• Nama log: Scroll ke bagian AlloyDB dan pilih file log yang sesuai untuk instance Anda. Contoh:
  • alloydb.googlapis.com/postgres.log
• Tingkat keparahan: Pilih level log.
• Rentang waktu: Pilih preset atau buat rentang kustom.

gcloud

Gunakan perintah gcloud logging untuk melihat entri log. Pada contoh di bawah, ganti PROJECT_ID. Flag limit adalah parameter opsional yang menunjukkan jumlah entri maksimum yang akan ditampilkan.

gcloud logging read "projects/[PROJECT_ID]/logs/alloydb.googleapis.com/postgres.log" --limit=10

Pemecahan masalah VPN

Lihat halaman Pemecahan masalah Cloud VPN diGoogle Cloud

Memecahkan masalah error proxy TCP

Cara penyiapan proxy TCP juga dapat menyebabkan error. Untuk memecahkan masalah error proxy TCP, lihat contoh masalah berikut dan cara mengatasinya:

Kegagalan memulai virtual machine (VM)

Anda akan melihat pesan berikut saat memulai instance VM di Compute Engine:

You do not currently have an active account selected.

Hal-hal yang dapat dicoba

Jalankan salah satu perintah berikut untuk mengonfigurasi akun aktif:

• Untuk mendapatkan kredensial baru, jalankan perintah berikut:

  gcloud auth login
  

• Untuk memilih akun yang telah diautentikasi, jalankan perintah berikut:

  gcloud config set account ACCOUNT
  

  Ganti ACCOUNT dengan nama akun yang ingin Anda konfigurasi.

Kegagalan saat terhubung ke instance database sumber

Anda melihat pesan error berikut saat menguji tugas migrasi:

Failure connecting to the source database. Make sure the connectivity information on the connection profile is correct and the source database is reachable.

Hal-hal yang dapat dicoba

Lakukan iterasi melalui langkah-langkah berikut untuk memahami letak masalahnya:

1. Periksa apakah VM yang menghosting penampung proxy TCP sedang berjalan:

   1. Di konsol, buka halaman instance VM Compute Engine.

      Buka instance VM

   2. Telusuri VM yang dibuat sebagai bagian dari proses penyiapan proxy. Jika tidak tercantum atau tidak berjalan, konfigurasi proxy TCP Anda dari awal, dan perbarui setelan instance sumber dalam tugas migrasi dengan alamat IP yang benar.

2. Jika VM berjalan, pastikan tidak ada error saat mendownload image penampung proxy TCP:

   1. Pilih VM yang dibuat sebagai bagian dari proses penyiapan proxy TCP. Di bagian Logs, klik Serial port 1 (console).

   2. Jika Anda tidak dapat melihat entri Launching user container 'gcr.io/dms-images/tcp-proxy' dalam log, masalahnya mungkin karena instance Anda tidak dapat mengambil image dari Container Registry. Untuk memverifikasi apakah hal ini terjadi, hubungkan ke VM, dan coba tarik image dari Container Registry secara manual menggunakan perintah berikut:

      docker pull gcr.io/dms-images/tcp-proxy

      Jika Anda melihat error berikut: Error response from daemon: Get "https://gcr.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers), berarti VM Anda tidak dapat terhubung ke Container Registry. Jika VM Anda hanya memiliki alamat IP pribadi, Anda harus mengaktifkan Akses Google Pribadi di subnet yang menjadi bagian dari alamat IP tersebut; jika tidak, VM tidak akan memiliki akses ke Google Enterprise API, seperti Container Registry.

3. Pastikan penampung dapat terhubung ke instance sumber:

   1. Pilih VM yang dibuat sebagai bagian dari proses penyiapan proxy. Pada bagian Logs, klik Cloud Logging.

   2. Jika Anda melihat pesan berikut: Connection refused, please verify that the machine you are using to run the script can connect to the source database at, artinya penampung proxy TCP tidak dapat terhubung ke instance database sumber. Ada beberapa alasan hal ini dapat terjadi:

      • Alamat IP instance sumber salah.
      • Ada kebijakan firewall yang menolak koneksi dari proxy TCP ke instance sumber.
      • Instance sumber berada di jaringan Virtual Private Cloud (VPC) yang berbeda dengan VM yang menghosting proxy TCP.

   Anda dapat men-debug masalah konektivitas menggunakan Uji Konektivitas Google Clouduntuk memastikan ada konektivitas antara database tujuan dan VM yang menghosting proxy TCP:

   1. Di konsol, buka halaman Uji Konektivitas.

      Buka Uji Konektivitas

   2. Klik Buat Uji Konektivitas.

   3. Masukkan nama untuk pengujian.

   4. Pilih TCP sebagai protokol.

   5. Pilih IP address dari daftar Source endpoint. Masukkan alamat IP publik proxy TCP yang baru dibuat jika database sumber dapat diakses menggunakan alamat IP publik; jika tidak, masukkan alamat IP pribadi proxy TCP.

   6. Pilih Alamat IP dari daftar Endpoint tujuan, lalu masukkan alamat IP database sumber.

   7. Masukkan nomor port yang digunakan untuk terhubung ke database sumber di kolom Port tujuan.

   8. Klik Create.

   Jalankan uji konektivitas dan atasi masalah konektivitas yang muncul. Setelah Anda memperbaiki masalah konektivitas, pastikan proxy TCP dapat terhubung ke instance sumber:

   1. Buka VM instances di Compute Engine.

      Buka instance VM

   2. Pilih VM yang dibuat sebagai bagian dari proses penyiapan proxy. Pada bagian Logs, klik Cloud Logging.

   3. Jika Anda melihat entri log Connection to source DB verified, artinya proxy TCP kini dapat terhubung ke instance sumber.

4. Pastikan pengujian migrasi tidak gagal karena masalah koneksi.

Gagal terhubung ke instance database tujuan

Jika penampung proxy TCP dapat terhubung ke instance sumber, tetapi pengujian migrasi masih gagal karena masalah koneksi, masalahnya mungkin konektivitas antara instance tujuan dan VM yang menghosting penampung proxy TCP.

Men-debug masalah

Untuk men-debug masalah ini, Anda dapat menggunakan Uji Konektivitas Google Clouduntuk memastikan ada konektivitas antara database tujuan dan VM yang menghosting proxy TCP:

1. Di konsol, buka halaman Uji Konektivitas.

   Buka Uji Konektivitas

2. Klik Buat Uji Konektivitas.

3. Tetapkan parameter berikut untuk pengujian Anda:

   1. Masukkan nama untuk pengujian.
   2. Pilih TCP sebagai protokol.
   3. Pilih IP address dari daftar Source endpoint, lalu masukkan alamat IP cluster AlloyDB yang baru dibuat.
   4. Pilih Alamat IP dari daftar Endpoint tujuan, lalu masukkan alamat IP pribadi proxy TCP.
   5. Masukkan 5432 di kolom Port tujuan.

4. Klik Create.

5. Jalankan uji konektivitas dan atasi masalah konektivitas yang muncul.

Kemungkinan penyebab

Ada aturan firewall yang menolak komunikasi antara instance tujuan dan VM proxy TCP.

Hal-hal yang dapat dicoba

Tambahkan aturan firewall yang memungkinkan instance tujuan berkomunikasi dengan Proxy TCP menggunakan port 5432.

Kemungkinan penyebab

Ada ketidakcocokan VPC antara instance tujuan dan VM yang menjalankan penampung proxy TCP.

Hal-hal yang dapat dicoba

Pilih VPC yang sama untuk instance tujuan.

Memecahkan masalah tunnel SSH terbalik

Tunneling SSH adalah metode untuk meneruskan beberapa komunikasi di atas koneksi SSH. Tunneling SSH terbalik memungkinkan penyiapan tunnel SSH, tetapi mempertahankan bahwa jaringan tujuan adalah jaringan yang memulai koneksi tunnel. Hal ini berguna jika Anda tidak ingin membuka port di jaringan Anda sendiri untuk tujuan keamanan.

Yang Anda coba capai adalah menyiapkan hal berikut: AlloyDB DB ---> Compute Engine VM bastion ---> tunnel ---> source network bastion ---> source DB

Meskipun Database Migration Service memigrasikan data dari sumber ke tujuan, Anda harus mengaktifkan konektivitas dari tujuan ke sumber.

Diasumsikan bahwa:

• AlloyDB destination dapat mengakses Compute Engine VM bastion.

• source network bastion dapat mengakses source DB (hal ini dicapai dengan melakukan peering jaringan AlloyDB ke jaringan VM Compute Engine).

Kemudian, Anda menyiapkan tunnel SSH dari source network bastion ke Compute Engine VM bastion, yang merutekan koneksi masuk ke beberapa port di Compute Engine VM bastion melalui tunnel ke source DB.

Setiap link dalam skenario di atas dapat disiapkan dengan tidak benar dan mencegah seluruh alur berfungsi. Pecahkan masalah setiap link, satu per satu:

source network bastion ---> source DB

1. Hubungkan ke source network bastion menggunakan SSH, atau dari terminal jika mesin lokal.
2. Uji konektivitas ke DB sumber menggunakan salah satu metode berikut:
   • telnet [source_db_host_or_ip] [source_db_port] - Anda akan melihat string koneksi telnet, yang diakhiri dengan Connected to x.x.x.x.
   • [db_client] -h[source_db_host_or_ip] -P[source_db_port] - Anda akan melihat akses ditolak

Jika gagal, Anda harus memverifikasi bahwa Anda telah mengaktifkan akses dari bastion ini ke DB sumber.

Compute Engine VM bastion ---> source DB

1. SSH ke Compute Engine VM bastion (menggunakan gcloud compute ssh VM_INSTANCE_NAME)
2. Uji konektivitas ke DB sumber menggunakan salah satu metode berikut:
   • telnet 127.0.0.1 [tunnel_port] - Anda akan melihat string koneksi telnet, yang diakhiri dengan Connected to x.x.x.x.
   • [db_client] -h127.0.0.1 -P[tunnel_port] - akan melihat akses ditolak

Jika gagal, Anda harus memastikan bahwa tunnel sudah aktif dan berjalan dengan benar. Menjalankan sudo netstat -tupln akan menampilkan semua proses pemrosesan di VM ini, dan Anda akan melihat sshd listening on the tunnel_port.

AlloyDB DB ---> source DB

Hal ini paling baik diuji oleh testing the migration job dari Database Migration Service. Jika gagal, berarti ada beberapa masalah dengan peering atau perutean VPC antara jaringan AlloyDB dan jaringan Compute Engine VM bastion.

Firewall server database sumber harus dikonfigurasi untuk mengizinkan seluruh rentang IP internal yang dialokasikan untuk koneksi layanan pribadi jaringan VPC yang akan digunakan oleh instance tujuan AlloyDB sebagai kolom privateNetwork dari setelan ipConfiguration-nya.

Untuk menemukan rentang IP internal di konsol:

1. Buka halaman jaringan VPC di konsol Google Cloud .

2. Pilih jaringan VPC yang ingin Anda gunakan.

3. Pilih tab PRIVATE SERVICE CONNECTION.

Anda juga dapat melihat traffic antara instance AlloyDB dan instance VM Compute Engine di konsol Cloud Logging di project Cloud VPN gateway. Di log VM Compute Engine, cari traffic yang berasal dari instance AlloyDB. Di log instance AlloyDB, cari traffic dari VM Compute Engine.