Untuk memecahkan masalah terkait ABAP SDK edisi SAP BTP untuk Google Cloud, langkah pertama adalah mencari tahu asal masalah tersebut. Masalah ini dapat terkait dengan infrastruktur Anda, lingkungan SAP BTP, dan alat yang Anda gunakan, atau ABAP SDK untuk Google Cloud itu sendiri.
Jika analisis Anda menunjukkan masalah dengan ABAP SDK untuk Google Cloud, pecahkan masalah tersebut menggunakan log aplikasi SAP dan pesan error.
Jika menurut Anda masalah tersebut terjadi dalam lingkungan atau alat SAP, hubungi SAP untuk mendapatkan bantuan.
Memeriksa prasyarat
Pastikan semua prasyarat terpenuhi untuk penginstalan ABAP SDK edisi SAP BTP untuk Google Cloud. Untuk informasi tentang prasyarat penginstalan SDK, lihat Sebelum memulai.
Membaca dokumentasi dukungan SAP
Jika memiliki akun pengguna SAP, Anda dapat menemukan solusi untuk berbagai masalah software SAP dengan membaca Catatan SAP dan Artikel SAP Knowledge Base yang tersedia di SAP ONE Support Launchpad.
Lihat log
Saat logging dikonfigurasi, ABAP SDK edisi SAP untuk Google Cloud akan mencatat pesan error ke log aplikasi SAP. Untuk mengetahui informasi selengkapnya tentang logging, lihat Mengonfigurasi logging.
Untuk melihat pesan log, lakukan langkah-langkah berikut:
- Mengakses launchpad SAP Fiori dari sistem BTP ABAP tempat ABAP SDK untuk Google Cloud diinstal.
- Buka aplikasi Google SDK: Application Logs Display.
Berikan filter log yang sesuai:
- Dari: pilih tanggal mulai untuk memfilter log.
- Kepada: pilih tanggal akhir untuk memfilter log.
- Objek log: memilih objek log yang lognya harus diambil.
- Subobject log: pilih subobjek log yang lognya harus diambil.
- Nama layanan: pilih nama layanan API yang akan digunakan untuk mengambil log.
Klik Go. Daftar header log aplikasi akan ditampilkan.
Klik header log untuk membuka log tingkat item mendetail. Pesan log ditampilkan dengan tingkat keparahan dan stempel waktu.
Pesan log biasanya terdiri dari dua entri berikut:
- Entering: memberikan informasi tentang lokasi kode tempat terjadinya error. Untuk pemecahan masalah, Anda dapat menggunakan lokasi kode ini sebagai titik henti sementara saat proses debug.
- Pesan error: memberikan informasi tentang error yang terjadi saat menjalankan operasi.
Proses Debug
Jika memiliki otorisasi yang diperlukan, Anda dapat men-debug class klien API.
Untuk men-debug class klien API, gunakan salah satu opsi berikut:
Tambahkan titik henti sementara ke konstruktor class
/GOOG/CL_HTTP_CLIENT
, lalu jalankan program Anda.Tambahkan titik henti sementara ke metode yang Anda gunakan, lalu jalankan program.
Pelacakan HTTP
Saat memecahkan masalah error, Anda dapat memeriksa pelacakan panggilan HTTP di Koneksi Keluar Sistem SAP Monitor. Untuk informasi selengkapnya, lihat halaman SAP Monitoring System Outbound Communication in General.
Masalah operasional umum
Saat menggunakan Google Cloud API melalui metode publik stub klien, developer mungkin mengalami error dan pengecualian. Error dan pengecualian ini secara luas diklasifikasikan menjadi dua kategori:
- Error dan pengecualian yang dipicu oleh ABAP SDK untuk Google Cloud
- Error yang ditampilkan oleh Google Cloud API
Bagian ini membahas error dan pengecualian yang dipicu oleh SDK.
/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending
Masalah: Permintaan HTTP ke metode API gagal.
Penyebab: Masalah ini dapat disebabkan oleh masalah konektivitas.
Penyelesaian: Di project Google Cloud tempat Anda mencoba mengakses Google Cloud API, aktifkan API target. Untuk mengetahui informasi tentang cara mengaktifkan Google Cloud API, lihat Mengaktifkan API.
/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_request-Invalid value for " audience". This value should be the full resource name of the Identity Provider. See https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token for the list of possible formats.
Masalah: Anda tidak dapat membuat token Layanan Token Keamanan (STS).
Penyebab: Saat Anda melakukan autentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, konfigurasi autentikasi Anda tidak akan menyertakan konfigurasi yang diperlukan.
Penyelesaian: Verifikasi dan perbarui detail berikut:
Di aplikasi Communication Arrangement, perbarui ID kumpulan Workload Identity Federation dan ID penyedia Workload Identity Federation.
Di aplikasi Google SDK: Main Configuration, untuk peta komunikasi Anda, perbarui project ID Google Cloud dan nomor project Google Cloud untuk kunci klien.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
/GOOG/MSG:400 - Error generating STS token:Bad Request-invalid_scope-Invalid scope provided in the request
Masalah: Anda tidak dapat melakukan autentikasi ke Google Cloud.
Penyebab: Saat Anda mengautentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, Cakupan Google Cloud menjadi tidak valid.
Resolusi: Di aplikasi Google SDK: Main Configuration, untuk
peta komunikasi, pastikan
Cakupan Google Cloud adalah https://www.googleapis.com/auth/cloud-platform
.
/GOOG/MSG:461 - API Key not valid. Please pass a valid API Key
Masalah: Anda tidak dapat melakukan autentikasi ke Google Cloud menggunakan autentikasi berbasis kunci API.
Penyebab: Kunci API yang tidak valid diberikan dalam pengaturan komunikasi.
Penyelesaian: Untuk mengatasi masalah ini, pertahankan nama dan versi rahasia yang valid dalam pengaturan komunikasi terkait. Selain itu, pastikan kunci API yang valid dikonfigurasi di rahasia.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API yang disimpan di Secret Manager
/GOOG/MSG: 461 - Communication Map entry for authentication service not maintained
Masalah: SDK tidak dapat menentukan artefak komunikasi untuk autentikasi.
Penyebab: Tidak ada peta komunikasi yang disimpan untuk layanan autentikasi.
Penyelesaian: Di aplikasi Google SDK: Konfigurasi Utama, buat peta komunikasi dan pertahankan Jenis autentikasi yang benar untuk metode autentikasi yang Anda gunakan.
Untuk membuat peta komunikasi, lihat petunjuk metode autentikasi di Mengonfigurasi autentikasi untuk ABAP SDK edisi SAP BTP untuk Google Cloud.
/GOOG/MSG: 461 - Communication Scenario not valid for default Google Authentication
Masalah: SDK tidak dapat menentukan pengaturan komunikasi untuk autentikasi.
Penyebab: Entri yang dipertahankan untuk layanan autentikasi tidak valid.
Resolusi: Di aplikasi Google SDK: Main Configuration, untuk entri peta komunikasi, pastikan pengaturan komunikasi dikonfigurasi dengan skenario komunikasi dan sistem komunikasi yang benar.
Untuk memperbarui pengaturan komunikasi, lihat petunjuk metode autentikasi di Menyiapkan autentikasi untuk ABAP SDK edisi SAP BTP untuk Google Cloud.
/GOOG/MSG:400 - Error generating IDP token: Not found
Masalah: Anda tidak dapat membuat token penyedia identitas dari layanan XSUAA.
Penyebab: Saat Anda mengautentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, baik URL nama host untuk layanan XSUAA maupun nilai jalurnya menjadi tidak valid di sistem komunikasi.
Penyelesaian: Verifikasi dan perbarui detail berikut:
- Dalam sistem komunikasi untuk layanan XSUAA atau di tujuan BTP yang digunakan dalam sistem komunikasi, pertahankan URL nama host yang benar.
- Dalam pengaturan komunikasi, pertahankan jalur yang valid.
/GOOG/MSG:400 - Error generating STS token: Not found
Masalah: Anda tidak dapat membuat token Layanan Token Keamanan yang diperlukan untuk autentikasi.
Penyebab: Saat Anda melakukan autentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, dan Anda menggunakan pengaturan komunikasi untuk layanan STS, sistem komunikasi yang terkait dengan layanan STS tidak akan valid.
Penyelesaian: Verifikasi dan perbarui detail berikut:
- Dalam sistem komunikasi untuk layanan STS atau di tujuan BTP yang digunakan dalam sistem komunikasi, pertahankan URL nama host yang benar.
- Dalam pengaturan komunikasi, pertahankan jalur yang valid.
/GOOG/MSG:400 - Error generating IAM token: Not found
Masalah: Anda tidak dapat membuat token IAM yang diperlukan untuk autentikasi.
Penyebab: Saat Anda melakukan autentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, dan Anda menggunakan pengaturan komunikasi untuk layanan IAM, peta komunikasi dan sistem komunikasi yang terkait dengan layanan IAM menjadi tidak valid.
Penyelesaian: Verifikasi dan perbarui detail berikut:
- Dalam sistem komunikasi untuk layanan IAM atau di tujuan BTP yang digunakan dalam sistem komunikasi, pertahankan URL nama host yang benar.
- Dalam pengaturan komunikasi, pertahankan jalur yang valid.
Error validasi konfigurasi
G001 | Check communication scenario
Penyebab: Skenario komunikasi yang dikonfigurasi di peta komunikasi
tidak didukung dengan class otorisasi default /GOOG/CL_AUTH_GOOGLE
.
Penyelesaian: Jika Anda menggunakan /GOOG/CL_AUTH_GOOGLE
sebagai class otorisasi,
pastikan salah satu skenario komunikasi berikut telah ditetapkan dalam
peta komunikasi Anda, bergantung pada metode autentikasi:
Skenario komunikasi | Authentication |
---|---|
/GOOG/COM_SDK_WIF |
Federasi Workload Identity |
/GOOG/COM_SDK_APIKSM |
Kunci API menggunakan Secret Manager |
Untuk memperbarui peta komunikasi, lihat petunjuk metode autentikasi di Menyiapkan autentikasi untuk ABAP SDK edisi SAP BTP untuk Google Cloud.
W001 | Check Comm. arrangement for WIF
Penyebab: Pengaturan komunikasi tidak dapat diidentifikasi menggunakan skenario komunikasi dan sistem komunikasi yang ditentukan dalam aplikasi Google SDK: Konfigurasi Utama.
Penyelesaian: Pastikan pengaturan komunikasi untuk layanan autentikasi menggunakan skenario komunikasi dan sistem komunikasi yang valid.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
W002 | Fetch XSUAA token
Penyebab: Pengambilan token XSUAA gagal.
Resolusi: Pastikan instance layanan XSUAA dikonfigurasi dengan benar.
Untuk mengetahui informasi selengkapnya, lihat Membuat instance layanan Otorisasi dan Kepercayaan (XSUAA).
W003 | Fetch WIF Pool ID
Penyebab: ID kumpulan Workload Identity Federation tidak ada dalam pengaturan komunikasi.
Penyelesaian: Dalam pengaturan komunikasi yang digunakan
untuk layanan autentikasi, pastikan skenario komunikasi
/GOOG/COM_SDK_WIF
digunakan, dan ID kumpulan gabungan identitas
beban kerja yang valid telah ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
W004 | Fetch WIF Provider ID
Penyebab: ID penyedia Workload Identity Federation tidak ada dalam pengaturan komunikasi.
Penyelesaian: Dalam pengaturan komunikasi yang digunakan
untuk layanan autentikasi, pastikan skenario komunikasi
/GOOG/COM_SDK_WIF
digunakan, dan ID penyedia penggabungan identitas
beban kerja yang valid telah ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
W005 | Fetch STS token
Penyebab: Pengambilan token STS gagal.
Penyelesaian: Untuk mengatasi masalah ini, lakukan langkah berikut:
- Dalam peta komunikasi, periksa apakah nomor project Google Cloud dikelola dengan benar. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
- Pastikan bahwa ID kumpulan Workload Identity Federation dan ID penyedia valid dan dikelola dengan benar dalam pengaturan komunikasi yang digunakan untuk layanan autentikasi. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
- Dalam peta komunikasi, jika entri dipertahankan untuk layanan
sts:v1
, pastikan pengaturan komunikasi yang dipertahankan valid, tersedia dalam sistem, dan menggunakan skenario komunikasi dan sistem komunikasi yang sama seperti yang dikelola dalam aplikasi konfigurasi SDK.
W006 | Fetch IAM credential token
Penyebab: Pengambilan token IAM gagal dari IAM Credentials API.
Penyelesaian: Untuk mengatasi masalah ini, lakukan langkah berikut:
- Dalam peta komunikasi, periksa apakah nomor project Google Cloud dikelola dengan benar. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
- Dalam peta komunikasi, jika entri dipertahankan untuk layanan
iamcredentials:v1
, pastikan pengaturan komunikasi yang dipertahankan valid, tersedia dalam sistem, serta menggunakan skenario komunikasi dan sistem komunikasi yang sama seperti yang ditentukan dalam aplikasi konfigurasi SDK.
V001 | Check Comm. Arr. for API Key(SM)
Penyebab: Pengaturan komunikasi tidak dapat diidentifikasi menggunakan skenario komunikasi dan sistem komunikasi yang ditentukan dalam aplikasi Google SDK: Konfigurasi Utama.
Penyelesaian: Pastikan pengaturan komunikasi yang dipertahankan untuk layanan autentikasi valid, tersedia dalam sistem, serta menggunakan skenario komunikasi dan sistem komunikasi yang sama seperti yang dikelola dalam aplikasi konfigurasi SDK.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
V002 | Fetch Secret Name
Penyebab: Nama rahasia tidak ada dalam pengaturan komunikasi.
Penyelesaian: Dalam pengaturan komunikasi yang digunakan
untuk layanan autentikasi, pastikan skenario komunikasi
/GOOG/COM_SDK_APIKSM
digunakan, dan rahasia yang valid ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
V003 | Fetch Secret Version
Penyebab: Properti Secret version tidak berisi nilai yang valid dalam pengaturan komunikasi.
Penyelesaian: Dalam pengaturan komunikasi yang digunakan
untuk layanan autentikasi, pastikan skenario komunikasi
/GOOG/COM_SDK_APIKSM
digunakan, dan versi secret yang valid ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
V004 | Fetch Token from Secret Manager
Penyebab: Secret Manager API gagal mengambil secret yang berisi kunci API.
Penyelesaian: Untuk mengatasi masalah ini, lakukan langkah berikut:
- Periksa apakah akun layanan memiliki izin yang diperlukan untuk mengakses secret. Untuk mengetahui informasi selengkapnya, lihat Autentikasi menggunakan kunci API yang disimpan di Secret Manager.
- Periksa apakah ID project Google Cloud dikelola dengan benar dalam susunan komunikasi yang digunakan untuk layanan autentikasi. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
- Pastikan ID kumpulan Workload Identity Federation dan ID penyedia valid dan dikelola dengan benar dalam pengaturan komunikasi yang digunakan untuk layanan autentikasi. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
- Pastikan nama rahasia dan versi rahasia (jika dipertahankan) valid dan dikelola dengan benar dalam pengaturan komunikasi. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan kunci API dari Secret Manager.
Pesan error yang ditampilkan oleh Google Cloud API
Setiap stub klien API memiliki parameter ekspor yang memberikan kode pengembalian API dan pesan error.
ev_ret_code
berisi kode status HTTP. Jika terjadi error yang ditampilkan oleh API, parameter ini berisi nilai4XX
.ev_err_resp
berisi kategori error dan pesan error yang ditampilkan oleh API.
Contoh berikut menunjukkan error yang ditampilkan API saat Anda membuat topik Pub/Sub baru dengan nama topik yang sudah ada.
ERROR_TEXT
: KonflikERROR_DESCRIPTION
: Resource sudah ada di project (resource=SAMPLE_TOPIC_01
)
Untuk error yang ditampilkan oleh API, sebaiknya periksa dokumentasi publik tentang API yang terkait.
Mendapatkan dukungan dari komunitas
Ajukan pertanyaan dan diskusikan ABAP SDK untuk Google Cloud dengan komunitas di Cloud Forums.
Dapatkan dukungan
Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait ABAP SDK untuk Google Cloud edisi SAP BTP, kumpulkan semua informasi diagnostik yang tersedia dan hubungi Cloud Customer Care.
Untuk mengetahui informasi tentang cara menghubungi Cloud Customer Care, lihat Mendapatkan dukungan untuk SAP di Google Cloud.