로그 - Azure Database for PostgreSQL - 단일 서버

  • 아티클

적용 대상: Azure Database for PostgreSQL - 단일 서버

Important

Azure Database for PostgreSQL - 단일 서버는 곧 사용 중지됩니다. Azure Database for PostgreSQL - 유연한 서버로 업그레이드하는 것이 좋습니다. Azure Database for PostgreSQL - 유연한 서버로 마이그레이션하는 자세한 방법은 Azure Database for PostgreSQL 단일 서버는 어떻게 되나요?를 참조하세요.

Azure Database for PostgreSQL을 사용하여 Postgres의 표준 로그를 구성하고 액세스할 수 있습니다. 로그는 구성 오류 및 비정상적인 성능 문제를 인지하고, 해결하며, 복구하는 데 사용됩니다. 구성 및 액세스할 수 있는 로깅 정보에는 오류, 쿼리 정보, autovacuum 레코드, 연결 및 검사점이 있습니다. (트랜잭션 로그 액세스 권한은 사용할 수 없습니다.)

감사 로깅은 PostgreSQL 확장인 pgaudit을 통해 가능하게 됩니다. 자세히 알아보려면 감사 개념 문서를 참조하세요.

로깅 구성

로깅 서버 매개 변수를 사용하면 서버에서 로깅을 구성할 수 있습니다. 각 Azure Database for PostgreSQL 서버에서 log_checkpoints 및 log_connections는 기본적으로 설정되어 있습니다. 로깅 요구에 맞게 매개 변수를 추가로 조정할 수도 있습니다.

Azure Database for PostgreSQL - 로깅 매개 변수

Postgres 로그 매개 변수에 대한 자세한 내용을 알아보려면 Postgres 설명서의 로그할 시기 및 로그할 항목 섹션을 참조하세요. Azure Database for PostgreSQL에서 전부는 아니지만 대부분의 Postgres 로깅 매개 변수를 구성할 수 있습니다.

Azure Database for PostgreSQL 매개 변수를 구성하는 방법을 알아보려면 포털 설명서 또는 CLI 설명서를 참조하세요.

참고 항목

가령 명령문 로깅과 같이 많은 양의 로그를 구성하면 상당한 성능 오버헤드가 추가될 수 있습니다.

.log 파일 액세스

Azure Database for PostgreSQL의 기본 로그 형식은 .log입니다. 이 로그의 샘플 줄은 다음과 같습니다:

2019-10-14 17:00:03 UTC-5d773cc3.3c-LOG: connection received: host=101.0.0.6 port=34331 pid=16216

Azure Database for PostgreSQL은 .log 파일에 대한 단기 스토리지 위치를 제공합니다. 새 파일은 1시간 마다 또는 100MB 중 먼저 도달하는 것으로 시작됩니다. 로그는 Postgres에서 내보내질 때 현재 파일에 추가됩니다.

log_retention_period 매개 변수를 사용하여 이 로그 스토리지의 보존 기간을 설정할 수 있습니다. 기본값은 3일이며 최대값은 7일입니다. 단기 스토리지 위치는 최대 1GB의 로그 파일을 보유할 수 있습니다. 1GB 후에는 새 로그를 위한 공간을 확보하기 위해 보존 기간에 관계 없이 가장 오래된 파일이 삭제됩니다.

로그 및 로그 분석에 대한 장기 보존을 위해 .log 파일을 다운로드하고 타사 서비스로 이동할 수 있습니다. Azure Portal, Azure CLI를 사용하여 파일을 다운로드할 수 있습니다. 그 대신에 로그 (JSON 형식)를 장기 위치로 자동으로 내보내는 Azure Monitor 진단 설정을 구성할 수 있습니다. 이 옵션에 대한 자세한 내용은 아래 섹션을 참조하세요.

매개 변수 logging_collector을 OFF로 설정하여 .log 파일 생성을 중단할 수 있습니다. Azure Monitor 진단 설정을 사용하는 경우 .log 파일 생성을 해제하는 것이 좋습니다. 이 구성을 통해 추가 로깅의 성능 영향을 줄일 수 있습니다.

참고 항목

서버를 다시 시작하여 이 변경 내용을 적용합니다.

리소스 로그

Azure Database for PostgreSQL은 Azure Monitor 진단 로그와 통합됩니다. 진단 설정을 사용하면 JSON 형식의 Postgres 로그를 Azure Monitor 로그에 분석 및 경고 목적으로, Event Hubs에 스트리밍 목적으로, Azure Storage에 보관 목적으로 보낼 수 있습니다.

Important

이 서버 로그용 진단 기능은 범용 및 메모리 최적화 가격 책정 계층에서만 사용 가능합니다.

진단 설정 구성

Azure Portal, CLI, REST API 및 PowerShell을 사용하여 Postgres 서버에 진단 설정을 사용할 수 있습니다. 선택할 로그 카테고리는 PostgreSQLLogs입니다. (쿼리 저장소를 사용하는 경우 구성할 수 있는 다른 로그가 있습니다.)

Azure Portal을 사용하여 리소스 로그를 사용하도록 설정하려면 다음 단계를 수행합니다.

  1. 포털에서 Postgres 서버의 탐색 메뉴에 있는 진단 설정으로 이동합니다.
  2. 진단 설정 추가를 선택합니다.
  3. 이 설정의 이름을 정합니다.
  4. 선호하는 엔드포인트(스토리지 계정, 이벤트 허브, 로그 분석)를 선택합니다.
  5. 로그 유형 PostgreSQL 서버 로그를 선택합니다.
  6. 설정을 저장합니다.

PowerShell, CLI 또는 REST API를 사용하여 리소스 로그를 사용하려면 진단 설정 문서를 참조하세요.

리소스 로그 액세스

로그에 액세스하는 방법은 선택한 엔드포인트에 따라 다릅니다. Azure Storage의 경우에는 로그 스토리지 계정 문서를 참조하세요. Event Hubs에 대해서는 Azure 로그 스트림 문서를 참조하세요.

Azure Monitor 로그의 경우 선택한 작업 영역으로 로그가 전송됩니다. Postgres 로그는 AzureDiagnostics 컬렉션 모드를 사용하므로, AzureDiagnostics 테이블에서 쿼리될 수 있습니다. 테이블의 필드는 아래에 설명되어 있습니다. 쿼리와 경고에 대한 자세한 정보를 Azure Monitor 로그 쿼리 개요에서 알아봅니다.

다음은 시작해볼 수 있는 쿼리입니다. 쿼리를 기반으로 한 경고를 구성할 수 있습니다.

마지막 날에 특정 서버에 대한 모든 Postgres 로그를 검색합니다

AzureDiagnostics
| where LogicalServerName_s == "myservername"
| where Category == "PostgreSQLLogs"
| where TimeGenerated > ago(1d)

모든 localhost가 아닌 연결 시도를 검색합니다

AzureDiagnostics
| where Message contains "connection received" and Message !contains "host=127.0.0.1"
| where Category == "PostgreSQLLogs" and TimeGenerated > ago(6h)

위의 쿼리는 이 작업 영역에 있는 Postgres 서버 로깅에 대해 최근 6시간 동안의 결과를 표시합니다.

로그 형식

다음 표에서는 PostgreSQLLogs 형식의 필드를 설명합니다. 포함되는 필드와 이러한 필드가 표시되는 순서는 선택한 출력 엔드포인트에 따라 달라질 수 있습니다.

필드 설명
TenantId 테넌트 ID
SourceSystem Azure
TimeGenerated [UTC] UTC에 로그가 기록된 때의 타임스탬프
Type 로그의 형식 항상 AzureDiagnostics입니다.
SubscriptionId 서버가 속한 구독의 GUID
ResourceGroup 서버가 속한 리소스 그룹의 이름
ResourceProvider 리소스 공급자의 이름. 항상 MICROSOFT.DBFORPOSTGRESQL입니다.
ResourceType Servers
ResourceId 리소스 URI
리소스 서버의 이름
범주 PostgreSQLLogs
OperationName LogEvent
errorLevel 로깅 수준(예: LOG, ERROR, NOTICE)
메시지 기본 로그 메시지
도메인 서버 버전(예: postgres-10)
세부 정보 보조 로그 메시지(해당하는 경우)
ColumnName 열 이름(해당하는 경우)
SchemaName 스키마 이름(해당하는 경우)
DatatypeName 데이터 형식 이름(해당하는 경우)
LogicalServerName 서버의 이름
_ResourceId 리소스 URI
접두사 로그 줄의 prefix

다음 단계