SharePoint용 페이지 진단 도구 사용
이 문서에서는 SharePoint용 페이지 진단 도구를 사용하여 미리 정의된 성능 조건 집합에 대해 Microsoft 365 최신 및 클래식 사이트 페이지의 SharePoint를 분석하는 방법을 설명합니다.
SharePoint용 페이지 진단 도구는 다음을 위해 설치할 수 있습니다.
팁
버전 2.0.0 이상에는 클래식 사이트 페이지 외에도 최신 페이지에 대한 지원이 포함되어 있습니다. 사용 중인 도구의 버전이 확실하지 않은 경우 정보 링크 또는 타원(...)을 선택하여 버전을 확인할 수 있습니다. 도구를 사용할 때 항상 최신 버전으로 업데이트합니다.
SharePoint용 페이지 진단 도구는 Microsoft 365 최신 포털의 SharePoint와 클래식 게시 사이트 페이지를 모두 분석하는 새 Microsoft Edge(https://www.microsoft.com/edge) 및 Chrome 브라우저의 브라우저 확장입니다.
중요
이 도구는 Microsoft 365의 SharePoint에서만 작동하며 SharePoint 시스템 페이지 또는 SharePoint 앱 페이지에서 사용할 수 없습니다. 앱 페이지 유형은 포털이 아닌 Microsoft 365의 SharePoint 내 특정 비즈니스 애플리케이션에 사용하도록 설계되었습니다. 이 도구는 포털 페이지 및 Teams 사이트 페이지를 최적화하도록 설계되었습니다.
이 도구는 미리 정의된 규칙 집합에 대해 페이지가 수행되는 방식을 보여 주는 분석된 각 페이지에 대한 보고서를 생성하고 테스트 결과가 기준 값을 벗어나면 자세한 정보를 표시합니다. SharePoint 관리자 및 디자이너는 이 도구를 사용하여 성능 문제를 해결하고 게시하기 전에 새 페이지가 최적화되도록 할 수 있습니다.
페이지 진단 도구는 allitems.aspx 또는 sharepoint.aspx 같은 시스템 페이지가 아닌 SharePoint 사이트 페이지만 분석하도록 설계되었습니다. 시스템 페이지 또는 다른 비사이트 페이지에서 도구를 실행하려고 하면 해당 유형의 페이지에 대해 도구를 실행할 수 없다는 오류 메시지가 표시됩니다.
라이브러리 또는 시스템 페이지를 평가하는 데 값이 없기 때문에 도구에서 오류가 발생하지 않습니다. SharePoint 사이트 페이지로 이동하여 도구를 사용합니다. SharePoint 페이지에서 이 오류가 발생하면 master 페이지를 검사 SharePoint 메타태그가 제거되지 않았는지 확인합니다.
도구에 대한 피드백을 제공하려면 도구의 오른쪽 위 모서리에 있는 줄임표를 선택한 다음 피드백 제공을 선택합니다.
SharePoint용 페이지 진단 도구 설치
이 섹션의 설치 절차는 Chrome 및 Microsoft Edge 브라우저 모두에서 작동합니다.
중요
Microsoft는 SharePoint용 페이지 진단 도구에서 분석하는 데이터 또는 페이지 콘텐츠를 읽지 않으며 개인 정보, 웹 사이트 또는 다운로드 정보를 캡처하지 않습니다. 도구에서 Microsoft에 기록된 유일한 식별 가능한 정보는 테넌트 이름, 실패한 규칙 수 및 도구가 실행된 날짜 및 시간입니다. 이 정보는 Microsoft에서 최신 포털 및 게시 사이트 사용 추세 및 일반적인 성능 문제를 더 잘 이해하는 데 사용됩니다.
Microsoft Edge(Edge 확장) 또는 Chrome(Chrome 확장)용 SharePoint용 페이지 진단을 설치합니다. 저장소의 설명 페이지에 제공된 사용자 개인 정보 취급 방침을 검토합니다. 브라우저에 도구를 추가할 때 다음 사용 권한 알림이 표시됩니다.
이 알림은 페이지에 웹 파트 및 페이지의 사용자 지정에 따라 SharePoint 외부 위치의 콘텐츠가 포함될 수 있기 때문입니다. 즉, 시작 단추를 클릭할 때 도구가 요청 및 응답을 읽고 도구가 실행 중인 활성 SharePoint 탭에 대해서만 읽습니다. 이 정보는 웹 브라우저에서 로컬로 캡처되며 도구의 네트워크 추적 탭에서 JSON으로 내보내기 또는 HAR로 내보내기 단추를 통해 사용할 수 있습니다. 정보는 Microsoft로 전송되거나 캡처되지 않습니다. 이 도구는 여기에서 액세스할 수 있는 Microsoft 개인 정보 취급 방침을 따릅니다.
다운로드 관리 권한은 도구의 JSON으로 내보내기 기능 사용을 다룹니다. 결과에 URL이 포함되고 PII(개인 식별 정보)로 분류될 수 있으므로 organization 외부에서 JSON 파일을 공유하기 전에 회사의 개인 정보 보호 지침을 따릅니다.
Incognito 또는 InPrivate 모드에서 도구를 사용하려면 브라우저에 대한 절차를 따르세요.
- Microsoft Edge에서 확장 으로 이동하거나 URL 표시줄에 edge://extensions 입력하고 확장에 대한 세부 정보를 선택합니다. 확장 설정에서 InPrivate에서 허용 확인란을 선택합니다.
- Chrome에서 확장 으로 이동하거나 URL 표시줄에 chrome://extensions 입력하고 확장에 대한 세부 정보를 선택합니다. 확장 설정에서 Incognito에서 허용 슬라이더를 선택합니다.
검토하려는 SharePoint의 SharePoint 사이트 페이지로 이동합니다. 페이지에서 항목의 "로드 지연"을 허용했습니다. 따라서 도구는 자동으로 중지되지 않습니다(이는 모든 페이지 로드 시나리오를 수용하기 위한 것입니다). 컬렉션을 중지하려면 중지를 선택합니다. 데이터 수집을 중지하기 전에 페이지 로드가 완료되었는지 확인하거나 부분 추적만 캡처합니다.
확장 도구 모음 단추
를 클릭합니다. 도구를 로드하려면 다음 확장 팝업 창이 표시됩니다.
시작을 선택하여 분석을 위해 데이터 수집을 시작합니다.
SharePoint용 페이지 진단 도구에 표시되는 내용
도구의 오른쪽 위 모서리에 있는 타원(...)을 클릭하여 다음 링크를 찾습니다.
- 추가 리소스 링크는 이 문서에 대한 링크를 포함하여 도구에 대한 일반적인 지침과 세부 정보를 제공합니다.
- 피드백 제공 링크는 SharePoint 사이트 및 공동 작업 사용자 음성 사이트에 대한 링크를 제공합니다.
- 정보 링크에는 현재 설치된 버전의 도구와 도구의 타사 알림에 대한 직접 링크가 포함됩니다.
상관 관계 ID, SPRequestDuration, SPIISLatency, 페이지 로드 시간 및 URL 세부 정보는 정보이며 몇 가지 용도로 사용할 수 있습니다.
- correlationID는 특정 페이지에 대한 더 많은 진단 데이터를 수집할 수 있으므로 Microsoft 지원 작업할 때 중요한 요소입니다.
- SPRequestDuration 은 SharePoint에서 페이지를 처리하는 데 걸리는 시간입니다. 구조적 탐색, 큰 이미지, 많은 API 호출은 모두 더 긴 기간에 기여할 수 있습니다.
- SPIISLatency 는 SharePoint에서 페이지 로드를 시작하는 데 걸린 시간(밀리초)입니다. 이 값에는 웹 애플리케이션이 응답하는 데 걸린 시간이 포함되지 않습니다.
- 페이지 로드 시간은 요청 시간부터 응답이 수신되고 브라우저에서 렌더링된 시간까지 페이지에 의해 기록된 총 시간입니다. 이 값은 네트워크 대기 시간, 컴퓨터 성능 및 브라우저에서 페이지를 로드하는 데 걸리는 시간을 비롯한 다양한 요인의 영향을 받습니다.
- 페이지 URL(Uniform Resource Locator)은 현재 페이지의 웹 주소입니다.
진단 테스트 탭에는 분석 결과가 세 가지 범주로 표시됩니다. 조치가 필요하지 않으며개선 기회 및 주의가 필요합니다. 각 테스트 결과는 다음 표에 설명된 대로 다음 범주 중 하나의 항목으로 표시됩니다.
범주 색상 설명 주의 필요 빨강 테스트 결과는 기준 값을 벗어나 페이지 성능에 영향을 줍니다. 수정 지침을 따릅니다. 개선 기회 황색 테스트 결과는 기준 값을 벗어나 성능 문제에 영향을 미칠 수 있습니다. 테스트별 기준이 적용될 수 있습니다. 필요한 작업 없음 녹색 테스트 결과는 테스트의 기준 값에 속합니다. 
네트워크 추적 탭은 페이지 빌드 요청 및 응답에 대한 세부 정보를 제공합니다.
진단 테스트 탭을 사용하는 방법
SharePoint용 페이지 진단 도구를 사용하여 SharePoint 최신 포털 페이지 또는 클래식 게시 사이트 페이지를 분석하는 경우 결과를 기준 값과 비교하고 진단 테스트 탭에 표시되는 미리 정의된 규칙을 사용하여 결과를 분석합니다. 특정 테스트에 대한 규칙은 둘 사이의 특정 성능 특성이 어떻게 다른지에 따라 최신 포털 및 클래식 게시 사이트에 대해 서로 다른 기준 값을 사용할 수 있습니다.
개선 기회 또는 주의 필요 범주에 표시되는 테스트 결과는 권장 사례에 대해 검토해야 하는 영역을 나타내며 결과에 대한 추가 정보를 표시하도록 선택할 수 있습니다. 각 항목에 대한 세부 정보에는 테스트와 관련된 적절한 지침으로 직접 안내하는 자세한 정보 링크가 포함됩니다. 작업 필요 없음 범주에 표시되는 테스트 결과는 관련 규칙을 준수함을 나타내며 선택 시 추가 세부 정보를 표시하지 않습니다.
진단 테스트 탭의 정보는 페이지를 디자인하는 방법을 알려주지 않지만 페이지 성능에 영향을 줄 수 있는 요소를 강조 표시합니다. 일부 페이지 기능 및 사용자 지정은 페이지 성능에 불가피한 영향을 미치며, 해당 영향이 상당한 경우 페이지에서 잠재적인 수정 또는 누락에 대해 검토해야 합니다.
빨간색 또는 노란색 결과는 데이터를 너무 자주 새로 고치는 웹 파트를 나타낼 수도 있습니다. 예를 들어 회사 뉴스는 매초 업데이트되지 않지만 사용자 지정 웹 파트는 전체 사용자 환경을 개선할 수 있는 캐싱 요소를 구현하는 대신 매초에 최신 뉴스를 가져오도록 빌드되는 경우가 많습니다. 웹 파트를 페이지에 포함할 때는 사용 가능한 각 매개 변수의 값을 평가하여 의도한 용도에 맞게 적절하게 설정하여 성능 영향을 줄이는 간단한 방법이 있는 경우가 많습니다.
참고
게시 기능이 사용하도록 설정되지 않은 클래식 팀 사이트는 CDN을 사용할 수 없습니다. 이러한 사이트에서 도구를 실행하면 CDN 테스트가 실패하고 무시될 수 있지만 나머지 테스트는 모두 적용할 수 있습니다. SharePoint 게시 기능의 추가 기능은 페이지 로드 시간을 늘릴 수 있으므로 CDN 기능을 허용하기 위해 사용하도록 설정해서는 안 됩니다.
중요
테스트 규칙이 정기적으로 추가 및 업데이트되므로 현재 규칙 및 테스트 결과에 포함된 특정 정보에 대한 자세한 내용은 최신 버전의 도구를 참조하세요. 확장을 관리하여 버전을 확인할 수 있으며 확장에서 업데이트를 사용할 수 있는지 여부를 알려 줍니다.
네트워크 추적 탭을 사용하는 방법 및 HAR 파일을 내보내는 방법
네트워크 추적 탭은 페이지를 빌드하기 위한 요청과 SharePoint에서 받은 응답에 대한 자세한 정보를 제공합니다.
빨간색으로 플래그가 지정된 항목 로드 시간을 찾습니다. 각 요청 및 응답은 다음 대기 시간 메트릭을 사용하여 전체 페이지 성능에 미치는 영향을 나타내기 위해 색으로 코딩됩니다.
- 녹색: < 500ms
- 노란색: 500-1000ms
- 빨간색: > 1000ms
위에 표시된 이미지에서 빨간색 항목은 기본 페이지와 관련이 있습니다. 페이지가 1000ms(1초 미만)로 < 로드되지 않는 한 항상 빨간색으로 표시됩니다.
테스트 항목 로드 시간. 브라우저에서 항목을 이미 캐시했기 때문에 시간 또는 색 표시기가 없는 경우도 있습니다. 이를 올바르게 테스트하려면 페이지를 열고 브라우저 캐시를 지운 다음 시작을 클릭하여 "콜드" 페이지 로드를 강제로 적용하고 초기 페이지 로드의 진정한 반영이 됩니다. 그러면 페이지에 캐시되는 항목을 결정하는 데 도움이 되므로 "웜" 페이지 로드와 비교해야 합니다.
문제를 조사하는 데 도움이 될 수 있는 다른 사용자와 관련 세부 정보를 공유합니다. 도구에 제공된 세부 정보 또는 정보를 개발자 또는 기술 지원 담당자와 공유하려면 HAR(HTTP 보관으로 내보내기 사용) 를 사용하는 것이 좋습니다.
시작을 클릭하기 전에 내보내기를 사용하도록 설정해야 합니다. 그러면 브라우저에서 디버그 모드가 활성화됩니다. 그러면 "네트워크 추적" 탭을 통해 액세스할 수 있는 HAR(HTTP 보관 파일)가 생성됩니다. "HAR로 내보내기" 단추를 클릭하여 파일을 컴퓨터에 다운로드한 다음 그에 따라 공유할 수 있습니다. 파일은 F12 개발자 도구 및 Fiddler와 같은 다양한 디버그 도구에서 열 수 있습니다.
중요
이러한 결과에는 URL이 포함되며 PII(개인 식별 정보)로 분류할 수 있습니다. 해당 정보를 배포하기 전에 organization 지침을 따라야 합니다.
Microsoft 지원 참여
지원 사례에서 직접 작업할 때만 활용해야 하는 Microsoft 지원 수준 기능이 포함되어 있습니다. 이 기능을 활용하면 지원 팀 참여 없이 사용할 때 아무런 이점이 없으며 페이지 성능이 상당히 느려질 수 있습니다. 추가 정보가 서비스의 로깅에 추가되므로 도구에서 이 기능을 사용할 때 추가 정보는 없습니다.
사용하도록 설정했다는 알림이 표시되고 페이지 성능이 활성화되는 동안 성능이 2~3배 느려지는 것을 제외하고는 변경 내용이 표시되지 않습니다. 특정 페이지 및 활성 세션에만 관련됩니다. 이러한 이유로 이 기능은 적극적으로 지원에 참여하는 경우에만 아끼고 사용해야 합니다.
Microsoft 지원 수준 기능을 사용하도록 설정하려면
SharePoint용 페이지 진단 도구를 엽니다.
키보드에서 Alt-Shift-L을 누릅니다. 그러면 지원 로깅 사용 검사 상자가 표시됩니다.
검사 상자를 선택한 다음 시작을 클릭하여 페이지를 다시 로드하고 자세한 로깅을 생성합니다.
CorrelationID(도구의 맨 위에 표시됨)를 적어 두어 지원 담당자에게 제공하여 진단 세션에 대한 추가 정보를 수집할 수 있도록 해야 합니다.