Memecahkan masalah ABAP SDK edisi SAP BTP untuk Google Cloud

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:

  1. Mengakses launchpad SAP Fiori dari sistem BTP ABAP tempat ABAP SDK untuk Google Cloud diinstal.
  2. Buka aplikasi Google SDK: Application Logs Display.

  3. 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.

  4. Klik Go. Daftar header log aplikasi akan ditampilkan.

    Header log aplikasi

  5. Klik header log untuk membuka log tingkat item mendetail. Pesan log ditampilkan dengan tingkat keparahan dan stempel waktu.

    Log tingkat item mendetail

    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:

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:

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:

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 nilai 4XX.

  • 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: Konflik
  • ERROR_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.