Wykonywanie zapytań o metryki prometheus przy użyciu skoroszytów platformy Azure

Tworzenie pulpitów nawigacyjnych obsługiwanych przez usługę zarządzaną usługi Azure Monitor dla rozwiązania Prometheus przy użyciu skoroszytów platformy Azure. W tym artykule przedstawiono skoroszyty obszarów roboczych usługi Azure Monitor i pokazano, jak wykonywać zapytania dotyczące metryk rozwiązania Prometheus przy użyciu skoroszytów platformy Azure i języka zapytań Prometheus (PromQL).

Wymagania wstępne

Aby wykonać zapytanie dotyczące metryk rozwiązania Prometheus z obszaru roboczego usługi Azure Monitor, potrzebne są następujące elementy:

  • Obszar roboczy usługi Azure Monitor. Aby utworzyć obszar roboczy usługi Azure Monitor, zobacz Tworzenie obszaru roboczego usługi Azure Monitor.
  • Obszar roboczy usługi Azure Monitor musi zbierać metryki rozwiązania Prometheus z klastra usługi AKS.
  • Użytkownik musi mieć przypisaną rolę, która może wykonywać operację microsoft.monitor/accounts/read w obszarze roboczym usługi Azure Monitor.

Skoroszyt programu Prometheus Explorer

Obszary robocze usługi Azure Monitor obejmują skoroszyt eksploracji do wykonywania zapytań dotyczących metryk rozwiązania Prometheus.

  1. Na stronie przeglądu obszaru roboczego usługi Azure Monitor wybierz pozycję Prometheus explorer

Screenshot that shows Azure Monitor workspace menu selection.

  1. Lub element menu Skoroszyty, a następnie w galerii obszarów roboczych usługi Azure Monitor wybierz kafelek skoroszytu Prometheus Explorer.

Screenshot that shows Azure Monitor workspace gallery.

Skoroszyt ma następujące opcje wejściowe:

  • Zakres czasu. Wybierz okres, który chcesz uwzględnić w zapytaniu. Wybierz pozycję Niestandardowe , aby ustawić godzinę rozpoczęcia i zakończenia.
  • PromQL. Wprowadź zapytanie PromQL, aby pobrać dane. Aby uzyskać więcej informacji na temat rozwiązania PromQL, zobacz Querying Prometheus (Wykonywanie zapytań w usłudze Prometheus).
  • Karty Graf, Siatka i Wymiary . Przełączanie między grafiką, tabelarycznym i wymiarowym widokiem danych wyjściowych zapytania.

Screenshot that shows PromQL explorer.

Tworzenie skoroszytu Prometheus

Skoroszyty obsługują wiele wizualizacji i integracji platformy Azure. Aby uzyskać więcej informacji na temat skoroszytów platformy Azure, zobacz Tworzenie skoroszytu platformy Azure.

  1. W obszarze roboczym usługi Azure Monitor wybierz pozycję Skoroszyty.

  2. Wybierz Nowy.

  3. W nowym skoroszycie wybierz pozycję Dodaj, a następnie wybierz pozycję Dodaj zapytanie z listy rozwijanej. A screenshot showing the add content dropdown in a blank workspace.

  4. Skoroszyty platformy Azure używają źródeł danych do ustawiania zakresu źródłowego prezentowanych danych. Aby wysłać zapytanie do metryk rozwiązania Prometheus, wybierz listę rozwijaną Źródło danych i wybierz pozycję Prometheus .

  5. Z listy rozwijanej Obszar roboczy usługi Azure Monitor wybierz swój obszar roboczy.

  6. Wybierz typ zapytania z listy rozwijanej Typ zapytania Prometheus.

  7. Napisz zapytanie PromQL w polu Zapytanie Prometheus.

  8. Wybierz przycisk Uruchom zapytanie .

  9. Wybierz pozycję Gotowe edytowanie w dolnej części sekcji i zapisz swoją pracę

Screenshot that shows sample PromQL query.

Rozwiązywanie problemów

Jeśli zostanie wyświetlony komunikat z informacją, że "Obecnie nie masz żadnych danych prometheus pozyskanych do tego obszaru roboczego usługi Azure Monitor":

  • Sprawdź, czy kolekcja metryk została włączona w bloku Monitorowane klastry obszaru roboczego usługi Azure Monitor.

Jeśli zapytanie skoroszytu nie zwraca danych z komunikatem "Nie masz dostępu do zapytania":

  • Sprawdź, czy masz wystarczające uprawnienia do wykonywania funkcji microsoft.monitor/accounts/read przypisanej za pośrednictwem kontroli dostępu (IAM) w obszarze roboczym usługi Azure Monitor.
  • Sprawdź, czy ustawienia sieci obsługują dostęp do zapytań. Aby zezwolić na dostęp publiczny, może być konieczne włączenie dostępu prywatnego za pośrednictwem prywatnego punktu końcowego lub zmiana ustawień.
  • Jeśli w przeglądarce jest włączony blok reklam, może być konieczne wstrzymanie lub wyłączenie i odświeżenie skoroszytu w celu wyświetlenia danych.

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Brakuje wszystkich lub niektórych moich metryk. Jak mogę rozwiązać problemy?

Przewodnik rozwiązywania problemów umożliwia pozyskiwanie metryk rozwiązania Prometheus z zarządzanego agenta tutaj.

Dlaczego brakuje metryk, które mają dwie etykiety o tej samej nazwie, ale innej wielkości liter?

Rozwiązanie Prometheus zarządzane przez platformę Azure jest systemem bez uwzględniania wielkości liter. Traktuje ciągi, takie jak nazwy metryk, nazwy etykiet lub wartości etykiet, co szeregi czasowe, jeśli różnią się one od innej serii czasowej tylko w przypadku ciągu. Aby uzyskać więcej informacji, zobacz Omówienie metryk rozwiązania Prometheus.

Widzę pewne luki w danych metryk, dlaczego tak się dzieje?

Podczas aktualizacji węzła może zostać wyświetlona 1-minutowa luka w danych metryk zebranych z naszych modułów zbierających na poziomie klastra. Ta luka występuje, ponieważ węzeł, w ramach którego są uruchamiane dane, jest aktualizowany w ramach normalnego procesu aktualizacji. Ten proces aktualizacji ma wpływ na cele w całym klastrze, takie jak kube-state-metrics i niestandardowe obiekty docelowe aplikacji, które zostały określone. Dzieje się tak, gdy klaster jest aktualizowany ręcznie lub za pośrednictwem autoaktualizacji. To zachowanie jest oczekiwane i występuje z powodu węzła, który jest uruchamiany podczas aktualizowania. To zachowanie nie ma wpływu na żadne z naszych zalecanych reguł alertów.

Następne kroki