Masalah umum Apigee

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Pilih satu atau beberapa opsi berikut untuk memfilter halaman ini:

Bagian ini mencantumkan masalah umum untuk komponen Apigee. Untuk daftar bug, fitur baru, dan informasi rilis lainnya, lihat catatan rilis.

ID Masalah Memengaruhi Status Deskripsi
hybrid 1.16.0 BUKA Deployment proxy tidak selesai karena izin RBAC tidak ada di Hybrid v1.16.0.

Ada masalah umum di 1.16.0 saat cluster Hybrid mungkin gagal melaporkan status deployment proxy. Hal ini disebabkan oleh izin yang tidak ada dalam peran apigee-manager-role.

Solusi: Tambahkan izin ke template diagram helm apigee-operator:

  1. Edit apigee-operator file template diagram Helm apigee-operator/templates/apigee-operators.yaml.
  2. Tambahkan kata kerja - watch ke resource deployments, setelah kata kerja - update di baris 584.
  3. Perbarui rilis Helm apigee-operator.
418274570 hybrid 1.16.0 FIXED Halaman catatan rilis hybrid tidak diperbarui dengan informasi 1.16.0-hotfix.1.

Halaman catatan rilis hybrid tidak menampilkan informasi update 1.16.0-hotfix.1. Lihat catatan rilis Apigee hybrid v1.16.0-hotfix.1 untuk mengetahui detail update.
484366184 hybrid 1.14.x, hybrid 1.15.x FIXED di hybrid 1.16.0 Apigee Hybrid versi 1.14 dan 1.15 mengalami loop error di apigee-ingressgateway-manager saat Kubernetes Gateway API v1.4.0 atau yang lebih baru digunakan.

Apigee Hybrid 1.16 tidak terpengaruh oleh masalah ini.

Solusi: Jika Anda perlu menggunakan Kubernetes Gateway API dengan Apigee hybrid versi 1.14 atau 1.15, instal Gateway API versi v1.3.x. Contoh:

kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.3.0/standard-install.yaml

Lihat juga:
480997525 Apigee 1-17-0-apigee-1 TETAP di Apigee 1-17-0-apigee-2 Panggilan proxy gagal dengan error The URI contain illegal characters setelah upgrade Netty.

Di Apigee versi 1-17-0-apigee-1, upgrade Netty ke 4.1.129.Final memperkenalkan regresi. Hal ini dapat menyebabkan panggilan proxy API gagal dengan kode status 400 dan pesan error The URI contain illegal characters. Masalah ini dilacak secara eksternal di netty/netty#16020.

465834046 hybrid 1.14.3, hybrid 1.15.1, dan hybrid 1.16.0 serta yang lebih baru untuk upgrade SUDAH DIPERBAIKI di hybrid 1.14.3, hybrid 1.15.1, dan hybrid 1.16.0 untuk penginstalan baru cert-manager versi 1.18+ mengubah default untuk kebijakan rotasi kunci pribadi dari Never menjadi Always. Jika kunci pribadi untuk apigee-ca dirotasi, hal ini akan memengaruhi traffic

Versi cert-manager yang lebih baru (v1.18+) kini otomatis merotasi kunci pribadi. Jika kunci ini dirotasi untuk sertifikat apigee-ca, akan terjadi gangguan.

Solusi: Untuk menghindari masalah ini, Anda dapat memilih salah satu opsi berikut:

  • Jangan mengupgrade cert-manager ke versi yang lebih tinggi dari 1.17.x.
  • Edit sertifikat apigee-ca di namespace cert-manager dan tetapkan spec.privateKey.rotationPolicy ke Never. Gunakan prosedur berikut untuk mengedit sertifikat apigee-ca dan mengupgrade cert-manager:
    1. Periksa konten sertifikat apigee-ca Anda untuk melihat apakah rotationPolicy disetel: 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      Cari nilai di bagian spec.privateKey dalam output:

      ...
spec:
  commonName: apigee-hybrid
  duration: 87600h
  isCA: true
  issuerRef:
    group: cert-manager.io
    kind: ClusterIssuer
    name: apigee-root-certificate-issuer
  privateKey:
    algorithm: ECDSA
    # Note: rotationPolicy would appear here if it is set.
    size: 256
  secretName: apigee-ca
...
    2. Jika rotationPolicy tidak ditetapkan atau jika ditetapkan ke Always, edit sertifikat apigee-ca untuk menetapkan nilai rotationPolicy ke Never:
      1. Lakukan uji coba terlebih dahulu: 
        kubectl patch Certificate \
  --dry-run=server \
  -n cert-manager \
  --type=json \
  -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \
  -o=yaml \
  apigee-ca
      2. Patch sertifikat: 
        kubectl patch Certificate \
  -n cert-manager \
  --type=json \
  -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \
  -o=yaml \
  apigee-ca
    3. Pastikan nilai rotationPolicy sekarang disetel ke Never: 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      Output-nya akan terlihat seperti berikut:

      ...
spec:
  commonName: apigee-hybrid
  duration: 87600h
  isCA: true
  issuerRef:
    group: cert-manager.io
    kind: ClusterIssuer
    name: apigee-root-certificate-issuer
  privateKey:
    algorithm: ECDSA
    rotationPolicy: Never
    size: 256
  secretName: apigee-ca
...
    4. Upgrade cert-manager. Perintah berikut akan mendownload dan menginstal cert-manager v0.14.2: 
      kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v0.14.2/cert-manager.yaml

Lihat:
458417250 Apigee 1-16-0-apigee-4 FIXED di Apigee 1-16-0-apigee-6 Message Processor menampilkan error 500 dengan "Duplicate Header "authorization"".

Jika ada beberapa header otorisasi dalam permintaan, gateway ingress Apigee tidak akan menggabungkannya menjadi satu header. Hal ini menyebabkan Message Processor menampilkan error 500 dengan pesan "Duplicate Header "authorization"".

Solusi: Jika ada beberapa header otorisasi dalam permintaan, gabungkan header tersebut menjadi satu header. Contoh: 

curl -s https://my-hostname.net/mocktarget/echo \
          -H 'authorization: a, b'
462685598 UI BUKA

UI Apigee saat ini tidak menawarkan opsi untuk menyediakan organisasi Apigee dengan Google-owned and Google-managed encryption key.

UI Apigee tidak menawarkan opsi untuk memilih Google-owned and Google-managed encryption key saat menyediakan organisasi langganan.

Solusi: Gunakan Apigee API untuk membuat organisasi berbasis langganan dengan Google-owned and Google-managed encryption key.

Seperti yang disebutkan dalam dokumentasi Apigee API, saat membuat organisasi Apigee, Anda dapat membuat organisasi menggunakan Google-owned and Google-managed encryption key dengan tidak memberikan nilai untuk kolom runtimeDatabaseEncryptionKeyName, apiConsumerDataEncryptionKeyName, dan controlPlaneEncryptionKeyName.

460431753 Apigee, Apigee hybrid BUKA Kebijakan Apigee Model Armor tidak didukung dengan WebSockets.

Kebijakan Apigee Model Armor, termasuk SanitizeUserPrompt dan SanitizeModelResponse, saat ini tidak berfungsi seperti yang diharapkan saat digunakan di proxy API yang menangani koneksi WebSocket. Lihat WebSockets dengan Apigee untuk mengetahui informasi selengkapnya tentang konfigurasi WebSocket.
433759657 Apigee DIPERBAIKI di 1-16-0-apigee-3 atau yang lebih baru

Setelah upgrade ke 1-16-0-apigee-3, beberapa organisasi Apigee mungkin mengalami error HTTP 500 yang berasal dari java.lang.NoClassDefFoundError dalam kebijakan Java Callout. Error akan muncul mirip dengan berikut ini: 

{"fault":{"faultstring":"Failed to execute JavaCallout. org/apache/commons/lang/StringUtils","detail":{"errorcode":"steps.javacallout.ExecutionError"}}}

Error ini terjadi saat kebijakan Java Callout salah bergantung pada library yang ditujukan untuk penggunaan internal Apigee, bukan menyediakan dependensinya sendiri.

Tindakan diperlukan: Untuk mencegah masalah ini, developer harus memastikan bahwa semua Panggilan Java bersifat mandiri dan menggunakan library khusus mereka sendiri, serta menghindari ketergantungan pada jalur class internal Apigee.

Di proxy API yang menggunakan library JAR Apache Commons, impor file JAR Apache Commons untuk disertakan sebagai resource untuk proxy. Untuk mengetahui informasi selengkapnya, lihat Panduan resource Java.

451841788 hybrid 1.14.3 dan hybrid 1.15.1 FIXED Apigee Hybrid memerlukan properti mintTaskScheduler.serviceAccountPath meskipun Monetisasi tidak diaktifkan.

Mengupgrade diagram apigee-org dapat gagal jika properti mintTaskScheduler.serviceAccountPath tidak disetel, meskipun Monetisasi tidak diaktifkan: 

Error: UPGRADE FAILED: execution error at (apigee-org/templates/mint-task-scheduler-gsa-secret.yaml:12:63): mintTaskScheduler.serviceAccountPath is required!

Solusi: Hapus file apigee-org/templates/mint-task-scheduler-gsa-secret.yaml dan apitee-org/templates/mint-task-scheduler-sa.yaml.

Secara opsional, Anda dapat memindahkan file ke lokasi terpisah di luar direktori diagram Helm. Atau, Anda dapat mendownloadnya lagi jika ingin mengaktifkan Monetisasi pada masa mendatang, dengan mengikuti petunjuk di Langkah 2: Download diagram Helm Apigee.

Misalnya, dari direktori helm-charts/:

  1. ls apigee-org/templates/

    Output:

    apigee-org-guardrails.yaml              mart-sa.yaml
apigee-proxy-chaining-certificate.yaml  mint-task-scheduler-gsa-secret.yaml
apigee-proxy-chaining-route.yaml        mint-task-scheduler-sa.yaml
ax-hash-salt-secret.yaml                NOTES.txt
connect-agent-gsa-secret.yaml           organization.yaml
connect-agent-sa.yaml                   udca-gsa-secret.yaml
data-encryption-secret.yaml             udca-sa.yaml
encryption-keys-secret.yaml             watcher-gsa-secret.yaml
_helpers.tpl                            watcher-sa.yaml
mart-gsa-secret.yaml
  2. (Opsional:) 
    cp apigee-org/templates/mint-task-scheduler-gsa-secret.yaml /tmp/
cp apigee-org/templates/mint-task-scheduler-sa.yaml /tmp/
  3. rm apigee-org/templates/mint-task-scheduler-gsa-secret.yaml
  4. rm apigee-org/templates/mint-task-scheduler-sa.yaml
  5. ls apigee-org/templates/

    Output:

    apigee-org-guardrails.yaml              mart-gsa-secret.yaml
apigee-proxy-chaining-certificate.yaml  mart-sa.yaml
apigee-proxy-chaining-route.yaml        NOTES.txt
ax-hash-salt-secret.yaml                organization.yaml
connect-agent-gsa-secret.yaml           udca-gsa-secret.yaml
connect-agent-sa.yaml                   udca-sa.yaml
data-encryption-secret.yaml             watcher-gsa-secret.yaml
encryption-keys-secret.yaml             watcher-sa.yaml
_helpers.tpl
451375397 hybrid 1.14.3 FIXED di hybrid 1.15.1

Skrip apigee-pull-push.sh dapat menampilkan pesan error No such image, misalnya:

Error response from daemon: No such image: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:latest

Solusi: Edit skrip HELM_CHARTS_DIR/apigee-operator/etc/tools/apigee-pull-push.sh untuk mengubah baris 114 dalam fungsi docker_tag() dari: 

  docker tag "${source}/$i" "${dest}/$i:${TAG}"

Kepada: 

  docker tag "${source}/$i:${TAG}" "${dest}/$i:${TAG}"
405936071 hybrid 1.15.0 FIXED di hybrid 1.15.1

Jika metrics.serviceAccountRef atau metrics.serviceAccountSecretProviderClass ditentukan dalam file overrides.yaml, peran telemetri akan menargetkan akun layanan yang salah.

Solusi: Perbaiki _helper.tpl dalam diagram apigee-operator/, lalu terapkan kembali.

  1. Edit apigee-operator/templates/_helpers.tpl dan hapus baris tebal berikut: 

    {{- define "metricsSA" -}}
  {{- $metricsName := "apigee-metrics" }}
  {{- $telemetryName := "apigee-telemetry" -}}
  {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}}
  {{- if .Values.gcp.workloadIdentity.enabled -}}
  {{- printf "%s-sa" $metricsName -}}
  {{- else if .Values.serviceAccountSecretProviderClass -}}  <-- DELETE
  {{- .Values.serviceAccountSecretProviderClass -}}          <-- DELETE
  {{- else if .Values.metrics.serviceAccountRef -}}          <-- DELETE
  {{- .Values.metrics.serviceAccountRef -}}                  <-- DELETE
  {{- else if .Values.multiOrgCluster -}}
  {{- printf "%s-%s" $metricsName $generatedName -}}
  {{- else -}}
  {{- printf "%s-%s" $metricsName $telemetryName -}}
  {{- end -}}
{{- end -}}

    Bagian yang dihasilkan akan terlihat seperti berikut: 

    {{- define "metricsSA" -}}
  {{- $metricsName := "apigee-metrics" }}
  {{- $telemetryName := "apigee-telemetry" -}}
  {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}}
  {{- if .Values.gcp.workloadIdentity.enabled -}}
  {{- printf "%s-sa" $metricsName -}}
  {{- else if .Values.multiOrgCluster -}}
  {{- printf "%s-%s" $metricsName $generatedName -}}
  {{- else -}}
  {{- printf "%s-%s" $metricsName $telemetryName -}}
  {{- end -}}
{{- end -}}

  2. Terapkan kembali diagram apigee-operator. 

    helm upgrade operator apigee-operator/ \
    --namespace APIGEE_NAMESPACE \
    --atomic \
    -f overrides.yaml
419856132 hybrid 1.14.2 dan yang lebih baru TETAP di hybrid 1.14.3 dan hybrid 1.15.0 Jika gateway.networking.k8s.io/v1 diinstal di cluster Anda,apigee-ingressgateway-manager mungkin gagal diupgrade.

Untuk mendapatkan solusi, ikuti langkah-langkah dalam Masalah umum 416634326.

378686709 Apigee
Apigee hybrid		 SUDAH DIPERBAIKI di Apigee (panggilan dukungan diperlukan)
SUDAH DIPERBAIKI di hybrid 1.14.3 dan hybrid 1.15.1 (prosedur diperlukan)

Penggunaan karakter pengganti (*) di basepath proxy Apigee dapat berkonflik dengan basepath eksplisit lainnya, sehingga menghasilkan error 404. Misalnya, penggunaan basepath berikut untuk dua proxy yang di-deploy di lingkungan yang sama dapat menyebabkan error 404 saat memanggil Proxy-2: 

Proxy-1: /a/v1/b
Proxy-2: /a/*/c

Dalam hal ini, panggilan ke jalur dasar eksplisit akan berhasil diselesaikan, tetapi panggilan ke Proxy-2 dapat menampilkan 404, jika jalur karakter pengganti dievaluasi sebagai /a/v1/c.

Diperbaiki: Masalah ini telah diperbaiki di Apigee dan di hybrid 1.14.3 dan yang lebih baru. Namun, perbaikan ini tidak diaktifkan secara default. Jika Anda ingin mengaktifkan penggunaan karakter pengganti di basepath:

  • Pelanggan dengan organisasi Apigee harus menghubungi dukungan Apigee untuk mengaktifkan perbaikan jika diperlukan.
  • Pelanggan dengan organisasi hybrid Apigee harus menggunakan prosedur berikut untuk mengaktifkan perbaikan jika diperlukan.

Prosedur: Untuk mengaktifkan penggunaan karakter pengganti (*) di basepath proxy Apigee dalam Apigee Hybrid:

  1. Tambahkan stanza berikut ke file overrides.yaml Anda sebelum mengupgrade ke hybrid 1.14.3 atau yang lebih baru: 
    runtime:
  cwcAppend:
    conf_message-processor-communication_classificationV2.enabled: "true"
  2. Terapkan perubahan pada diagram apigee-env. Ulangi perubahan untuk setiap lingkungan di penginstalan Anda. 
    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
    • ENV_RELEASE_NAME adalah nama yang digunakan untuk melacak penginstalan dan upgrade diagram apigee-env. Nama ini harus unik dari nama rilis Helm lainnya dalam penginstalan Anda. Biasanya ini sama dengan ENV_NAME. Namun, jika lingkungan Anda memiliki nama yang sama dengan grup lingkungan, Anda harus menggunakan nama rilis yang berbeda untuk lingkungan dan grup lingkungan, misalnya dev-env-release dan dev-envgroup-release. Untuk mengetahui informasi selengkapnya tentang rilis di Helm, lihat Tiga konsep besar dalam dokumentasi Helm.
    • ENV_NAME adalah nama lingkungan yang Anda upgrade.
    • OVERRIDES_FILE adalah file penggantian Anda.
  3. Upgrade ke hybrid 1.14.3 atau yang lebih baru.
382565315 hybrid 1.13.0,
hybrid 1.13.1,
hybrid 1.13.2,
hybrid 1.14.0		 TETAP di hybrid 1.13.3 dan hybrid 1.14.1

Penggunaan LogTimer di SecurityPolicy dapat menyebabkan kebocoran memori.

Dalam beberapa situasi, thread logger Apigee Hybrid dapat menggunakan semua memori yang tersedia. Misalnya, entri log yang sering mencatat error izin yang terkait dengan Javacallout dapat menyebabkan OOM.

421190799 Apigee FIXED di Apigee 1-15-0-apigee-7

Prosesor Ekstensi Apigee tidak mendukung pemrosesan data lebih dari 100 kb sebagai bagian dari peristiwa isi permintaan dan respons.
432315283 Apigee BUKA

Saat memperbarui keystore atau truststore tanpa membuat keystore atau truststore baru, update runtime dapat gagal dan menyebabkan error terputus-putus berikut: 

  {"fault":{"faultstring":"SSL Handshake failed sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target","detail":{"errorcode":"messaging.adaptors.http.flow.SslHandshakeFailed"}}}

Error ini bersifat sementara karena update keystore atau truststore dapat gagal di satu pod runtime, tetapi berhasil di pod lainnya. Untuk menghindari masalah ini, perbarui keystore atau truststore dengan membuat keystore atau truststore baru. Arahkan ulang referensi Anda ke keystore atau truststore baru, seperti yang dijelaskan dalam Jika masa berlaku sertifikat berakhir.
412740465 hybrid 1.14.0 dan yang lebih baru TETAP di hybrid 1.14.3 dan hybrid 1.15.1

Mulai versi 1.14.0 Apigee Hybrid, penambahan otomatis header rekaman aktivitas Zipkin (x-b3-*) telah dihapus.

T/A

 Apigee hybrid BUKA Mengonfigurasi penerusan proxy non-API menggunakan httpProxy tanpa menetapkan envs.httpProxy juga tidak akan menerapkan konfigurasi proxy ke panggilan eksternal Apigee Runtime ke layanan seperti Pub/Sub atau Google Cloud API lainnya.

Jika hanya menentukan httpProxy, Anda juga harus memastikan bahwa *.googleapis.com masuk dalam daftar yang diizinkan untuk pod Apigee Runtime Anda agar dapat terhubung ke layanan ini.

Lihat Mengonfigurasi penerusan proxy untuk proxy API.

416634326 hybrid 1.14.2 dan yang lebih baru TETAP di hybrid 1.14.3 dan hybrid 1.15.1

Keberadaan Definisi Resource Kustom (CRD) istio.io di cluster hybrid Apigee dapat menyebabkan kegagalan pada pod apigee-ingressgateway-manager.

Selama upgrade Apigee Hybrid dari versi lama ke 1.14.2 atau yang lebih baru, keberadaan CRD istio.io yang ada dapat menyebabkan pemeriksaan kesiapan gagal di penampung discovery pada pod apigee-ingressgateway-manager.

Solusi: CRD istio.io tidak diperlukan oleh Apigee Hybrid v1.14.2 atau yang lebih baru. Ada dua opsi untuk memperbaiki masalah ini:

  • Hapus CRD istio.io jika Anda tidak menggunakan Istio untuk tujuan apa pun selain Apigee di cluster Anda.
  • Perbarui apigee-ingressgateway-manager clusterrole untuk menambahkan izin bagi istio.io.

Setelah setiap opsi di atas, Anda harus memulai ulang pod apigee-ingressgateway-manager.

Menghapus CRD

  1. Mencantumkan CRD istio.io di cluster Anda ke file CSV: 
    kubectl get crd -o custom-columns=NAME:metadata.name | grep istio.io > istio-crd.csv
  2. Opsional: Simpan CRD secara lokal jika Anda perlu membuatnya ulang: 
    kubectl get crd $(cat istio-crd.csv) -o yaml > istio-crd.yaml
  3. Hapus CRD istio.io:

    Uji coba:

    kubectl delete crd $(cat istio-crd.csv) --dry-run=client

    Jalankan:

    kubectl delete crd $(cat istio-crd.csv)

Memperbarui clusterrole

  1. Dapatkan clusterrole apigee-ingressgateway-manager saat ini: 
    kubectl get clusterrole apigee-ingressgateway-manager-apigee -o yaml > apigee-ingressgateway-manager-apigee-clusterrole.yaml
  2. Salin clusterrole ke lokasi baru: 
    cp apigee-ingressgateway-manager-apigee-clusterrole.yaml apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml
  3. Tambahkan izin tambahan berikut ke bagian akhir file: 
    - apiGroups:
  - gateway.networking.k8s.io
  resources:
  - gatewayclasses
  - gateways
  - grpcroutes
  - httproutes
  - referencegrants
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - networking.istio.io
  resources:
  - sidecars
  - destinationrules
  - gateways
  - virtualservices
  - envoyfilters
  - workloadentries
  - serviceentries
  - workloadgroups
  - proxyconfigs
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - security.istio.io
  resources:
  - peerauthentications
  - authorizationpolicies
  - requestauthentications
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - telemetry.istio.io
  resources:
  - telemetries
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - extensions.istio.io
  resources:
  - wasmplugins
  verbs:
  - get
  - list
  - watch
  4. Terapkan peran: 
    kubectl -n APIGEE_NAMESPACE apply -f apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml

Setelah menyelesaikan opsi di atas, Anda harus memulai ulang apigee-ingressgateway-manager pods.

  1. Buat daftar pod ingress-manager untuk diinstal ulang atau dibuat ulang: 
    kubectl get deployments -n APIGEE_NAMESPACE

    Contoh output:

    NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager       1/1     1            1           32d
apigee-ingressgateway-manager   2/2     2            2           32d
  2. Mulai ulang pod ingress-manager: 
    kubectl rollout restart deployment -n APIGEE_NAMESPACE apigee-ingressgateway-manager
  3. Setelah beberapa menit, pantau pod apigee-ingressgateway-manager: 
    watch -n 10 kubectl -n APIGEE_NAMESPACE get pods -l app=apigee-ingressgateway-manager

    Contoh output:

    NAME                                             READY   STATUS    RESTARTS   AGE
apigee-ingressgateway-manager-12345abcde-678wx   3/3     Running   0          10m
apigee-ingressgateway-manager-12345abcde-901yz   3/3     Running   0          10m
414499328 hybrid 1.14.1 TETAP di hybrid 1.14.3 dan hybrid 1.15.0

ApigeeTelemetry dapat macet dalam status creating.

Masalah ini telah terlihat pada penginstalan OpenShift.

Solusi: Ubah template diagram apigee-operator untuk membuat akses clusterrole yang benar.

  1. Edit file template helm-charts/apigee-operator/templates/apigee-operators.yaml, dan temukan definisi clusterrole -apigee-manager-role-. Dimulai dengan: 
    kind: ClusterRole
metadata:
  name: apigee-manager-role-{{ include 'namespace' }}
rules:
  ...
  2. Temukan blok - apiGroups: apiregistration.k8s.io, lalu tambahkan resource apiservices/finalizers ke daftar resource: 
    - apiGroups:
  - apiregistration.k8s.io
  resources:
  - apiservices
  - apiservices/finalizers
  verbs:
  - create
  - delete
  - get
  - patch
  - update
  3. Temukan blok - apiGroups: authorization.k8s.io, lalu tambahkan blok - apiGroups: apigee.cloud.google.com setelah akhir blok dengan teks berikut: 
    - apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update

    Contoh:

    - apiGroups:
  - authorization.k8s.io
  resources:
  - subjectaccessreviews
  verbs:
  - create
  - get
  - list
- apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update
  4. Terapkan perubahan pada diagram apigee-operator:

    Uji coba:

    helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE \
  --dry-run=server

    mengupgrade diagram:

    helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE \
402739748 Apigee BUKA

APIproduct dibatasi hingga 50 jalur. Jika Anda menambahkan jalur tambahan, pesan error akan ditampilkan: Operation group limit of 51 exceeded in Operation Config

Solusi: Gunakan pola karakter pengganti untuk menggabungkan jalur resource dan operasi seperti yang dijelaskan dalam Mengonfigurasi jalur resource.

Solusi: Buat beberapa Produk API. Solusi ini telah diverifikasi dan layak bagi mereka yang menambahkan banyak Proxy API ke Produk API. Aplikasi yang terkait dengan Produk API Anda harus diupdate untuk menyertakan yang baru, tetapi kredensial dan detail permintaan sisi klien telah terbukti tidak perlu diubah.

291294211 Apigee BUKA

Error saat menggunakan API Laporan Kustom dan Statistik saat memilih menurut jenis biaya untuk penginstalan menggunakan Monetisasi.

Solusi: Ambil semua jenis biaya di sisi klien sebelum memfilter.

391140293 Apigee
Apigee Hybrid		 FIXED

Penskalaan pod ingress Istio dapat menyebabkan error 503.

Penskalaan pod ingress Istio terkadang dapat menyebabkan error 503. Jika terjadi error 503, log untuk load balancer akan menampilkan pesan berikut: statusDetails: backend_connection_closed_before_data_sent_to_client.

Solusi: Menskalakan pod ingress Istio secara manual.

368155212 hybrid 1.14.0
hybrid 1.14.1		 FIXED di hybrid 1.14.2

ESS dan non-ESS Rotasi kredensial Cassandra tidak berfungsi di organisasi dengan Batas Proxy yang Ditingkatkan.

Traffic runtime tidak terpengaruh.

401624396 hybrid 1.13.x
hybrid 1.14.x		 BUKA Tugas pemulihan Apigee gagal saat memulihkan cadangan Penyedia Cloud GCP atau HYBRID yang diambil dari penyiapan multi-region. Masalah ini tidak memengaruhi CSI pemulihan.

Cadangan yang diambil dari penyiapan multi-region menggunakan Penyedia Cloud GCP dan HYBRID berisi informasi tentang semua region Hybrid yang ada saat snapshot diambil. Selain itu, karena region tersebut tidak ada lagi, tugas pemulihan akan berkonflik dengan status Cassandra saat ini dan gagal dengan error berikut: Unrecognized strategy option passed to NetworkTopologyStrategy.

401746333 Apigee
hybrid 1.12.4
hybrid 1.13.3
hybrid 1.14.1		 FIXED

Library Nimbus JOSE + JWT dapat menyebabkan java.lang.ClassCircularityError saat menggunakan kebijakan JavaCallout .

Jika Anda memiliki organisasi yang mendukung hybrid Apigee dengan kebijakan JavaCallout yang menggunakan library Nimbus JOSE + JWT, jangan upgrade ke hybrid 1.12.4, hybrid 1.13.3, hybrid 1.14.1.
397693324 hybrid 1.14.0
hybrid 1.14.1		 FIXED di hybrid 1.14.2

ESS dan non-ESS Rotasi kredensial Cassandra multi-region akan gagal di setiap region kecuali yang pertama.

Traffic runtime tidak terpengaruh.

Ikuti solusi sementara yang diberikan untuk mengatasi masalah ini.

391861216 hybrid 1.13.x
hybrid 1.14.x		 FIXED di hybrid 1.13.3 dan hybrid 1.14.1 Memulai ulang pod Cassandra di cluster Hybrid yang telah dipulihkan menggunakan GCP atau Penyedia Cloud HYBRID akan menyebabkan pod memasuki status CrashLoopBackoff. Masalah ini tidak memengaruhi CSI pemulihan.

Pod Cassandra akan dimulai ulang setelah menerapkan perubahan penggantian Cassandra, seperti saat mengaktifkan kembali pencadangan, yang akan memicu masalah ini. Log pod Cassandra dalam status CrashLoopBackoff akan menampilkan error berikut: Cannot change the number of tokens from 512 to 256.

Ikuti solusi sementara yang diberikan untuk mengatasi masalah ini.

388608440 hybrid 1.11.x
hybrid 1.12.x		 FIXED di hybrid 1.12.4 dan yang lebih baru Tugas pencadangan Apigee tidak membersihkan snapshot perantara Cassandra.

Dalam beberapa kasus yang jarang terjadi, tugas pencadangan Apigee tidak menghapus snapshot perantara Cassandra yang dibuat saat melakukan pencadangan menggunakan Penyedia Cloud HYBRID atau GCP. Hal ini hanya terjadi jika masalah mendasar mencegah proses pencadangan berhasil terhubung ke server jarak jauh atau Cloud Storage. Jika masalah koneksi berlanjut, snapshot Cassandra yang tersisa tersebut dapat menumpuk seiring waktu, menggunakan penyimpanan di disk Cassandra. Jika Anda terpengaruh, perbaiki masalah koneksi yang mendasarinya, lalu ikuti langkah-langkah yang diberikan dalam panduan pemecahan masalah Cassandra untuk menghapus snapshot Cassandra secara manual.

392135466 hybrid 1.14.0 BUKA Penggabungan proxy dengan mTLS tidak didukung saat menggunakan Batas proxy per lingkungan yang ditingkatkan
383334511 Apigee BUKA Entri KVM dibuat dengan nama yang tidak terduga

Jika kebijakan KeyValueMapOperations digunakan dengan cakupan apiproxy, dan operasi <Put> kebijakan dipanggil dalam alur bersama melalui hook alur, entri KVM akan dibuat dengan nama alur bersama. Kebijakan ini diharapkan dibuat dengan nama proxy API.

384937220

 hybrid 1.14.0 FIXED Pembuatan rilis Helm dapat gagal jika ada beberapa host virtual.

Jika ada beberapa host virtual, pembuatan rilis Helm dapat gagal karena nama ApigeeRoute yang bertentangan. Solusinya adalah menjalankan perintah berikut untuk setiap host virtual saat membuat:

kubectl annotate ar apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite
kubectl annotate cert apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite

dengan:

  • PROJECT_ID_SUFFIX adalah akhiran unik untuk penggabungan internal project Anda di Kubernetes. Anda dapat menemukan akhiran ini dengan perintah berikut: 
    kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining

    Output Anda akan terlihat seperti:

    kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining
apigee-ingressgateway-internal-chaining-my-project--1234567    ClusterIP  34.118.226.140  <none>    15021/TCP,443/TCP    5d6h

    Dalam contoh output, my-project--1234567 adalah PROJECT_ID_SUFFIX.

  • APIGEE_NAMESPACE adalah namespace Apigee Anda.
  • NEW_ENV_GROUP_NAME adalah nama grup lingkungan tambahan. Perbarui nilai ini untuk setiap host virtual.

T/A

 Apigee hybrid BUKA Akun layanan yang tidak valid dapat membuat API UpdateControlPlaneAccess masuk ke loop percobaan ulang.

Jika pengguna memberikan akun layanan yang tidak valid ke API UpdateControlPlaneAccess, operasi akan masuk ke loop percobaan ulang yang secara efektif mengunci organisasi agar tidak memanggil API hingga operasi mencapai waktu tunggu.
373722434 hybrid 1.13.x TETAP mulai dari hybrid 1.13.2 dan yang lebih baru Tugas pencadangan Apigee tidak dapat diupload ke bucket Cloud Storage dengan kebijakan retensi.

Saat menggunakan Penyedia Cloud GCP, tugas pencadangan Apigee tidak dapat diupload ke bucket Cloud Storage dengan kebijakan retensi. File cadangan mungkin dibiarkan di bucket Cloud Storage dengan ukuran file 0 byte.

Solusi: Nonaktifkan kebijakan retensi di bucket Cloud Storage.

341099433

 Apigee hybrid BUKA Komponen apigee-logger tidak mendukung Workload Identity Federation.

apigee-logger menggunakan akun layanan IAM Google untuk mengirimkan log ke Cloud Logging. Hal ini disebabkan oleh kurangnya dukungan FluentBit untuk Workload Identity Federation, yang mencegah apigee-logger menggunakan fitur ini.

T/A

 Apigee hybrid BUKA Pelacakan terdistribusi di Apigee Hybrid tidak didukung untuk organisasi yang menggunakan residensi data.

T/A

 Apigee BUKA Apigee tidak mendukung enkripsi ulang kunci, yang berarti meskipun setelah rotasi, versi kunci lama akan tetap digunakan dan Anda tidak dapat mengubah kunci CMEK setelah pembuatan org.

270574696

 Apigee FIXED Apigee tidak mendukung Cloud External Key Manager.

268104619

 Apigee
Apigee Hybrid		 BUKA Dalam kebijakan OASValidation, saat Anda menentukan jenis array di header, MP akan menampilkan error, meskipun inputnya valid.

364872027

 Apigee
Apigee Hybrid		 FIXED Error penguraian PEM dalam kebijakan JWT/JWS karena format non-standar

Untuk Apigee dan Apigee Hybrid versi 1.13 dan yang lebih tinggi, setiap penyimpangan dalam format PEM kunci yang diperlukan yang digunakan dalam kebijakan JWS atau JWT Apigee dapat menyebabkan error parsing. Misalnya, menempatkan karakter selain baris baru (/n) tepat sebelum baris "-----END" (batas pasca-enkapsulasi) tidak diizinkan dan akan menyebabkan error.

Untuk mencegah error ini, pastikan tidak ada karakter selain baris baru, seperti spasi atau garis miring di akhir, yang langsung mendahului batas pasca-enkapsulasi.

Untuk mengetahui informasi selengkapnya tentang encoding yang digunakan untuk kunci publik atau pribadi, lihat IETF RFC 7468.

310191899

 Apigee
Apigee Hybrid		 BUKA Waktu tunggu habis saat men-deploy proxy API dan alur bersama

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

Untuk mengurangi kemungkinan waktu tunggu habis, sebaiknya tetapkan target 1 QPS saat menggunakan endpoint ini atau periksa status deployment sebelum mencoba deployment lain.

329304975

 Apigee FIXED Batas jumlah basepath per lingkungan

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

Selama batas ini berlaku, Anda dapat men-deploy hingga 1.000 revisi proxy API (yang masing-masing berisi satu basepath) per lingkungan. Jika proxy atau revisi API Anda berisi lebih dari satu basepath, jumlah total basepath per lingkungan tidak boleh melebihi 1.000.

333791378

 hybrid 1.12.0 BUKA Fitur pencadangan dan pemulihan Cassandra tidak didukung oleh alat migrasi Helm

Untuk mengetahui langkah-langkah yang diperlukan untuk menginstal patch bagi solusi sementara, lihat Pemecahan masalah.

310384001

 hybrid 1.11.0 BUKA Kegagalan validasi sertifikat dapat menampilkan respons error 502, bukan 503, saat pengguna menambahkan tag <Enforce>true</Enforce> di blok <SSLInfo> target untuk validasi default sertifikat endpoint target TLS.

289583112

 Apigee BUKA Kebijakan OASValidation tidak berfungsi dengan persyaratan keamanan global dalam spesifikasi OpenAPI

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

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

205666368

 Apigee
hybrid 1.10.2
hybrid 1.10.3		 TETAP di Apigee 1-10-0-apigee-6 dan
Hybrid 1.10.3-hotfix.1		 Apigee Hybrid tidak memvalidasi sertifikat target secara default.

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

295929616

 hybrid 1.10.0 dan yang lebih baru FIXED di hybrid 1.10.3 Menginstal Apigee Hybrid 1.10 di OpenShift (OSE) dapat gagal karena error kehabisan memori.

Penginstalan atau upgrade ke Apigee Hybrid 1.10.0 hingga 1.10.2 dapat gagal di OSE karena masalah kehabisan memori. Diperbaiki di Apigee Hybrid versi 1.10.3.

292118812

 hybrid 1.10.1 FIXED apigee-udca mungkin tidak mematuhi setelan proxy http.

Jika firewall memaksa semua traffic melalui proxy penerusan, apigee-udca dapat memasuki status penundaan loop error.

292558790

 Apigee
hybrid 1.8.0 dan yang lebih baru		 BUKA Kebijakan OASValidation gagal dengan error Unable to parse JSON.
  • Kebijakan OASValidation gagal jika konten JSON tidak cocok dengan pola yang diharapkan. Misalnya, jika header 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 elemen <OASResource>.

297012500

 Apigee
hybrid 1.8.0 dan yang lebih baru		 BUKA Masalah Deployment dengan Validasi OAS saat menggunakan referensi melingkar.
  • Deployment Apigee akan gagal untuk kebijakan Validasi OAS saat menggunakan referensi melingkar untuk spesifikasi OpenAPI 3.0.0 karena akan masuk ke loop tak terbatas.

    • Solusi: Gunakan yaml spesifikasi OpenAPI tanpa referensi melingkar.

289254725

 Apigee
Apigee 1-10-0-apigee-3
hybrid 1.8.8
hybrid 1.9.3		 TETAP di Apigee 1-10-0-apigee-5
TETAP di hybrid		 Deployment proxy yang menyertakan kebijakan OASValidation mungkin gagal.

Deployment proxy yang menyertakan kebijakan OASValidation dapat gagal jika:

  • Spesifikasi OpenAPI yang digunakan untuk validasi dalam kebijakan OASValidation berformat YAML, dan
  • Spesifikasi OpenAPI berformat YAML berisi angka floating. Contoh: 
    schema:
type: number
example: 2.345

284500460

 Apigee
Apigee 1-10-0-apigee-1		 FIXED Peningkatan latensi untuk kebijakan Message Logging saat digunakan dengan Cloud Logging.

Untuk menghindari peningkatan latensi dalam respons ke klien, kebijakan Message Logging harus dilampirkan ke PostClientFlow. Untuk mengetahui informasi selengkapnya tentang penggunaan kebijakan di PostClientFlow, lihat Mengontrol proxy API dengan alur.

282997216

 hybrid 1.8.0 dan yang lebih baru
hybrid 1.9.0 dan yang lebih baru		 BUKA Karakter khusus tidak diizinkan dalam sandi Cassandra Jolokia

Gunakan hanya karakter alfanumerik untuk sandi Cassandra Jolokia. Penggunaan karakter khusus (termasuk, tetapi tidak terbatas pada "!", "@", "#", "$", "%", "^", "&", & "*") dapat menyebabkan kegagalan startup Cassandra.

270371160

 hybrid 1.9.0 dan yang lebih baru FIXED Gateway Apigee Ingress hanya mendukung protokol/cipher TLS1.2+

Gateway Apigee Ingress hanya mendukung TLS1.2+, dan bukan versi TLS sebelumnya.

269139342

 hybrid 1.7.0 dan yang lebih baru FIXED apigeectl getOrg tidak mengikuti setelan HTTP_PROXY di overrides.yaml

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

266452840

 Apigee
hybrid 1.7.0 dan yang lebih baru
hybrid 1.8.0 dan yang lebih baru
hybrid 1.9.0 dan yang lebih baru		 FIXED Web socket tidak berfungsi dengan Anthos Service Mesh 1.15.3 di Apigee X dan Apigee Hybrid

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

287922301

 Apigee BUKA Ketidakakuratan dalam tarif Monetisasi di sekitar nilai minimum rentang volume

Karena desain saat ini, rasio monetisasi yang tidak akurat dapat dinilai untuk transaksi yang terjadi di dekat batas volume. Hal ini terwujud sebagai terlalu banyak transaksi yang dinilai pada tarif pra-batas, dan lebih mungkin terjadi ketika banyak transaksi untuk kombinasi paket tarif dan developer tertentu terjadi dalam periode 30 detik. Artinya, pelaporan monetisasi akan melaporkan biaya secara berlebihan dengan tarif berjenjang yang menurun, dan melaporkan biaya secara kurang jika tarif berjenjang meningkat. Masalah ini terjadi di Apigee X dan Apigee Hybrid, serta tidak ada solusi yang diketahui. Resolusi telah dimulai dan akan tersedia dalam rilis mendatang.

242213234

 Apigee FIXED Produk API gagal dimuat dengan error "no connections available" (tidak ada koneksi yang tersedia)

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

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

Solusi: Buat aturan egress secara manual, seperti berikut: 

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

247540503

 hybrid 1.7.0 dan yang lebih baru
hybrid 1.8.0 dan yang lebih baru		 FIXED Kondisi persaingan dengan pencarian kunci enkripsi dapat menyebabkan kegagalan pencarian KVM.

Dalam keadaan tertentu dengan throughput yang sangat tinggi, kondisi race dengan pencarian kunci enkripsi dapat menyebabkan kegagalan pencarian KVM.

258699204

 hybrid 1.8.0 dan yang lebih baru FIXED Permintaan dan batas memori default untuk pod metrik telah tidak sengaja berubah di 1.8.x.

Jika Anda melihat masalah pada pod apigee-telemetry-app atau apigee-telemetry-proxy yang tidak berjalan, ubah properti permintaan resource dan batas resource metrics agar sesuai dengan default berikut dalam Referensi properti konfigurasi: metrics.

Properti konfigurasi Nilai default
metrics.aggregator.resources.requests.memory: 512Mi
metrics.aggregator.resources.limits.memory: 3Gi
metrics.app.resources.requests.memory: 512Mi
metrics.app.resources.limits.memory: 1Gi
metrics.appStackdriverExporter.resources.requests.memory: 512Mi
metrics.appStackdriverExporter.resources.limits.memory: 1Gi
metrics.proxy.resources.requests.memory: 512Mi
metrics.proxy.resources.limits.memory: 1Gi
metrics.proxyStackdriverExporter.resources.requests.memory: 512Mi
metrics.proxyStackdriverExporter.resources.limits.memory: 1Gi

Terapkan perubahan dengan apigeectl apply dengan flag ‑‑telemetry: 

apigeectl apply --telemetry -f overrides.yaml

260324159

 Apigee 1-9-0-apigee-16 FIXED Deployment proxy API dan alur bersama memerlukan waktu hingga 30 menit.

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

214447386

 Semua BUKA Pesan "config not modified" ditampilkan di Apigee API Log audit Akses Data sebagai Error.

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

260772383

 hybrid 1.8.0 dan yang lebih baru BUKA Error pengikatan soket di platform AKS

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 stanza svcAnnotations berikut ke file penggantian: 

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

 hybrid 1.8.0 dan yang lebih baru FIXED MART terkadang tidak dapat terhubung ke FluentD.

Saat menggunakan UDCA cakupan Org, MART terkadang tidak dapat terhubung ke FluentD. UDCA cakupan organisasi adalah default di Apigee hybrid versi 1.8. Lihat orgScopedUDCA di referensi properti Konfigurasi.

T/A hybrid 1.6.0 dan yang lebih baru BUKA apigee-logger tidak berfungsi di Anthos BareMetal dengan CentOS atau RHEL.

Setelah migrasi apigee-logger dari fluend ke fluent-bit di Apigee Hybrid versi 1.6.6, logger berhenti berfungsi di Anthos BareMetal dengan CentOS atau RHEL.
207762842 hybrid 1.5.0 dan yang lebih baru FIXED Log tidak dikirim ke Cloud Logging oleh apigee-logger.

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

191291501, 191000617 Apigee FIXED Mengubah alamat email entitas developer akan gagal di UI.
191002224 hybrid 1.5.0 dan yang lebih baru FIXED Mengubah alamat email gagal saat menggunakan PUT /organizations/{org_name}/developers/{developer_email} API.
184555974 hybrid 1.5.0 dan yang lebih baru FIXED Fluentd apigee-logger tidak dapat mem-parsing log di cluster OpenShift.
T/A Mengarsipkan deployment BUKA Mengelola dan men-debug deployment arsip Apigee di UI tidak didukung

Di UI Apigee, Anda tidak dapat melihat, mengonfirmasi status deployment, atau mengelola deployment arsip, seperti yang dijelaskan dalam Men-deploy proxy API, atau menggunakan UI Debug seperti yang dijelaskan dalam Menggunakan Debug. Sebagai solusi sementara, Anda dapat menggunakan gcloud atau API untuk Mencantumkan semua deployment arsip dalam lingkungan dan menggunakan Debug API.

T/A Mengarsipkan deployment BUKA Rollback deployment arsip tidak didukung

Rollback deployment arsip saat ini tidak didukung. Untuk menghapus versi deployment arsip, Anda harus men-deploy ulang versi arsip sebelumnya atau menghapus lingkungan.

421402073

 Apigee di VS Code BUKA Autentikasi Google dalam kebijakan tidak didukung di Apigee dalam Visual Studio Code (VS Code)

Autentikasi Google dalam kebijakan ServiceCallout dan ExternalCallout, seperti yang dijelaskan dalam Menggunakan Autentikasi Google, tidak didukung di Apigee di VS Code.

422757662 Apigee 1-15-0-apigee-5
hybrid 1.15.0		 TETAP di Apigee 1-15-0-apigee-7 dan Apigee 1-15-0-apigee-8

Header x-b3 tidak tersedia saat DistributedTrace dinonaktifkan

Pada rilis Apigee 1-15-0-apigee-5 dan hybrid 1.15.0, Apigee berhenti mengirim header x-b3 ke endpoint target saat Distributed Trace dinonaktifkan. Namun, beberapa penginstalan Apigee mengandalkan header x-b3 yang dikirim terlepas dari apakah Distributed Trace diaktifkan atau dinonaktifkan. Oleh karena itu, perubahan ini telah dikembalikan mulai dari Apigee 1-15-0-apigee-7.

146222881 hybrid 1.3.0 dan yang lebih baru FIXED Error Header HTTP Tidak Valid

Error Header HTTP tidak valid: Ingress Istio mengalihkan semua respons target masuk ke protokol HTTP2. Karena pemroses pesan hybrid 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 error ini, Anda dapat melakukan salah satu tindakan berikut untuk memperbaiki masalah:

  • Ubah layanan target untuk menghilangkan header Host dalam respons.
  • Hapus header Host menggunakan kebijakan AssignMessage di proxy API Anda jika perlu.

420985360

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

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

  • Coba API ini memiliki batasan berikut:
    • Header Accept ditetapkan ke application/json, terlepas dari nilai yang ditetapkan untuk consumes dalam Spesifikasi OpenAPI.
    • Header permintaan dengan jenis selain string tidak didukung.
T/A Portal terintegrasi BUKA Admin portal

  • Update portal simultan (seperti pengeditan halaman, tema, CSS, atau skrip) oleh beberapa pengguna tidak didukung saat ini.
  • Jika Anda menghapus halaman dokumentasi referensi API dari portal, halaman tersebut tidak dapat dibuat ulang; Anda harus menghapus dan menambahkan kembali produk API, serta membuat ulang dokumentasi referensi API.
  • Saat menyesuaikan tema portal, perubahan mungkin memerlukan waktu hingga 5 menit untuk diterapkan sepenuhnya.
T/A Portal terintegrasi BUKA Fitur portal

Penelusuran akan diintegrasikan ke portal terintegrasi dalam rilis mendatang.

T/A Portal terintegrasi BUKA Penyedia identitas SAML

Logout tunggal (SLO) dengan penyedia identitas SAML tidak didukung untuk domain kustom. Untuk mengaktifkan domain kustom dengan penyedia identitas SAML, biarkan kolom URL Logout kosong saat Anda mengonfigurasi setelan SAML.

191815997 hybrid 1.6.0 dan yang lebih baru FIXED Jika pelanggan hybrid mengonfigurasi proxy penerusan untuk proxy API, token Google tidak akan berfungsi kecuali jika memiliki akses langsung ke *.googleapis.com.
T/A Apigee TETAP di Apigee 1-12-0-apigee-2 dan hybrid 1.12.0 API Monitoring dan Cloud Monitoring menunjukkan lonjakan yang tidak normal

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

    Berikut adalah contoh yang menunjukkan lonjakan tersebut:

    (lihat gambar yang lebih besar)

  • Karena bug, sistem mencatat jumlah dengan tidak benar untuk jangka waktu singkat dan jumlah tersebut diperbaiki. Hal ini terjadi jika ada penurunan traffic API (yang mengakibatkan penurunan 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.

Metrik Deskripsi
apigee.googleapis.com/proxy/request_count Jumlah permintaan ke proxy Apigee sejak sampel terakhir direkam.
apigee.googleapis.com/proxy/response_count Jumlah respons yang dikirim oleh proxy API Apigee.
apigee.googleapis.com/proxy/latencies Distribusi latensi, yang dihitung dari saat permintaan diterima oleh proxy Apigee hingga saat respons dikirim dari proxy Apigee ke klien.
apigee.googleapis.com/target/request_count Jumlah permintaan yang dikirim ke target Apigee sejak sampel terakhir direkam.
apigee.googleapis.com/target/response_count Jumlah respons yang diterima dari target Apigee sejak sampel terakhir dicatat.
apigee.googleapis.com/target/latencies Distribusi latensi, yang dihitung dari waktu permintaan dikirim ke target Apigee hingga waktu respons diterima oleh proxy Apigee. Waktu tidak mencakup overhead proxy API Apigee.

Untuk Apigee hybrid, lihat: Ringkasan pengumpulan metrik dan Melihat metrik.

203778087 hybrid 1.5.3 dan yang lebih baru BUKA apigee-stackdriver-logging-agent saat ini berjalan sebagai root.

Solusi: Nonaktifkan agen logging di hybrid.

205629443 Apigee FIXED Jika ServiceCallout bersifat fire and forget (tanpa tag <Response>), kondisi persaingan dapat terjadi jika ada kebijakan lain yang terjadi setelahnya.

Solusi: Untuk mempertahankan perilaku kirim dan lupakan:

  1. Tambahkan <Response>calloutResponse</Response> ke ServiceCallout.
  2. Tetapkan continueOnError ke true.
207719377 Apigee FIXED di Apigee 1-11-0-apigee-1 Jika ada lebih dari satu kebijakan SpikeArrest dalam satu paket, error 502 akan terjadi.

Solusi: Hindari penggunaan lebih dari satu kebijakan SpikeArrest di proxy untuk mencegah masalah ini.

209097822 hybrid 1.5.0 dan yang lebih baru
Apigee		 FIXED Pembaruan dinamis pada laju dalam penekanan lonjakan mungkin tidak langsung ditampilkan

Untuk kunci tertentu, jika ada traffic berkelanjutan, kunci tersebut mungkin tidak dibatasi lajunya pada kecepatan yang diperbarui. Jika tidak ada traffic selama lima menit untuk kunci tertentu, rasio akan ditampilkan.

Solusi: Deploy ulang proxy dengan variabel referensi baru jika tarif harus segera berlaku. Atau gunakan dua penyelesaian lonjakan bersyarat dengan variabel alur yang berbeda untuk menyesuaikan rasio.

221305498 Apigee BUKA Pemantauan API dapat menampilkan kode kesalahan '(not set)'.

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

246774745 Apigee FIXED Nilai io.timeout.millis tidak diterapkan saat digunakan dengan beberapa target dinamis.

Jika proxy menetapkan dua atau lebih nilai io.timeout.millis dalam dua atau lebih alur menggunakan host target yang sama, hanya satu nilai io.timeout.millis yang akan digunakan.

245664917 hybrid 1.8.x FIXED Error upgrade Apigee Hybrid dapat diabaikan

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

300660653 Apigee FIXED Error seharusnya ditampilkan, tetapi tidak ditampilkan, saat men-deploy proxy dengan jalur yang sama ke beberapa lingkungan yang terlampir ke grup instance dan lingkungan yang sama

Men-deploy proxy dengan jalur yang sama ke beberapa lingkungan yang terlampir ke grup lingkungan dan instance yang sama tidak diizinkan dan akan menampilkan pesan peringatan tentang konflik jalur dasar. Namun, tidak ada error yang ditampilkan dan deployment tampak berhasil.

Solusi: Saat men-deploy dan setelah men-deploy, pastikan tidak ada konflik jalur dasar dengan proxy yang di-deploy dan perbaiki sesuai kebutuhan.

301458133 Apigee FIXED Beberapa upaya deployment proxy menampilkan error bahwa revisi tidak dapat diubah

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

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

301845257 Apigee FIXED Mencoba men-deploy lebih dari 800 proxy ke grup lingkungan akan gagal dengan error. Batas saat error ditampilkan lebih rendah dari 800 jika basepath lebih panjang dari 15 karakter.

315820718 Apigee FIXED Dengan permintaan proxy gRPC, trailer gRPC dihapus dari respons

Saat panggilan dilakukan ke Server Target gRPC, satu-satunya trailer yang ditampilkan adalah trailer "grpc-status". Semua cuplikan lainnya dihapus dari respons.
341157011 Apigee FIXED Spesifikasi yang dibuat dengan Gemini Code Assist di Cloud Code yang juga menyertakan karakter UTF-8 non-ASCII tidak diuraikan dengan benar saat diupload ke hub API.

Akibatnya, hub API tidak akan mengekstrak operasi, definisi, dan metadata lainnya dengan benar.
338285095 Apigee FIXED Aplikasi yang terkait dengan AppGroup tidak muncul dalam daftar Aplikasi di UI Apigee. Akibatnya, pengguna tidak dapat mengakses halaman Detail Aplikasi di konsol. Menggunakan penelusuran di konsol dengan nama aplikasi atau kunci API parsial penelusuran aplikasi tidak didukung hingga masalah ini diselesaikan.

Organisasi hybrid Apigee tidak terpengaruh oleh masalah ini, karena menggunakan UI Klasik untuk melihat detail aplikasi.

Solusi sementara: Daftar semua aplikasi tersedia menggunakan API. Lihat organizations.apps.list.
355714868 Monetisasi
Apigee hybrid		 FIXED di hybrid 1.14.3, hybrid 1.15.1, hybrid 1.16.0 Data biaya berulang, penyiapan, dan pengisian ulang tidak dicatat atau ditagih untuk organisasi hybrid

Untuk organisasi hybrid dengan monetisasi, data biaya berulang (RECURRING_FEE), biaya penyiapan (SETUP_FEE), dan biaya pengisian ulang (TOPUP_FEE) tidak dicatat atau ditagih untuk penagihan pascabayar. Untuk penagihan prabayar, pemotongan saldo e-wallet terjadi untuk biaya ini, tetapi tidak dilaporkan.
438850078 Apigee BUKA

Rekursi tak terbatas terjadi dalam kebijakan OASValidation saat respons backend berisi jenis diskriminator yang sama dengan skema induk. Masalah ini dapat menyebabkan StackOverflowError.
449012244 Apigee BUKA

Gunakan definisi endpoint target terpisah untuk target SSE (server sent-event). Mencampur endpoint target SSE dan non-SSE bersama-sama dapat menyebabkan perilaku yang tidak konsisten seperti variabel alur response.content yang kosong.
445936920 Apigee 1-16-0-apigee-2 dan yang lebih baru BUKA

Masalah konfigurasi DNS yang sebelumnya tidak terdeteksi kini dapat menyebabkan error DNS. Apigee menghapus fungsi penggantian DNS otomatis yang ada di 1-16-0-apigee-2. Penghapusan ini menghilangkan ketahanan platform terhadap kesalahan konfigurasi DNS dan kini dapat mengakibatkan error DNS.

Temukan error terkait dengan memeriksa log runtime untuk mengetahui error resolusi DNS.
383372330 Apigee Emulator versi 1.13.0 hingga 1.15.1, tetapi tidak termasuk DIPERBAIKI di Apigee Emulator versi 1.15.1 dan yang lebih baru

Semua deployment proxy gagal secara lokal dengan pesan error termasuk Error parsing deployment report as JSON: 

06/13/2025 6:45 PM EMULATOR INFO Deploying environment testenv, to Container apigee-1.14.2 (1.14.2)
06/13/2025 6:45 PM EMULATOR ERROR Error parsing deployment report as JSON
06/13/2025 6:45 PM EMULATOR ERROR null
06/13/2025 6:45 PM EMULATOR ERROR Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500
06/13/2025 6:45 PM EMULATOR ERROR Deploy to Container apigee-1.14.2 (1.14.2), failed with Error: Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500
 Perbaikan: Update ke Apigee Emulator versi 1.15.1 atau yang lebih baru.