Wykres historyczny dla pul agentów (wersja zapoznawcza)

Usługa Azure DevOps Services

Raport użycia puli umożliwia wyświetlanie zadań uruchomionych w pulach agentów połączonych ze 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 zakupić 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świetlać 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 dla 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 uruchomione zadania dla własnych agentów	Agent zestawu skalowania i samodzielnie hostowany
Prywatna współbieżność hostowana samodzielnie	Wyświetla współbieżność, zadania w kolejce i uruchomione zadania dla prywatnych projektów hostowanych samodzielnie	Agent zestawu skalowania i samodzielnie hostowany

Wykresy w raporcie zużycie puli przedstawiają następujące punkty 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 w trybie online w puli agentów (self-hosted ) lub w 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ż w ciągu 10 minut na osi czasu może zostać ukończonych wiele krótko działających zadań, 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 wykreśliny 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 pokazano 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łu 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 jest wyświetlany raport zużycie puli?

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.

Element dla projektu można pobrać project_id , 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 zapytania, 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 zwróconych 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ż agenci 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ń zostało ukończonych w 10-minutowym interwale, współtworzy łączną liczbę uruchomionych zadań w danym interwale.

Jaka jest różnica między wyświetlaniem grafó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 wykreśliny przy użyciu danych z potoków w tym konkretnym projekcie, w których uruchomiono zadania w tej puli.