Log adalah cara yang baik untuk memecahkan masalah terkait penginstalan hybrid Apigee. Lihat Logging untuk mengetahui detailnya.
Anda dapat melihat log sinkronisasi Apigee menggunakan perintahkubectl logs
. Contoh:
kubectl logs -n apigee apigee-synchronizer-apigee-example-test
Entri log penyinkron
Tabel berikut menjelaskan kolom yang akan Anda lihat di File logSynchronizer.
Kolom | Menunjukkan |
---|---|
org: |
Nama organisasi |
env: |
Nama lingkungan |
target: |
Jalur entity yang diwakili oleh entri log |
action: |
Tindakan SYNC=Tindakan sinkronisasi upstream
replikasi=Tindakan mereplikasi/mendownload |
context-id: |
Versi kontrak jika berlaku |
Contoh:
2019-02-05 00:00:59,098 org:hybrid env:test target: action:SYNC context-id: mode: Apigee-Timer-5 INFO CONFIG-CHANGE - SyncContext.syncUpStream() : Upstream sync started with https://apigee.googleapis.com
Memahami Log Sinkronisasi
Jika Anda perlu memecahkan masalah terkait Synchronizer, lihat file log. Tabel berikut dapat membantu Anda memecahkan masalah error yang mungkin terlihat di Log Sinkronisasi. Lihat juga Logging.
Entri log | Apa maksudnya |
---|---|
org:test env:dev target: action:SYNC context-id: mode:
Apigee-Timer-0 INFO CONFIG-CHANGE - SyncContext.syncUpStream() :
Upstream sync
started with http://localhost:8080 |
Polling upstream dimulai untuk organisasi dan lingkungan dan diberi URL bidang pengelolaan |
2019-01-21 16:58:02,275 org:test env:qa target:
action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract poll returned 200 |
Kontrak berhasil diterima |
2019-01-21 16:58:02,536 org:test env:dev target:
action:SYNC context-id: mode: Apigee-Timer-0 INFO CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Received a new
contract version 20190121.090851.339 |
Versi kontrak diterima |
2019-01-21 17:58:56,530 org:test env:qa
target:/organizations/test/environments/qa action:REPLICATE
context-id:20190121.090859.699 mode: Apigee-Timer-1 INFO
CONFIG-CHANGE - ConfigReplicator.startReplication() :
Replication
started |
Menunjukkan awal Replikasi. Kolom MDC menunjukkan detail tentang apa yang sedang direplikasi |
2019-01-21 17:58:56,654 org:test env:qa
target:/organizations/test/environments/qa/resourcefiles/js/JavaScriptCallout.js
action:REPLICATE context-id:20190121.090859.699 mode:
Apigee-Timer-1 INFO CONFIG-CHANGE -
ConfigReplicator.startReplication() : Replication
complete |
Menunjukkan Replikasi selesai. Kolom MDC menunjukkan detail tentang apa yang sedang direplikasi |
2019-01-21 17:58:56,654 org:test env:qa
target:/organizations/test/environments/qa action:REPLICATE
context-id:20190121.090859.699 mode: Apigee-Timer-1
ERROR
CONFIG-CHANGE - ConfigReplicator.startReplication() : Replication
failed |
Menunjukkan error replikasi |
2019-01-21 17:59:00,246 org:test env:qa target:
action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE -
SyncContext.syncUpStream() : Upstream sync finished in 4
seconds |
Menunjukkan akhir siklus sinkronisasi dan juga memberikan waktu yang dibutuhkan untuk sinkronisasi |
2019-01-21 18:00:00,249 org:test env:dev target:
action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract
poll returned 304 |
Menunjukkan bahwa kontrak yang lebih baru tidak tersedia |
2019-01-21 18:21:39,128 org:test env:qa target:
action:SYNC context-id: mode: Apigee-Timer-1 ERROR CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract
poll returned error 0 |
Menunjukkan bahwa bidang pengelolaan tidak dapat dijangkau |
2019-01-21 18:21:39,128 org:test env:qa target:
action:SYNC context-id: mode: Apigee-Timer-1 ERROR CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract
poll returned error 404 |
Menunjukkan bahwa bidang pengelolaan menampilkan respons 404 untuk kontrak |
2019-01-21 18:22:39,217 org:test1 env:dev target:
action:SYNC context-id: mode: Apigee-Timer-2 ERROR CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract
poll returned error 403 |
Menunjukkan bahwa lingkungan yang disurvei tidak mendukung hybrid |
2019-01-21 18:22:39,217 org:test1 env:dev target:
action:SYNC context-id: mode: Apigee-Timer-2 ERROR CONFIG-CHANGE -
ManagementServerBasedReplicationContext.getContract() :
Upstream contract
poll returned error 401 |
Kredensial yang diberikan memiliki beberapa masalah |
Pemecahan masalah error
Log adalah cara yang baik untuk memecahkan masalah terkait penginstalan. Lihat Logging untuk mengetahui detailnya.
Sinkronisasi gagal dimulai
Berikut adalah beberapa kesalahan dan cara perbaikannya dijelaskan. Setiap pesan error ini dimulai dengan ErrorCode jenis sync.xxxxx. Di bawah ini adalah kemungkinan kode error
sync.NullOrEmptyConfig
Pesan: Null atau konfigurasi kosong yang disediakan melalui com.apigee.sync.config
Alasan: Anda akan melihat pesan error ini jika properti konfigurasi Synchronizer tidak diberikan dengan benar.
Solusi: Pastikan semua properti konfigurasi diisi dengan nilai yang sesuai.
sync.ConfigFileNotFound
Alasan: Sinkronisasir ditetapkan untuk membaca properti konfigurasinya dari sebuah file, tetapi file tersebut tidak dapat dimuat
Solusi: memastikan file tersedia dan dapat diakses selama booting Synchronizer
sync.IncorrectSettings
Alasan: Satu atau beberapa properti konfigurasi yang diperlukan tidak ada di konfigurasi Synchronizer atau nilainya di luar rentang yang diharapkan. Error tersebut harus memiliki detail selengkapnya tentang properti yang menyebabkan masalah. Error ini terintegrasi ke dalam parser untuk memastikan bahwa error dan setelan ditemukan bahkan sebelum layanan dimulai.
Tabel berikut mencantumkan beberapa kemungkinan error IncorrectSettings:
Error | Apa yang salah |
---|---|
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/controlPlane/retries numeric
instance is greater than the required maximum (maximum: 3, found:
20) |
Nilai yang dimasukkan ke kolom percobaan ulang di bagian controlPlane melebihi batas yang diizinkan |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/controlPlane/connectionTimeout
numeric instance is lower than the required minimum (minimum: 10,
found: 1) |
Nilai yang diberikan ke kolom connectionTimeout di bagian controlPlane lebih rendah dari yang diizinkan |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/controlPlane object has
missing required properties
([\"contractProvider\"]) |
Bagian controlPlane tidak memiliki kolom wajib ContractProvider |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/controlPlane/contractProvider
string \"http://\\uapi.apigee.com\" is not a valid
URI |
URI penyedia kontrak bukan URI yang valid |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/environments array is too
short: must have at least 1 elements but instance has 0
elements |
Array lingkungan harus memiliki setidaknya satu lingkungan |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/environments/0 object has
missing required properties
([\"environmentName\"]) |
Lingkungan di indeks 0 tidak memiliki kolom wajib environmentName |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/environments/0 object has
missing required properties
([\"organizationName\"]) |
Lingkungan di indeks 0 tidak memiliki kolom wajib organizationName |
configuration.json.IncorrectSettings:
[com.apigee.sync.config.json] Error:/environments/0/pollInterval
numeric instance is lower than the required minimum (minimum: 60,
found: 6) |
Lingkungan pada indeks 0 memiliki interval polling yang berada di bawah batas yang diizinkan yaitu 60 |
Solusi: Perbaiki setelan untuk menyertakan blok yang diperlukan
sync.ReplicationRootDoesNotExist
Alasan: Sinkronisasir dilengkapi dengan root replikasi yang tidak ada
Solusi: pastikan folder root yang disediakan ada dan dapat ditulis
sync.ReadOnlyReplicationRoot
Alasan: Sinkronisasir dilengkapi dengan root replikasi yang tidak memiliki izin tulis
Solusi: pastikan folder root yang disediakan ada dan dapat ditulis
sync.ReplicationRootNotADir
Alasan: Sinkronisasir dilengkapi dengan root replikasi yang mungkin merupakan file
Solusi: pastikan folder root yang disediakan ada dan dapat ditulis
sync.InvalidControlPlaneURL
Alasan: Sinkronisasir memiliki URL konfigurasi yang kosong
Solusi: Pastikan folder root yang disediakan ada dan dapat ditulis
sync.InvalidControlPlaneSubscriptionURL
Alasan: Sinkronisasir mendapatkan URL konfigurasi yang salah, tidak lengkap, atau kosong untuk pembuatan langganan.
Solusi: Perbaiki URL ke URL konfigurasi yang valid untuk pembuatan langganan pub/sub guna menangani sinyal dari bidang kontrol.
sync.InvalidControlPlaneUnsubscriptionURL
Alasan: Sinkronisasir mendapatkan URL konfigurasi yang salah, tidak lengkap, atau kosong untuk penghapusan langganan.
Solusi: Perbaiki URL ke URL konfigurasi yang valid untuk penghapusan langganan pub/sub guna menangani sinyal dari bidang kontrol.
sync.CannotCreateEnvironmentFolder
Alasan: Synchronizer mencoba membuat folder untuk mereplikasi qa lingkungan, tetapi tidak dapat membuat folder yang diperlukan
Solusi: memastikan root replikasi tidak memiliki jalur yang bertentangan dengan nama yang sama, yaitu file hanya baca
sync.DuplicateEnvironmentEntries
Alasan: Lingkungan yang sama telah ditambahkan beberapa kali dalam konfigurasi.
Upaya Hukum: Setiap lingkungan hanya dapat ditentukan satu kali.
sync.DiskExceedsAllowedCapacity
Alasan: Disk penyimpanan yang disediakan sudah mencapai batas kapasitas yang disediakan melalui properti konfigurasi.
Solusi: Pastikan ada kapasitas disk yang cukup atau periksa apakah setelan penyimpanan dapat disesuaikan untuk memungkinkan lebih banyak ruang disk.
sync.OwnershipClaimFailed
Alasan: Sinkronisasir mencoba mengklaim kepemilikan pada folder lingkungan, tetapi gagal
Upaya Hukum: setiap Synchronizer akan mencoba memastikan terlebih dahulu bahwa ia adalah satu-satunya penulis untuk sistem file. Error tersebut menunjukkan jalur dan alasan kegagalan. Mengatasi akar masalah
Error sinkronisasi selama runtime
Error Sinkronisasi berikut dapat terjadi selama runtime.
sync.replicators.PollReturnedError
Pesan terkait akan menyertakan status upstream. Berikut adalah status error
status 0
Alasan: Menunjukkan masalah konektivitas. Bidang manajemen tidak dapat dijangkau
Upaya Hukum: Pastikan detail bidang pengelolaan sudah benar dan API kontrak dapat dijangkau
status 404
Alasan: Kemungkinan besar nama org/env tidak ditemukan di server
Upaya Hukum: Pastikan detail bidang pengelolaan sudah benar dan API kontrak dapat dijangkau
status 401
Alasan: Kemungkinan besar kredensial yang diberikan tidak memiliki hak istimewa admin org.
Upaya Hukum: Pastikan kredensial bidang pengelolaan sudah benar dan API kontrak dapat dijangkau
status 403
Alasan: Menunjukkan bahwa lingkungan yang disurvei tidak disiapkan sebagai lingkungan hybrid
Upaya Hukum: Pastikan organisasi memiliki tanda yang diperlukan "features.hybrid.enabled=true"
sync.OwnershipClaimedByOther
Alasan: Selama operasi Synchronizer menemukan bahwa root file sedang diakses oleh instance Synchronizer lain. (Ini dapat terjadi jika sistem file dibagikan antar-Sinkronisasi.)
Solusi: Atasi masalah root untuk memastikan tidak ada dua instance Synchronizer yang memiliki sistem file yang sama. Sinkronisasi akan menonaktifkan dirinya sendiri dan berada dalam posisi yang tidak dapat dipulihkan di sini. Tindakan ini juga memastikan Sinkronisasi lain yang mengakses root file yang sama akan diberi tahu melalui file kepemilikannya
sync.DiskExceedsAllowedCapacity
Alasan: Selama operasi berlangsung, Synchronizer menyadari bahwa jumlah disk telah melebihi batas yang diizinkan.
Solusi: Pada tahap ini, Synchronizer akan membatalkan download dan mencoba operasi pembersihan file yang sudah tidak berlaku. Namun, ini dapat menjadi kondisi berulang dan satu-satunya cara untuk memulihkan sepenuhnya adalah dengan memastikan Synchronizer memiliki memori disk yang cukup untuk beroperasi.
Mendiagnosis kegagalan download kontrak
Jika Anda melihat "polling kontrak upstream" dalam pesan error, coba panggil Contract API dan periksa detailnya, dengan nama pengguna adalah nama pengguna Apigee Anda (alamat email Anda). Kontrak ini mewakili seluruh kumpulan data yang didownload oleh Sinkronkanr dari bidang pengelolaan.
Tidak ada residensi data
curl https://apigee.googleapis.com/v1/organizations/org/environments/env/contracts/1.0 -u username
Residensi Data
curl https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/org/environments/env/contracts/1.0 -u username