Özel raporlar oluşturma ve yönetme

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

Özel raporlar, belirli API metriklerini ayrıntılı olarak incelemenizi ve tam olarak görmek istediğiniz verileri görüntülemenizi sağlar. Edge'de yerleşik olarak bulunan metrics ve boyutlardan herhangi birini kullanarak özel rapor oluşturabilirsiniz. Ayrıca kullanıcı veya ürün kimliği, fiyat, REST işlemi, hedef sürüm, hedef URL ve mesaj uzunluğu gibi özel metrikleri toplamak için API proxy'lerinize İstatistiklerCollector politikasını ekleyebilirsiniz.

Videolar

Özel raporlar hakkında daha fazla bilgi edinmek için aşağıdaki videoları izleyin.

Video Açıklama
Kullanıcı arayüzünü kullanarak özel raporlar oluşturma Edge kullanıcı arayüzünü kullanarak özel raporlar oluşturmayı öğrenin.
Özel raporlara genel bakış Özel raporların kullanımına genel bakışı inceleyin.
API gecikmesini izleme Özel raporları kullanarak API gecikmesini nasıl izleyebileceğinizi öğrenin.
API hata yanıtlarını izleme Özel raporlar kullanarak API hata yanıtlarını izleyin.

Özel raporlar hakkında

Özel rapor oluştururken görmek istediğiniz verileri (metrikler) seçer, verileri anlamlı şekillerde (boyutlar) gruplandırır ve döndürülen verileri isteğe bağlı olarak verilerin belirli özelliklerine (filtreleri) göre sınırlandırırsınız.

Özel raporda görüntülenen grafik türünü sütun veya çizgi grafik olarak da ayarlayabilirsiniz. Aşağıdaki resimlerde, API proxy boyutuna göre gruplandırılmış saniye başına işlem sayısı metriğinin grafik örnekleri gösterilmektedir:

  • Sütun - Her API proxy'si farklı bir sütunla temsil edilir:

    Özel sütun grafik

  • Satır: Her API farklı bir satır olacaktır:

    Özel çizgi grafik

Metrikleri ve boyutları ayarlama

Özel raporunuz için seçtiğiniz metrics, ölçmeye çalıştığınız verileri belirtir. Genel metrikler arasında şunlar bulunur:
  • Saniye başına işlem sayısı
  • Yanıt süresi
  • Politika hataları

Bazı metrikler, metriğe göre çalışacak bir toplama işlevi ayarlamanıza olanak tanır. Örneğin, yanıt süresi metriğiyle aşağıdaki toplama işlevlerini kullanabilirsiniz:

  • avg: Ortalama yanıt süresini döndürür.
  • min: Minimum yanıt süresini döndürür.
  • max: Maksimum yanıt süresini döndürür.
  • sum: Tüm yanıt sürelerinin toplamını döndürür.

Tüm metrikler toplama işlevlerinin hepsini desteklemez. metrics ile ilgili dokümanlar, metrik adını ve metrik tarafından desteklenen işlevi (sum, avg, min, max) belirten bir tablo içerir.

Boyut, metrik verilerinin nasıl gruplandırılacağını belirtir. Örneğin, yanıt süresi metriğini gösteren özel bir rapor oluşturmak istiyorsunuz. Metrik verilerini API ürününe, API proxy'sine veya geliştirici e-posta adresine göre gruplandırmak için boyutları kullanabilirsiniz. Böylece şu veriler elde edilir:

  • API ürünü başına yanıt süresi
  • API proxy'si başına yanıt süresi
  • Geliştirici e-postası başına yanıt süresi

Boyutun özel raporun grafiğinde görüntülenme şekli grafik türüne bağlıdır:

  • Sütun: Her sütun, farklı bir boyut değerine karşılık gelir.
  • Çizgi: Grafikteki her çizgi farklı bir boyut değerine karşılık gelir ve x ekseni zamanı temsil eder.

Özel metrikler ve boyutlar oluşturma

Kullanıcı veya ürün kimliği, fiyat, REST işlemi, hedef sürüm, hedef URL ve mesaj uzunluğu gibi özel analiz verilerini toplamak için API proxy'lerinize PercentageCollector politikasını ekleyin. Veriler Apigee tarafından önceden tanımlanmış akış değişkenlerinden, istek başlıklarından, sorgu parametrelerinden veya sizin tanımladığınız özel değişkenlerden gelebilir. Veriler toplandıktan sonra, bu verileri görüntülemek için özel bir rapor oluşturabilirsiniz.

Özel analiz verilerini özel bir raporda görüntüleme şekliniz, raporun veri türüne bağlıdır:

  • Dize türündeki veriler için, özel bir raporda boyut olarak istatistiksel verilere başvurun.
  • Sayısal veri türleri (tam sayı/kayan/uzun/çift) için özel bir rapordaki istatistiksel verilere boyut veya metrik olarak referansta bulunun.

Özel analiz verilerinin toplanmasıyla ilgili örnekler için StatsCollector politikasına bakın.

Filtreleri ayarlama

Filtre, döndürülecek metrik verileri için belirli özellikler belirleyerek özel raporda görüntülenen metrik verilerini sınırlandırmanıza olanak tanır. Örneğin, yalnızca belirli bir değerden daha uzun bir yanıt süresi veya yalnızca belirli bir ada sahip API proxy'si için metrik verilerini görmek üzere bir filtre oluşturabilirsiniz.

Filtreler; eq, ne, gt, lt ve diğer operatörler gibi operatörler kullanarak karmaşık filtreler oluşturmanıza olanak tanıyan koşullu bir söz dizimi kullanır.

Özel rapor örnekleri

En basit özel rapor türünde tek bir metrik ve tek bir boyut belirtirsiniz. Örneğin, aşağıdaki ayarlarla özel bir rapor tanımlarsınız:

  • type = Sütun
  • metrik = Saniye başına ortalama işlem sayısı
  • boyut = API Proxy'si

Özel rapor, API proxy boyutuna göre gruplandırılmış "Saniye başına ortalama işlem sayısı" metrik verilerinin yer aldığı bir sütun grafik içerir:

Özel rapor TTP'leri

Ortalamaları gösteren metrikler, yukarıdaki grafikte görebileceğiniz gibi grafiğin sağ tarafında bir Dağılımı göster bağlantısı da gösterir. Dağılım kutusunu açmak için bağlantının üzerine gelin. Dağılım kutusu, verilerinizin temel eğilimlerini gösterir.

Dağılım kutusu

Özel bir rapora birden çok metrik ekleyebilirsiniz. Örneğin, iki metrik içeren özel bir rapor tanımlarsınız:

  • type = Sütun
  • metrik = Saniye başına ortalama işlem sayısı
  • metrik = Politika Hataları
  • boyut = API Proxy'si

Özel rapor, her metrik için ayrı bir grafik içerir:

Özel rapor iki metrik

Özel bir rapora birden çok boyut ekleyebilirsiniz. Örneğin, iki metrik ve iki boyut içeren aşağıdaki ayarlara sahip bir özel rapor tanımlarsınız:

  • type = Sütun
  • metrik = Saniye başına ortalama işlem sayısı
  • metrik = Politika hataları
  • boyut = API Proxy'si
  • boyut = İstek fiili

Grafik başlangıçta metrikleri, özel raporu oluşturduğunuzda belirtilen ilk boyut olan Proxy'ye göre gruplandırır:

Özel rapor iki boyutu

Daha sonra, tek bir proxy seçmek için ilk boyuta karşılık gelen Proxy açılır listesini kullanabilirsiniz. Güncellenen grafikte, seçili proxy için istek fiiline göre metrikler gösterilmektedir:

Özel raporda iki boyut ayrıntılı incelemesi

Özel rapora daha fazla boyut ekledikçe kullanıcı arayüzü, raporu her boyuta göre ayrıntılı olarak incelemenizi sağlayacak şekilde ayarlanır.

Tüm özel raporları görüntüleme

Aşağıda açıklanan özel raporlar sayfasına erişin.

Edge

Edge kullanıcı arayüzünü kullanarak özel raporlar sayfasına erişmek için:

  1. https://apigee.com/edge adresinde oturum açın.
  2. Analiz > Özel Raporlar > Raporlar'ı seçin.

Klasik Edge (Private Cloud)

Klasik Edge kullanıcı arayüzünü kullanarak özel raporlar sayfasına erişmek için:

  1. http://ms-ip:9000 üzerinde oturum açın. Burada ms-ip, Yönetim Sunucusu düğümünün IP adresi veya DNS adıdır.
  2. Analytics > Raporlar'ı seçin.

Özel raporlar sayfasında, kuruluşunuz için oluşturulmuş tüm özel raporlar aşağıdaki şekilde gösterildiği gibi görüntülenir:

Özel raporlar kontrol paneli

Şekilde vurgulandığı gibi, özel raporlar sayfasında aşağıdakileri yapabilirsiniz:

  • Tüm özel raporların listesini görüntüleyin.
  • Özel rapor ekleyin.
  • Listede adını tıklayarak özel bir rapor çalıştırın. Rapor, varsayılan olarak son bir saatte toplanan veriler kullanılarak çalıştırılır ve veriler özel rapor kontrol panelinde gösterilir. Özel raporlar kontrol panelini keşfetme başlıklı makaleyi inceleyin.
  • İlgili bir dizenin tamamını veya bir kısmını arama kutusuna girerek özel raporlar listesinde arama yapın; görüntülenen tüm alanlarda bu dize aranır.
  • Özel bir raporu silin.

Özel rapor kontrol panelini keşfetme

Özel rapor kontrol paneli, belirtilen metriğin sütun veya çizgi grafiği de dahil olmak üzere özel raporunuzun belirli bir zaman aralığına ait sonuçlarını görüntüler:

Özel raporlar kontrol paneli

Özel rapor kontrol paneliyle yapabilecekleriniz:

  • Seçili zaman aralığı için özel rapor verilerini görüntüleyin.
  • Özel rapor verilerini görüntülemek istediğiniz Ortam'ı seçin.
  • Özel rapor verilerini filtrelemek için belirli bir boyut seçin. Bu alan yalnızca rapora birden fazla boyut belirttiğinizde etkinleştirilir.
  • Grafik veya Tablo görünümünü seçin.

  • Bir metriği, ilişkili metriğin tablo satırındaki simgesini seçerek analiz edin. Anormallikleri görüntüleyin ve bunu önceki bir dönemle veya diğer metriklerle karşılaştırın.
  • Özel raporu çalıştırmak için tıklayıp zaman aralığını ayarlayın.
  • Özel raporu CSV dosyası olarak indirin. Dosya şu şekilde adlandırılır: metric.csv. Örneğin: Average_of_total_response_time.csv.
  • Özel raporu düzenleyin.

Metrik analizi kontrol panelini keşfedin

Özet tablosu satırında simgesini seçerseniz aşağıdaki grafikler görünür (üst grafik yalnızca raporu birden fazla metrik kullanacak şekilde yapılandırdıysanız görünür):

Metriği analiz et

Bu grafikler aşağıdaki bilgileri gösterir:

  • Karşılaştır: Raporu birden fazla metrik kullanacak şekilde yapılandırdıysanız metrikleri birbiriyle karşılaştırın.
  • Önceki dönemle karşılaştır: Önceki döneme ait metriği görüntüleyin. Örneğin, özel raporu son 24 saat için görüntülemeyi seçtiyseniz bu grafikte önceki 24 saatlik döneme ait veriler gösterilir.
  • Anormallikleri analiz et: Rapor verilerinde aykırı olan tüm veri noktalarını görüntüler. Bu grafikte iki değer gösterilir:

    • Çizgi olarak gösterilen metriğin hareketli ortalaması. Çizgi üzerindeki belirli bir nokta için hareketli ortalama değeri, söz konusu zamandaki metrik değerinin ve önceki iki veri noktasının metriğinin değerleri ortalaması olarak hesaplanır.
    • Grafiğin mavi alanı, metriğin ortalama maksimum ve ortalama minimum değerlerini tanımlar. Ortalama maksimum 1,2 * (hareketli ortalama) ve ortalama minimum değer 0,8 *'dir (hareketli ortalama).

    Hareketli ortalama, ortalama maksimum veya ortalama minimum aralığın dışındaysa olası bir anormallik olarak değerlendirilir ve grafikte kırmızı bir nokta olarak çizilir.

Özel rapor ekleme

Özel raporlar ekleyerek API programınızın her yönüyle ilgili bilgi sağlayan grafikler oluşturabilirsiniz.

Özel raporu ekledikten sonra eşzamanlı veya eşzamansız olarak run gerekir.

Özel rapor eklemek için:

  1. Özel Raporlar sayfasına erişin.
  2. + Özel Rapor'u tıklayın.
  3. Basic (Temel) bölümünde, aşağıdaki bilgileri girin:
    Alan Açıklama
    Rapor adı Raporun adı.
    Rapor açıklaması Raporun açıklaması.
    Grafik türü Özel analiz verilerinizi sunmak için kullanılacak grafik stilini seçin.
    • Sütun: X ekseni, boyutlara göre belirlenen grupları temsil eder.
    • Çizgi: X ekseni, zamanı temsil eder.
  4. Metrikler bölümünde:
    1. Metrikler için simgesini tıklayın.
    2. Analiz etmek istediğiniz metriği seçin.
    3. Toplam, Ortalama, Min veya Maksimum değerlerini görüntülemek için bir Toplama işlevi seçin.
    4. Kaydet'i tıklayın.
    5. Başka metrikler eklemek için simgesini tıklayın.
  5. Boyutlar bölümünde simgesini tıklayın ve raporları oluşturmak için kullanılan veri kümesini sınırlamak için "Proxy" gibi bir boyut seçin. Verileri daha da sınırlandırmak için ek boyutlar ekleyebilirsiniz.
  6. Filtreler bölümünde rapor tanımınıza filtreler ekleyerek görüntülenen verileri daha da daraltın. Örneğin, hava durumu API proxy'si veya geliştirici burcin@example.com ile ilgili verileri hariç tutan bir filtre ekleyebilirsiniz.

    1. öğesini tıklayın ve filtreleme yapmak istediğiniz varlığın Adını, = veya != gibi bir operatörü ve bir Değeri seçin.
    2. Filtreyi kaydetmek için Ekle'yi tıklayın.
    3. Başka filtreler eklemek için simgesini tıklayıp bir VE ya da VEYA bağlayıcısı seçin.
  7. Özel rapora kimlerin erişebileceğini sınırlamak için rapor için tanımlanan özel Rolleri düzenleyin.

    1. Özel rol ayarlarını düzenlemek için simgesini tıklayın.
    2. Rapora erişmek için gereken özel rolü ve erişim düzeyini (görüntüleme, düzenleme, silme) seçin.
    3. Ekle'yi tıklayın.
    4. Başka rolleri düzenlemek için öğesini tıklayın.
  8. Raporu kaydetmek için Kaydet'i tıklayın.

Özel rapor çalıştırma

Edge Analytics, bir raporu eşzamanlı veya eşzamansız olarak çalıştırmanızı sağlar.

  • Eşzamanlı rapor için rapor isteğini çalıştırırsınız ve analiz sunucusu yanıt verene kadar istek engellenir. Ancak, bir raporun büyük miktarda veri işlemesi gerekebileceğinden (örneğin, 100'lerce GB) eşzamanlı rapor, zaman aşımı nedeniyle başarısız olabilir.

    Eşzamanlı bir raporun maksimum zaman aralığı 14 gün olabilir. 15 günlük veya daha uzun bir zaman aralığı seçerseniz rapor her zaman eşzamansız olarak çalıştırılır.

  • Eşzamansız rapor için rapor isteğini çalıştırır ve sonuçları daha sonra alırsınız. Eşzamansız sorgu işlemenin iyi bir alternatif olabileceği bazı durumlar şunlardır:

    • Geniş zaman aralıklarını kapsayan raporlar analiz etme ve oluşturma
    • Verileri, çeşitli gruplandırma boyutları ve sorguya karmaşıklık katan diğer kısıtlamalarla analiz etme
    • Bazı kullanıcılar veya kuruluşlar için veri hacimlerinin önemli ölçüde arttığını fark ettiğinizde sorguları yönetme.

    Bu dokümanda, kullanıcı arayüzü kullanılarak eşzamansız raporun nasıl başlatılacağı açıklanmaktadır. API'yi eşzamansız özel raporlar API'sini kullanma bölümünde de açıklandığı gibi kullanabilirsiniz.

Belirli bir zaman aralığına yönelik özel bir rapor çalıştırmak için:

  1. Özel Raporlar sayfasına erişin.
  2. Çalıştırılacak raporu seçin. Varsayılan olarak rapor, önceki bir saatin verilerini görüntüler.
  3. Raporu farklı bir zaman aralığı için çalıştırmak üzere:

    1. Özel Rapor Zamanı Seçimi pop-up'ını açmak için raporun üst kısmındaki zaman aralığı alanını tıklayın.
    2. Aşağıdakilerden birini seçin:
      • Son Saat, Dün veya Son 7 Gün gibi önceden tanımlanmış bir zaman aralığı.
      • Başlangıç/Bitiş tarih ve saati seçerek Özel Aralık seçebilir veya takvimi kullanarak başlangıç ve bitiş tarihlerini seçebilirsiniz. Eşgüdümlü Evrensel Zaman'ı (UTC) kullanmak için UTC'yi tıklayın.

    3. Raporu çalıştırmak için aşağıdakilerden birini seçin:
      • Raporu eşzamanlı olarak çalıştırmak için Apply (Uygula) seçeneğini tıklayın. Sonuçlar, rapor tamamlandıktan sonra özel rapor kontrol panelinde görüntülenir. Raporun çalışması 60 saniyeden uzun sürerse otomatik olarak eşzamansız bir rapora dönüştürülür.

      • Raporu arka plan işi olarak eşzamansız olarak çalıştırmak için İşi Gönder. Şu iletişim kutusu görünür:

        Eş zamansız gönder

        Özel rapor işinin durumunu görüntülemek için iletişim kutusunda Durumu Görüntüle'yi tıklayın.

Eşzamansız özel rapor işlerini görüntüleme

Eşzamansız özel rapor işlerini görüntülemek için aşağıdakilerden birini seçin:

  • Arka Plan İşi Olarak Gönderilen Rapor iletişim kutusunda Durumu Görüntüle'yi tıklayın.
  • Sol gezinme çubuğundan Analiz > Özel Raporlar > İşleri Raporla'yı seçin.

Rapor İşleri sayfası, aşağıdaki şekilde gösterildiği gibi görüntülenir:

İşleri raporla

İşleri Raporla sayfası ile şunları yapabilirsiniz:

  • Son 7 gün içinde gönderilen tüm eşzamansız özel rapor işi sonuçlarını görüntüleyin.

  • Özel rapor işlerini görüntülemek istediğiniz ortamı seçin.

  • Özel raporu görüntülemek için Durum'un tamamlandığından emin olun. Ardından, fareyi rapora karşılık gelen satırın üzerine getirin. Raporu göster ve Raporu indir simgesi görünür. Raporu görüntülemek için Raporu göster öğesini seçin.

  • Raporu indir simgesini tıklayarak özel raporu indirin.

    Raporun tamamı, CSV dosyalarını içeren OfflineQueryResult-xxx.zip adlı bir ZIP dosyası olarak indirilir.

  • İlgili bir dizenin tamamını veya bir kısmını arama kutusuna girerek özel raporlar listesinde arama yapın; görüntülenen tüm alanlarda bu dize aranır.

Özel raporu düzenleme

Özel bir raporu düzenlemek için:

  1. Özel Raporlar sayfasına erişin.
  2. Fareyi, düzenlemek istediğiniz raporun adının üzerine getirin. Sayfanın sağ tarafında düzenle ve sil simgeleri görünür.
  3. Düzenleme simgesini tıklayın.
  4. Özel rapor ayrıntılarını düzenleyin.
  5. Kaydet'i tıklayın.

Özel rapor sonuçlarına dönersiniz.

Özel raporu silme

Özel bir raporu silmek için:

  1. Özel Raporlar sayfasına erişin.
  2. Fareyi, düzenlemek istediğiniz raporun adının üzerine getirin. Sayfanın sağ tarafında düzenle ve sil simgeleri görünür.
  3. Raporu silmek için sil simgesini tıklayın.