Menyiapkan subdomain yang diterjemahkan memerlukan konfigurasi DNS, SSL/TLS, dan origin yang benar. Untuk mempermudah pemecahan masalah, Linguise kini menyediakan debugger terjemahan subdomain yang memeriksa pengaturan Anda dan menyoroti masalah konfigurasi atau konektivitas.
Debugger membantu Anda mengidentifikasi penyebab kegagalan pemeriksaan pengaturan dan memberikan informasi kesalahan yang relevan sehingga Anda dapat memperbaiki masalah dan memverifikasi konfigurasi Anda lagi.
Apa yang diperiksa oleh Subdomain Translation Debugger?
Debugger memeriksa konfigurasi DNS, koneksi SSL/TLS, dan situs web asli (origin). Ia memverifikasi kepemilikan domain, catatan CNAME subdomain yang diterjemahkan, catatan A/AAAA, sertifikat, dan ketersediaan HTTPS.
Selain itu, ia juga memeriksa apakah sumbernya dapat diakses secara publik dan mengembalikan respons HTTP yang dapat digunakan. Setiap pemeriksaan mengembalikan status dan, jika berlaku, kode kesalahan.
Memahami hasil diagnostik
Debugger menggunakan berbagai status untuk menampilkan hasil setiap pemeriksaan.
Gagal
Status Gagal berarti debugger mendeteksi masalah konfigurasi atau konektivitas yang perlu diperbaiki. Periksa kode kesalahan dan detail diagnostik untuk mengidentifikasi komponen yang terpengaruh, seperti DNS, SSL/TLS, atau situs web asal. Setelah memperbaiki masalah, jalankan pemeriksaan pengaturan lagi untuk memverifikasi hasilnya.
Peringatan
Status Peringatan berarti situs web dapat diakses, tetapi responsnya mungkin mencegah penerjemahan yang andal atau menunjukkan potensi masalah konfigurasi. Tinjau detail diagnostik dan periksa situs web asal, server, atau konfigurasi jaringan seperti yang ditunjukkan. Setelah masalah teratasi, jalankan kembali pemeriksaan pengaturan.
Tidak dikenal
Status "Tidak Diketahui" berarti debugger tidak dapat menetapkan hasil yang andal untuk pemeriksaan tersebut. Coba lagi pemeriksaan pengaturan terlebih dahulu. Jika status tersebut tetap ada, tinjau informasi diagnostik dan selidiki apakah masalah DNS, TLS, atau konektivitas yang mendasarinya menjadi penyebabnya.
Dilewati
Status "Dilewati" berarti pemeriksaan tidak dapat dijalankan karena pemeriksaan sebelumnya yang diperlukan gagal. Misalnya, pemeriksaan TLS dapat dilewati ketika nama host yang diterjemahkan tidak dapat diselesaikan melalui DNS. Status "Dilewati" berarti pemeriksaan tidak dapat dijalankan karena pemeriksaan sebelumnya gagal. Perbaiki terlebih dahulu pemeriksaan yang gagal sebelumnya, lalu jalankan kembali pemeriksaan pengaturan.
Kesalahan DNS
Kesalahan DNS terjadi ketika catatan yang diperlukan untuk menghubungkan subdomain terjemahan Anda atau situs web asli hilang, salah, atau tidak dapat diselesaikan.
CNAME subdomain salah atau hilang
Kesalahan ini berarti bahwa nama host bahasa terjemahan tidak mengarah ke target CNAME Linguise yang dibutuhkan.
Periksa konfigurasi DNS untuk nama host bahasa yang bermasalah dan pastikan CNAME-nya mengarah ke Linguise yang diberikan selama penyiapan. Jika catatan tersebut hilang atau mengarah ke target yang salah, perbarui dengan penyedia DNS Anda. Debugger mungkin melaporkan kesalahan berikut:
- DNS_CNAME_NXDOMAIN: nama host yang diterjemahkan tidak dapat diselesaikan.
- DNS_CNAME_MISMATCH: CNAME mengarah ke target yang salah.
Verifikasi kepemilikan domain
Kesalahan ini berarti bahwalinguise hilang atau nilainya tidak sesuai dengan nilai verifikasi saat ini. Debugger mungkin melaporkan DNS_TXT_MISMATCH ketika catatan TXT tidak berisi nilai verifikasi yang diharapkan.
Buka penyedia DNS Anda dan periksalinguise.<domain> Catatan TXT. Tambahkan catatan jika hilang, atau perbarui nilainya ke nilai verifikasi yang diberikan oleh Linguise.
Jangan hapus catatan TXT yang tidak terkait dari domain Anda. Setelah perubahan DNS tersebar, jalankan kembali pemeriksaan pengaturan.
Kesalahan DNS domain asli
Kesalahan ini berarti bahwa domain asli tidak mengarah ke catatan publik A atau AAAA yang dapat digunakan. Periksa catatan DNS Anda dan pastikan domain tersebut mengarah ke alamat IP publik yang benar.
Jika data tersebut hilang atau salah, perbarui dengan penyedia DNS Anda. Tunggu hingga perubahan DNS tersebar, lalu jalankan kembali pemeriksaan pengaturan.
Kesalahan SSL/TLS
Kesalahan SSL/TLS terjadi ketika Linguise tidak dapat membuat koneksi HTTPS yang aman dan valid ke subdomain yang diterjemahkan atau situs web aslinya.
Kesalahan SSL/TLS subdomain yang diterjemahkan
Kesalahan ini berarti Linguise tidak dapat membuat koneksi TLS yang valid ke nama host yang diterjemahkan.
Periksa apakah nama host memiliki sertifikat SSL yang valid dan belum kedaluwarsa yang sesuai dengan nama host tersebut. Pastikan juga rantai sertifikat lengkap dan HTTPS tersedia di port 443.
Jika Anda menggunakan CDN, reverse proxy, atau WAF, periksa konfigurasi TLS-nya dan pastikan tidak menghalangi koneksi. Setelah memperbaiki konfigurasi, jalankan kembali pemeriksaan pengaturan.
Kesalahan SSL/TLS situs web asli
Kesalahan ini berarti Linguise tidak dapat membuat koneksi HTTPS yang valid ke situs web asli.
Periksa sertifikat asal untuk mengetahui masa berlaku, ketidaksesuaian nama host, rantai sertifikat yang tidak lengkap, atau masalah konfigurasi TLS lainnya. Jika situs web Anda menggunakan CDN atau reverse proxy, pastikan juga sertifikat yang benar digunakan untuk koneksi asal. Perbaiki sertifikat atau konfigurasi TLS, lalu jalankan kembali pemeriksaan pengaturan.
Kesalahan situs web Origin
Kesalahan asal terjadi ketika Linguise tidak dapat terhubung dengan benar ke situs web asli atau tidak menerima respons yang dapat digunakan darinya.
Kesalahan asal tujuan
Kesalahan ini berarti bahwa origin yang dikonfigurasi mengarah ke tujuan yang tidak dapat diakses Linguise . Pastikan domain tersebut mengarah ke tujuan yang dapat diakses publik.
Jika sumber menggunakan alamat privat, loopback, atau link-local, perbarui konfigurasi sumber untuk menggunakan tujuan yang dapat diakses publik, lalu jalankan kembali pemeriksaan pengaturan.
Kesalahan HTTP asal
Kesalahan ini berarti Linguise dapat mengakses situs web asli tetapi menerima respons HTTP yang dapat mencegah penerjemahan yang andal.
Penyebab umum meliputi waktu tunggu permintaan, persyaratan otentikasi, pembatasan laju permintaan, pengalihan, atau kesalahan server. Periksa langsung situs web asal dan tinjau konfigurasi server, firewall, WAF, otentikasi, dan pembatasan laju permintaan Anda.
Pastikan situs web asli dapat mengembalikan respons yang valid terhadap permintaan dari Linguise, lalu jalankan kembali pemeriksaan pengaturan.
Kesalahan diagnostik dan runtime
Kesalahan diagnostik dan kesalahan saat runtime berkaitan dengan debugger atau proses diagnostiknya, dan bukan berarti menunjukkan masalah pada konfigurasi DNS, TLS, atau origin.
PEMERIKSA INTI GAGAL
Kesalahan ini berarti bahwa pemeriksa diagnostik inti gagal menyelesaikan pemeriksaan dengan sukses. Coba lagi pemeriksaan pengaturan dan tinjau detail diagnostik jika tersedia. Jika kesalahan terus terjadi, periksa apakah ada masalah konfigurasi atau konektivitas yang mungkin memengaruhi proses diagnostik.
KONFIGURASI DIAGNOSTIK BERUBAH
Kesalahan ini berarti bahwa konfigurasi diagnostik telah berubah saat pemeriksaan sedang berjalan, sehingga hasilnya mungkin tidak lagi valid. Jalankan diagnostik lagi menggunakan konfigurasi saat ini untuk memastikan bahwa pemeriksaan menggunakan pengaturan terbaru.
BATAS WAKTU DIAGNOSTIK TERLEBIH
Kesalahan ini berarti bahwa operasi diagnostik tidak selesai dalam waktu yang diizinkan. Coba lagi pemeriksaan pengaturan dan tinjau detail diagnostik untuk menentukan apakah pemeriksaan tertunda karena konfigurasi atau konektivitas saat ini.
DOMAIN_DIAGNOSTIK_TIDAK_DITEMUKAN
Kesalahan ini berarti bahwa diagnostik tidak dapat menemukan atau menyelesaikan domain yang dikonfigurasi. Periksa apakah domain telah dikonfigurasi dengan benar dan apakah catatan DNS-nya tersedia untuk umum. Setelah memperbaiki masalah konfigurasi DNS atau domain, jalankan pemeriksaan pengaturan lagi.
PERMINTAAN_DIAGNOSTIK_TIDAK_VALID
Kesalahan ini berarti bahwa permintaan diagnostik tidak dapat diproses karena permintaan tersebut tidak valid. Coba lagi pemeriksaan pengaturan dan pastikan diagnostik berjalan dengan konfigurasi saat ini dan detail permintaan yang valid.
PROBE_DIAGNOSTIK_GAGAL
Kesalahan ini berarti bahwa salah satu pemeriksaan diagnostik gagal diselesaikan dengan sukses. Coba lagi pemeriksaan diagnostik dan tinjau detail yang tersedia untuk mengidentifikasi pemeriksaan mana yang gagal dan apakah masalah tersebut terkait dengan konfigurasi atau konektivitas saat ini.
DIAGNOSIS GAGAL
Kesalahan ini berarti bahwa keseluruhan proses diagnostik gagal menghasilkan hasil yang valid. Coba lagi pemeriksaan pengaturan dan tinjau detail diagnostik yang tersedia, termasuk nama host yang terpengaruh, ID permintaan, dan stempel waktu, untuk membantu mengidentifikasi penyebabnya.
Jika kesalahan tetap terjadi setelah mencoba lagi dan memeriksa konfigurasi yang relevan, berikan kode kesalahan dan detail permintaan diagnostik kepada dukungan Linguise untuk penyelidikan lebih lanjut.
Bagaimana cara mengatasi masalah ini?
Saat mengatasi masalah pemeriksaan pengaturan yang gagal, perbaiki masalah sesuai urutan yang ditunjukkan oleh hasil diagnostik:
- Kepemilikan domain dan DNS: Pastikan catatan TXT, CNAME, dan A/AAAA yang diperlukan telah dikonfigurasi dengan benar dan dapat diakses secara publik.
- SSL/TLS: Periksa sertifikat yang relevan, konfigurasi nama host, rantai sertifikat, dan ketersediaan HTTPS.
- Asal: Pastikan situs web asli dapat diakses secara publik dan bahwa server, firewall, WAF, otentikasi, dan konfigurasi pembatasan laju aksesnya memungkinkan Linguise untuk mengaksesnya.
- Jalankan Pemeriksaan pengaturan lagi: Setelah menerapkan perbaikan yang diperlukan dan memberi waktu agar perubahan DNS tersebar, jalankan Pemeriksaan pengaturan lagi.
Memperbaiki kesalahan DNS atau konektivitas sebelumnya juga dapat menyelesaikan kesalahan TLS atau origin yang bergantung, serta pemeriksaan yang sebelumnya ditandai sebagai Dilewati.
Debugger terjemahan subdomain memudahkan identifikasi dan pemecahan masalah DNS, SSL/TLS, dan masalah asal yang memengaruhi subdomain yang diterjemahkan. Tinjau kesalahan yang dilaporkan, terapkan perbaikan yang disarankan, dan jalankan Periksa pengaturan lagi untuk memastikan konfigurasi Anda berfungsi dengan benar.
Jika masalah tetap berlanjut setelah mengikuti langkah-langkah pemecahan masalah yang disarankan, hubungi Linguise dukungan untuk bantuan lebih lanjut.
