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 parameter set 명령을 통해 PostgreSQL 서버 로그 및 주 버전 업그레이드 로그 캡처를 사용하도록 설정할 수 있습니다.

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

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

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

az postgres flexible-server parameter set \
  --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 parameter set 명령을 사용하여 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 download 명령을 통해 캡처된 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>

참고

• 제공된 파일 이름에 맞는 로그 파일을 다운로드할 수 있는 경우, 동일한 이름과 콘텐츠를 가진 로컬 파일이 만들어집니다.

• 제공된 파일 이름 중에 다운로드할 수 없는 것이 있으면 해당 명령은 오류를 보고하지 않습니다. 해당 파일을 다운로드하지 않습니다.

관련 콘텐츠

• 고가용성 구성.
• 예약된 유지 관리 구성.
• 포털을 사용하여 메트릭에 대한 경고 만들기.