Łączenie narzędzia Grafana z metrykami usługi Azure Monitor Prometheus
Artykuł
Najczęstszym sposobem analizowania i prezentowania danych Rozwiązania Prometheus jest pulpit nawigacyjny narzędzia Grafana. Metryki rozwiązania Prometheus można zbierać na platformie Azure w następujący sposób:
W tym artykule wyjaśniono, jak skonfigurować metryki prometheus hostowane na platformie Azure jako źródło danych dla zarządzanej przez platformę Azure Grafana, self-hosted Grafana uruchomionej na maszynie wirtualnej platformy Azure lub wystąpienia narzędzia Grafana działającego poza platformą Azure.
Punkt końcowy zapytania obszaru roboczego usługi Azure Monitor
Na platformie Azure dane rozwiązania Prometheus są przechowywane w obszarze roboczym usługi Azure Monitor. Podczas konfigurowania źródła danych Rozwiązania Prometheus w narzędziu Grafana należy użyć punktu końcowego Zapytania dla obszaru roboczego usługi Azure Monitor. Aby znaleźć punkt końcowy zapytania, otwórz stronę Przegląd obszaru roboczego usługi Azure Monitor w witrynie Azure Portal.
Podczas tworzenia wystąpienia zarządzanego narzędzia Grafana platformy Azure jest on automatycznie konfigurowany przy użyciu tożsamości systemu zarządzanego. Tożsamość ma przypisaną rolę Czytelnik danych monitorowania na poziomie subskrypcji. Ta rola umożliwia tożsamości odczytywanie danych jakichkolwiek danych monitorowania dla subskrypcji. Ta tożsamość służy do uwierzytelniania narzędzia Grafana w usłudze Azure Monitor. Nie musisz nic robić, aby skonfigurować tożsamość.
Utwórz źródło danych Prometheus w narzędziu Grafana.
Aby skonfigurować rozwiązanie Prometheus jako źródło danych, wykonaj następujące kroki:
Otwórz obszar roboczy usługi Azure Managed Grafana w witrynie Azure Portal.
Wybierz pozycję W punkcie końcowym , aby wyświetlić obszar roboczy narzędzia Grafana.
Wybierz pozycję Połączenia , a następnie pozycję Źródła danych.
Wybierz pozycję Dodaj źródło danych
Wyszukaj i wybierz pozycję Prometheus.
Wklej punkt końcowy zapytania z obszaru roboczego usługi Azure Monitor do pola Adres URL serwera Prometheus.
W obszarze Uwierzytelnianie wybierz pozycję Azure Auth.
W obszarze Uwierzytelnianie platformy Azure wybierz pozycję Tożsamość zarządzana z listy rozwijanej Uwierzytelnianie.
Przewiń w dół strony i wybierz pozycję Zapisz i przetestuj.
Self-managed Grafana
W poniższej sekcji opisano sposób konfigurowania samodzielnego zarządzanego narzędzia Grafana na maszynie wirtualnej platformy Azure w celu korzystania z danych prometheus hostowanych na platformie Azure.
Konfigurowanie tożsamości systemu
Wykonaj następujące kroki, aby zezwolić na dostęp do wszystkich obszarów roboczych usługi Azure Monitor w grupie zasobów lub subskrypcji:
Otwórz stronę Tożsamość maszyny wirtualnej w witrynie Azure Portal.
Ustaw wartość Stan na Wł.
Wybierz pozycję Zapisz.
Wybierz pozycję Przypisania ról platformy Azure, aby przejrzeć istniejący dostęp w subskrypcji.
Jeśli rola Czytelnik danych monitorowania nie jest wyświetlana dla subskrypcji lub grupy zasobów, wybierz pozycję + Dodaj przypisanie roli
Na liście rozwijanej Zakres wybierz pozycję Subskrypcja lub Grupa zasobów. Wybranie pozycji Subskrypcja umożliwia dostęp do wszystkich obszarów roboczych usługi Azure Monitor w ramach subskrypcji. Wybranie pozycji Grupa zasobów umożliwia dostęp tylko do obszarów roboczych usługi Azure Monitor w wybranej grupie zasobów.
Wybierz określoną subskrypcję lub grupę zasobów, w której znajduje się obszar roboczy usługi Azure Monitor.
Z listy rozwijanej Rola wybierz pozycję Monitor Data Reader (Czytelnik danych monitorowania).
Wybierz pozycję Zapisz.
Konfigurowanie narzędzia Grafana na potrzeby uwierzytelniania platformy Azure
Wersje 9.x i nowsze platformy Grafana obsługują uwierzytelnianie platformy Azure, ale nie jest domyślnie włączone. Aby włączyć uwierzytelnianie platformy Azure, zaktualizuj konfigurację narzędzia Grafana i uruchom ponownie wystąpienie narzędzia Grafana. Aby znaleźć plik, zapoznaj się grafana.ini z dokumentem Configure Grafana (Konfigurowanie narzędzia Grafana) z witryny Grafana Labs.
Znajdź i otwórz grafana.ini plik na maszynie wirtualnej.
[auth] W sekcji pliku konfiguracji zmień ustawienie na azure_auth_enabledtrue.
[azure] W sekcji pliku konfiguracji zmień ustawienie na managed_identity_enabledtrue
Uruchom ponownie wystąpienie narzędzia Grafana.
Tworzenie źródła danych Prometheus w narzędziu Grafana
Skonfiguruj rozwiązanie Prometheus jako źródło danych, wykonując następujące kroki:
Otwórz narzędzie Grafana w przeglądarce.
Wybierz pozycję Połączenia , a następnie pozycję Źródła danych.
Wybierz pozycję Dodaj źródło danych
Wyszukaj i wybierz pozycję Prometheus.
Wklej punkt końcowy zapytania z obszaru roboczego usługi Azure Monitor do pola Adres URL serwera Prometheus.
W obszarze Uwierzytelnianie wybierz pozycję Azure Auth.
W obszarze Uwierzytelnianie platformy Azure wybierz pozycję Tożsamość zarządzana z listy rozwijanej Uwierzytelnianie.
Przewiń w dół strony i wybierz pozycję Zapisz i przetestuj.
Narzędzie Grafana hostowane poza platformą Azure
Jeśli wystąpienie narzędzia Grafana nie jest hostowane na platformie Azure, możesz nawiązać połączenie z danymi rozwiązania Prometheus w obszarze roboczym usługi Azure Monitor przy użyciu identyfikatora Entra firmy Microsoft.
Skonfiguruj uwierzytelnianie microsoft Entra ID, wykonując następujące kroki:
Zarejestruj aplikację przy użyciu identyfikatora Entra firmy Microsoft.
Udziel dostępu aplikacji do obszaru roboczego usługi Azure Monitor.
Skonfiguruj własną aplikację Grafana przy użyciu poświadczeń aplikacji.
Rejestrowanie aplikacji przy użyciu identyfikatora Entra firmy Microsoft
Aby zarejestrować aplikację, otwórz stronę Przegląd usługi Active Directory w witrynie Azure Portal.
Wybierz pozycję Rejestracja aplikacji.
Na stronie Rejestrowanie aplikacji wprowadź nazwę aplikacji.
Wybierz pozycję Zarejestruj.
Zanotuj identyfikator aplikacji (klienta) i identyfikator katalogu (dzierżawy). Są one używane w ustawieniach uwierzytelniania narzędzia Grafana.
Na stronie przeglądu aplikacji wybierz pozycję Certyfikaty i wpisy tajne.
Na karcie Wpisy tajne klienta wybierz pozycję Nowy klucz tajny klienta.
Wprowadź opis.
Wybierz okres wygaśnięcia z listy rozwijanej i wybierz pozycję Dodaj.
Uwaga
Utwórz proces odnawiania wpisu tajnego i aktualizowania ustawień źródła danych Grafana przed wygaśnięciem wpisu tajnego.
Po wygaśnięciu wpisu tajnego narzędzie Grafana utraci możliwość wykonywania zapytań o dane z obszaru roboczego usługi Azure Monitor.
Skopiuj i zapisz wartość wpisu tajnego klienta.
Uwaga
Wartości wpisów tajnych klienta można wyświetlać tylko natychmiast po utworzeniu. Pamiętaj, aby zapisać wpis tajny przed opuszczeniem strony.
Zezwalanie aplikacji na dostęp do obszaru roboczego
Zezwól aplikacji na wykonywanie zapytań dotyczących danych z obszaru roboczego usługi Azure Monitor.
Otwórz obszar roboczy usługi Azure Monitor w witrynie Azure Portal.
Na stronie Przegląd zanotuj punkt końcowy zapytania. Punkt końcowy zapytania jest używany podczas konfigurowania źródła danych Grafana.
Wybierz pozycję Kontrola dostępu (IAM).
Wybierz pozycję Dodaj, a następnie dodaj przypisanie roli na stronie Kontrola dostępu (Zarządzanie dostępem i tożsamościami).
Na stronie Dodawanie przypisania roli wyszukaj pozycję Monitorowanie.
Wybierz pozycję Czytelnik danych monitorowania, a następnie wybierz kartę Członkowie .
Utworzono rejestrację aplikacji i przypisano do niej dostęp do wykonywania zapytań dotyczących danych z obszaru roboczego usługi Azure Monitor. Następnym krokiem jest skonfigurowanie źródła danych Prometheus w narzędziu Grafana.
Konfigurowanie narzędzia Grafana na potrzeby uwierzytelniania platformy Azure
Narzędzie Grafana obsługuje teraz łączenie się z zarządzanym rozwiązaniem Prometheus w usłudze Azure Monitor przy użyciu źródła danych Prometheus. W przypadku wystąpień własnego narzędzia Grafana konieczna jest zmiana konfiguracji w celu użycia opcji Uwierzytelniania platformy Azure w narzędziu Grafana. W przypadku wystąpień narzędzia Grafana, które nie są zarządzane przez platformę Azure, wprowadź następujące zmiany:
Wersje 9.x i nowsze platformy Grafana obsługują uwierzytelnianie platformy Azure, ale nie jest domyślnie włączone. Aby włączyć uwierzytelnianie platformy Azure, zaktualizuj konfigurację narzędzia Grafana i uruchom ponownie wystąpienie narzędzia Grafana. Aby znaleźć plik, zapoznaj się grafana.ini z dokumentem Configure Grafana (Konfigurowanie narzędzia Grafana) z witryny Grafana Labs.
Znajdź i otwórz grafana.ini plik na maszynie wirtualnej.
Zidentyfikuj wersję narzędzia Grafana.
W przypadku programu Grafana 9.0 w [feature_toggles] sekcji ustaw wartość prometheus_azure_authtrue.
W przypadku wersji Grafana 9.1 i nowszych w [auth] sekcji ustaw azure_auth_enabled ustawienie na true.
Uruchom ponownie wystąpienie narzędzia Grafana.
Tworzenie źródła danych Prometheus w narzędziu Grafana
Skonfiguruj rozwiązanie Prometheus jako źródło danych, wykonując następujące kroki:
Otwórz narzędzie Grafana w przeglądarce.
Wybierz pozycję Połączenia , a następnie pozycję Źródła danych.
Wybierz pozycję Dodaj źródło danych
Wyszukaj i wybierz pozycję Prometheus.
Wklej punkt końcowy zapytania z obszaru roboczego usługi Azure Monitor do pola adresu URL .
W obszarze Uwierzytelnianie wybierz pozycję Azure Auth. W przypadku starszych wersji narzędzia Grafana w obszarze Auth włącz opcję Azure Authentication (Uwierzytelnianie platformy Azure)
W obszarze Uwierzytelnianie platformy Azure wybierz pozycję Rejestracja aplikacji z listy rozwijanej Uwierzytelnianie.
Wprowadź identyfikator direct(dzierżawy), identyfikator aplikacji (klienta) i klucz tajny klienta wygenerowany podczas tworzenia rejestracji aplikacji.
Przewiń w dół strony i wybierz pozycję Zapisz i przetestuj.
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, jako identyczne szeregi czasowe, jeśli różnią się one od innych szeregów czasowych tylko wielkością lister w 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 aktualizacji węzła, w którym pojawia się ta luka. To zachowanie nie ma wpływu na żadne z naszych zalecanych reguł alertów.