Konfigurowanie diagnostyki dla usług Azure Cloud Services (wsparcie dodatkowe) i maszyn wirtualnych

Uwaga

Ten artykuł dotyczy usług Azure Cloud Services (rozszerzonej pomocy technicznej). Usługi Cloud Services (wersja klasyczna) są wycofane z dnia 31 sierpnia 2024 r. Aby uzyskać więcej informacji, zobacz Model wdrażania usług w chmurze (klasyczny) zostanie wycofany 31 sierpnia 2024 r. 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ą Azure Cloud Services (rozszerzoną pomocą techniczną) 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. 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 domyślnie przestarzała i wyłączona z opcją włączenia w tej wersji. Wtyczka została usunięta w programie Visual Studio 17.11. Ta wtyczka była 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 buforowania 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. Po opublikowaniu projektu na platformie Azure program Visual Studio automatycznie aktualizuje diagnostykę parametry połączenia 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.

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 globalnie unikatowy identyfikator dostawcy (GUID) 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 (rozszerzona obsługa) 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ługami Azure Cloud Services (rozszerzona pomoc techniczna)

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 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 (rozszerzona obsługa) i maszyn wirtualnych oraz Włączanie rejestrowania diagnostycznego dla usługi Web Apps w usłudze aplikacja systemu Azure Service.