Konfigurowanie diagnostyki dla usług w chmurze i maszyn wirtualnych platformy Azure

Uwaga

Ten artykuł dotyczy usług Azure Cloud Services (wersja klasyczna), która jest obecnie przestarzała dla nowych klientów i zostanie wycofana 31 sierpnia 2024 r. Istniejące usługi utworzone za pomocą tej technologii są nadal obsługiwane za pośrednictwem usług Azure Cloud Services (wsparcie dodatkowe). W przypadku nowego programowania zalecamy użycie nowszego typu usługi przeznaczonego do określonego celu, takiego jak aplikacja systemu Azure Service, Azure Functions lub Azure Container Apps. Aby uzyskać najnowszą listę dostępnych usług, zobacz Katalog produktów platformy Azure.

Jeśli musisz rozwiązać problemy z usługą w chmurze platformy Azure lub maszyną wirtualną, możesz użyć programu Visual Studio, aby łatwiej skonfigurować Diagnostyka Azure. Diagnostyka przechwytuje dane systemowe i dane rejestrowania na maszynach wirtualnych i wystąpieniach maszyn wirtualnych, które uruchamiają usługę w chmurze. Dane diagnostyczne są przesyłane do wybranego konta magazynu. Aby uzyskać więcej informacji na temat rejestrowania diagnostycznego na platformie Azure, zobacz Włączanie rejestrowania diagnostycznego dla usługi Web Apps w usłudze aplikacja systemu Azure Service.

W tym artykule pokazano, jak używać programu Visual Studio do włączania i konfigurowania Diagnostyka Azure, zarówno przed, jak i po wdrożeniu. Dowiedz się, jak skonfigurować diagnostykę na maszynach wirtualnych platformy Azure, jak wybrać typy informacji diagnostycznych do zbierania i jak wyświetlać informacje po ich zebraniu.

Aby skonfigurować Diagnostyka Azure, zmień ustawienia diagnostyczne w oknie dialogowym Konfiguracja diagnostyki w programie Visual Studio. Ustawienia są zapisywane w pliku o nazwie diagnostics.wadcfgx. Można również bezpośrednio zmodyfikować plik konfiguracji. Jeśli ręcznie zaktualizujesz plik, zmiany konfiguracji zostaną wprowadzone przy następnym wdrożeniu usługi w chmurze na platformie Azure lub uruchomieniu usługi w emulatorze.

Ostrzeżenie

W programie Visual Studio 2022 przestarzały emulator usługi Azure Storage został zastąpiony emulatorem usługi Azurite podczas debugowania projektów usługi w chmurze. Ten emulator usługi Azurite nie działa z wtyczką Diagnostyka Azure, która zapewnia obsługę Diagnostyka Azure podczas uruchamiania i testowania lokalnego. Jeśli potrzebujesz wtyczki dla lokalnych scenariuszy uruchamiania i testowania, możesz zaktualizować parametry połączenia w konfiguracji usługi lokalnej () na konto usługi Azure Storage (.cscfgzobacz Zarządzanie parametry połączenia dla kont magazynu) lub pobrać poprzedni emulator usługi Azure Storage. W wersji programu Visual Studio 17.10 wtyczka lokalna Diagnostyka Azure jest przestarzała i będzie domyślnie wyłączona z opcją włączenia w tej wersji. Ze względu na wycofanie wtyczka może zostać usunięta w przyszłej wersji programu Visual Studio. Ta wtyczka jest używana tylko z lokalnym emulatorem usługi Azure Compute i wyłączenie nie ma wpływu na wdrożone usługi Cloud Services korzystające z rozszerzenia Diagnostyka Azure na platformie Azure. Aby włączyć wtyczkę diagnostyki w programie Visual Studio 17.10, dodaj następujące ustawienie właściwości do dowolnego PropertyGroup elementu w pliku projektu: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Jak program Visual Studio określa konto magazynu diagnostyki

• Jeśli w pliku określono .cscfg parametry połączenia diagnostyki, program Visual Studio używa go do konfigurowania rozszerzenia diagnostyki podczas publikowania i generowania publicznych plików XML konfiguracji podczas pakowania.
• Jeśli w pliku nie określono .cscfg parametry połączenia diagnostyki, program Visual Studio powraca do korzystania z konta magazynu określonego w .wadcfgx pliku w celu skonfigurowania rozszerzenia diagnostycznego do publikowania i generowania plików XML konfiguracji publicznej podczas tworzenia pakietów.
• Diagnostyka parametry połączenia w .cscfg pliku ma pierwszeństwo przed kontem magazynu w .wadcfgx pliku. Jeśli w pliku określono .cscfg parametry połączenia diagnostyki, program Visual Studio używa tego parametry połączenia i ignoruje konto magazynu w programie .wadcfgx.

Co robi pole wyboru "Aktualizuj magazyn deweloperskich parametry połączenia s..."?

Pole wyboru Aktualizowanie magazynu programistycznego parametry połączenia do diagnostyki i Buforowanie przy użyciu poświadczeń konta usługi Microsoft Azure Storage podczas publikowania na platformie Microsoft Azure jest wygodnym sposobem aktualizowania dowolnego konta magazynu programistycznego parametry połączenia przy użyciu konta usługi Azure Storage określonego podczas publikowania.

Jeśli na przykład zaznaczysz to pole wyboru, a diagnostyka parametry połączenia określa UseDevelopmentStorage=true, podczas publikowania projektu na platformie Azure program Visual Studio automatycznie aktualizuje parametry połączenia diagnostyki przy użyciu konta magazynu określonego w kreatorze publikowania. Jeśli jednak rzeczywiste konto magazynu zostało określone jako parametry połączenia diagnostyki, to konto jest używane.

Włączanie diagnostyki w projektach usługi w chmurze przed ich wdrożeniem

W programie Visual Studio można zbierać dane diagnostyczne dla ról uruchamianych na platformie Azure podczas uruchamiania usługi w emulatorze przed wdrożeniem. Wszystkie zmiany ustawień diagnostycznych w programie Visual Studio są zapisywane w pliku konfiguracji diagnostics.wadcfgx. Te ustawienia określają konto magazynu, na którym są zapisywane dane diagnostyczne podczas wdrażania usługi w chmurze.

Ostrzeżenie

Po włączeniu diagnostyki dla istniejącej roli wszystkie rozszerzenia, które zostały już ustawione, są wyłączone podczas wdrażania pakietu. Są to:

• Diagnostyka programu Microsoft Monitoring Agent
• Monitorowanie zabezpieczeń platformy Microsoft Azure
• Rozwiązanie Microsoft Antimalware
• Microsoft Monitoring Agent
• Agent profilera usług firmy Microsoft
• Rozszerzenie domeny platformy Windows Azure
• Rozszerzenie Diagnostyka Azure systemu Windows
• Rozszerzenie pulpitu zdalnego platformy Windows Azure
• Moduł zbierający dzienniki platformy Windows Azure

Rozszerzenia można zresetować za pośrednictwem witryny Azure Portal lub programu PowerShell po wdrożeniu zaktualizowanej roli.

Aby włączyć diagnostykę w programie Visual Studio przed wdrożeniem

1. W menu skrótów roli wybierz pozycję Właściwości. W oknie dialogowym Właściwości roli wybierz kartę Konfiguracja.

2. W sekcji Diagnostyka upewnij się, że pole wyboru Włącz diagnostykę zostało zaznaczone.

   

3. Aby określić konto magazynu dla danych diagnostycznych, wybierz przycisk wielokropka (...) .

   

4. W oknie dialogowym Tworzenie ciągu Połączenie ion magazynu określ, czy chcesz nawiązać połączenie przy użyciu emulatora usługi Azure Storage, subskrypcji platformy Azure, czy ręcznie wprowadzonych poświadczeń.

   

   • Jeśli wybierzesz pozycję Emulator usługi Microsoft Azure Storage, parametry połączenia zostanie ustawiona na UseDevelopmentStorage=truewartość .
   • Jeśli wybierzesz pozycję Twoja subskrypcja, możesz wybrać subskrypcję platformy Azure, której chcesz użyć, i wprowadzić nazwę konta. Aby zarządzać subskrypcjami platformy Azure, wybierz pozycję Zarządzaj kontami.
   • Jeśli wybierzesz pozycję Ręcznie wprowadzone poświadczenia, wprowadź nazwę i klucz konta platformy Azure, którego chcesz użyć.

5. Aby wyświetlić okno dialogowe Konfiguracja diagnostyki, wybierz pozycję Konfiguruj. Z wyjątkiem katalogów ogólnych i dzienników każda karta reprezentuje źródło danych diagnostycznych, które można zebrać. Domyślna karta Ogólne zawiera następujące opcje zbierania danych diagnostycznych: Tylko błędy, Wszystkie informacje i Plan niestandardowy. Domyślna opcja Błędy używa tylko najmniejszej ilości miejsca do magazynowania, ponieważ nie przesyła ostrzeżeń ani komunikatów śledzenia. Opcja Wszystkie informacje przenosi najwięcej informacji , używa najbardziej magazynu, a zatem jest najdroższą opcją.

   Uwaga

   Minimalny obsługiwany rozmiar dla opcji "Przydział dysku w MB" wynosi 50 MB, a domyślny rozmiar to 4 GB. Jeśli jednak zbierasz zrzuty pamięci, zwiększ je do większej wartości, takiej jak 10 GB.

   

6. W tym przykładzie wybierz opcję Plan niestandardowy, aby dostosować zebrane dane.

7. W polu Przydział dysku w MB można ustawić ilość miejsca do przydzielenia na koncie magazynu na potrzeby danych diagnostycznych. Możesz zmienić lub zaakceptować wartość domyślną.

8. Na każdej karcie danych diagnostycznych, które chcesz zebrać, zaznacz pole wyboru Włącz transfer <typu> dziennika. Jeśli na przykład chcesz zbierać dzienniki aplikacji, na karcie Dzienniki aplikacji zaznacz pole wyboru Włącz transfer dzienników aplikacji. Ponadto określ wszelkie inne informacje wymagane przez każdy typ danych diagnostycznych. Aby uzyskać informacje o konfiguracji dla każdej karty, zobacz sekcję Konfigurowanie źródeł danych diagnostycznych w dalszej części tego artykułu.

9. Po włączeniu zbierania wszystkich żądanych danych diagnostycznych wybierz przycisk OK.

10. Uruchom projekt usługi w chmurze platformy Azure w programie Visual Studio, jak zwykle. Podczas korzystania z aplikacji włączone informacje dziennika są zapisywane na określonym koncie usługi Azure Storage.

Konfigurowanie źródeł danych diagnostycznych

Po włączeniu zbierania danych diagnostycznych możesz wybrać dokładnie źródła danych, które chcesz zebrać, oraz jakie informacje są zbierane. W następnych sekcjach opisano karty w oknie dialogowym Konfiguracja diagnostyki i co oznacza każda opcja konfiguracji.

Dzienniki aplikacji

Dzienniki aplikacji zawierają informacje diagnostyczne tworzone przez aplikację internetową. Jeśli chcesz przechwycić dzienniki aplikacji, zaznacz pole wyboru Włącz transfer dzienników aplikacji. Aby zwiększyć lub zmniejszyć interwał między transferem dzienników aplikacji na konto magazynu, zmień wartość Okresu transferu (min). Możesz również zmienić ilość informacji przechwyconych w dzienniku, ustawiając wartość poziomu dziennika. Na przykład wybierz pozycję Pełne, aby uzyskać więcej informacji, lub wybierz pozycję Krytyczne, aby przechwycić tylko błędy krytyczne. Jeśli masz określonego dostawcę diagnostyki, który emituje dzienniki aplikacji, możesz przechwycić dzienniki, dodając identyfikator GUID dostawcy w polu Identyfikator GUID dostawcy.

Aby uzyskać więcej informacji na temat dzienników aplikacji, zobacz Włączanie rejestrowania diagnostycznego dla usługi Web Apps w usłudze aplikacja systemu Azure.

dzienniki zdarzeń systemu Windows

Aby przechwycić dzienniki zdarzeń systemu Windows, zaznacz pole wyboru Włącz transfer dzienników zdarzeń systemu Windows. Aby zwiększyć lub zmniejszyć interwał między transferem dzienników zdarzeń na konto magazynu, zmień wartość Okresu transferu (min). Zaznacz pola wyboru dla typów zdarzeń, które chcesz śledzić.

Jeśli chcesz określić niestandardowe źródło danych, wprowadź je w polu tekstowym Nazwa> źródła danych, a następnie wybierz pozycję Dodaj.< Źródło danych jest dodawane do pliku diagnostics.cfcfg.

Liczniki wydajności

Informacje o liczniku wydajności mogą pomóc w zlokalizowaniu wąskich gardeł systemu i precyzyjnego dostosowania wydajności systemu i aplikacji. Aby uzyskać więcej informacji, zobacz Tworzenie i używanie liczników wydajności w aplikacji platformy Azure. Aby przechwycić liczniki wydajności, zaznacz pole wyboru Włącz transfer liczników wydajności. Aby zwiększyć lub zmniejszyć interwał między transferem dzienników zdarzeń na konto magazynu, zmień wartość Okresu transferu (min). Zaznacz pola wyboru dla liczników wydajności, które chcesz śledzić.

Aby śledzić licznik wydajności, który nie znajduje się na liście, wprowadź licznik wydajności przy użyciu sugerowanej składni. a następnie wybierz pozycję Dodaj. System operacyjny na maszynie wirtualnej określa, które liczniki wydajności można śledzić. Aby uzyskać więcej informacji na temat składni, zobacz Określanie ścieżki licznika.

Dzienniki infrastruktury

Dzienniki infrastruktury zawierają informacje o infrastrukturze diagnostycznej platformy Azure, module RemoteAccess i module RemoteForwarder. Aby zebrać informacje o dziennikach infrastruktury, zaznacz pole wyboru Włącz transfer dzienników infrastruktury. Aby zwiększyć lub zmniejszyć interwał między transferem dzienników infrastruktury na konto magazynu, zmień wartość Okresu transferu (min).

Aby uzyskać więcej informacji, zobacz Zbieranie danych rejestrowania przy użyciu Diagnostyka Azure.

Katalogi dzienników

Katalogi dzienników zawierają dane zebrane z katalogów dzienników dla żądań internetowych usług informacyjnych (IIS), żądań niepomyślnie lub wybranych folderów. Aby przechwycić katalogi dzienników, zaznacz pole wyboru Włącz transfer katalogów dzienników . Aby zwiększyć lub zmniejszyć interwał między transferem dzienników na konto magazynu, zmień wartość Okres transferu (min).

Zaznacz pola wyboru dzienników, które chcesz zebrać, takie jak dzienniki usług IIS i dzienniki żądań niepomyślnie. Podano domyślne nazwy kontenerów magazynu, ale można zmienić nazwy.

Dzienniki można przechwytywać z dowolnego folderu. Określ ścieżkę w sekcji Dziennik z katalogu bezwzględnego, a następnie wybierz pozycję Dodaj katalog. Dzienniki są przechwytywane w określonych kontenerach.

Dzienniki ETW

Jeśli używasz śledzenia zdarzeń dla systemu Windows (ETW) (ETW) i chcesz przechwycić dzienniki ETW, zaznacz pole wyboru Włącz transfer dzienników ETW. Aby zwiększyć lub zmniejszyć interwał między transferem dzienników na konto magazynu, zmień wartość Okres transferu (min).

Zdarzenia są przechwytywane ze źródeł zdarzeń i manifestów zdarzeń, które określisz. Aby określić źródło zdarzeń, w sekcji Źródła zdarzeń wprowadź nazwę, a następnie wybierz pozycję Dodaj źródło zdarzeń. Podobnie można określić manifest zdarzenia w sekcji Manifesty zdarzeń, a następnie wybrać pozycję Dodaj manifest zdarzenia.

Struktura ETW jest obsługiwana w ASP.NET za pośrednictwem klas w przestrzeni nazw System.Diagnostics.aspx . Przestrzeń nazw Microsoft.WindowsAzure.Diagnostics, która dziedziczy i rozszerza standardowe klasy System.Diagnostics.aspx , umożliwia korzystanie z System.Diagnostics.aspx jako struktury rejestrowania w środowisku platformy Azure. Aby uzyskać więcej informacji, zobacz Przejmowanie kontroli nad rejestrowaniem i śledzeniem na platformie Microsoft Azure oraz Włączanie diagnostyki w usługach Azure Cloud Services i maszynach wirtualnych.

Zrzuty awaryjne

Aby przechwycić informacje o awarii wystąpienia roli, zaznacz pole wyboru Włącz transfer zrzutów awaryjnych. (Ponieważ ASP.NET obsługuje większość wyjątków, jest to ogólnie przydatne tylko w przypadku ról procesów roboczych). Aby zwiększyć lub zmniejszyć procent miejsca do magazynowania poświęconego zrzutom awaryjnym, zmień wartość Limit przydziału katalogu (%) Możesz zmienić kontener magazynu, w którym są przechowywane zrzuty awaryjne, i wybrać, czy chcesz przechwycić zrzut pełny , czy mini .

Aktualnie śledzone procesy są wyświetlane na następnym zrzucie ekranu. Zaznacz pola wyboru dla procesów, które chcesz przechwycić. Aby dodać kolejny proces do listy, wprowadź nazwę procesu, a następnie wybierz pozycję Dodaj proces.

Aby uzyskać więcej informacji, zobacz Przejmowanie kontroli nad rejestrowaniem i śledzeniem na platformie Microsoft Azure.

Rozwiązywanie problemów z usługą w chmurze platformy Azure

Jeśli występują problemy z projektami usługi w chmurze, takie jak rola, która utknęła w stanie "zajęty", wielokrotnie odtwarza lub zgłasza wewnętrzny błąd serwera, istnieją narzędzia i techniki, których można użyć do diagnozowania i rozwiązywania problemu. Aby zapoznać się z konkretnymi przykładami typowych problemów i rozwiązań, a także zapoznać się z omówieniem pojęć i narzędzi, których można użyć do diagnozowania i naprawiania tych błędów, zobacz Dane diagnostyczne obliczeniowe platformy jako usługi (PaaS) platformy Azure.

Pytania i odpowiedzi

Jaki jest rozmiar buforu i jak duży powinien być?

W każdym wystąpieniu maszyny wirtualnej limit przydziału ogranicza ilość danych diagnostycznych, które mogą być przechowywane w lokalnym systemie plików. Ponadto określasz rozmiar buforu dla każdego typu dostępnych danych diagnostycznych. Ten rozmiar buforu działa jak indywidualny limit przydziału dla tego typu danych. Aby określić całkowity limit przydziału i ilość pamięci, która pozostaje, zobacz dolną część okna dialogowego dla typu danych diagnostycznych. W przypadku określenia większych buforów lub większej liczby typów danych nastąpi podejście do ogólnego limitu przydziału. Ogólny limit przydziału można zmienić, modyfikując plik konfiguracji diagnostics.wadcfgx . Dane diagnostyczne są przechowywane w tym samym systemie plików co dane aplikacji. Jeśli aplikacja używa dużej ilości miejsca na dysku, nie należy zwiększać ogólnego limitu przydziału diagnostyki.

Jaki jest okres transferu i jak długo powinien to być?

Okres transferu to czas, który upłynie między przechwytywaniem danych. Po każdym okresie transferu dane są przenoszone z lokalnego systemu plików na maszynie wirtualnej do tabel na koncie magazynu. Jeśli ilość zebranych danych przekracza limit przydziału przed końcem okresu transferu, starsze dane zostaną odrzucone. Jeśli tracisz dane, ponieważ dane przekraczają rozmiar buforu lub całkowity limit przydziału, możesz zmniejszyć okres transferu.

W jakiej strefie czasowej znajdują się sygnatury czasowe?

Sygnatury czasowe znajdują się w lokalnej strefie czasowej centrum danych, które hostuje usługę w chmurze. Używane są następujące trzy kolumny sygnatur czasowych w tabelach dziennika:

• PreciseTimeStamp: sygnatura czasowa ETW zdarzenia. Oznacza to, że czas rejestrowania zdarzenia z klienta.
• TIMESTAMP: wartość parametru PreciseTimeStamp zaokrąglona w dół do granicy częstotliwości przekazywania. Jeśli na przykład częstotliwość przekazywania wynosi 5 minut, a czas zdarzenia 00:17:12, sygnatura czasowa to 00:15:00.
• Sygnatura czasowa: sygnatura czasowa, w której jednostka została utworzona w tabeli platformy Azure.

Jak mogę zarządzać kosztami podczas zbierania informacji diagnostycznych?

Ustawienia domyślne (poziom dziennika ustawiony na Wartość Błąd i Okres transferu ustawiony na 1 minutę) zostały zaprojektowane tak, aby zminimalizować koszty. Koszty obliczeń zwiększają się podczas zbierania większej ilości danych diagnostycznych lub skrócenia okresu transferu. Nie zbieraj więcej danych niż potrzebujesz i nie zapomnij wyłączyć zbierania danych, gdy nie są już potrzebne. Zawsze możesz włączyć go ponownie, nawet w czasie wykonywania, jak opisano wcześniej w tym artykule.

Jak mogę zebrać dzienniki żądań niepowodzenia z usług IIS?

Domyślnie usługi IIS nie zbierają dzienników żądań niepomyślnych. Usługi IIS można skonfigurować tak, aby zbierały dzienniki żądań niepomyślnych, edytując plik web.config dla roli sieci Web.

Nie otrzymuję informacji śledzenia z metod RoleEntryPoint, takich jak OnStart. Co jest nie tak?

Metody roleEntryPoint są wywoływane w kontekście WAIISHost.exe, a nie w usługach IIS. Informacje o konfiguracji w pliku web.config, które zwykle umożliwiają śledzenie, nie mają zastosowania. Aby rozwiązać ten problem, dodaj plik config do projektu roli sieci Web i nadaj plikowi nazwę, aby był zgodny z zestawem wyjściowym zawierającym kod RoleEntryPoint . W domyślnym projekcie roli sieci Web nazwa pliku config powinna być WAIISHost.exe.config. Dodaj następujące wiersze do tego pliku:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

W oknie Właściwości ustaw właściwość Kopiuj na katalog wyjściowy, aby zawsze kopiować.

Powiązana zawartość

Aby dowiedzieć się więcej na temat rejestrowania diagnostycznego na platformie Azure, zobacz Włączanie diagnostyki w usługach Azure Cloud Services i maszynach wirtualnych oraz Włączanie rejestrowania diagnostycznego dla usługi Web Apps w usłudze aplikacja systemu Azure Service.