에이전트 풀에 대한 기록 그래프(미리 보기)

Azure DevOps Services

풀 사용량 보고서를 사용하면 최대 30일 동안 에이전트 풀 작업 동시성을 사용하여 그래프로 표시된 에이전트 풀에서 실행 중인 작업을 볼 수 있습니다. 이 정보를 사용하여 동시성 제한으로 인해 작업이 실행되고 있지 않은지 여부를 결정할 수 있습니다. 동시성 또는 온라인 에이전트 제한에 따라 대기 중이거나 실행 중인 작업이 많은 경우 추가 병렬 작업을 구입하거나 자체 호스팅 에이전트를 더 프로비전할 수 있습니다.

필수 조건

Important

해당 조직의 프로젝트 수준 보고서를 포함하여 조직의 에이전트 풀에 대한 풀 사용 보고서를 보려면 프로젝트 컬렉션 관리자 그룹의 구성원이어야 합니다.

풀 사용량 보고서

풀 사용량 보고서는 에이전트 풀에 대한 분석 탭의 일부이며 에이전트 풀 유형에 따라 다음 차트를 포함합니다.

차트 종류	설명	에이전트 풀 유형
퍼블릭 호스팅 동시성	공용 프로젝트에 대한 동시성, 대기 중인 작업 및 실행 중인 작업을 표시합니다.	Microsoft-hosted
프라이빗 호스팅 동시성	프라이빗 프로젝트에 대한 동시성, 대기 중인 작업 및 실행 중인 작업을 표시합니다.	Microsoft-hosted
에이전트 사용량	자체 호스팅 에이전트에 대한 온라인 에이전트, 대기 중인 작업 및 실행 중인 작업을 표시합니다.	확장 집합 에이전트 및 자체 호스팅
프라이빗 자체 호스팅 동시성	프라이빗 자체 호스팅 프로젝트에 대한 동시성, 대기 중인 작업 및 실행 중인 작업을 표시합니다.	확장 집합 에이전트 및 자체 호스팅

풀 사용량 보고서의 차트는 다음 데이터 요소를 그래프로 표시합니다.

• 동시성 - 프로젝트 유형(퍼블릭 또는 프라이빗) 및 에이전트 풀 유형(Microsoft 호스팅 또는 자체 호스팅)에 적용되는 조직의 병렬 작업 수입니다. 자세한 내용은 병렬 잡억 구성 및 결제를 참조하세요.
• 온라인 에이전트 - 자체 호스팅 에이전트 풀 또는 확장 집합 에이전트 풀의 온라인 에이전트 수입니다.
• 대기 중인 작업 - 대기 중인 작업 수와 에이전트를 기다리는 작업 수입니다.
• 실행 중인 작업 - 실행 중인 작업 수입니다.

풀 데이터는 10분 단위로 집계되며, 실행 중인 작업의 수는 지정된 시간 간격 동안 실행 중인 작업의 최대 수에 따라 그려집니다. 10분 시간 표시 막대 내에서 여러 개의 짧은 실행 작업이 완료될 수 있으므로 실행 중인 작업 수가 동일한 기간 동안 동시성 또는 온라인 에이전트보다 높을 수 있습니다.

보고서 범위

풀 사용량 보고서는 조직 범위 또는 프로젝트 범위에 표시할 수 있습니다. 조직 수준에서 차트는 해당 풀에서 작업을 실행한 조직 내의 모든 프로젝트에서 파이프라인의 데이터를 사용하여 그려집니다. 프로젝트 수준에서 차트는 해당 풀에서 작업을 실행한 특정 프로젝트의 파이프라인 데이터를 사용하여 그려집니다.

• 조직 수준에서 풀 사용량 보고서를 보려면 조직 설정, 파이프라인, 에이전트 풀을 선택합니다.
• 프로젝트 수준에서 풀 사용 보고서를 보려면 원하는 프로젝트로 이동하여 프로젝트 설정, 파이프라인, 에이전트 풀을 선택합니다.

에이전트 풀 보기에서 원하는 풀을 선택하고 분석 탭을 봅니다. 다음 예제에서는 자체 호스팅 에이전트 풀에 대한 풀 사용 보고서를 보여줍니다.

이 예제에서는 Azure Pipelines Microsoft 호스팅 에이전트 풀에 대한 사용 그래프를 보여 줍니다.

필터링

그래프의 타임라인을 조정하려면 필터 를 선택하고 간격 드롭다운을 선택한 다음 원하는 간격을 선택합니다.

1일 간격의 경우 시간당 데이터를 볼 수 있으며, 다른 간격의 경우 하루에 데이터를 볼 수 있습니다. 풀 데이터는 10분 단위로 집계되며, 실행 중인 작업의 수는 지정된 시간 간격 동안 실행 중인 작업의 최대 수에 따라 그려집니다. 이 예제에는 두 개의 온라인 에이전트가 있지만 일부 지역에서는 풀 데이터가 집계되는 방식으로 인해 4개의 실행 중인 작업이 있습니다.

FAQ

풀 사용량 보고서는 표시되는 데이터를 어디서 얻나요?

풀 사용량 보고서는 Azure DevOps Analytics 서비스 및 엔드포인트를 TaskAgentRequestSnapshots 사용합니다. 다음 URL 접 https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots두사를 사용하여 이 엔드포인트를 쿼리할 수 있습니다.

다음 URLhttps://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3로 project_id 이동하여 프로젝트에 대한 항목을 검색할 수 있습니다.

다음 예제에서는 샘플 쿼리 및 응답을 보여줍니다.

{
"@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
},
...

쿼리 옵션에 대한 자세한 내용은 OData를 사용한 분석에 대한 쿼리 지침을 참조하세요.

참고 항목

엔드포인트는 TaskAgentRequestSnapshots 미리 보기 상태이며 아직 문서화되지 않았지만 엔드포인트 URL https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots로 이동하여 반환된 데이터에 대한 정보를 볼 수 있습니다.

에이전트 또는 동시성보다 실행 중인 작업이 더 많은 이유는 무엇인가요?

풀 데이터는 10분 단위로 집계되며, 실행 중인 작업의 수는 지정된 시간 간격 동안 실행 중인 작업의 최대 수에 따라 그려집니다. 각 실행 중인 작업은 개별적으로 계산되며, 10분 간격 동안 여러 작업이 완료된 경우 해당 간격에 대한 실행 중인 작업의 총 수에 기여합니다.

프로젝트 설정과 조직 설정에서 그래프를 보는 것의 차이점은 무엇인가요?

그래프의 데이터 범위는 프로젝트 설정 또는 조직 설정을 통해 차트에 액세스하는지 여부에 따라 결정됩니다. 조직 수준에서 차트는 해당 풀에서 작업을 실행한 조직 내의 모든 프로젝트에서 파이프라인의 데이터를 사용하여 그려집니다. 프로젝트 수준에서 차트는 해당 풀에서 작업을 실행한 특정 프로젝트의 파이프라인 데이터를 사용하여 그려집니다.