Antywzór: dodaj informacje niestandardowe do schematu należącego do Apigee w bazie danych Postgres

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Edge API Analytics to bardzo zaawansowana wbudowana funkcja dostępna w usłudze Apigee Edge. Zbiera i analizuje szeroki zakres danych przepływających przez interfejsy API. Zgromadzone dane analityczne mogą dostarczyć bardzo przydatnych statystyk. Na przykład: jak zmienia się natężenie ruchu przez interfejs API w danym czasie? Które API jest najczęściej używane? Które interfejsy API mają wysoki współczynnik błędów?

Regularna analiza tych danych i statystyk może służyć do podejmowania odpowiednich działań, takich jak planowanie przyszłej przepustowości interfejsów API na podstawie bieżącego wykorzystania, podejmowanie decyzji biznesowych i inwestycyjnych w przyszłości itp.

Dane Analytics i ich przechowywanie

Interfejs Analytics API rejestruje wiele różnych typów danych, np.:

  • Informacje o interfejsie API – URI żądania, adres IP klienta, kody stanu odpowiedzi itp.
  • Wydajność proxy interfejsu API – współczynnik sukcesu/niepowodzenia, czas przetwarzania żądania i odpowiedzi itp.
  • Wydajność serwera docelowego – współczynnik sukcesu/błędu, czas przetwarzania
  • Informacje o błędach – liczba błędów, kod błędu, zasady niepowodzenia, liczba błędów spowodowanych przez Apigee i cel na serwerze.
  • Inne informacje – liczba żądań wysłanych przez deweloperów, aplikacje deweloperów itp.

Wszystkie te dane są przechowywane w schemacie analytics utworzonym i zarządzanym w bazie danych Postgres przez Apigee Edge.

Zazwyczaj w standardowej instalacji Edge Postgres ma te schematy:

Schemat o nazwie analytics jest używany przez Edge do przechowywania wszystkich danych analitycznych dotyczących każdej organizacji i środowiska. Jeśli zarabianie jest zainstalowane, będzie widoczny schemat rkms. Inne schematy są przeznaczone do wewnętrznego użytku w Postgres.

Schemat analytics będzie się zmieniać, ponieważ Apigee Edge będzie w czasie wykonywania dynamicznie dodawać do niego nowe tabele faktów. Komponent serwera Postgres agreguje dane faktów w tabele zbiorcze, które są wczytywane i wyświetlane w interfejsie Edge.

antywzorzec

Dodawanie kolumn niestandardowych, tabel lub widoków do dowolnego schematu należącego do Apigee w bazie danych Postgres w środowiskach prywatnej chmury bezpośrednio za pomocą zapytań SQL nie jest zalecane, ponieważ może mieć niekorzystne konsekwencje.

Aby dokładniej wyjaśnić ten proces, posłużmy się przykładem.

Załóżmy, że w ramach schematu Analytics została utworzona tabela niestandardowa o nazwie account:

Po pewnym czasie może być konieczne uaktualnienie Apigee Edge z wersji niższej do wyższej. Aktualizacja Apigee Edge Private Cloud obejmuje uaktualnienie Postgresa i wielu innych komponentów. Jeśli do bazy danych Postgres dodano kolumny, tabele lub widoki niestandardowe, uaktualnienie Postgresa zakończy się niepowodzeniem z powodu błędów odwołujących się do obiektów niestandardowych, które nie zostały utworzone przez Apigee Edge. W związku z tym uaktualnienie Apigee Edge również się nie powiedzie i nie będzie można go ukończyć.

Podobne błędy mogą występować podczas czynności konserwacyjnych Apigee Edge, w ramach których wykonywane są kopie zapasowe i przywracanie komponentów Edge, w tym bazy danych Postgres.

Wpływ

  • Nie można ukończyć uaktualniania Apigee Edge, ponieważ uaktualnianie komponentu Postgres kończy się niepowodzeniem z błędami odwołującymi się do obiektów niestandardowych, które nie zostały utworzone przez Apigee Edge.
  • Niezgodności (i błędy) podczas wykonywania konserwacji usługi Apigee Analytics (tworzenie kopii zapasowej/przywracanie).

Sprawdzona metoda

  • Nie dodawaj żadnych niestandardowych informacji w postaci kolumn, tabel, widoków, funkcji ani procedur bezpośrednio do żadnego schematu należącego do Apigee, takiego jak analytics itp.
  • Jeśli potrzebujesz informacji niestandardowych, możesz je dodać jako kolumny (pola) za pomocą polityki Zbierania statystyk do schematu analytics.

Więcej informacji