Google Cloud Apigee destek kayıtları için en iyi uygulamalar

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Apigee X belgelerini görüntülüyorsunuz.
. Görüntüle: Apigee Edge belgelerine göz atın.

Destek kaydında ayrıntılı ve gerekli bilgilerin sağlanması, Google Cloud Apigee Destek Ekibi size hızlı ve etkili şekilde yanıt verecek. Desteğiniz yoksa kritik ayrıntıların eksik olması durumunda, daha fazla bilgi istememiz iletişim kurmak önemlidir. Bu daha fazla zaman alır ve sorunların çözülmesinde gecikmelere neden olabilir. Bu En İyi Uygulamalar Kılavuzu, teknik sorunları çözmek için ihtiyaç duyduğumuz bilgileri destek kaydını hızlandırabilirsiniz.

Sorunu açıklamak

Bir sorunda, gerçekleşen olayın ve önceki işlemin ayrıntılarıyla ilgili bilgiler bulunmalıdır ne zaman ve nasıl gerçekleştiğini içerir. İyi bir Apigee destek kaydının her Apigee ürünü için aşağıdaki önemli bilgileri içermelidir:

Temel bilgiler Açıklama Herkese Açık Bulut için Apigee Edge Private Cloud için Apigee Edge
Ürün Sürümü de dahil olmak üzere sorunun gözlemlendiği belirli Apigee ürünü bilgileri de dahil etmeniz gerekir.
  • Sürüm
Sorun Ayrıntıları Sorunun açıklandığı, eksiksiz ve ayrıntılı bir sorun açıklaması hata mesajı görebilirsiniz.
  • Hata mesajı
  • Trace aracı çıkışı
  • Sorunu yeniden oluşturma adımları
  • API isteğini/komutunu tamamlayın
  • Hata mesajı
  • Trace aracı çıkışı
  • Sorunu yeniden oluşturma adımları
  • API isteğini/komutunu tamamlayın
  • Bileşen teşhis günlükleri
Zaman Sorunun başladığı zamanı ve ne kadar sürdüğünü gösteren zaman damgası
  • Sorunun meydana geldiği tarih, saat ve saat dilimi
  • Sorunun süresi
  • Sorunun meydana geldiği tarih, saat ve saat dilimi
  • Sorunun süresi
Ayarlar Sorunun gözlemlendiği yerle ilgili ayrıntılı bilgiler.
  • Kuruluş adı
  • Ortam adı
  • API proxy'si adı
  • Düzeltme
  • Ağ topolojisi
  • Failing Edge bileşeni

Aşağıdaki bölümlerde bu kavramlar daha ayrıntılı olarak açıklanmaktadır.

Ürün

Farklı Apigee ürünleri, Public Cloud'da Apigee Edge ve Apigee Edge on Private Cloud'u kullanıyor. Bu yüzden sorun yaşadığınız ürün hakkında bilgi verir.

Aşağıdaki tabloda eksiksiz bilgiler gösteren bazı örnekler verilmiştir sütununda YAPILACAKLAR sütununda ve YAPILMAYACAKLAR sütunu:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER
Herkese Açık Bulut kuruluşumuzda OAuth2 API proxy'si dağıtımı başarısız oldu ...

API proxy'si dağıtılamadı

(Sorunu gördüğünüz Apigee ürününü bilmemiz gerekir.)

Edge Private Cloud sürüm 4.50.00'da aşağıdaki hata nedeniyle yükleme işlemi başarısız oldu ...

Private Cloud kurulumumuzda yükleme işlemi başarısız oldu.

(Sürüm bilgileri eksik)

Sorun Ayrıntıları

Hata mesajı da dahil olmak üzere gözlemlenen sorunla ilgili tam bilgileri sağlayın (varsa) gözlemlenen davranışlar) ve beklenen ve gerçekleşen davranışları ifade eder.

Aşağıdaki tabloda Yapılması Gerekenler sütunundaki bilgilerin tamamını gösteren bazı örnekler verilmiştir. YAPILMAYACAKLAR sütununda yer alan eksik bilgiler varsa:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER

Yeni edgemicro proxy'si edgemicro_auth şu hatayla başarısız oluyor:

{"error":"missing_authorization","error_description":"Missing Authorization header"}

Bugün oluşturulan yeni edgemicro proxy'si çalışmıyor

(Proxy adı bilinmiyor. Proxy'nin bir hata mı yoksa herhangi bir hata mı döndürdüğü açık değil. beklenmedik bir yanıt.)

Müşterilerimiz, aşağıdaki hata mesajıyla birlikte 500 hata mesajı alıyor: API proxy'sine istek gönderme:

{"fault":{"faultstring":"Execution of JSReadResponse failed with error: Javascript runtime error: \"TypeError: Cannot read property \"content\" from undefined. (JSReadResponse.js:23)","detail":{"errorcode":"steps.javascript.ScriptExecutionFailed"}}}

Müşterilerimiz, API proxy'sine istekte bulunurken 500 Hataları alıyor.

(500 Hatalarını iletmek, işlemi tespit etmemiz için yeterli bilgi sağlamaz sorunu araştırın. Asıl hata mesajını ve gösterir.)

Saat

Zaman çok önemli bir bilgidir. Destek mühendisinin şunları bilmesi önemlidir: ne kadar sürdüğünü ve sorunun devam edip etmediğini kontrol etmenizi öneririz.

Sorunu çözen Destek Mühendisi sizin saat diliminizde olmayabilir, bu nedenle ilgili açıklamalar sorunu teşhis etmeyi zorlaştırır. Bu nedenle, Tarih ve saat için ISO 8601 biçimi damgasını kazımalıdır.

Aşağıdaki tabloda, YAPILACAKLAR sütununda; sorunun ne zaman olduğu ve YAPILMAYACAKLAR sütununda aşağıdaki sorun oluştu:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER
Dün 06.11.2020 17:30 (PDT) arasında çok sayıda 503s gözlemlendi ve 06.11.2020 17:35 PDT...

Dün saat 17:30'da 5 dakika boyunca çok sayıda 503s gözlemlendi.

(Belirtilen tarihi kullanmak zorundayız ve bu sorunun hangi saat diliminde olduğu da açık değil.) gözlemlendi.)

9.11.2020 15:30 IST itibarıyla aşağıdaki API Proxy'lerinde yüksek gecikmeler gözlemlendi. 9.11.2020 18:10 IST'ye...

Geçen hafta bazı API Proxy'lerinde yüksek gecikmeler gözlemlendi.

(Bu sorunun geçen hafta hangi gün ve sürede gözlemlendiği belirsizdir.)

Kurulum

Sorunu tam olarak nerede gördüğünüzle ilgili ayrıntıları bilmemiz gerekiyor. Seçtiğiniz düzenleme moduna aşağıdaki bilgilere ihtiyacımız var:

  • Apigee Cloud kullanıyorsanız birden fazla kuruluşunuz olabilir. Bu nedenle, sorunu gözlemlediğiniz kuruluşu ve diğer ayrıntıları öğrenin:
    • Kuruluş ve Ortam adları
    • API proxy adı ve düzeltme numaraları (API isteği hataları için)
  • Private Cloud kullanıyorsanız desteklenen birçok yükleme topolojilerini inceleyin. Bu yüzden, deneme sayısı, etkileşim sayısı ve benzeri ayrıntılar da dahil olmak üzere, veri merkezleri ve düğümler var.

Aşağıdaki tabloda Yapılması Gerekenler sütunundaki bilgilerin tamamını gösteren bazı örnekler verilmiştir. YAPILMAYACAKLAR sütununda yer alan eksik bilgiler varsa:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER

401 Edge Public Cloud'da 06.11.2020 09:30 (CST) tarihinden bu yana hata sayısı arttı.

Edge kurulum ayrıntıları:

Başarısız olan API'nin ayrıntıları aşağıda verilmiştir:
Kuruluş adları: myorg
Ortam adları: test
API proxy adları: myproxy
Düzeltme numaraları: 3

Hata:

{"fault":{"faultstring":"Failed to resolve API Key variable request.header.X-APP-API_KEY","detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

401 hata sayısı arttı.

(Sorunun ne zaman gerçekleştiğine bağlı olarak, kullanılan ürünle ilgili veya kurulumla ilgili ayrıntıları yazın.)

Şu süreden sonra Edge Private Cloud 4.19.06 sürümünde Mesaj İşleyici başlatılamıyor ek ağ geçidi düğümleri eklenmesi.

Teşhis günlükleri:
Mesaj İşleyici günlükleri eklendi.

Ağ topolojisi: Ek düğümleri içeren
dosyası eklendinetwork-topology.png.

Şu süreden sonra Edge Private Cloud 4.19.06 sürümünde Mesaj İşleyici başlatılamıyor ek ağ geçidi düğümleri eklenmesi.

(İleti İşleyici Günlükleri ve ağ topolojisi eksik.)

Faydalı yapılar

Sorunla ilgili eserleri bize göndermeniz çözümü hızlandıracaktır. gözlemlediğiniz davranışın ne olduğunu anlayabilir ve bununla ilgili daha fazla bilgi edinebilirsiniz.

Bu bölümde tüm Apigee ürünlerinde faydalı olan bazı faydalı yapılar açıklanmaktadır:

Tüm Apigee ürünleri için ortak yapılar

Şu yapılar tüm Apigee ürünleri için kullanışlıdır: Public Cloud'da Apigee Edge ve Private Cloud'da Apigee Edge:

Yapı Açıklama
Trace aracı çıkışı Trace aracı çıkışı, üzerinden gelen API istekleri hakkında ayrıntılı bilgi Apigee ürünleri. Bu, 4XX, 5XX ve gecikme sorunları.
Ekran görüntüleri Ekran görüntüleri, gözlemlenen gerçek davranış veya hatanın bağlamını vermeye yardımcı olur. Evet , kullanıcı arayüzünde veya Analytics'te olduğu gibi, gözlemlenen tüm hatalar ya da sorunlar için yararlı olabilir.
HAR (Http ARchive) HAR, kullanıcı arayüzüyle ilgili sorunlarda hata ayıklamak için HTTP oturum araçları tarafından yakalanan bir dosyadır. Bu kayıt, Chrome, Firefox veya Internet Explorer gibi tarayıcılar kullanılarak yakalanabilir.
tcpdumps tcpdump aracı, ağ. Bu, TLS el sıkışma hataları gibi ağla ilgili sorunlar, 502 hata, gecikme sorunları vb.

Private Cloud için Apigee Edge'e yönelik ek yapılar

Private Cloud için Apigee Edge'de daha hızlı kolaylaştıracak bazı ek yapılara ihtiyaç duyabiliriz. yardımcı olur.

Yapı Açıklama
Ağ topolojisi Aşağıdakiler dahil olmak üzere Private Cloud kurulumunuzu açıklayan Edge yükleme topolojisi diyagramı her düğümde yüklü tüm veri merkezleri, düğümler ve bileşenler.
Edge bileşeni teşhis günlükleri Message gibi belirli Apigee Edge bileşeniyle ilgili teşhis günlükleri İşlemci, Yönlendirici veya Cassandra.
Yükleme Yapılandırma Dosyası Apigee Edge'i yüklerken veya yükseltirken kullanılan sessiz yapılandırma dosyası.

Bu dosya, şu durumlarda tüm ayarların doğru olduğunu doğrulamak açısından yararlıdır: yükleme veya taşıma sorunlarıyla karşılaşıldığından.

Yığın dökümleri Yığın dökümleri, Java bellek işleminin anlık görüntüsüdür. Bu işlem, hafıza alanı yüksekse Belirli Edge bileşenlerinde kullanım veya OutOfMemory hataları görülür.
İş parçacığı dökümleri İş parçacığı dökümü, çalışan bir Java işleminin tüm iş parçacıklarının anlık görüntüsüdür.

Bu, belirli Edge bileşenlerinde yüksek CPU veya Yük gözlemlendiği durumlarda faydalıdır.

Destek kaydı şablonları ve örnek durumlar

Bu bölümde, duruma göre farklı ürünler için destek kaydı şablonları ve örnek bu dokümanda açıklanan en iyi uygulamalar:

Herkese Açık Bulutta Apigee Edge

Şablon

Bu bölümde şu proje için örnek şablon sunulmaktadır: Herkese Açık Bulutta Apigee Edge.

Sorun:

<Sorunun veya sizin tarafınızda gözlemlenen davranışın ayrıntılı bir açıklamasını sağlayın. Varsa ürün adını ve sürümünü ekleyin.>

Hata mesajı:

<Gözlemlenen hata mesajının tamamını ekleyin (varsa)>

Sorun başlangıç zamanı (ISO 8601 biçimi):

Sorun bitiş zamanı (ISO 8601 biçimi):

Apigee kurulum ayrıntıları:
Kuruluş adları:
Ortam adları:
API proxy adları:
Düzeltme numaraları:

Yeniden oluşturma adımları:

<Mümkün olduğunda sorunun yeniden üretilmesi için gereken adımları sağlayın>

Teşhis bilgileri:

<Eklenen dosyaların listesi>

Örnek olay

Bu bölümde Apigee Cloud (Google'da Apigee) için örnek bir olay sunulmaktadır Genel Bulut'ta Cloud/Apigee Edge).

Sorun:

Herkese Açık Bulutumuzda çok sayıda 503 Hizmet Kullanılamıyor hatası görüyoruz org. Lütfen sorunu inceleyip nasıl çözeceğimizi bize bildirebilir misiniz?

Hata mesajı:

{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}

Problem başlangıç zamanı (ISO 8601 biçimi): 2020-10-04 06:30 IST

Sorun bitiş zamanı (ISO 8601 biçimi): Sorun hâlâ devam ediyor.

Apigee Cloud kurulum ayrıntıları:
Kuruluş adları: myorg
Ortam adları: dev
API proxy adları: myproxy
Düzeltme numaraları: 3

Yeniden oluşturma adımları:

Sorunu yeniden oluşturmak için aşağıdaki curl komutunu çalıştırın:

curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'

Teşhis bilgileri:

İzleme aracı çıkışı (trace-503.xml)

Private Cloud için Apigee Edge

Şablon

Bu bölümde şu proje için örnek şablon sunulmaktadır: Apigee Edge for Private Cloud'u seçin.

Sorun:

<Sorunun veya sizin tarafınızda gözlemlenen davranışın ayrıntılı bir açıklamasını sağlayın. Varsa ürün adını ve sürümünü ekleyin.>

Hata mesajı:

<Gözlemlenen hata mesajının tamamını ekleyin (varsa)>

Sorun başlangıç zamanı (ISO 8601 biçimi):

Sorun bitiş zamanı (ISO 8601 biçimi):

Edge Private Cloud kurulum ayrıntıları:

<Private Cloud kurulumunuzu aşağıdaki gibi açıklayan ağ topolojisini ekleyin: veri merkezleri ve düğümler>

Yeniden oluşturma adımları:

<Mümkün olduğunda sorunun yeniden üretilmesi için gereken adımları sağlayın>

Teşhis bilgileri

<Eklenen dosyaların listesi>

Örnek olay

Bu bölümde, Private Cloud için Apigee Edge'in örnek bir durumu sunulmaktadır.

Sorun:

Apigee Yönetim Sunucusu'nu 10 numaralı Düğüm'e Linux RHEL 7.6'da Edge Private Cloud 4.19.06 yüklüyse hata oluştu.

Hata Mesajı:

<snipped as the output is too long>
Checking for management-server uuid ................................................
Unable to get uuid for management-server.
Error: setup.sh: /opt/apigee/apigee-service/bin/apigee-service exited with unexpected status 1

Sorun başlangıç zamanı (ISO 8601 biçimi): Yüklediğimiz her öğe veya

Sorun bitiş zamanı (ISO 8601 biçimi): Geçerli değil

Edge Private Cloud kurulum ayrıntıları:

network-topology.png dosyasını ekleyin.

Yeniden oluşturma adımları:

Yukarıda hataya neden olan komut aşağıda verilmiştir:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt

Teşhis bilgileri:

Şu dosyalar eklendi:

  • output.txt hata mesajı da dahil olmak üzere yukarıdaki komutun tam çıkışını içerir
  • Yönetim sunucusu günlükleri
  • Yapılandırma dosyası NonProdConfig.txt