포털 오류 로그 보기

  • 아티클

참고

2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.

포털 관리자와 개발자는 Power Apps 포털을 사용하여 고객을 위한 웹 사이트를 만듭니다. 개발자는 포털을 개발하는 동안 문제를 디버깅하는 경우가 많습니다. 디버깅을 돕기 위해 포털의 모든 문제에 대한 자세한 오류 로그에 액세스할 수 있습니다. 포털에 대한 오류 로그를 얻을 수 있는 방법은 여러 가지가 있습니다.

참고

Power Apps 포털 오류 로그는 Power Pages에도 사용됩니다. 추가 정보: Power Pages란

팁

이 문서에서 작업을 수행하는 데 필요한 역할에 대해 알아보려면 포털 관리 작업에 필요한 관리자 역할을 읽어보세요.

사용자 지정 오류

포털에서 서버 측 예외가 발생하는 경우 기본적으로 사용자에게 친숙한 오류 메시지가 표시되는 맞춤형 오류 페이지가 나타납니다. 오류 메시지를 구성하려면 사용자 지정 오류 메시지 표시를 참조하십시오.

그러나 디버깅 목적을 위해 옐로우 스크린(YSOD)이라고도 하는 ASP.NET 상세 오류 페이지를 참조하는 것이 좋습니다. 자세한 오류 페이지는 서버 오류의 전체 스택을 가져오는 데 도움이 됩니다.

노랑색 죽음의 화면

YSOD를 활성화하려면 포털에서 사용자 정의 오류를 비활성화해야 합니다.

참고

개발 단계에 있을 때만 사용자 지정 오류를 사용하지 않도록 설정하고 공개 후에는 사용자 지정 오류를 사용하도록 하는 것이 좋습니다.

사용자 지정 오류에 대한 추가 정보: 사용자 지정 오류 페이지 표시

사용자 지정 오류 사용 안 함

포털에서 서버 쪽 예외가 발생 하면 자세한 예외 메시지를 표시하기 위해 포털에서 사용자 지정 오류를 비활성화할 수 있습니다.

  1. Power Apps 포털 관리 센터를 엽니다.

  2. 포털 작업 > 사용자 지정 오류를 사용 안 함으로 이동합니다.

    사용자 지정 오류 사용 안 함

  3. 확인 메시지에서 사용 안 함을 클릭합니다. 사용자 지정 오류가 비활성화되는 동안 포털은 다시 시작되어 사용할 수 없게 됩니다. 사용자 지정 오류를 사용할 수 없는 경우 메시지가 나타납니다.

사용자 지정 오류 사용

포털에서 사용자 지정 오류를 사용하여 YSOD 대신 전문가 수준의 페이지를 표시할 수 있습니다. 이 페이지에서는 응용 프로그램에서 예외가 발생하는 경우에 의미있는 정보를 제공합니다.

  1. Power Apps 포털 관리 센터를 엽니다.

  2. 포털 작업 > 사용자 지정 오류를 사용으로 이동합니다.

    사용자 지정 오류 사용

  3. 확인 메시지에서 사용을 클릭합니다. 사용자 지정 오류가 활성화되는 동안 포털은 다시 시작되어 사용할 수 없게 됩니다. 사용자 지정 오류를 사용할 수 있는 경우 메시지가 나타납니다.

참고

  • 포털이 연결된 인스턴스를 변경하는 경우 사용자 지정 오류 설정은 사용으로 설정됩니다. 필요한 경우 사용자 지정 오류를 다시 사용하지 않도록 설정해야 합니다.
  • 포털이 연결된 인스턴스가 변경될 때 사용자 지정 오류를 사용하거나 사용하지 않도록 설정해야 합니다. 그렇지 않으면 오류 메시지가 나타납니다.

사용자 지정 오류 메시지 표시

일반 오류 대신 전문가 수준의 사용자 지정 오류를 표시하도록 포털을 구성할 수 있습니다.

사용자 지정 오류를 정의하려면 콘텐츠 조각 Portal Generic Error를 사용합니다. 이 조각에 정의된 콘텐츠는 오류 페이지에 표시됩니다. 이 콘텐츠 조각은 기본 제공되지 않으므로 만들어야 합니다. 콘텐츠 조각 형식은 텍스트 또는 HTML일 수 있습니다. 콘텐츠 코드 조각을 만들거나 편집하려면 콘텐츠 코드 조각을 사용하여 콘텐츠 사용자 지정을 참조하십시오.

참고

콘텐츠 조각에 유동 코드가 작성되면 이 코드를 건너뛰고 이를 렌더링하지 않습니다.

사용자 지정 오류를 사용하도록 설정하면 오류 페이지에 다음 구조로 메시지가 나타납니다.

<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>

다음은 HTML 형식의 콘텐츠 조각을 사용하는 사용자 지정 오류 메시지의 예입니다.

이것은 사용자 지정 오류입니다. 여기를 클릭하여 오류의 스크린샷과 함께 지원 티켓을 제출하십시오

사용자 지정 오류 메시지

참고

Microsoft Dataverse에 연결할 수 없어서 포털에서 콘텐츠 조각을 검색할 수 없거나 Dataverse에서 조각을 사용할 수 없는 경우 오류 메시지가 나타납니다.

포털 액세스 오류 로그

포털을 개발하고 게시한 후에도 포털 로그에 액세스하여 고객이 보고한 문제를 디버깅할 수 있어야 합니다. 로그에 액세스하려면 사용자가 소유한 Azure Blob 저장소 계정으로 모든 응용 프로그램 오류를 보내도록 포털을 구성합니다. 문제의 세부 사항을 가지고 있기 때문에 포털 오류 로그에 액세스하여 고객 쿼리에 효율적으로 응답할 수 있습니다. 포털 오류 로그를 Azure Blob Storage에 가져오려면 Power Apps 포털 관리 센터에서 진단 로깅을 사용하도록 설정해야 합니다.

참고

포털이 연결된 Dataverse 인스턴스를 변경하면 진단 로깅이 비활성화됩니다. 진단 로깅을 사용하도록 다시 설정해야 합니다.

진단 로깅 사용

  1. Power Apps 포털 관리 센터를 엽니다.

  2. 포털 작업 > 진단 로깅 사용으로 이동합니다.

    진단 로깅 사용

  3. 진단 로깅 사용 창에서 다음 값을 입력합니다.

    • Azure Blob 저장소 서비스의 연결 문자열: 포털 오류 로그를 저장할 Azure Blob 저장소 서비스의 URL입니다. URL의 최대 길이는 2048자입니다. URL이 2048자보다 길면 오류 메시지가 나타납니다. 연결 문자열에 대한 추가 정보: Azure Storage 연결 문자열 구성
    • 보존 기간 선택: 포털 오류 로그를 Blob 저장소에 보관할 기간입니다. 선택한 기간 후에 오류 로그가 삭제됩니다. 다음 값 중 하나를 선택할 수 있습니다.
      • 1일
      • 7일
      • 30일
      • 60일
      • 90일
      • 180일
      • 항상

    기본적으로 보존 기간은 30일입니다.

    진단 로깅 창 시용

  4. 구성을 선택합니다.

진단 로깅이 구성되면 새 원격 분석 로그 Blob 컨테이너가 Azure Storage 계정에 만들어지고 로그는 컨테이너에 저장된 Blob 파일에 기록됩니다. 다음 스크린샷은 Azure Storage Explorer의 원격 분석 로그 Blob 컨테이너를 보여 줍니다.

Azure 블로그 스토리지 계정

진단 로깅이 성공적으로 활성화되면 다음 작업을 사용할 수 있게 됩니다.

  • 진단 로깅 구성 업데이트: 포털에 대한 진단 로깅 구성을 업데이트하거나 제거할 수 있습니다.
  • 진단 로깅 구성 사용 안 함: 포털에 대한 진단 로깅 구성을 사용하지 않도록 설정할 수 있습니다.

진단 로깅 업데이트

  1. Power Apps 포털 관리 센터를 엽니다.

  2. 포털 작업 > 진단 로깅 구성 업데이트로 이동합니다.

    진단 로깅 구성 업데이트

  3. 진단 로깅 구성 업데이트 창에서 다음 값을 입력합니다.

    • Azure Blob 저장소 서비스의 연결 문자열을 업데이트하시겠습니까?: Azure Blob 저장소 서비스의 연결 문자열을 업데이트할지 여부를 지정할 수 있습니다. 기본적으로 선택되어 있습니다.
    • Azure Blob 저장소 서비스의 연결 문자열: 포털 오류 로그를 저장할 Azure Blob 저장소 서비스의 URL입니다. URL의 최대 길이는 2048자입니다. URL이 2048자보다 길면 오류 메시지가 나타납니다. 이 필드는 Azure Blob 저장소 서비스의 연결 문자열을 업데이트하시겠습니까? 확인란이 선택된 경우에만 표시됩니다. 연결 문자열에 대한 추가 정보: Azure Storage 연결 문자열 구성
    • 보존 기간 선택: 포털 오류 로그를 Blob 저장소에 보관할 기간입니다. 선택한 기간 후에 오류 로그가 삭제됩니다. 다음 값 중 하나를 선택할 수 있습니다.
      • 1일
      • 7일
      • 30일
      • 60일
      • 90일
      • 180일
      • 항상 표시

    기본적으로 보존 기간은 30일입니다.

    진단 로깅 구성 창 업데이트

  4. 업데이트를 선택합니다.

진단 로깅 사용 안 함

  1. Power Apps 포털 관리 센터를 엽니다.

  2. 포털 작업 > 진단 로깅 사용 안 함으로 이동합니다.

    진단 로깅 사용 중지

  3. 확인 메시지에서 사용 안 함을 클릭합니다.

플러그 인 오류 표시

포털을 개발하는 동안 흔히 나타나는 또 다른 시나리오는 사용자 지정 플러그 인과 Dataverse 환경에서 작성된 비즈니스 논리에 의해 발생한 오류입니다. 이러한 오류는 일반적으로 사용자 지정 오류를 사용하지 않도록 설정하거나 진단 로깅을 사용하도록 설정하여 액세스할 수 있습니다. 경우에 따라서는 빠르게 문제를 진단하려면 이러한 오류를 직접 포털에 표시하는 것이 더 빠릅니다. 포털 화면에 Dataverse의 사용자 지정 플러그인 오류를 표시하도록 포털을 구성하여 이를 수행할 수 있습니다.

사용자 지정 플러그 인 오류를 표시하려면 사이트 설정 Site/EnableCustomPluginError를 만들고 해당 값을 True로 설정합니다. 사용자 지정 플러그 인 오류가 일반 오류 대신 화면에 표시됩니다. 오류는 플러그 인 오류의 메시지 부분 표시하며 완전한 스택 추적을 표시하지 않습니다.

다음은 사용자 정의 플러그인 오류가 표시된 화면입니다.

  • 목록
    • 레코드 검색
  • 기본 양식
    • Retrieve
    • 만들기/업데이트 등
  • 다단계 양식
    • Retrieve
    • 만들기/업데이트 등

사이트 설정이 없는 경우 기본적으로 false로 처리되며 플러그 인 오류가 렌더링되지 않습니다.

참조 항목

Power App 포털 유지 관리 및 문제 해결

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).