Masalah umum Apigee

310191899

Endpoint berikut mungkin mengalami waktu tunggu saat digunakan dengan volume kueri per detik (QPS) yang tinggi:

• organizations.environments.apis.revisions.
  deployments.deploy
• organizations.environments.apis.revisions.
  deployments.undeploy
• organizations.environments.sharedflows.revisions.
  deployments.deploy
• organizations.environments.sharedflows.revisions.
  deployments.undeploy

Untuk mengurangi kemungkinan waktu tunggu, sebaiknya gunakan target tiga QPS saat menggunakan endpoint ini.

329304975

Apigee menerapkan batas sementara 1.000 jalur dasar per lingkungan untuk menghindari potensi kegagalan saat men-deploy revisi proxy API.

Meskipun batas ini diterapkan, Anda dapat men-deploy hingga 1.000 revisi proxy API (masing-masing berisi satu basepath) per lingkungan. Jika proxy atau revisi API Anda berisi lebih dari satu jalur dasar, jumlah total jalur dasar per lingkungan tidak boleh lebih dari 1000.

333791378

Untuk langkah-langkah yang diperlukan guna menginstal patch untuk solusi, lihat Pemecahan masalah.

310384001

289583112

Jika kebijakan OASValidation menentukan <OASResource> dengan persyaratan keamanan yang ditetapkan di tingkat global, persyaratan keamanan tidak diterapkan.

Solusi: Untuk memastikan penerapan, semua persyaratan keamanan harus ditetapkan di tingkat operasi dalam spesifikasi OpenAPI yang diteruskan di elemen <OASResource> dari kebijakan OASValidation.

205666368

Lihat Tentang menetapkan opsi TLS di endpoint target atau server target.

295929616

Menginstal atau mengupgrade ke Apigee hybrid 1.10.0 hingga 1.10.2 dapat gagal di OSE karena masalah kehabisan memori. Perbaikan di Apigee Hybrid versi 1.10.3.

292268968

Jika firewall memaksa semua traffic melalui forward proxy, apigee-udca mungkin masuk ke status backoff loop error.

269573358

• Kebijakan OASValidation akan gagal jika konten JSON tidak cocok pola yang diantisipasi. Misalnya, jika {i>header <i}mengharapkan nilai dalam format <text>@<text> dan diisi dengan teks yang tidak memiliki simbol @, kebijakan akan gagal dengan error Unable to parse JSON.
• Jika kebijakan OASValidation menentukan <OASResource> yang berisi parameter path yang menggunakan skema $ref, kebijakan akan gagal dengan error Unable to parse JSON - Unrecognized token.

  Solusi: Jangan gunakan $ref dalam parameter path spesifikasi OpenAPI yang ditentukan dalam <OASResource> .

299953958

• Deployment Apigee akan gagal untuk kebijakan Validasi OAS saat menggunakan referensi melingkar untuk spesifikasi OpenAPI 3.0.0 yang masuk ke dalam loop tak terbatas.

Solusi: Gunakan yaml spesifikasi OpenAPI tanpa referensi melingkar.

289254725

Deployment proxy yang menyertakan kebijakan OASValidation mungkin gagal jika:

• Spesifikasi OpenAPI yang digunakan untuk validasi dalam kebijakan OASValidation menggunakan format YAML, dan
• Spesifikasi OpenAPI berformat YAML berisi angka mengambang. Contoh:

  schema:
  type: number
  example: 2.345

284500460

Untuk menghindari peningkatan latensi dalam respons terhadap klien, kebijakan Pencatatan Pesan harus yang dilampirkan ke PostClientFlow. Untuk informasi selengkapnya tentang penggunaan kebijakan di PostClientFlows, lihat Mengontrol proxy API dengan flow.

282997216

Hanya gunakan karakter alfanumerik untuk Cassandra Jolokia {i>password<i}. Menggunakan karakter khusus (termasuk, tetapi tidak terbatas pada "!", "@", "#", "$", "%", "^", "&", & "*") dapat menyebabkan kegagalan {i>Cassandra<i}.

271415351

Permintaan deployment serentak untuk proxy API atau SharedFlow dapat mengakibatkan status yang tidak konsisten di Server Pengelolaan di mana beberapa revisi ditampilkan sebagai di-deploy. Hal ini bisa terjadi, misalnya, saat pipeline deployment CI/CD dijalankan secara bersamaan dilakukan dengan revisi yang berbeda. Untuk menghindari permasalahan ini, hindari yang men-deploy proxy API atau SharedFlow sebelum proses deployment selesai.

271689008

Dengan cert-manager v1.10.1 pada OpenShift versi 4.7 hingga 4.10, pod cert-manager tidak dimulai seperti yang diharapkan. Untuk mengatasi masalah ini, ubah batasan konfigurasi keamanan seperti yang dijelaskan dalam catatan rilis cert-manager 1.10.

270371160

Gateway Ingress Apigee hanya mendukung TLS1.2+, dan tidak mendukung versi yang lebih lama TLS.

269139342

Validasi organisasi Apigee tidak mengikuti proxy Penerusan HTTP aturan yang ditetapkan dalam overrides.yaml. Setel validateOrg: false untuk melewati validasi ini.

266452840

Pada keadaan tertentu, soket web tidak berfungsi untuk Apigee X dan Apigee Hybrid saat menggunakan Anthos Service Mesh 1.15.3-asm.6.

242213234

Error ini mungkin ditampilkan saat mencoba memuat produk API: "Produk tidak berhasil dimuat. Error: tidak ada koneksi tersedia dari agen koneksi Apigee."

Masalah terjadi setelah mengaktifkan kontrol layanan VPC di project Google Cloud dan menambahkan iamcredentials.googleapis.com sebagai salah satu dan layanan yang dibatasi di perimeter layanan.

Solusi: Secara manual buat aturan keluar, seperti berikut:

-egressTo:
    operations:
    -serviceName: "iamcredentials.googleapis.com"
        methodSelectors:
        -method:
    resources:
    -projects/608305225983
  egressFrom:
    identityType: ANY_IDENTITY

247540503

Dalam keadaan tertentu dengan throughput yang sangat tinggi dalam sebuah perlombaan kondisi dengan pencarian kunci enkripsi dapat menyebabkan pencarian KVM gagal.

258699204

Jika Anda melihat masalah dengan aplikasi apigee-telemetry- pod apigee-telemetry-proxy tidak berjalan, ubah metrics permintaan resource dan batas resource properti default untuk mencocokkan dengan nilai default berikut di Referensi properti konfigurasi: metrik.

Terapkan perubahan dengan apigeectl apply dengan flag ‑‑telemetry:

apigeectl apply --telemetry -f overrides.yaml

260324159

Proxy API dan alur bersama dapat memerlukan waktu sekitar 20 hingga 30 menit untuk di-deploy pada bidang runtime dalam keadaan tertentu karena 'soket ditutup' dalam sinkronisasi.

254505866

Penyediaan hub API yang menggunakan UI akan gagal jika Anda memilih region selain yang berikut ini:

• asia-east1
• asia-southeast1
• europe-west1
• europe-west4
• us-central1
• us-east1
• us-west1
• us-west4

251897633

Pemilih versi hybrid Apigee hanya berfungsi jika Anda memilih atau klik langsung pada teks.

250875730

Hal ini diperkirakan akan terjadi setiap menit dan tidak memengaruhi biaya penagihan Anda.

260772383

Jika menginstal hybrid di AKS, Anda mungkin melihat error ini:

envoy config listener '0.0.0.0_443' failed to bind or apply socket options: cannot bind '0.0.0.0:443': Permission denied

Solusi: Tambahkan svcAnnotations berikut stanza ke file pengganti:

ingressGateways:
- name: INGRESS_NAME
  ...
  svcAnnotations:
    service.beta.kubernetes.io/azure-load-balancer-internal: "true"

Lihat Mengonfigurasi runtime hybrid. Lihat juga Menggunakan load balancer internal dengan AKS.

241786534

Saat menggunakan UDCA Cakupan Org, MART terkadang tidak dapat terhubung ke FluentD. UDCA cakupan organisasi merupakan setelan default di Apigee Hybrid versi 1.8. Lihat orgScopedUDCA di properti Configuration alamat IP internal.

Setelah migrasi apigee-logger dari fluend hingga fluent-bit di Apigee Hybrid versi 1.6.6, pencatat log berhenti berfungsi pada Anthos BareMetal dengan CentOS atau RHEL.

231758700
231976420

Pengguna mengalami {i>error<i} berikut ini saat menarik image untuk Apigee Hybrid dari Docker Hub: ERRO[0001] Metadata for targets expired. Ini berlaku untuk komponen hybrid berikut:

• google/apigee-authn-authz
• google/apigee-mart-server
• google/apigee-runtime
• google/apigee-synchronizer

Solusi

Jika mengalami {i>error<i} ini, Anda dapat gunakan salah satu dari dua solusi berikut:

• Beralih menggunakan gcr.io/apigee-release untuk mengambil image hybrid.
• Nonaktifkan kepercayaan konten Docker dengan menyetel variabel lingkungan DOCKER_CONTENT_TRUST menjadi 0

Konfigurasi apigee-logger saat ini, termasuk tidak kompatibel dengan runtime Kubernetes, mengakibatkan log tidak dikirim ke Cloud Logging seperti yang diharapkan. Masalah ini juga menyebabkan pod apigee-logger tidak bekerja secara teratur. Masalah ini memengaruhi penginstalan hybrid Apigee di AKS, Anthos Bare Metal, dan platform lainnya. Perhatikan bahwa saat dalam beberapa kasus, masalah ini menyebabkan volume log yang berlebihan.

{i>Proxy<i} yang tidak berisi operasi, atau berisi operasi tanpa kecocokan HTTP, akan menampilkan kode error 404 jika jalur permintaan tidak berisi tepat satu segmen dalam tambahan pada jalur dasar. Misalnya, permintaan untuk /basepath akan gagal, tetapi permintaan untuk /basepath/user mungkin berhasil. Untuk mencegah kegagalan, tambahkan bagian Operations dengan setidaknya satu http_match ke proxy API yang dapat dikonfigurasi.

Penggunaan karakter pengganti (*) di jalur dasar proxy dari Proxy API yang dapat dikonfigurasi menyebabkan penerusan informasi yang salah jalur permintaan ke target backend.

Untuk mencegah penerusan jalur permintaan yang salah, hindari penggunaan * di basepath proxy API yang dapat dikonfigurasi hingga telah diperbaiki.

Di UI Apigee, Anda tidak dapat melihat, mengonfirmasi deployment status Anda, atau mengelola deployment arsip Anda, seperti yang dijelaskan Men-deploy proxy API, atau menggunakan UI Debug seperti yang dijelaskan dalam Menggunakan Debug. Sebagai solusinya, Anda dapat menggunakan API ke Buat daftar semua deployment arsip di lingkungan dan gunakan metode API Debug.

Melakukan roll back deployment arsip saat ini tidak didukung. Untuk menghapus versi deployment arsip, Anda perlu men-deploy ulang versi arsip sebelumnya atau menghapus lingkungan.

Autentikasi Google di ServiceInfo dan Externalcallout kebijakan perusahaan, sebagaimana dijelaskan dalam Menggunakan Autentikasi Google, tidak didukung di Apigee di VS Code.

Error Header HTTP tidak valid: Masuk Istio mengganti semua respons target yang masuk ke protokol HTTP2. Karena pemroses pesan hibrida hanya mendukung HTTP1, Anda mungkin melihat error berikut saat proxy API dipanggil:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,

name: [:authority], value: [domain_name]

Jika melihat pesan error ini, Anda dapat melakukan tindakan berikut tindakan untuk memperbaiki masalah:

• Ubah layanan target untuk menghilangkan header Host di yang dihasilkan.
• Hapus {i>header<i} {i>Host<i} menggunakan Kebijakan TetapkanMessage di proxy API Anda jika diperlukan.

• Apigee mendukung Spesifikasi OpenAPI 3.0 saat Anda memublikasikan API Anda menggunakan SmartDocs di portal Anda subset fitur belum didukung. Misalnya, allOf properti untuk menggabungkan dan memperluas skema.

  Jika fitur yang tidak didukung dirujuk dalam OpenAPI Anda Spesifikasi, dalam beberapa kasus, alat akan mengabaikan fitur tersebut namun tetap merender dokumentasi referensi API. Dalam kasus lain, fitur yang tidak didukung akan menyebabkan error yang mencegah rendering dokumentasi referensi API berhasil. Di beberapa dalam kedua kasus tersebut, Anda harus memodifikasi Spesifikasi OpenAPI untuk menghindari penggunaan fitur yang tidak didukung hingga fitur tersebut didukung di untuk rilis mendatang.

• Saat menggunakan Coba API ini di portal, Header Accept ditetapkan ke application/json, berapa pun nilai yang ditetapkan untuk consumes dalam Spesifikasi OpenAPI.

• Update portal secara bersamaan (seperti halaman, tema, CSS, atau pengeditan skrip) oleh beberapa pengguna tidak didukung saat ini baik.
• Jika Anda menghapus halaman dokumentasi referensi API dari tidak ada cara untuk membuatnya kembali; Anda harus menghapus dan menambahkan kembali produk API, dan membuat ulang API dokumentasi referensi.
• Saat menyesuaikan tema portal, mungkin perlu waktu hingga 5 menit agar perubahan diterapkan sepenuhnya.

Penelusuran akan diintegrasikan ke portal terintegrasi di rilis mendatang.

Logout tunggal (SLO) dengan penyedia identitas SAML tidak didukung untuk domain kustom. Untuk mengaktifkan domain kustom dengan penyedia identitas SAML, kosongkan bidang URL keluar Anda mengonfigurasi setelan SAML.

• Jumlah permintaan dan respons Proxy API (untuk proxy dan target) menunjukkan lonjakan yang tidak normal

  Berikut contoh yang menunjukkan lonjakan tersebut:

  (lihat gambar yang lebih besar)

  
• Karena adanya bug, sistem salah mendaftarkan hitungan untuk jangka waktu singkat dan jumlahnya dikoreksi. Hal ini sering terjadi saat ada penurunan traffic API (yang menghasilkan skala gateway API).
• Untuk membedakan lonjakan permintaan yang sebenarnya dengan masalah ini, lihat halaman Analisis API (khususnya halaman Performa Proxy dan Performa Target)

Metrik yang Terpengaruh:

• apigee.googleapis.com/proxyv2/request_count
• apigee.googleapis.com/proxyv2/response_count
• apigee.googleapis.com/targetv2/request_count
• apigee.googleapis.com/targetv2/response_count

Metrik baru

Anda dapat menggunakan metrik baru untuk menghindari masalah ini.

Untuk Apigee Hybrid, lihat: Ringkasan pengumpulan metrik dan Metrik tampilan.

Solusi: Nonaktifkan agen logging di lingkungan hybrid.

Solusi: Untuk mempertahankan perilaku pengaktifan dan pengabaian:

1. Tambahkan <Response>calloutResponse</Response> ke Servicecallout.
2. Tetapkan continueOnError ke true.

Solusi: Hindari menggunakan lebih dari satu kebijakan SpikeArrest di {i>proxy<i} untuk mencegah masalah.

Untuk kunci tertentu, jika ada traffic berkelanjutan, kapasitasnya mungkin tidak dibatasi pada tarif yang diperbarui. Jika ada lima menit tanpa traffic untuk kunci tertentu, tarifnya akan ditampilkan.

Solusi: Deploy ulang proxy dengan referensi baru variabel jika tarif tersebut harus segera diterapkan. Atau gunakan dua penghentian lonjakan bersyarat dengan variabel aliran yang berbeda untuk disesuaikan tarif tersebut.

Pemantauan API dari Proxy API yang Dapat Dikonfigurasi mungkin menampilkan kesalahan kode '(not set)' untuk respons dengan status non-2xx dari target.

Jika proxy menetapkan dua io.timeout.millis atau lebih nilai dalam dua atau lebih flow yang menggunakan host target yang sama, hanya satu nilai io.timeout.millis tetap diterima.

Selama upgrade ke Apigee hybrid 1.8.x, setelah berjalan apigeectl init dan mengonfirmasi bahwa check-ready berhasil, Anda mungkin akan melihat jika melihat pod, sehingga tugas validasi skema Cassandra berada dalam status error. Ini adalah kondisi yang tidak berbahaya, dan Anda dapat melanjutkan ke langkah berikutnya dengan aman dalam prosedur upgrade.

Men-deploy proxy dengan jalur yang sama ke beberapa lingkungan yang disertakan pada instance dan grup lingkungan yang sama tidak diizinkan dan akan menampilkan pesan peringatan tentang konflik jalur dasar. Sebagai gantinya, tidak ada error yang ditampilkan dan deployment terlihat berhasil.

Solusi: Saat men-deploy dan setelah deployment, pastikan belum jalur dasar bertentangan dengan proxy yang di-deploy dan memperbaikinya sesuai kebutuhan.

Saat mencoba menyimpan proxy yang di-deploy sebelumnya, deployment mungkin gagal dengan pesan error yang menyatakan bahwa revisi tidak dapat diubah.

Solusi: Klik panah dropdown di samping tombol Simpan, lalu pilih Simpan sebagai revisi baru. Kemudian, coba lakukan deployment lagi.

Update pada serangkaian cipher default yang didukung oleh Apigee server untuk meningkatkan keamanan dapat mengakibatkan Unsupported protocol error untuk beberapa versi TLS. Pelanggan yang mengalami error ini harus meninjau daftar lengkapnya penyandian yang didukung oleh Build FIPS Envoy.

Saat panggilan dilakukan ke Server Target gRPC, satu-satunya cuplikan yang ditampilkan adalah &quot;grpc-status&quot; cuplikan. Semua cuplikan lainnya akan dihapus dari respons.