Wybierz odpowiednią strategię zapytań dla Azure Resource Graph

Azure Resource Graph (ARG) został stworzony z myślą o szybkich, dużych zapytaniach na Twoich zasobach Azure. Ponieważ ARG indeksuje dane asynchronicznie, ważne jest, aby zrozumieć, kiedy bezpośrednio zapytać ARG, a kiedy wrócić do dostawcy zasobów (RP), który jest właścicielem zasobu – źródła prawdy dotyczącego jego stanu zasobu. Ten artykuł wyjaśnia, jak ARG wpisuje się w płaszczyznę kontroli Azure, kiedy stosować hybrydową strategię zapytań ARG + RP oraz jak wybierać między RP, interfejsem API zapytań ARG a interfejsem API Get/List.

Jak ARG wpisuje się w płaszczyznę kontroli Azure

Płaszczyzna kontroli zasobów składa się z trzech komponentów:

  • Azure Resource Manager (ARM) – brama żądań dla ARG. ARM kieruje żądania do ARG bez konieczności wykonywania indywidualnych wywołań do każdego dostawcy zasobów.

  • Dostawcy zasobów (na przykład Dostawca zasobów obliczeniowych, czyli CRP) – źródło prawdy dla stanu zasobu. Bezpośrednie wywołania do API dostawcy zasobów zwracają bardzo spójne dane.

  • Azure Resource Graph (ARG) – asynchroniczny indeks nad danymi płaszczyzny sterowania, stworzony do wysokoprzepustowego, skalowalnego zapytań na dużych zbiorach zasobów. ARG działa niemal w czasie rzeczywistym i opiera się na modelu spójności ostatecznej ze względu na rozproszony charakter systemu obsługującego ten interfejs API. Jest nieznacznie opóźnione względem źródła referencyjnego, a czasami nawet bardziej, jeśli wystąpią zakłócenia po stronie backendu.

ARG pozostaje zsynchronizowany dzięki dwóm mechanizmom: asynchronicznym powiadomieniom o zmianach z usługi ARM i od dostawców zasobów oraz okresowym przebiegom uzgadniania, które wychwytują wszystko, co zostało pominięte w powiadomieniach.

Note

ARG wymienia silną spójność na rzecz skali i przepustowości. Interfejsy API dostawców zasobów przedkładają przepustowość nad poprawność w danym momencie. Wybierz w zależności od tego, którego potrzebujesz w swojej firmie.

Stosuj hybrydową strategię zapytań w krytycznych sytuacjach

W sytuacjach, gdy świeżość danych i ich niezawodność mają znaczenie, stosuj strategię hybrydową: zapytaj ARG o skalę i wracaj do API dostawcy zasobów, gdy wykryjesz problem ze świeżością danych, opóźnienie indeksowania lub podwyższone opóźnienia, albo przed podjęciem krytycznego działania opartego na stanie zasobu. Takie podejście pozwala jednocześnie uniknąć dwóch rodzajów błędów – kosztu ciągłego, bezpośredniego wywoływania RP oraz ryzyka podejmowania działań na podstawie nieaktualnych danych ARG, jak gdyby były aktualne (na przykład ponownego uruchomienia lub wycofania zasobu z aprowizacji na podstawie nieaktualnego stanu).

Typowe scenariusze

Ankietowanie bezpośrednio po utworzeniu zasobów – Niektóre workflowy odpytują zasób w ciągu 1–2 sekund od jego utworzenia — na przykład czekając provisioningState na osiągnięcie ostatecznego stanu lub oczekiwania na pojawienie się określonych właściwości w odpowiedzi. Ponieważ indeksowanie ARG może nie być kompletne, zapytanie wysłane tak szybko po utworzeniu może wrócić 404 Not Found mimo istnienia zasobu. Stosuj strategię hybrydową, aby uniknąć wyników fałszywie ujemnych: jeśli ARG zwróci status „not found” bezpośrednio po operacji zapisu, przed potraktowaniem tego jako błędu odwołaj się do dostawcy zasobów.

Weryfikacja stanu przed operacją destrukcyjną – Jeśli Twój workflow używa ARG do identyfikacji kandydatów na zasoby operacji, a ta operacja jest destrukcyjna (usunięcie, ponowne uruchomienie, deprovisionacja), nie reaguj bezpośrednio na wynik ARG. Opóźnienia backendu mogą sprawić, że widok ARG na zasób jest nieaktualny. To ryzyko jest znaczące, gdy powstałego działania nie da się cofnąć.

Ważna

Użyj ARG do zbudowania listy kandydatów, a następnie przed wykonaniem destrukcyjnej akcji wykonaj silną kontrolę spójności wobec dostawcy zasobów.

Wskazówki dotyczące radzenia sobie ze spójnością ostateczną w ARG

  • Weryfikuj tylko przed wykonaniem nieodwracalnych działań, nie przy każdym odpytywaniu. Dodaj dodatkową kontrolę dostawcy zasobów przed przepływami pracy mającymi wpływ na klienta lub o charakterze destrukcyjnym — nie dla każdego zapytania ARG. Weryfikowanie każdego odpytania niweczy sens korzystania z ARG i może wywołać ograniczanie przepustowości w dużej skali. Zasada jest taka: zaufaj ARG w zakresie identyfikacji i skali, a następnie zweryfikuj to w źródle prawdy tuż przed wykonaniem jakiejkolwiek nieodwracalnej operacji.

    Wskazówka

    Jeśli weryfikacja wolumenu operacji budzi obawy o ograniczanie limitu, skontaktuj się z Microsoftem zanim osiągniesz limit. Zwiększenia limitów w celu obsługi tego wzorca są uzasadnioną i spodziewaną prośbą — a nie przypadkiem skrajnym.

  • Dodaj czas oczekiwania między kolejnymi zapytaniami ARG, jeśli twój scenariusz na to pozwala. Gdy tak się dzieje, zastosuj wykładnicze cofnięcie: zacznij od kilku sekund przed pierwszą próbą i zwiększ czas oczekiwania z każdą kolejną próbą (na przykład 2 → 4 → 8 → 16 sekund...) do limitu kilku minut. Przestań zwiększać, gdy osiągniesz ten limit, i albo kontynuuj ankietowanie w ograniczonym czasie, albo wróć do API dostawcy zasobów.

  • Rozważ użycie interfejsu API ARG Get/List w przypadku odpytywania z wysoką częstotliwością. Zobacz tę sekcję, która zawiera więcej informacji na temat konfigurowania mechanizmu awaryjnego za pomocą Get/List API.

Porównanie interfejsu API

Użyj tej tabeli, aby zdecydować, które API pasuje do Twojego scenariusza.

Funkcja API dostawcy zasobów (przykład: CRP) ARG Query API API ARG do pobierania/listowania
Co to jest Bezpośrednie wywołania do własnych API dostawcy zasobów (na przykład API VM/VMSS) w celu zapytań o zasoby i zapasy. API masowych zapytań Azure Resource Graph, dostępne przez Resource Graph Explorer w portalu Azure, Azure PowerShell, Azure CLI, SDK oraz REST API. Używa istniejących interfejsów API Get/List płaszczyzny sterowania z dołączonym parametrem useResourceGraph=true, co powoduje skierowanie wywołania do zaplecza ARG. Dostępne przez Azure REST API oraz wybrane SDK.
Referencja Znajdź dostawców zasobów według usług platformy Azure Uruchom zapytanie usługi Azure Resource Graph za pomocą interfejsu API REST, które korzysta z POST /providers/Microsoft.ResourceGraph/resources ARG GET/LIST API wykorzystuje istniejące API GET na płaszczyźnie sterowania, które dodają flagę useResourceGraph=true do API, co płynnie kieruje wywołanie do tego backendu.
Najlepsze dla • Małoskalowe, doraźne lub rzadkie zapytania dotyczące API płaszczyzny sterowania.
• Scenariusze wymagające silnie spójnych danych bezpośrednio ze źródła prawdy.
• Ostateczna kontrola przed operacją destrukcyjną lub nieodwracalną (usunięcie, ponowne uruchomienie, deprovisionacja).
• Rozwiązanie awaryjne, gdy dane ARG są nieaktualne.
• Masowe wyszukiwania na poziomie dzierżawca, które łączą się między wieloma dzierżawcami, subskrypcjami, grupami zasobów lub grupami zarządzania dla złożonych scenariuszy analitycznych.
• Skanowanie lub odpytywanie wielu zasobów (tysiące lub więcej) w celu sprawdzenia ich stanu.
• Wyszukiwania ograniczone do pełnej powierzchni API get/list dla jednej subskrypcji lub grupy zasobów.
• Scenariusze sondaży o wysokiej równobieżności i dużej przepustowości.
Limit ograniczania Różni się w zależności od zasobu i operacji, na ogół niższy od limitów ARG. Przykład: GET na VMSS to 36 połączeń/min na poziomie zasobów i 2000 połączeń/min na poziomie subskrypcji. 15 zapytań na 5 sekund. Można to zgłaszać indywidualnie. Zgodny z limitami ARM — do 4 000 zapytań/min/subskrypcja/dzwoniący. Jest to miękki limit i można go podnosić w razie potrzeby.
Poziom spójności Zdecydowanie spójne — to jest źródło prawdy. Podąża za modelem spójności ostatecznej. Dane są indeksowane w backendzie ARG z opóźnieniem kilku minut, zazwyczaj poniżej 1 minuty. Podąża za modelem spójności ostatecznej. Dane są indeksowane w backendzie ARG z opóźnieniem kilku minut, zazwyczaj poniżej 1 minuty.
dostępność Same API płaszczyzny sterowania nie posiadają SLA, ale zasoby zarządzane przez nie mają – na przykład Azure maszyny wirtualne mają SLA na poziomie 99,9% lub wyższym, w zależności od opcji redundancji. Brak publicznego SLA. Brak publicznego SLA.
Etap cyklu życia produktu Ogólnodostępność Ogólnodostępność Ogólnodostępność
Ceny Dzwonimy bezpłatnie. Zasoby tworzone lub zarządzane przez te API (VM, magazyny itp.) podlegają standardowym opłatom Azure. Bezpłatna Bezpłatna

Note

Limity ograniczania przepustowości różnią się w zależności od typu zasobu i operacji. Powyższe rysunki to przykłady (VMSS pokazane dla kolumny dostawcy zasobów) – sprawdź aktualne limity dla konkretnego typu i regionu zasobów, zamiast traktować te liczby jako stałe wartości.

Zarówno hybrydowy mechanizm awaryjny, jak i interfejs API Get/List pomagają uzyskać możliwie najdokładniejszy dostępny stan zasobów, bez ryzyka zablokowania z powodu krótkotrwałych luk w aktualności danych.