참고: 추가 테이블을 쿼리해야 하는 커스텀 메트릭을 생성하는 경우 해당 테이블에 대한 SELECT 권한을 datadog 사용자에게 부여해야 할 수 있습니다. 예: grant SELECT on <TABLE_NAME> to datadog;. 자세한 내용은 FAQ 섹션을 참조하세요.

호스트

호스트에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

1. postgres.d/conf.yaml 파일을 편집하여 host/port를 가리키도록 하고 마스터를 모니터로 설정합니다. 사용 가능한 모든 설정 옵션은 샘플 postgres.d/conf.yaml을 참조하세요.

   init_config:
   
   instances:
     ## @param host - string - required
     ## The hostname to connect to.
     ## NOTE: Even if the server name is "localhost", the agent connects to
     ## PostgreSQL using TCP/IP, unless you also provide a value for the sock key.
     #
     - host: localhost
   
       ## @param port - integer - optional - default: 5432
       ## The port to use when connecting to PostgreSQL.
       #
       # port: 5432
   
       ## @param username - string - required
       ## The Datadog username created to connect to PostgreSQL.
       #
       username: datadog
   
       ## @param password - string - optional
       ## The password associated with the Datadog user.
       #
       # password: <PASSWORD>
   
       ## @param dbname - string - optional - default: postgres
       ## The name of the PostgresSQL database to monitor.
       ## Note: If omitted, the default system Postgres database is queried.
       #
       # dbname: <DBNAME>
   
       # @param disable_generic_tags - boolean - optional - default: false
       # The integration will stop sending server tag as is redundant with host tag
       disable_generic_tags: true
   

2. 관계 메트릭을 수집하려면, 에이전트를 모든 논리적 데이터베이스에 연결합니다. 이러한 데이터베이스는 자동으로 검색되거나 설정에서 각 데이터베이스를 명시적으로 나열할 수 있습니다.

   • 특정 인스턴스에서 논리 데이터베이스를 자동으로 검색하려면 해당 인스턴스에서 자동탐지를 활성화하세요.

   instances:
     - host: localhost
       # port: 5432
       database_autodiscovery:
         enabled: true
         # Optionally, set the include field to specify
         # a set of databases you are interested in discovering
         include:
           - mydb.*
           - example.*
       relations:
         - relation_regex: .*
   

   • 또는 설정에서 각 논리적 데이터베이스를 인스턴스로 목록화할 수 있습니다.

   instances:
     - host: example-service-primary.example-host.com
       # port: 5432
       username: datadog
       password: '<PASSWORD>'
       relations:
         - relation_name: products
         - relation_name: external_seller_products
     - host: example-service-replica-1.example-host.com
       # port: 5432
       username: datadog
       password: '<PASSWORD>'
       relations:
         - relation_regex: inventory_.*
           relkind:
             - r
             - i
     - host: example-service-replica-2.example-host.com
       # port: 5432
       username: datadog
       password: '<PASSWORD>'
       relations:
         - relation_regex: .*
   

3. 에이전트를 다시 시작합니다.

트레이스 수집

Datadog 애플리케이션 성능 모니터링(APM)은 분산 시스템에서 트레이스를 볼 수 있도록 Postgres와 통합됩니다. 트레이스 수집은 Datadog 에이전트 v6+에서 기본적으로 활성화됩니다. 트레이스 수집을 시작하려면 다음을 수행합니다.

1. Datadog에서 트레이스 수집을 활성화합니다.
2. Postgres에 요청하는 애플리케이션 계측.

로그 수집

에이전트 버전 > 6.0에서 사용 가능

PostgreSQL 기본 로깅은 stderr입니다. 로그에는 자세한 정보가 포함되어 있지 않습니다. 로그 줄 접두어에 지정된 추가 세부 정보를 사용해 파일에 로그인하는 것이 좋습니다. 자세한 내용은 오류 보고 및 로깅에 대한 PostgreSQL 설명서를 참조하세요.

1. /etc/postgresql/<VERSION>/main/postgresql.conf 파일에서 로깅을 설정합니다. 문 출력과 같은 정기적인 로그 결과를 보려면 로그 섹션에서 다음 파라미터의 주석 처리를 제거합니다.

     logging_collector = on
     log_directory = 'pg_log'  # directory where log files are written,
                               # can be absolute or relative to PGDATA
     log_filename = 'pg.log'   # log file name, can include pattern
     log_statement = 'all'     # log all queries
     #log_duration = on
     log_line_prefix= '%m [%p] %d %a %u %h %c '
     log_file_mode = 0644
     ## For Windows
     #log_destination = 'eventlog'
   

2. 자세한 기간 메트릭을 수집하여 Datadog 인터페이스에서 검색할 수 있도록 하려면 문 자체를 사용해 인라인으로 설정해야 합니다. 위와 권장 설정의 차이점은 아래를 참조하세요. 참고: log_statement 및 log_duration 옵션은 모두 주석 처리되어 있습니다. 이 주제에 대한 자세한 내용은 같은 줄에 문/기간 로깅하기를 참조하세요.

   이 설정은 모든 문을 기록합니다. 기간에 따라 출력을 줄이려면 log_min_duration_statement 값을 원하는 최소 기간(밀리초)으로 설정합니다.

     log_min_duration_statement = 0    # -1 is disabled, 0 logs all statements
                                       # and their durations, > 0 logs only
                                       # statements running at least this number
                                       # of milliseconds
     #log_statement = 'all'
     #log_duration = on
   

3. 로그 수집은 Datadog 에이전트에서 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화합니다.

   logs_enabled: true
   

4. 이 설정 블록을 postgres.d/conf.yaml 파일에 추가하고 편집하여 PostgreSQL 로그 수집을 시작하세요.

   logs:
     - type: file
       path: "<LOG_FILE_PATH>"
       source: postgresql
       service: "<SERVICE_NAME>"
       #To handle multi line that starts with yyyy-mm-dd use the following pattern
       #log_processing_rules:
       #  - type: multi_line
       #    pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])
       #    name: new_log_start_with_date
   

   service 및 path 파라미터 값을 변경하여 환경을 설정합니다. 사용 가능한 모든 설정 옵션은 샘플 postgres.d/conf.yaml을 참조하세요.

5. 에이전트를 다시 시작합니다.

도커(Docker)

컨테이너에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

LABEL "com.datadoghq.ad.check_names"='["postgres"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"host":"%%host%%", "port":5432,"username":"datadog","password":"<PASSWORD>"}]'

로그 수집

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 Docker 로그 수집을 참고하세요.

그런 다음 Docker 레이블로 로그 통합을 설정하세요.

LABEL "com.datadoghq.ad.logs"='[{"source":"postgresql","service":"postgresql"}]'

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 구성의 전체 목록은 Docker 애플리케이션 추적을 참조하세요.

그런 다음 [Postgres에 요청하는 애플리케이션 컨테이너]를 계측하고3 DD_AGENT_HOST를 에이전트 컨테이너의 이름으로 설정합니다.

Kubernetes

쿠버네티스에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

자동탐지 통합 템플릿을 애플리케이션 컨테이너의 포드 주석으로 설정합니다. 이외 템플릿은 또한 파일, configmap, key-value store로 설정할 수 있습니다.

주석 v1(Datadog 에이전트 v7.36 이하용)

apiVersion: v1
kind: Pod
metadata:
  name: postgres
  annotations:
    ad.datadoghq.com/postgresql.check_names: '["postgres"]'
    ad.datadoghq.com/postgresql.init_configs: '[{}]'
    ad.datadoghq.com/postgresql.instances: |
      [
        {
          "host": "%%host%%",
          "port":"5432",
          "username":"datadog",
          "password":"<PASSWORD>"
        }
      ]      
spec:
  containers:
    - name: postgres

주석 v2(Datadog 에이전트 v7.36 이상용)

apiVersion: v1
kind: Pod
metadata:
  name: postgres
  annotations:
    ad.datadoghq.com/postgres.checks: |
      {
        "postgres": {
          "init_config": {},
          "instances": [
            {
              "host": "%%host%%",
              "port":"5432",
              "username":"datadog",
              "password":"<PASSWORD>"
            }
          ]
        }
      }      
spec:
  containers:
    - name: postgres

로그 수집

Datadog 에이전트에서 기본적으로 로그 수집이 비활성화되어 있습니다. 활성화하려면 [쿠버네티스 로그 수집]을 확인하세요.

그런 다음 로그 통합을 포드 주석으로 설정합니다. 또한 파일, configmap, 또는 key-value store로 설정할 수 있습니다.

주석 v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: postgres
  annotations:
    ad.datadoghq.com/postgres.logs: '[{"source":"postgresql","service":"<SERVICE_NAME>"}]'
spec:
  containers:
    - name: postgres

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+를 실행하는 호스트에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 구성의 전체 목록은 Kubernetes 애플리케이션 추적 및 Kubernetes DaemonSet 설정을 참조하세요.

그런 다음 Postgres에 요청하는 애플리케이션 컨테이너를 계측합니다.

ECS

ECS에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

{
  "containerDefinitions": [{
    "name": "postgres",
    "image": "postgres:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"postgres\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"host\":\"%%host%%\", \"port\":5432,\"username\":\"datadog\",\"password\":\"<PASSWORD>\"}]"
    }
  }]
}

로그 수집

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 ECS 로그 수집을 참조하세요.

그런 다음 Docker 레이블로 로그 통합을 설정하세요.

{
  "containerDefinitions": [{
    "name": "postgres",
    "image": "postgres:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"postgresql\",\"service\":\"postgresql\"}]"
    }
  }]
}

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 구성의 전체 목록은 Docker 애플리케이션 추적을 참조하세요.

그런 다음 Postgres에 요청하는 애플리케이션 컨테이너 을 계측하고 [DD_AGENT_HOST]를 EC2 비공개 IP 주소로 설정합니다.