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

Azure DevOps Services

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

필수 구성 요소

중요

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

풀 사용량 보고서

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

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

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

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

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

보고서 scope

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

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

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

이 예제에서는 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를 사용하는 Analytics에 대한 쿼리 지침을 참조하세요.

참고

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

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

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

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

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