Udostępnij za pośrednictwem

Invoke-AzOperationalInsightsQuery

  • Odwołanie
Moduł:
Az.OperationalInsights

Zwraca wyniki wyszukiwania na podstawie określonych parametrów.

Składnia

Invoke-AzOperationalInsightsQuery
      -WorkspaceId <String>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Invoke-AzOperationalInsightsQuery
      -Workspace <PSWorkspace>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Invoke-AzOperationalInsightsQuery zwraca wyniki wyszukiwania na podstawie określonych parametrów. Możesz uzyskać dostęp do stanu wyszukiwania we właściwości Metadata zwróconego obiektu. Jeśli stan to Oczekiwanie, wyszukiwanie nie zostało ukończone, a wyniki będą pochodzić z archiwum. Wyniki wyszukiwania można pobrać z właściwości Value zwróconego obiektu. Sprawdź szczegóły ogólnych limitów zapytań tutaj: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Uwaga: spróbuj ustawić -Wait na większą wartość, jeśli wystąpi błąd "Żądanie zostało anulowane z powodu skonfigurowanego limitu czasu httpclient.timeout 100 sekund".

Przykłady

Przykład 1. Pobieranie wyników wyszukiwania przy użyciu zapytania

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results

Po wywołaniu $queryResults.Wyniki będą zawierać wszystkie wiersze wynikowe z zapytania.

Przykład 2. Konwertowanie $results. Wynik IEnumerable do tablicy

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)

Niektóre zapytania mogą powodować zwracanie bardzo dużych zestawów danych. W związku z tym domyślne zachowanie polecenia cmdlet polega na zwracaniu liczby IEnumerable w celu zmniejszenia kosztów pamięci. Jeśli wolisz mieć tablicę wyników, możesz użyć metody rozszerzenia LINQ Enumerable.ToArray(), aby przekonwertować element IEnumerable na tablicę.

Przykład 3. Pobieranie wyników wyszukiwania przy użyciu zapytania w określonym przedziale czasu

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results

Wyniki z tego zapytania będą ograniczone do ostatnich 24 godzin.

Przykład 4. Uwzględnij statystyki renderowania & w wyniku zapytania

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results

$queryResults.Render

$queryResults.Statistics

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeRender

Jeśli zostanie określony, informacje o renderowaniu zapytań dotyczących metryk zostaną uwzględnione w odpowiedzi.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeStatistics

Jeśli zostanie określony, statystyki zapytań zostaną uwzględnione w odpowiedzi.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Query

Zapytanie do wykonania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Timespan

Przedział czasu, przez który ma być powiązane zapytanie.

Typ:Nullable<T>[TimeSpan]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Wait

Umieszcza górną granicę czasu, przez jaki serwer spędzi przetwarzanie zapytania. Zobacz: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Workspace

Obszar roboczy

Typ:PSWorkspace
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WorkspaceId

Identyfikator obszaru roboczego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSWorkspace

Dane wyjściowe

PSQueryResponse