Antipattern: Postgres veritabanında Apigee'nin sahip olduğu şemaya özel bilgiler ekleme

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

Edge API Analytics, Apigee Edge tarafından sağlanan çok güçlü bir yerleşik özelliktir. API'ler üzerinden akan geniş bir veri yelpazesini toplar ve analiz eder. Elde edilen analiz verileri çok faydalı bilgiler sağlayabilir. Örneğin, API trafiği hacmi belirli bir süre içinde nasıl bir eğilim gösteriyor? En çok kullanılan API hangisi? Hangi API'lerde hata oranları yüksek?

Bu verilerin ve analizlerin düzenli olarak incelenmesi, mevcut kullanıma, işletmeye ve gelecekteki yatırım kararlarına göre API'lerin gelecekteki kapasite planlaması gibi uygun işlemlerin yapılmasını sağlayabilir.

Analytics verileri ve depolanması

API Analytics, aşağıdakiler gibi birçok farklı veri türünü yakalar:

  • API hakkında bilgiler (ör. istek URI'si, istemci IP adresi, yanıt durumu kodları)
  • API Proxy Performansı - Başarı/Başarısızlık oranı, İstek ve Yanıt İşleme Süresi vb.
  • Hedef sunucu performansı: Başarı/başarısızlık oranı, işleme süresi
  • Hata Bilgileri: Hata Sayısı, Hata Kodu, Başarısız Olan Politika, Apigee ve Hedef Sunucu Kaynaklı Hata Sayısı.
  • Diğer bilgiler: Geliştiriciler, geliştirici uygulamaları vb. tarafından yapılan isteklerin sayısı

Bu verilerin tümü, Apigee Edge tarafından bir Postgres veritabanında oluşturulan ve yönetilen bir analytics şemada saklanır.

Genellikle, standart bir Edge yüklemesinde Postgres aşağıdaki şemalara sahiptir:

analytics adlı şema, her kuruluş ve ortam için tüm analiz verilerini depolamak üzere Edge tarafından kullanılır. Para kazanma özelliği yüklüyse rkms şeması bulunur. Diğer şemalar Postgres'in iç işleyişi için tasarlanmıştır.

Apigee Edge, çalışma zamanında yeni olgu tablolarını dinamik olarak ekleyeceğinden analytics şeması değişmeye devam edecektir. Postgres sunucu bileşeni, olgu verilerini birleştirilmiş tablolarda toplar. Bu tablolar Edge kullanıcı arayüzüne yüklenir ve burada gösterilir.

Antipattern

SQL sorgularını kullanarak doğrudan Özel Bulut ortamlarındaki Postgres veritabanında Apigee'ye ait şemalara özel sütunlar, tablolar ve/veya görünümler eklemek, olumsuz sonuçlara yol açabileceğinden önerilmez.

Bunu ayrıntılı olarak açıklamak için bir örnek verelim.

Aşağıda gösterildiği gibi, analytics şeması altında account adlı özel bir tablonun oluşturulduğunu varsayalım:

Bir süre sonra, Apigee Edge'in daha düşük bir sürümden daha yüksek bir sürüme yükseltilmesi gerektiğini varsayalım. Private Cloud Apigee Edge'i yükseltmek, diğer birçok bileşenin yanı sıra Postgres'i de yükseltmeyi içerir. Postgres veritabanına eklenen özel sütunlar, tablolar veya görünümler varsa Postgres yükseltmesi, özel nesneler Apigee Edge tarafından oluşturulmadığı için bu nesnelere referans veren hatalarla başarısız olur. Bu nedenle, Apigee Edge yükseltme işlemi de başarısız olur ve tamamlanamaz.

Benzer şekilde, Postgres veritabanı dahil olmak üzere Edge bileşenlerinin yedeklenmesi ve geri yüklenmesinin yapıldığı Apigee Edge bakım etkinlikleri sırasında da hatalar oluşabilir.

Etki

  • Apigee Edge tarafından oluşturulmayan özel nesnelere referans veren hatalar nedeniyle Postgres bileşen yükseltmesi başarısız olduğundan Apigee Edge yükseltmesi tamamlanamıyor.
  • Apigee Analytics hizmeti bakımı (yedekleme/geri yükleme) gerçekleştirilirken tutarsızlıklar (ve hatalar) oluşuyor.

En İyi Uygulama

  • Doğrudan analytics gibi Apigee'ye ait şemalara sütun, tablo, görünüm, işlev ve prosedür biçiminde özel bilgiler eklemeyin.
  • Özel bilgilerin desteklenmesi gerekiyorsa analytics şemasına bir İstatistik Toplayıcı politikası kullanılarak sütun (alan) olarak eklenebilir.

Daha fazla bilgi