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

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Apigee X belgelerini görüntülüyorsunuz.
Apigee Edge belgelerini inceleyin.

Destek kaydında ayrıntılı ve gerekli bilgilerin sağlanması, Google Cloud Apigee Destek ekibinin size hızlı ve verimli bir şekilde yanıt vermesini kolaylaştırır. Destek kaydınızda kritik ayrıntılar eksik olduğunda daha fazla bilgi istememiz gerekir. Bu da birkaç kez bilgi alışverişinde bulunmanızı gerektirebilir. Bu işlem daha fazla zaman alır ve sorunların çözülmesinde gecikmelere neden olabilir. Bu En İyi Uygulamalar Kılavuzu, teknik destek kaydınızı daha hızlı çözmek için ihtiyacımız olan bilgileri sağlar.

Sorunu açıklama

Sorunda olay ve olması beklenenlerin ayrıntılarıyla ilgili bilgilerin yanı sıra olayın ne zaman ve nasıl gerçekleştiğine dair bilgiler bulunmalıdır. İyi bir Apigee destek kaydı, Apigee ürünlerinin her biri için aşağıdaki temel bilgileri içermelidir:

Temel bilgiler Açıklama Herkese Açık Bulut İçin Apigee Edge Özel Bulut için Apigee Edge
Ürün Varsa, sürüm bilgileri de dahil olmak üzere sorunun gözlemlendiği belirli Apigee ürünü.
  • Sürüm
Sorun Ayrıntıları Varsa tam hata mesajı dahil olmak üzere sorunu özetleyen net ve ayrıntılı sorun açıklaması.
  • Hata mesajı
  • İzleme aracı çıktısı
  • Sorunu yeniden oluşturma adımları
  • API isteğini/komutunu tamamlayın
  • Hata mesajı
  • İzleme aracı çıktısı
  • Sorunu yeniden oluşturma adımları
  • API isteğini/komutunu tamamlayın
  • Bileşen teşhis günlükleri
Zaman Sorunun başladığı ve ne kadar sürdüğünü belirten belirli bir 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
Kurulum Sorunun görüldüğü yerle ilgili ayrıntılı bilgiler.
  • Kuruluş adı
  • Ortam adı
  • API proxy'si adı
  • Düzeltme
  • Ağ topolojisi
  • Başarısız Kenar bileşeni

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

Ürün

Farklı Apigee ürünleri mevcuttur (Public Cloud'da Apigee Edge ve Private Cloud'da Apigee Edge). Bu nedenle hangi ürünün sorun yaşadığıyla ilgili özel bilgilere ihtiyacımız vardır.

Aşağıdaki tabloda, YAPILACAKLAR sütunundaki tüm bilgileri ve YAPILMAYACAKLAR sütunundaki eksik bilgileri gösteren bazı örnekler bulunmaktadır:

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

API proxy'si dağıtılamadı

(Sorunu gördüğünüz Apigee ürününü tanımamız gerekir.)

Yükleme, Edge Private Cloud sürüm 4.50.00'de aşağıdaki hata nedeniyle başarısız oldu ...

Yükleme, Private Cloud kurulumumuzda başarısız oldu.

(Sürüm bilgileri eksik)

Sorun Ayrıntıları

Hata mesajı (varsa) ile gözlemlenen ve gerçek davranış da dahil olmak üzere, gözlemlenen sorunla ilgili kesin bilgi sağlayın.

Aşağıdaki tabloda, YAPILACAKLAR sütunundaki tüm bilgileri ve YAPILMAYACAKLAR sütunundaki eksik bilgileri gösteren bazı örnekler verilmiştir:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER

Yeni edgemicro proxy'si edgemicro_auth, aşağıdaki 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 hata mı yoksa beklenmeyen bir yanıt mı döndürdüğü net değildir.)

İstemcilerimiz, API proxy'sine istekte bulunurken aşağıdaki hata mesajıyla 500 hata alıyor:

{"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"}}}

İstemcilerimiz API proxy'sine istekte bulunurken 500 hata alıyor.

(Sadece 500 hatalarını iletmek, sorunu araştırmamız için yeterli bilgi sağlamaz. Gözlemlenen asıl hata mesajını ve hata kodunu bilmemiz gerekir.)

Saat

Zaman çok önemli bir bilgidir. Destek Mühendisinin bu sorunu ilk ne zaman fark ettiğinizi, ne kadar sürdüğünü ve sorunun hâlâ devam edip etmediğini bilmesi önemlidir.

Sorunu çözen Destek Mühendisi sizin saat diliminizde olmayabilir. Bu nedenle, zamanla ilgili göreli ifadeler sorunun teşhis edilmesini zorlaştırır. Bu nedenle, sorunun görüldüğü zamanla ilgili kesin zaman bilgisi vermek için tarih ve saat damgası için ISO 8601 biçimini kullanmanız önerilir.

Aşağıdaki tabloda, sorunun YAPILACAKLAR sütununda doğru zamanı ve süreyi, sorunun Yapılmaması Gerekenler sütununda ise ne zaman oluştuğuna dair belirsiz veya net olmayan bilgileri gösteren bazı örnekler verilmiştir:

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

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 gözlemlendiği de belirsiz.)

9.11.2020 15:30 IST ile 09.11.2020 18:10 IST arasında aşağıdaki API Proxy'lerinde yüksek gecikmeler var...

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

(Bu sorunun geçen hafta hangi gün ve süre boyunca görüldüğü belirsizdir.)

Kurulum

Sorunu tam olarak nerede gördüğünüzle ilgili ayrıntıları öğrenmemiz gerekiyor. Kullandığınız ürüne bağlı olarak aşağıdaki bilgilere ihtiyacımız olur:

  • Apigee Cloud kullanıyorsanız birden fazla kuruluşunuz olabilir. Bu nedenle, sorunu gözlemlediğiniz kuruluşu ve diğer ayrıntıları öğrenmemiz gerekir:
    • 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 topolojisinden birini kullanıyor olabilirsiniz. Bu nedenle, veri merkezi ve düğüm sayısı gibi ayrıntılar da dahil, hangi topolojiyi kullandığınızı bilmemiz gerekir.

Aşağıdaki tabloda, YAPILACAKLAR sütunundaki tüm bilgileri ve YAPILMAYACAKLAR sütunundaki eksik bilgileri gösteren bazı örnekler verilmiştir:

YAPILMASI GEREKENLER YAPILMAMASI GEREKENLER

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

Edge kurulum ayrıntıları:

Başarısız 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 arttı.

(Sorunun görüldüğü zamandan veya kurulumla ilgili herhangi bir ayrıntıdan dolayı, kullanılan ürünle ilgili herhangi bir bilgi vermez.)

Ek ağ geçidi düğümleri eklendikten sonra Edge Private Cloud 4.19.06 sürümünde Mesaj İşleyici başlatılamıyor.

Teşhis günlükleri:
Message Processor günlükleri eklendi.

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

Ek ağ geçidi düğümleri eklendikten sonra Edge Private Cloud 4.19.06 sürümünde Mesaj İşleyici başlatılamıyor.

(İleti İşlemci Günlükleri ve ağ topolojisi eksiktir.)

Faydalı yapılar

Bize sorunla ilgili eserler sağlamanız, tam olarak gözlemlediğiniz davranışı anlamamıza ve sorunla ilgili daha fazla bilgi edinmemize yardımcı olacağı için çözümü hızlandırır.

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

Tüm Apigee ürünlerinde ortak kullanılan yapılar

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

Yapı Açıklama
İzleme aracı çıkışı Trace aracı çıktısı, Apigee ürünleri üzerinden gelen API istekleri hakkında ayrıntılı bilgiler içerir. Bu; 4XX, 5XX gibi çalışma zamanı hataları ve gecikme sorunları için yararlıdır.
Ekran görüntüleri Ekran görüntüleri, gözlemlenen gerçek davranış veya hatanın bağlamını açıklamaya yardımcı olur. Bu, kullanıcı arayüzü veya Analytics'te olduğu gibi gözlemlenen hata ya da sorunlar için faydalıdır.
HAR (Http ARchive) HAR, kullanıcı arayüzü ile ilgili sorunları gidermek için HTTP oturum araçları tarafından yakalanan bir dosyadır. Bu veriler Chrome, Firefox veya Internet Explorer gibi tarayıcılar kullanılarak yakalanabilir.
tcpdumps tcpdump aracı, ağ üzerinden aktarılan veya alınan TCP/IP paketlerini yakalar. Bu; TLS el sıkışma hataları, 502 hataları ve gecikme sorunları gibi ağla ilgili tüm sorunlar için yararlıdır.

Private Cloud için Apigee Edge'deki ek yapılar

Private Cloud için Apigee Edge'de sorunların daha hızlı teşhisini kolaylaştıracak bazı ek yapılara ihtiyacımız olabilir.

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

Bu dosya, yükleme veya taşıma sorunlarıyla karşılaşıldığında tüm ayarların doğru olup olmadığını doğrulamak için yararlıdır.

Yığın dökümleri Yığın dökümleri, Java bellek işleminin anlık görüntüsüdür. Bu, belirli Edge bileşenlerinde yüksek bellek kullanımı veya OutOfMemory hataları görüldüğünde faydalıdır.
İş parçacığı dökümleri İş parçacığı dökümü, çalışan bir Java işlemindeki tüm iş parçacıklarının anlık görüntüsüdür.

Belirli Edge bileşenlerinde yüksek CPU veya Yük varsa bu faydalı olur.

Destek kaydı şablonları ve örnek destek kayıtları

Bu bölümde, bu belgede açıklanan en iyi uygulamalara dayalı olarak farklı ürünler için örnek şablonlar ve örnek durumlar sunulmuştur:

Herkese Açık Bulutta Apigee Edge

Şablon

Bu bölümde Herkese Açık Bulutta Apigee Edge için örnek şablon yer almaktadır.

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ı (varsa) ekleyin>

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

Sorunun 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 sorunu yeniden oluşturmak için gereken adımları sağlayın>

Teşhis bilgileri:

<Eklenen dosyaların listesi>

Örnek destek kaydı

Bu bölümde Apigee Cloud (Herkese Açık Bulutta Google Cloud/Apigee Edge üzerinde Apigee) için örnek bir örnek verilmiştir.

Sorun:

Herkese Açık Bulut kuruluşumuzda çok sayıda 503 Hizmet Kullanılamıyor hatasıyla karşılaşıyoruz. Sorunu inceleyip çözebilir veya çözümün nasıl yapılacağını bize bildirebilir misiniz?

Hata mesajı:

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

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

Sorunun bitiş zamanı (ISO 8601 biçimi): Sorun 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)

Özel Bulut için Apigee Edge

Şablon

Bu bölümde Private Cloud için Apigee Edge için örnek şablon verilmiştir.

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ı (varsa) ekleyin>

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

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

Edge Private Cloud kurulum bilgileri:

<Veri merkezleri ve düğümler dahil olmak üzere Private Cloud'unuzun kurulumunu açıklayan ağ topolojisini ekleyin>

Yeniden oluşturma adımları:

<Mümkün olduğunda sorunu yeniden oluşturmak için gereken adımları sağlayın>

Teşhis bilgileri

<Eklenen dosyaların listesi>

Örnek destek kaydı

Bu bölümde, Private Cloud için Apigee Edge'in örnek bir örneği verilmiştir.

Sorun:

Linux RHEL 7.6 üzerinde Edge Private Cloud 4.19.06'nın bir parçası olarak 10 numaralı düğüme Apigee Yönetim Sunucusu'nu yüklerken aşağıdaki hatayla karşılaşırız.

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): Cihaza

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

Edge Private Cloud kurulum bilgileri:

network-topology.png dosyasını ekledim

Yeniden oluşturma adımları:

Yukarıdaki hataya neden olan komut aşağıdaki gibidir:

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

Teşhis bilgileri:

Aşağıdaki dosyalar eklendi:

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