Wykres historyczny dla pul agentów (wersja zapoznawcza)

Azure DevOps Services

Raport użycia puli umożliwia wyświetlanie zadań uruchomionych w pulach agentów grafowanych z współbieżnością zadań puli agentów w okresie do 30 dni. Dzięki tym informacjom możesz zdecydować, czy zadania nie są uruchomione z powodu limitów współbieżności. Jeśli masz wiele zadań umieszczonych w kolejce lub uruchomionych zadań w limicie współbieżności lub agentów online, możesz kupić dodatkowe zadania równoległe lub aprowizować więcej własnych agentów.

Wymagania wstępne

Ważne

Musisz być członkiem grupy Administratorzy kolekcji projektów, aby wyświetlić raporty użycia puli dla pul agentów w organizacji, w tym raporty na poziomie projektu w tej organizacji.

Raport użycia puli

Raport użycia puli jest częścią karty Analiza puli agentów i zawiera następujące wykresy, w zależności od typu puli agentów.

Typ wykresu	opis	Typ puli agentów
Współbieżność hostowana publicznie	Wyświetla współbieżność, zadania w kolejce i uruchomione zadania dla projektów publicznych	Hostowane przez firmę Microsoft
Współbieżność hostowana prywatnie	Wyświetla współbieżność, zadania w kolejce i uruchomione zadania dla projektów prywatnych	Hostowane przez firmę Microsoft
Użycie agenta	Wyświetla agentów online, zadania w kolejce i uruchamianie zadań dla własnych agentów	Agent zestawu skalowania i self-hosted
Prywatna współbieżność współbieżności	Wyświetla współbieżność, zadania w kolejce i uruchomione zadania dla prywatnych projektów hostowanych samodzielnie	Agent zestawu skalowania i self-hosted

Wykresy w raporcie użycia puli grafy następujących punktów danych:

• Współbieżność — liczba zadań równoległych w organizacji, które mają zastosowanie do typu projektu (publicznego lub prywatnego) i typu puli agentów (hostowanego przez firmę Microsoft lub własnego). Aby uzyskać więcej informacji, zobacz Konfigurowanie zadań równoległych i płacenie za nie.
• Agenci online — liczba agentów online w puli własnych agentów lub puli agentów zestawu skalowania.
• Zadania w kolejce — liczba zadań w kolejce i oczekiwanie na agenta.
• Uruchomione zadania — liczba uruchomionych zadań.

Dane puli są agregowane z dokładnością do 10 minut, a liczba uruchomionych zadań jest wykreśliwana na podstawie maksymalnej liczby uruchomionych zadań dla określonego interwału czasu. Ponieważ wiele krótko działających zadań może zostać ukończonych na 10-minutowej osi czasu, liczba uruchomionych zadań może czasami być wyższa niż współbieżność lub agenci online w tym samym okresie.

Zakres raportu

Raport użycia puli może być wyświetlany w zakresie organizacji lub w zakresie projektu. Na poziomie organizacji wykres jest wykreślowany przy użyciu danych z potoków w dowolnym projekcie w organizacji, w których uruchomiono zadania w tej puli. Na poziomie projektu wykres jest kreślony przy użyciu danych z potoków w tym konkretnym projekcie, w których uruchomiono zadania w tej puli.

• Aby wyświetlić raport użycia puli na poziomie organizacji, wybierz pozycję Ustawienia organizacji, Potoki, Pule agentów.
• Aby wyświetlić raport użycia puli na poziomie projektu, przejdź do żądanego projektu i wybierz pozycję Ustawienia projektu, Potoki, Pule agentów.

W widoku Pule agentów wybierz żądaną pulę i wyświetl kartę Analiza. W poniższym przykładzie przedstawiono raport użycia puli dla puli agentów hostowanych samodzielnie.

W tym przykładzie przedstawiono wykresy użycia dla puli agentów hostowanych przez firmę Microsoft w usłudze Azure Pipelines .

Filtrowanie

Aby dostosować oś czasu wykresu, wybierz pozycję Filtruj , wybierz listę rozwijaną interwał i wybierz żądany interwał.

W przypadku interwału 1 dnia można wyświetlać dane na godzinę i dla innych interwałów, które można wyświetlić na dzień. Dane puli są agregowane z dokładnością do 10 minut, a liczba uruchomionych zadań jest wykreśliwana na podstawie maksymalnej liczby uruchomionych zadań dla określonego interwału czasu. W tym przykładzie istnieją dwa agenty online, ale w niektórych obszarach istnieją cztery uruchomione zadania ze względu na sposób agregowania danych puli.

Często zadawane pytania

Gdzie raport użycia puli pobiera wyświetlane dane?

Raport użycia puli używa usługi Azure DevOps Analytics i punktu końcowego TaskAgentRequestSnapshots . Możesz wykonać zapytanie dotyczące tego punktu końcowego przy użyciu następującego prefiksu adresu URL: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Możesz pobrać element project_id dla projektu, przechodząc do następującego adresu URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

Poniższy przykład przedstawia przykładowe zapytanie i odpowiedź.

{
"@odata.context": "https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/$metadata#TaskAgentRequestSnapshots",
"vsts.warnings@odata.type": "#Collection(String)",
"@vsts.warnings": [
"VS403507: The specified query does not include a $select or $apply clause which is recommended for all queries. Details on recommended query patterns are available here: https://go.microsoft.com/fwlink/?linkid=861060."
],
"value": [
{
"SamplingDateSK": 20201117,
"SamplingHour": 13,
"SamplingTime": "2020-11-17T13:10:00-08:00",
"QueuedDate": "2020-11-17T13:07:26.22-08:00",
"QueuedDateSK": 20201117,
"StartedDate": "2020-11-17T15:02:23.7398429-08:00",
"StartedDateSK": 20201117,
"FinishedDate": "2020-11-17T15:13:49.89-08:00",
"FinishedDateSK": 20201117,
"QueueDurationSeconds": 6897.519,
"ProjectSK": "...",
"PipelineSK": 5141,
"RequestId": 6313,
"PoolId": 28,
"PipelineType": "Build",
"IsHosted": true,
"IsRunning": false,
"IsQueued": true
},
...

Aby uzyskać więcej informacji na temat opcji zapytań, zobacz Wytyczne dotyczące zapytań dla analizy za pomocą usługi OData.

Uwaga

Punkt TaskAgentRequestSnapshots końcowy jest w wersji zapoznawczej i nie jest jeszcze udokumentowany, ale możesz wyświetlić informacje o zwracanych danych, przechodząc do adresu URL punktu końcowego: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Dlaczego istnieje więcej uruchomionych zadań niż agentów lub współbieżność?

Dane puli są agregowane z dokładnością do 10 minut, a liczba uruchomionych zadań jest wykreśliwana na podstawie maksymalnej liczby uruchomionych zadań dla określonego interwału czasu. Każde uruchomione zadanie jest liczone oddzielnie, a jeśli wiele zadań zostanie ukończonych w 10-minutowym interwale, współtworzy łączną liczbę uruchomionych zadań dla tego interwału.

Jaka jest różnica między wyświetlaniem wykresów w ustawieniach projektu a ustawieniami organizacji?

Zakres danych na grafie jest określany na podstawie tego, czy dostęp do wykresu jest uzyskiwany za pośrednictwem ustawień projektu, czy ustawień organizacji. Na poziomie organizacji wykres jest wykreślowany przy użyciu danych z potoków w dowolnym projekcie w organizacji, w których uruchomiono zadania w tej puli. Na poziomie projektu wykres jest kreślony przy użyciu danych z potoków w tym konkretnym projekcie, w których uruchomiono zadania w tej puli.