az webapp troubleshoot

  • Wersja Preview

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Diagnozowanie typowych problemów z aplikacją internetową systemu Linux.

Grupa poleceń w wersji zapoznawczej, która paruje wbudowane testy konfiguracji (z usługi KuduLite w ramach procesu roboczego) ze stanem środowiska uruchomieniowego dla wystąpienia i podsumowaniami uruchamiania z usługi ARM. Użyj polecenia , gdy uruchamianie aplikacji systemu Linux kończy się niepowodzeniem, zwracanie protokołu HTTP 502/503 lub wykazywanie innych błędów po wdrożeniu.

Polecenia

Nazwisko Opis Typ Stan
az webapp troubleshoot collect

Zbieranie artefaktów diagnostycznych z aplikacji internetowej systemu Linux.

 Core Preview
az webapp troubleshoot collect network-capture

Zbieranie i analizowanie przechwytywania pakietów z kontenera aplikacji internetowej systemu Linux.

 Core Preview
az webapp troubleshoot config

Zweryfikuj konfigurację aplikacji internetowej systemu Linux i uwidokuj ostatni błąd środowiska uruchomieniowego.

 Core Preview
az webapp troubleshoot deployment

Pokaż najnowszy stan wdrożenia i informacje diagnostyczne dla aplikacji internetowej systemu Linux.

 Core Preview
az webapp troubleshoot status

Pokaż stan środowiska uruchomieniowego witryny i ostatnie podsumowanie uruchamiania dla aplikacji internetowej systemu Linux.

 Core Preview

az webapp troubleshoot config

Wersja Preview

Grupa poleceń "rozwiązywanie problemów z aplikacją internetową" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zweryfikuj konfigurację aplikacji internetowej systemu Linux i uwidokuj ostatni błąd środowiska uruchomieniowego.

Agreguje dwa źródła danych w jeden raport: (1) Wbudowane kontrole konfiguracji — zestaw typowych ustawień usługi App Service systemu Linux (linuxFxVersion, powiązanie portu, polecenie uruchamiania, alwaysOn, ścieżka sprawdzania kondycji, ...) oceniane względem migawki konfiguracji uruchomionej witryny. (2) Błąd stanu środowiska uruchomieniowego lokacji zgłoszony przez usługę App Service dla procesu roboczego reprezentowanego przez migawkę sprawdzania konfiguracji. Użyj z --instance nazwą maszyny procesu roboczego, aby pobrać testy konfiguracji tego procesu roboczego. Identyfikator wystąpienia zwrócony przez te testy służy do wybierania zgodnego błędu środowiska uruchomieniowego. Jeśli migawka konfiguracji jest niedostępna, nazwa maszyny jest rozpoznawana za pośrednictwem usługi ARM, więc błąd innego procesu roboczego nie jest zwracany. Błędy środowiska uruchomieniowego są widoczne tylko wtedy, gdy wystąpiły w ciągu ostatnich 15 minut. Starsze błędy są pomijane zarówno ze ustrukturyzowanych danych wyjściowych, jak --report i widoku. Aby uzyskać 24-godzinne spojrzenie na stan środowiska uruchomieniowego i próby uruchomienia, uruchom polecenie az webapp troubleshoot status. Domyślnie polecenie zwraca ładunek ze strukturą, więc standardowe -o json/yaml/tsv/table formatery obsługują dane wyjściowe. Przekaż --report , aby wydrukować czytelny dla człowieka raport dwuczęściowy do stdout.

az webapp troubleshoot config --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--instance]
                              [--report {false, true}]
                              [--slot]

Przykłady

Uruchom wbudowane testy konfiguracji i wyświetl ostatni błąd środowiska uruchomieniowego, jeśli istnieje (domyślnie plik JSON)

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup

Drukowanie raportu czytelnego dla człowieka

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --report

Określanie docelowego miejsca wdrożenia

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --slot staging

Uruchamianie testów i wyświetlanie ostatniego błędu środowiska uruchomieniowego dla określonego wystąpienia procesu roboczego

az webapp troubleshoot config --name MyWebApp --resource-group MyResourceGroup --instance lw0sdlwk000002

Parametry wymagane

--name -n

Nazwa aplikacji internetowej. Jeśli nie zostanie określony, zostanie wygenerowana losowo nazwa. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults web=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--instance

Filtrowanie kontroli konfiguracji według nazwy maszyny procesu roboczego. Zalecenie dotyczące błędu środowiska uruchomieniowego używa odpowiedniego identyfikatora wystąpienia usługi ARM i nigdy nie wraca do innego procesu roboczego.

--report

Wydrukuj raport czytelny dla człowieka zamiast ładunku strukturalnego.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne wartości: false, true
--slot -s

Nazwa miejsca. Wartość domyślna miejsca produkcyjnego, jeśli nie zostanie określona.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az webapp troubleshoot deployment

Wersja Preview

Grupa poleceń "rozwiązywanie problemów z aplikacją internetową" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pokaż najnowszy stan wdrożenia i informacje diagnostyczne dla aplikacji internetowej systemu Linux.

Zwraca migawkę typu punkt w czasie z usługi Kudu i wzbogaca ją o stan kompilacji i środowiska uruchomieniowego platformy, gdy jest dostępny. Polecenie obsługuje aplikacje internetowe systemu Linux i nie czeka na ukończenie wdrożenia.

az webapp troubleshoot deployment --name
                                  --resource-group
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--slot]

Przykłady

Pokaż najnowszy stan wdrożenia aplikacji internetowej.

az webapp troubleshoot deployment --resource-group ResourceGroup --name AppName

Pokaż najnowszy stan wdrożenia dla miejsca wdrożenia.

az webapp troubleshoot deployment --resource-group ResourceGroup --name AppName --slot staging

Parametry wymagane

--name -n

Nazwa aplikacji internetowej. Jeśli nie zostanie określony, zostanie wygenerowana losowo nazwa. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults web=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--slot -s

Nazwa miejsca aplikacji internetowej. Domyślnie jest to miejsce produkcyjne.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az webapp troubleshoot status

Wersja Preview

Grupa poleceń "rozwiązywanie problemów z aplikacją internetową" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pokaż stan środowiska uruchomieniowego witryny i ostatnie podsumowanie uruchamiania dla aplikacji internetowej systemu Linux.

Agreguje dwa źródła danych:

  • Stan środowiska uruchomieniowego witryny
  • Podsumowanie uruchomienia: KuduLite (SCM) /api/startuplogs/summary (liczba pomyślnych i zakończonych niepowodzeniem prób uruchomienia w ciągu ostatnich 24 godzin oraz najnowsze znaczniki czasu powodzenia i niepowodzenia).

Użyj --instance, aby ograniczyć zakres obu do jednego procesu roboczego. Domyślnie polecenie zwraca ładunek ze strukturą, więc standardowe -o json/yaml/table formatery obsługują dane wyjściowe. Przekaż --report , aby wydrukować czytelny dla człowieka raport dwuczęściowy do stdout.

az webapp troubleshoot status --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--instance]
                              [--report {false, true}]
                              [--slot]

Przykłady

Pokaż stan wszystkich wystąpień aplikacji internetowej (domyślnie JSON)

az webapp troubleshoot status --name MyWebApp --resource-group MyResourceGroup

Drukowanie raportu czytelnego dla człowieka

az webapp troubleshoot status --name MyWebApp --resource-group MyResourceGroup --report

Pokaż stan o zakresie dla pojedynczego wystąpienia procesu roboczego

az webapp troubleshoot status --name MyWebApp --resource-group MyResourceGroup --instance 7c2d9

Parametry wymagane

--name -n

Nazwa aplikacji internetowej. Jeśli nie zostanie określony, zostanie wygenerowana losowo nazwa. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults web=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--instance

Określanie zakresu raportu do pojedynczego wystąpienia procesu roboczego.

Akceptuje szesnastkowy identyfikator wystąpienia (z az webapp list-instances) lub nazwę maszyny (np. lw0sdlwk0007AB). Po pominięciu funkcja zwraca przegląd każdego wystąpienia widocznego w ciągu ostatnich 24 godzin.

--report

Drukuj czytelny dla człowieka, kolorowy raport zamiast zwracać dane ustrukturyzowane.

Po ustawieniu polecenie zapisuje sformatowany raport (tabela przeglądu oraz stan ostatniego środowiska uruchomieniowego i podsumowanie uruchamiania) do wartości stdout i nie zwraca żadnych danych wyjściowych z możliwością odczytu maszyny. Pomiń parametr --report, aby zachować domyślny ładunek ustrukturyzowany, który działa z elementami -o json, -o yamli -o table.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne wartości: false, true
--slot -s

Nazwa miejsca. Wartość domyślna miejsca produkcyjnego, jeśli nie zostanie określona.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False