Włączanie dzienników wykonywania przesyłania strumieniowego w Azure Functions

Podczas tworzenia aplikacji często chcesz zobaczyć, co jest zapisywane w dziennikach niemal w czasie rzeczywistym podczas uruchamiania na platformie Azure.

Istnieją dwa sposoby wyświetlania strumienia plików dziennika generowanych przez wykonania funkcji.

  • Wbudowane przesyłanie strumieniowe dzienników: platforma App Service umożliwia wyświetlanie strumienia plików dziennika aplikacji. Jest to odpowiednik danych wyjściowych widocznych podczas debugowania funkcji podczas programowania lokalnego i używania karty Test w portalu. Zostaną wyświetlone wszystkie informacje oparte na dzienniku. Aby uzyskać więcej informacji, zobacz Stream logs (Dzienniki usługi Stream). Ta metoda przesyłania strumieniowego obsługuje tylko jedno wystąpienie i nie może być używana z aplikacją działającą w systemie Linux w planie Zużycie.

  • Transmisja strumieniowa metryk na żywo: gdy aplikacja funkcji jest połączona z aplikacją Szczegółowe informacje, możesz wyświetlać dane dziennika i inne metryki niemal w czasie rzeczywistym w Azure Portal przy użyciu strumienia metryk na żywo. Użyj tej metody podczas monitorowania funkcji działających w wielu wystąpieniach lub w systemie Linux w planie zużycie. Ta metoda używa przykładowych danych.

Strumienie dzienników można wyświetlać zarówno w portalu, jak i w większości lokalnych środowisk programistycznych.

Portal

W portalu można wyświetlić oba typy strumieni dzienników.

Wbudowane przesyłanie strumieniowe dzienników

Aby wyświetlić dzienniki przesyłania strumieniowego w portalu, wybierz kartę Funkcje platformy w aplikacji funkcji. Następnie w obszarze Monitorowanie wybierz pozycję Przesyłanie strumieniowe dzienników.

Enable streaming logs in the portal

Spowoduje to połączenie aplikacji z usługą przesyłania strumieniowego dzienników, a dzienniki aplikacji są wyświetlane w oknie. Można przełączać się między dziennikami aplikacji i dziennikami serwera sieci Web.

View streaming logs in the portal

Transmisja strumieniowa metryk na żywo

Aby wyświetlić strumień metryk na żywo dla aplikacji, wybierz kartę Przegląd aplikacji funkcji. Po włączeniu Szczegółowe informacje aplikacji zostanie wyświetlony link Aplikacja Szczegółowe informacje w obszarze Skonfigurowane funkcje. Ten link umożliwia przejście do strony Szczegółowe informacje aplikacji dla aplikacji.

W obszarze Aplikacja Szczegółowe informacje wybierz pozycję Transmisja strumieniowa metryk na żywo. Przykładowe wpisy dziennika są wyświetlane w obszarze Przykładowa telemetria.

View Live Metrics Stream in the portal

Visual Studio Code

Aby włączyć dzienniki przesyłania strumieniowego dla aplikacji funkcji na platformie Azure:

  1. Wybierz klawisz F1, aby otworzyć paletę poleceń, a następnie wyszukaj i uruchom polecenie Azure Functions: Uruchom dzienniki przesyłania strumieniowego.

  2. Wybierz aplikację funkcji na platformie Azure, a następnie wybierz pozycję Tak , aby włączyć rejestrowanie aplikacji dla aplikacji funkcji.

  3. Wyzwalanie funkcji na platformie Azure. Zwróć uwagę, że dane dziennika są wyświetlane w oknie Dane wyjściowe w Visual Studio Code.

  4. Gdy skończysz, pamiętaj, aby uruchomić polecenie Azure Functions: Zatrzymaj przesyłanie strumieniowe dzienników, aby wyłączyć rejestrowanie dla aplikacji funkcji.

Podstawowe narzędzia

Wbudowane przesyłanie strumieniowe dzienników

func azure functionapp logstream Użyj polecenia , aby rozpocząć odbieranie dzienników przesyłania strumieniowego określonej aplikacji funkcji uruchomionej na platformie Azure, jak w poniższym przykładzie:

func azure functionapp logstream <FunctionAppName>

Uwaga

Wbudowane przesyłanie strumieniowe dzienników nie jest jeszcze włączone w narzędziach Core Tools dla aplikacji funkcji działających w systemie Linux w planie Zużycie. W przypadku tych planów hostingu należy zamiast tego użyć strumienia metryk na żywo, aby wyświetlić dzienniki niemal w czasie rzeczywistym.

Transmisja strumieniowa metryk na żywo

Strumień metryk na żywo dla aplikacji funkcji można wyświetlić w nowym oknie przeglądarki, włączając --browser opcję , jak w poniższym przykładzie:

func azure functionapp logstream <FunctionAppName> --browser

Interfejs wiersza polecenia platformy Azure

Dzienniki przesyłania strumieniowego można włączyć przy użyciu interfejsu wiersza polecenia platformy Azure. Użyj następujących poleceń, aby się zalogować, wybrać subskrypcję i przesłać strumieniowo pliki dziennika:

az login
az account list
az account set --subscription <subscriptionNameOrId>
az webapp log tail --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME>

Azure PowerShell

Dzienniki przesyłania strumieniowego można włączyć przy użyciu Azure PowerShell. W przypadku programu PowerShell użyj polecenia Set-AzWebApp , aby włączyć rejestrowanie w aplikacji funkcji, jak pokazano w poniższym fragmencie kodu:

# Enable Logs
Set-AzWebApp -RequestTracingEnabled $True -HttpLoggingEnabled $True -DetailedErrorLoggingEnabled $True -ResourceGroupName $ResourceGroupName -Name $AppName

Aby uzyskać więcej informacji, zobacz kompletny przykład kodu.

Następne kroki