PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처 구성

적용 대상: Azure Database for PostgreSQL - 유연한 서버

PostgreSQL 서버 로그를 사용하여 Azure Database for PostgreSQL 유연한 서버에서 발생하는 특정 문제를 진단하고 서버에서 실행되는 활동에 대한 자세한 인사이트를 얻을 수 있습니다. 주 버전 업그레이드 로그를 사용하여 서버를 더 높은 주 버전의 PostgreSQL로 업그레이드하는 동안 발생할 수 있는 오류를 해결할 수 있습니다.

기본적으로 Azure Database for PostgreSQL 유연한 서버에서 다운로드할 서버 로그를 캡처할 수 없습니다. 그러나 이 기능을 사용하도록 설정하면 Azure Database for PostgreSQL 유연한 서버가 파일에 서버 로그를 캡처하기 시작하며, 자세한 검사를 위해 다운로드할 수 있습니다. Azure Portal 또는 Azure CLI 명령을 사용하여 문제 해결 작업을 지원할 수 있는 이러한 파일을 나열하고 다운로드할 수 있습니다.

이 문서에서는 기능을 사용하도록 설정하고 사용하지 않도록 설정하는 방법을 설명합니다. 또한 사용 가능한 모든 서버 로그를 나열하는 방법과 해당 로그를 다운로드하는 방법에 대해서도 설명합니다.

다운로드할 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처 사용

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버를 선택합니다.

2. 리소스 메뉴의 모니터링 섹션에서 서버 로그를 선택합니다.

   

3. 서버 로그 다운로드에서 사용 확인란을 표시합니다.

   

4. 기본적으로 로그 파일은 3일 동안 보존되지만 보존 기간을 1일에서 7일로 조정할 수 있습니다. 보존 기간(일) 슬라이서를 사용하여 원하는 구성에 맞게 조정합니다.

   

5. 저장 단추를 선택합니다.

   

6. 알림은 서비스가 다운로드할 로그 캡처를 구성하고 있음을 알려줍니다.

   

7. 작업이 종료되면 서비스에서 다운로드할 로그 캡처 구성을 완료했음을 알리는 알림이 표시됩니다.

   

CLI

az postgres flexible-server 매개 변수 집합 명령을 통해 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처를 사용하도록 설정할 수 있습니다.

다운로드할 로그 캡처를 사용하도록 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value on

다운로드를 위해 캡처된 로그의 보존 기간을 조정하려면 다음 명령을 사용합니다.

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.retention_days --value <retention_period_in_days>

서버 매개 변수 logfiles.retention_days 에 허용되는 값은 1일에서 7일 사이일 수 있습니다. 다른 값으로 설정하려고 하면 다음 오류가 발생합니다.

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

참고 항목

• 다운로드할 서버 로그 캡처를 사용하도록 설정한 후 몇 분 후에 첫 번째 로그를 다운로드할 수 있습니다.

• 처음에는 약 1시간 동안 서버 로그가 데이터 디스크 공간을 차지합니다. 그런 다음 백업 스토리지로 이동하여 구성된 보존 기간 동안 보관합니다.

다운로드할 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처 사용 안 함

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버를 선택합니다.

2. 리소스 메뉴의 모니터링 섹션에서 서버 로그를 선택합니다.

   

3. 서버 로그 다운로드에서 사용 확인란의 선택을 취소합니다.

   

4. 저장 단추를 선택합니다.

   

5. 알림은 서비스가 다운로드할 로그 캡처를 구성하고 있음을 알려줍니다.

   

6. 작업이 종료되면 서비스에서 다운로드할 로그 캡처 구성을 완료했음을 알리는 알림이 표시됩니다.

   

CLI

az postgres flexible-server 매개 변수 집합 명령을 통해 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처를 사용하지 않도록 설정할 수 있습니다.

다운로드할 로그 캡처를 사용하지 않도록 설정하려면 다음 명령을 사용합니다.

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value off

다운로드할 수 있는 캡처된 로그 나열

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버를 선택합니다.

2. 리소스 메뉴의 모니터링 섹션에서 서버 로그를 선택합니다.

   

3. 테이블에는 아직 삭제되지 않은 캡처된 모든 로그 파일이 표시됩니다. 특정 시점에 캡처되었지만 구성된 보존 기간을 초과하여 삭제된 파일은 더 이상 표시되지 않거나 액세스할 수 없습니다. 로그 파일, 로그 시간 범위 및 로그 형식 상자에 대한 검색을 사용하여 표시되는 로그를 줄이기 위한 필터링 조건을 정의할 수 있습니다. 열 머리글을 선택하면 표시된 로그 파일 목록을 선택한 헤더가 나타내는 특성 값으로 오름차순 또는 내림차순으로 정렬할 수 있습니다. 사용 가능한 각 열 아래에서 각 파일의 다양한 특성을 볼 수 있습니다.

   • 이름: 로그 파일의 이름입니다. 서비스는 각 로그 파일에 이 패턴을 postgresql_yyyy_mm_dd_hh_00_00.log사용하여 이름을 할당합니다.
   • 마지막 업데이트 시간: 각 로그 파일이 업로드된 마지막 시간의 타임스탬프입니다. 로그 파일은 약 10분마다 업로드됩니다.
   • 크기: 로그 파일이 차지하는 크기(바이트)입니다.
   • 로그 유형: 서버 로그 는 파일이 PostgreSQL 서버 로그에 해당한다는 것을 나타냅니다. 업그레이드 로그 는 파일이 주 버전 업그레이드 로그에 해당한다는 것을 나타냅니다.

   

4. 테이블의 내용은 자동으로 업데이트되지 않습니다. 최신 정보를 보려면 새로 고침을 선택할 수 있습니다.

   

CLI

az postgres flexible-server server-logs list 명령을 통해 캡처된 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그를 나열 할 수 있습니다.

지난 72시간(기본값)에서 업데이트된 다운로드에 사용할 수 있는 캡처된 모든 로그를 나열하려면 다음 명령을 사용합니다.

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server>

지난 10시간 동안 업데이트된 다운로드에 사용할 수 있는 캡처된 모든 로그를 나열하려면 다음 명령을 사용합니다.

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --file-last-written 10

다운로드할 수 있는 캡처된 모든 로그를 나열하려면 크기가 30KiB 미만인 경우 다음 명령을 사용합니다.

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --max-file-size 30

다운로드할 수 있는 캡처된 로그를 모두 나열하려면 이름에 다음 01_07명령을 사용합니다.

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --filename-contains 01_07

다운로드할 수 있는 캡처된 로그 다운로드

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버를 선택합니다.

2. 리소스 메뉴의 모니터링 섹션에서 서버 로그를 선택합니다.

   

3. 테이블에는 아직 삭제되지 않은 캡처된 모든 로그 파일이 표시됩니다. 특정 시점에 캡처되었지만 구성된 보존 기간을 초과하여 삭제된 파일은 더 이상 표시되지 않거나 액세스할 수 없습니다. 로그 파일, 로그 시간 범위 및 로그 형식 상자에 대한 검색을 사용하여 표시되는 로그를 줄이기 위한 필터링 조건을 정의할 수 있습니다. 열 머리글을 선택하면 표시된 로그 파일 목록을 선택한 헤더가 나타내는 특성 값으로 오름차순 또는 내림차순으로 정렬할 수 있습니다. 다운로드할 로그를 식별하고 작업 열에서 다운로드를 선택합니다.

   

4. 한 번에 여러 로그 파일을 다운로드하려면 다운로드할 모든 파일을 선택하고 도구 모음에서 다운로드를 선택합니다.

   

5. 테이블의 내용은 자동으로 업데이트되지 않습니다. 최신 정보를 보려면 새로 고침을 선택할 수 있습니다.

   

CLI

az postgres flexible-server server-logs 다운로드 명령을 통해 캡처된 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그를 다운로드 할 수 있습니다.

하나의 특정 로그를 다운로드하려면 다음 명령을 사용합니다.

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log_name>

하나의 특정 로그를 다운로드하려면 다음 명령을 사용합니다.

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log1_name log2_name ...logn_name>

참고 항목

• 다운로드할 수 있는 이름이 일치하는 로그 파일이 있는 파일 이름에 대해 동일한 이름과 내용으로 로컬 파일이 만들어집니다.

• 제공된 파일 이름을 다운로드할 수 없는 경우 명령은 오류를 보고하지 않습니다. 단순히 해당 파일을 다운로드하지 않습니다.

관련 콘텐츠

• Azure Database for PostgreSQL 유연한 서버의 인스턴스를 다시 시작합니다.
• Azure Database for PostgreSQL 유연한 서버의 인스턴스를 시작합니다.
• Azure Database for PostgreSQL 유연한 서버의 인스턴스를 중지합니다.
• Azure Database for PostgreSQL 유연한 서버의 인스턴스를 다시 시작합니다.
• Azure Database for PostgreSQL - 유연한 서버의 컴퓨팅 옵션입니다.
• Azure Database for PostgreSQL - 유연한 서버의 스토리지 옵션입니다.
• Azure Database for PostgreSQL - 유연한 서버의 제한