Memecahkan masalah ABAP SDK edisi SAP BTP untuk Google Cloud

Untuk memecahkan masalah terkait ABAP SDK edisi SAP BTP untuk Google Cloud, langkah pertamanya adalah mencari tahu sumber masalahnya. Masalah ini mungkin terkait dengan infrastruktur, lingkungan, dan alat SAP BTP yang Anda gunakan, atau ABAP SDK untuk Google Cloud itu sendiri.

Jika analisis Anda menunjukkan masalah pada ABAP SDK untuk Google Cloud, pemecahan masalah dapat dilakukan menggunakan log aplikasi SAP dan pesan error.

Jika Anda merasa masalahnya ada dalam lingkungan atau alat SAP, hubungi SAP untuk mendapatkan bantuan.

Memeriksa prasyarat

Pastikan semua prasyarat terpenuhi untuk penginstalan ABAP SDK untuk Google Cloud edisi SAP BTP. Untuk mengetahui informasi tentang prasyarat penginstalan SDK, lihat Sebelum memulai.

Membaca dokumentasi dukungan SAP

Jika Anda memiliki akun pengguna SAP, Anda dapat menemukan solusi untuk banyak masalah software SAP dengan membaca SAP Notes dan SAP Knowledge Base Articles yang tersedia di SAP ONE Support Launchpad.

Lihat log

Saat logging dikonfigurasi, ABAP SDK untuk Google Cloud edisi SAP BTP 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. Akses peluncur SAP Fiori dari sistem ABAP BTP 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.
    • Untuk: memilih tanggal akhir untuk memfilter log.
    • Objek log: pilih objek log yang log-nya harus diambil.
    • Subobjek log: pilih subobjek log yang log-nya harus diambil.
    • Nama layanan: pilih nama layanan API yang log-nya harus diambil.

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

    Header log aplikasi

  5. Klik header log untuk membuka log tingkat item yang 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 Pemantauan SAP. Untuk informasi selengkapnya, lihat halaman SAP Pemantauan Komunikasi Keluar Sistem Secara Umum.

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.

Solusi: 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 Security Token Service (STS).

Penyebab: Saat Anda mengautentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, penyiapan autentikasi Anda tidak memiliki 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, update project ID Google Cloud dan nomor project Google Cloud untuk kunci klien.

Untuk 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 melakukan autentikasi ke Google Cloud menggunakan token melalui Workload Identity Federation atau kunci API yang disimpan di Secret Manager, Cakupan Google Cloud tidak valid.

Resolusi: Di aplikasi Google SDK: Main Configuration, untuk peta komunikasi Anda, pastikan Google Cloud Scope 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 secret yang valid dalam pengaturan komunikasi terkait. Selain itu, pastikan kunci API yang valid dikonfigurasi dalam secret.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar 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 dikelola untuk layanan autentikasi.

Penyelesaian: Di aplikasi Google SDK: Main Configuration, buat peta komunikasi dan pertahankan Authentication type yang benar untuk metode autentikasi yang Anda gunakan.

Untuk membuat peta komunikasi, lihat petunjuk untuk 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 disimpan untuk layanan autentikasi tidak valid.

Penyelesaian: 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 untuk 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, URL nama host untuk layanan XSUAA atau nilai jalur tidak valid dalam 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 Security Token Service yang diperlukan untuk autentikasi.

Penyebab: Saat Anda mengautentikasi 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 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 mengautentikasi 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 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 dalam peta komunikasi tidak didukung dengan class otorisasi default /GOOG/CL_AUTH_GOOGLE.

Resolusi: Jika Anda menggunakan /GOOG/CL_AUTH_GOOGLE sebagai class otorisasi, pastikan salah satu skenario komunikasi berikut ditentukan dalam peta komunikasi Anda, bergantung pada metode autentikasi:

Skenario komunikasi Autentikasi
/GOOG/COM_SDK_WIF Workload Identity Federation
/GOOG/COM_SDK_APIKSM Kunci API menggunakan Secret Manager

Untuk memperbarui peta komunikasi, lihat petunjuk untuk 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 di aplikasi Google SDK: Main Configuration.

Penyelesaian: Pastikan pengaturan komunikasi untuk layanan autentikasi menggunakan scenario komunikasi dan sistem komunikasi yang valid.

Untuk informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.

W002 | Fetch XSUAA token

Penyebab: Pengambilan token XSUAA gagal.

Penyelesaian: 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 workload identity federation yang valid ditentukan.

Untuk 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 workload identity federation yang valid ditentukan.

Untuk 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 tindakan berikut:

W006 | Fetch IAM credential token

Penyebab: Pengambilan token IAM gagal dari IAM Credentials API.

Penyelesaian: Untuk mengatasi masalah ini, lakukan tindakan berikut:

  • Pada peta komunikasi, periksa apakah nomor project Google Cloud dikelola dengan benar. Untuk informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar dapat menggunakan Workload Identity Federation.
  • Pada peta komunikasi, jika entri dikelola untuk layanan iamcredentials:v1, pastikan pengaturan komunikasi yang dikelola valid, tersedia di sistem, dan 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 di aplikasi Google SDK: Main Configuration.

Resolusi: Pastikan pengaturan komunikasi yang dikelola untuk layanan autentikasi valid, tersedia di sistem, dan menggunakan skenario komunikasi dan sistem komunikasi yang sama seperti yang dikelola di aplikasi konfigurasi SDK.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar menggunakan kunci API dari Secret Manager.

V002 | Fetch Secret Name

Penyebab: Nama secret tidak ada dalam pengaturan komunikasi.

Penyelesaian: Dalam pengaturan komunikasi yang digunakan untuk layanan autentikasi, pastikan skenario komunikasi /GOOG/COM_SDK_APIKSM digunakan, dan secret yang valid ditentukan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar 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 rahasia yang valid ditentukan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi ABAP SDK untuk Google Cloud agar 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 tindakan 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 API yang sesuai.

Mendapatkan dukungan dari komunitas

Ajukan pertanyaan dan diskusikan ABAP SDK untuk Google Cloud dengan komunitas di Cloud Forum.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait ABAP SDK edisi SAP BTP untuk Google Cloud, 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.