Monitorowanie Google Maps Platform

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Cloud Monitoring zbiera wskaźniki dotyczące interfejsów API i usług oraz zasobów Google Cloud Platform, których używasz. Z tego artykułu dowiesz się, jak skonfigurować Cloud Monitoring oraz jak używać go do monitorowania korzystania z interfejsu API, tworzenia paneli i tworzenia alertów.

Cloud Monitoring udostępnia wiele funkcji i opcji. W tym temacie poznasz Cloud Monitoring i poznasz podstawowe przykłady. Informacje na temat wszystkich funkcji, w tym wielu innych przykładów, znajdziesz w dokumentacji Cloud Monitoring.

Skonfiguruj Cloud Monitoring

Na stronie Monitorowanie możesz wyświetlać dane i nimi zarządzać:

  • Pojedynczy projekt
  • Wiele projektów w ramach jednej organizacji
  • Wiele projektów w wielu organizacjach

Aby mieć pewność, że wskaźniki Twoich projektów są dostępne, wykonaj te czynności:

  1. W Google Cloud Console wybierz Monitorowanie:

    Otwórz Monitor

  2. Sprawdź, czy został wybrany właściwy projekt.
  3. W panelu nawigacji Monitory kliknij > po prawej stronie opcji Zakres wskaźników. Poniższy zrzut ekranu przedstawia stronę wyświetlaną po wybraniu projektu AllEnvironments:

    Zrzut ekranu wskaźników monitorowanych w projekcie. Wyświetlą się wszystkie projekty razem z ich nazwami i rolami.

W tabeli Wskaźniki monitorowane przez ten projekt znajduje się lista projektów, których wskaźniki są dostępne dla bieżącego zakresu wskaźników. Każdy wiersz w tabeli zawiera projekt i rolę tego projektu:

  • Projekt określania zakresu: ten projekt przechowuje skonfigurowane czas działania, zasady tworzenia alertów, grupy i panele alertów. Między zakresem wskaźników a projektem określania zakresu występuje relacja 1:1. W tym przykładzie projekt AllEnvironments jest projektem określania zakresu.
  • Monitorowany projekt: wskaźniki dotyczące projektu są widoczne w bieżącym zakresie wskaźników. W tym przykładzie projekty związane ze etapem produkcji i projektu są monitorowane.

Tabela o nazwie Projekty wymienione poniżej mogą wyświetlać wskaźniki tego projektu zawierają listę projektów, których zakres wskaźników obejmuje bieżący projekt. Poprzedni zrzut ekranu pokazuje, że żadne inne projekty nie mają dostępu do wskaźników przechowywanych przez projekt AllEnvironments.

Więcej informacji, w tym o tym, jak dodawać i usuwać projekty, znajdziesz w artykule Konfigurowanie Cloud Monitoring.

Zbadaj wskaźniki

Aby zbadać dane, utwórz wykres za pomocą Eksploratora wskaźników dostępnego w Cloud Monitoring. Jeśli na przykład chcesz wyświetlić limit wykorzystania interfejsu API, możesz użyć narzędzia Metrics Explorer do utworzenia wykresu zawierającego najnowsze dane.

Poniższa ilustracja przedstawia wykres wykorzystania limitów przez interfejsy API Map Google:

Zrzut ekranu danych dotyczących limitu dla wszystkich interfejsów API Map Google. Widać w nim wykres słupkowy, który pokazuje, jak każdy segment słupków odpowiada różnym interfejsom API.

Ten przykład przedstawia skumulowany wykres słupkowy, gdzie każdy interfejs API jest reprezentowany przez sekcję słupka. Możesz tworzyć różne typy wykresów, np. wykresy liniowe, słupkowe i mapy termiczne. Możesz też utworzyć pojedynczy wykres, który zawiera maksymalnie 10 różnych rodzajów danych.

Na tej ilustracji:

  • Pola Typ zasobu i Wskaźnik po lewej stronie wykresu określają dane widoczne na wykresie.
  • Typ wykresu widoczny nad wykresem umożliwia wybranie typu wykresu. W tym przykładzie ustawiona jest na skumulowany wykres słupkowy.
  • Przedział czasu powyżej wykresu jest ustawiony na 1 W (tydzień).
  • Poniżej wykresu znajdują się listy danych service, quota_metrics, metoda interfejsu API oraz wartości wskaźników, które definiują dane wykresu. Kliknij Dodaj filtr, by użyć tych informacji do zawężania wyświetlanych danych.

Gdy opuścisz stronę Metrics Explorer, wykres zostanie usunięty, więc nie musisz usuwać żadnych artefaktów. Możesz też zapisać wykres w panelu niestandardowym lub udostępnić go. Więcej informacji o dodawaniu wykresu do panelu znajdziesz poniżej w sekcji Tworzenie paneli.

Wykres z pojedynczym rodzajem danych

Aby skonfigurować wykres za pomocą narzędzia Metrics Explorer:

  1. W Cloud Console wybierz Monitorowanie:

    Otwórz Monitor

  2. W panelu nawigacji wybierz Eksplorator danych.
  3. Na pasku narzędzi wybierz Skumulowany wykres słupkowy z menu typu wykresu, aby wyświetlić dane na wykresie słupkowym.
  4. Wybierz przedział czasu, np. 1 W (tydzień).
  5. Podaj dane do wyświetlenia na wykresie. Aby użyć interfejsu opartego na menu lub wpisać filtr, wybierz kartę Konfiguracja. Aby używać języka MQL do monitorowania, wybierz kartę MQL.
    1. Aby wyświetlić na wykresie wykorzystanie limitu, jako typ zasobu wybierz Limit liczby klientów. Jeśli chcesz utworzyć wykres dotyczący wykorzystania interfejsu API, wybierz opcję informacje o wykorzystaniu lub interfejs Google Maps API (więcej informacji o wskaźnikach wykorzystania dostępnych w interfejsach Google Maps Platform API znajdziesz w sekcji Wskaźniki wykorzystania). Najedź kursorem na każdy typ zasobu, aby zobaczyć jego opis.
    2. Jako dane wybierz Wykorzystanie limitu stawki. Wykres automatycznie aktualizuje się, aby wyświetlić dane. Zwróć uwagę, że są też dostępne inne opcje limitu. Najeżdżaj kursorem na poszczególne dane, aby zobaczyć opis. Więcej informacji o polach Metrics Explorer znajdziesz w artykułach Wybieranie danych i Wybieranie sposobu wyświetlania danych z wykresu.
  6. (Opcjonalnie) Użyj tych opcji, aby doprecyzować wyświetlacz:
    1. Aby określić podzbiór danych do wyświetlenia, dodaj filtry. Aby dodać filtr, kliknij Dodaj filtr i zakończ okno. Więcej informacji znajdziesz w artykule Filtrowanie danych z wykresu. Aby na przykład wyświetlić dane pojedynczego interfejsu API:
      1. W polu Etykieta wybierz metoda.
      2. W polu Porównanie wybierz = (równa się).
      3. W polu Wartość wybierz nazwę konkretnej metody. Pojawi się prośba o wybranie nazwy metody zawierającej dane do wyświetlenia.
      4. Wybierz Gotowe, aby zaktualizować wykres.
    2. Aby pogrupować ciągi czasowe według etykiety, użyj pola Grupuj według. Wybranie wartości tego pola spowoduje automatyczne ustawienie wartości w polu Agregator.
    3. Aby określić, jak połączyć ciąg czasowy, ustaw pole Agregator. Jeśli na przykład pole Grupuj według jest puste, a pole Agregator jest ustawione, oznacza to, że wykres pokazuje średnią serię czasową.
    4. Aby skonfigurować sposób przetwarzania poszczególnych ciągów czasowych, wybierz Opcje zaawansowane. Więcej informacji znajdziesz w artykule Wybieranie wskaźników podczas korzystania z narzędzia Metrics Explorer.
  7. Opcjonalnie dodaj do panelu.

    Gdy opuścisz stronę Eksplorator wskaźników, wykres zostanie odrzucony. Możesz też kliknąć Zapisz wykres, aby zapisać wykres w nowym lub istniejącym panelu. Więcej informacji o dodawaniu wykresu do panelu znajdziesz poniżej w sekcji Tworzenie paneli informacyjnych.

Pokaż wiele danych

W niektórych przypadkach chcesz chcieć wyświetlać wiele danych na tym samym wykresie. Możesz na przykład wyświetlić limit na tych samych wykresach co wykorzystanie wykorzystania. Na wykresie można wyświetlać maksymalnie 10 rodzajów danych.

Aby dodać dane do istniejącego wykresu, wykonaj te czynności:

  1. Na istniejącym wykresie wybierz Dodaj inny wskaźnik u dołu ekranu.
  2. Wybierz wskaźnik, a następnie określ, jak chcesz wyświetlić ciąg czasowy dla tych wskaźników w ten sam sposób, co skonfigurowane powyżej dane.

Więcej informacji na temat analizowania danych:

Tworzenie paneli

Panele informacyjne pozwalają na wyświetlanie i monitorowanie danych serii czasowych jako kolekcji wykresów. Cloud Monitoring obsługuje panele predefiniowane i niestandardowe:

  • Wstępnie zdefiniowane panele są automatycznie instalowane na potrzeby używanych usług Google Cloud Platform. Tych paneli nie można konfigurować.
  • Panele niestandardowe to panele utworzone przez Ciebie. Panele niestandardowe pozwalają określić, jakie dane chcesz wyświetlić i jak je wyświetlać. Możesz na przykład wyświetlać dane wskaźnika, zasady tworzenia alertów i logi zapisane w Twoim projekcie. Dane dotyczące ciągów czasowych możesz wyświetlać na wykresie, w formie wskaźnika lub podsumowania statystyk albo w tabeli.

Do tworzenia paneli niestandardowych możesz użyć Cloud Console lub Cloud Monitoring API. Poniższa ilustracja przedstawia panel niestandardowy z dwoma wykresami:

  • Wykres limitu po lewej
  • Wykres liczby interfejsów API po prawej stronie

Zrzut ekranu panelu niestandardowego z 2 wykresami. Wykres po lewej stronie to wykres limitu, a po prawej – wykres wykorzystania interfejsu API.
  Oba wykresy przedstawiają punkty czasu na osi poziomej.

Utwórz panel niestandardowy, tworząc wykresy wskaźników, a następnie dodając je do panelu. Możesz utworzyć wykres w eksploratorze danych, a następnie dodać go do nowego lub istniejącego panelu. Możesz też utworzyć panel, a potem edytować go, aby dodać wykres.

Jeśli zdecydujesz się zarządzać panelami niestandardowymi za pomocą interfejsu Cloud Monitoring API, eksplorator wskaźników udostępnia 2 przydatne narzędzia:

  • Aby wygenerować wykres JSON na potrzeby wykresu, który chcesz dodać do panelu, skonfiguruj wykres za pomocą narzędzia Metrics Explorer. Następnie możesz uzyskać dostęp do pliku JSON za pomocą menu Więcej opcji na pasku narzędzi Metrics Explorer.
  • Aby zidentyfikować składnię filtra monitorowania, który jest używany w interfejsie Cloud Monitoring API, skonfiguruj interfejs wykresu za pomocą menu Metrics Explorer. Po wybraniu danych i filtrów przełącz się na tryb filtra bezpośredniego, aby wyświetlić równoważny filtr monitorowania.

Utwórz panel niestandardowy

Aby utworzyć panel niestandardowy:

  1. W Cloud Console wybierz Monitorowanie:

    Otwórz Monitor

  2. W panelu nawigacji kliknij Panele.
  3. Na stronie Przegląd paneli informacyjnych kliknij Utwórz panel.
  4. W przypadku każdego wykresu, który chcesz dodać do panelu, wykonaj te czynności:
    1. Wybierz typ wykresu z menu Dodaj wykres lub przeciągnij wykres z biblioteki do obszaru wykresu.

      Wyświetli się wstępnie skonfigurowany wykres wybranego typu. Poniższy przykład przedstawia wykres liniowy i jego panel konfiguracyjny:

      Zrzut ekranu eksploratora wskaźników, który służy do utworzenia wykresu do dodania do panelu.

    2. Wybierz Typ zasobu i Wskaźnik i zastosuj filtry w sposób opisany powyżej podczas tworzenia wykresu.

      Więcej informacji o wybranych opcjach znajdziesz w artykule Dodawanie widżetów na panelu.

  5. (Opcjonalnie) Na pasku narzędzi panelu kliknij Dodaj wykres, aby dodać kolejny wykres, a następnie powtórz poprzednie czynności, aby go dostosować.
  6. Gdy skończysz, kliknij strzałkę w lewo, aby opuścić panel, lub wybierz inny element menu Monitorowanie. Twój panel jest zapisywany automatycznie.

Wyświetlanie panelu

Aby wyświetlić panel:

  1. W Cloud Console wybierz Monitorowanie:

    Otwórz Monitor

  2. W panelu nawigacji kliknij Panele.
  3. Wybierz z listy panel niestandardowy lub zdefiniowany wstępnie.

Więcej informacji o tworzeniu paneli znajdziesz:

Dane na temat wykorzystania

Do monitorowania użycia interfejsów API Google Maps Platform są dostępne 2 grupy danych: Wskaźniki czasu działania usługi (typ zasobu consumed_api) dostępne dla większości interfejsów Google Cloud API i Wskaźniki Google Maps Platform, oraz konkretne dane dotyczące interfejsów API Google Maps Platform (maps.googleapis.com/Api).

Oba wskaźniki obsługują ten sam zestaw etykiet zasobów do podziału ruchu interfejsu API: project_id, service, method, version, location i credential_id. Opisy etykiet zasobów znajdziesz w dokumentacji odpowiedniego zasobu Metrics:

Każda grupa danych ma dwa typy wskaźników monitorowania wykorzystania: Liczba żądań i Opóźnienia.

W danych Liczba żądań możesz podzielić ruch według wykorzystania według etykiet danych protocol, grpc_status_code, response_code i response_code_class. Możesz też podzielić dane przez platform_type według danych Google Maps Platform.

W danych Opóźnienia możesz podzielić ruch związany z użytkowaniem według etykiet danych protocol, platform_type, response_code i response_code_class tylko w danych Google Maps Platform.

Więcej informacji o typach i etykietach dokumentacji znajdziesz w odpowiedniej grupie danych:

Mapowanie stanu odpowiedzi i etykiety kodu odpowiedzi

Tabela poniżej zawiera mapowanie między kodem stanu odpowiedzi a kodem odpowiedzi HTTP zwracanym w odpowiedzi na żądania do interfejsu API Google Maps Platform i etykietami kodu odpowiedzi dostępnymi w Cloud Monitoring: kod odpowiedzi HTTP, klasa kodu odpowiedzi HTTP i kod stanu GRPC. Kod stanu gRPC to liczbowy kod odpowiedzi gRPC dla żądań gRPC lub kod równoważny gRPC w przypadku żądań HTTP.

Kody odpowiedzi zwrócone w odpowiedziach interfejsu API Kody odpowiedzi zgłaszane do usługi Monitoring
Stan interfejsu API Map Google Kod odpowiedzi HTTP Kod odpowiedzi HTTP Klasa kodu odpowiedzi HTTP Kod stanu GRPC
OK 200,
204,
302
200,
204,
302
2xx,
3 xx
0 (OK)
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200 200/404(1) 2xx/4xx(1) 0 (OK),
5 (NOT_FOUND)(1)
NOT_FOUND (Street View Static, API geolocation i Roads API),
ZERO_RESULTS (Street View Static API)
404 404 4xx 5 (NOT_FOUND)
INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
itp.
200/400 400 4xx 3 (INVALID_RESULT)
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy żądania) 200/400 400 4xx 3 (INVALID_RESULT)
ŻĄDANIE_NIEDOZWOLONE 200/403 403 4xx 7 (PERMISSION_DENIED)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitPrzekroczony,
RateLimitPrzekroczono,
userRateLimitPrzekroczono
200/403,
429
403,
429
4xx 7 (PERMISSION_DENIED),
8. (RESOURCE_EXHAUSTED)
NIEZNANY 200/500,
503
500,
503
5xx 2 (NIEZNANE)
1 Aby poprawić spójność raportowania kodów błędów, interfejsy API Google Maps Platform przenoszą (stan) z kodu odpowiedzi HTTP/klasy> 200/2xx do 404/4xx (i kodu stanu GRPC z 0 (OK) do 5 (NOT_FOUND) w przypadku stanów interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS. W okresie przejściowym zobaczysz oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie będą się zmieniać. Podział kodów odpowiedzi zgłoszonych w czasie możesz przeglądać w narzędziu Metrics Explorer.

Tworzenie alertów

Alerty dają Ci aktualne informacje o problemach w aplikacjach, dzięki czemu możesz je szybko rozwiązywać. W usłudze Cloud Monitoring zasada tworzenia alertów opisuje okoliczności, w których mają być wyświetlane alerty i sposób powiadamiania.

Zasady tworzenia alertów mogą być proste lub złożone. Zasady tworzenia alertów pozwalają określić, czy pojedynczy ciąg czasowy może spowodować spełnienie warunku, czy też wiele ciągów czasowych musi spełniać warunek, zanim zostanie on spełniony. Przykład:

  • Powiadom mnie, gdy liczba żądań w określonym interfejsie API przekroczy 1000 w ciągu 5 minut.
  • Powiadom zespół ds. czatu, gdy 90 centyl odpowiedzi HTTP 200 przekroczy 100 ms w przypadku co najmniej 3 interfejsów API.

Poniższa ilustracja przedstawia definicję alertu generującą powiadomienia, gdy liczba żądań dla interfejsu API przekroczy 20 żądań w 5-minutowym okresie:

Zrzut ekranu z definicją alertu przedstawiającą liczbę żądań do interfejsu API dla wszystkich interfejsów API Map Google jako osobne wiersze oraz próg alertu w poziomie.

Na tej ilustracji:

  • Wykres pokazuje liczbę wywołań interfejsu API w czasie dla różnych interfejsów API.
  • Czerwona linia pokazuje próg alertu. Alert wywołany przez interfejs API, który przekracza ten 5-minutowy okres. W tym przykładzie widać, że jeden interfejs API przekroczył limit.

Po spełnieniu warunków zasady tworzenia alertów Cloud Monitoring otwiera powiadomienia o incydentach i problemach:

  • Incydent to stały rekord, w którym przechowywane są informacje o monitorowanych zasobach po spełnieniu warunku. Gdy warunek przestanie być spełniany, incydent zostanie automatycznie zamknięty. Wszystkie incydenty (otwarte i zamknięte) możesz wyświetlać w panelu alertów.
  • Określasz, kto będzie otrzymywać powiadomienia podczas konfigurowania zasad tworzenia alertów. Funkcja monitorowania obsługuje popularne kanały powiadomień, w tym pocztę e-mail, aplikację mobilną Cloud oraz usługi, takie jak PagerDuty czy Slack. Pełną listę kanałów powiadomień znajdziesz w opcjach powiadomień.

Typy alertów

Cloud Monitoring obsługuje wiele typów alertów. Możesz np. zdefiniować:

  • Alerty dotyczące progu wskaźników: wywołaj alert, jeśli wartość określonych danych spadnie powyżej lub spadnie poniżej określonej wartości dla okresu trwania lub gdy wartość zwiększy się lub spadnie o określoną wartość procentową.
  • Alerty dotyczące budżetu: ustaw reguły progowe wyświetlania powiadomień, gdy Twoje koszty (rzeczywiste lub prognozowane koszty) przekroczą określony procent budżetu (zgodnie z ustawionymi przez Ciebie regułami). Alert nie ogranicza użycia interfejsu API, a jedynie powiadomi Cię, gdy kwota wydatków będzie bliska określonej kwoty.
  • Alerty dotyczące limitów: Google Cloud Platform określa różne limity, które możesz wykorzystać do śledzenia i ograniczania zasobów używanych przez projekt lub organizację. Wysyłaj alerty, gdy wykorzystanie osiągnie limit.

Więcej informacji znajdziesz w artykule Typy zasad tworzenia alertów.

Zarządzaj zasadami tworzenia alertów

Możesz dodać zasadę tworzenia alertów do projektu za pomocą Cloud Console lub interfejsu Cloud Monitoring API. Informacje o tym, jak wyświetlić listę zasad tworzenia alertów na podstawie wskaźników i jak modyfikować te zasady, znajdziesz w tych sekcjach:

Utwórz alert

Gdy utworzysz alert:

  • Zdefiniuj warunki, które wywołują alerty, na podstawie danych wskaźników.
  • Określ kanały powiadomień, do których będą wysyłane powiadomienia o alertach.

Przykład poniżej pokazuje, jak skonfigurować alert, gdy współczynnik wykorzystania usług Google Maps Platform dla dowolnego interfejsu API przekracza 2 żądania w ciągu 5 minut.

Aby utworzyć alert:

  1. W Cloud Console wybierz Monitorowanie:

    Otwórz Monitor

  2. Wybierz Alerty.
  3. Wybierz Edytuj kanał powiadomień, aby określić sposób, w jaki alert ma otrzymywać powiadomienia. W tym przykładzie użyjemy adresu e-mail.
    1. Jako Kanał poczty e-mail wybierz Dodaj nowy.
    2. Wpisz adres e-mail i wyświetlaną nazwę.
    3. Kliknij Zapisz.
  4. Wybierz Alerty.
  5. Wybierz Utwórz zasadę.
  6. Wybierz przedział czasu, np. 7 dni.
  7. W sekcji Warunki alertu wybierz Nowy warunek:
    1. Kliknij Wybierz wskaźnik, a następnie wybierz Przejęty interfejs API jako zasób i Liczbę żądań jako wskaźnik, a następnie kliknij Zastosuj.
    2. (Opcjonalnie) Pod wykresem znajdziesz listę usług, quota_metrics, metody interfejsu API i wartości wskaźników. Kliknij Dodaj filtr, aby filtrować dane na podstawie tych informacji. Możesz na przykład użyć filtra, aby określić, że metoda musi mieć wartość google.places.Autocomplete.http, aby aktywować alert.
    3. W obszarze Przekształć dane wybierz 5 minut w przypadku opcji Okres obserwacji i Średnia w przypadku funkcji Okres obserwacji.
    4. Kliknij Dalej.
  8. W sekcji Skonfiguruj wyzwalacz alertu ustaw Wartość progu na 2, aby określić, czy alert ma się pojawiać, gdy w 5-minutowym oknie wystąpi więcej niż 2 żądania. Zwróć uwagę, że wykres przedstawia teraz czerwoną linię wskazującą limit alertów dla wybranego odstępu czasu. Na wykresie możesz sprawdzić, gdzie zostałby aktywowany alert. W razie potrzeby możesz użyć tego wykresu, aby dostosować limit.
  9. Kliknij Dalej.
  10. Na stronie Skonfiguruj powiadomienia i skończ alert:
    1. Wybierz adres e-mail utworzony dla kanału powiadomień.
    2. W sekcji Nazwij alert wpisz Mój test testowy.
    3. Wybierz Utwórz zasadę.
  11. Wyślij kilka żądań API. Wygeneruj więcej niż 2 żądania interfejsu API w ciągu 5 minut, aby wygenerować e-mail z powiadomieniem o alercie.
  12. Gdy otrzymasz e-maila z alertem, wejdź na stronę Alerty.
    1. Kliknij alert, aby wyświetlić więcej informacji.
    2. Kliknij nazwę alertu, aby wyświetlić informacje o nim, w tym wykres przedstawiający zdarzenie, które go wywołało.

Więcej informacji o alertach znajdziesz w tych artykułach: