datadog 사용자에게 관련 테이블에 대한 권한을 부여합니다.

ALTER ROLE datadog INHERIT;

다음 스키마를 모든 데이터베이스에 생성합니다.

CREATE SCHEMA datadog;
GRANT USAGE ON SCHEMA datadog TO datadog;
GRANT USAGE ON SCHEMA public TO datadog;
GRANT pg_monitor TO datadog;
CREATE EXTENSION IF NOT EXISTS pg_stat_statements schema public;

다음 스키마를 모든 데이터베이스에 생성합니다.

CREATE SCHEMA datadog;
GRANT USAGE ON SCHEMA datadog TO datadog;
GRANT USAGE ON SCHEMA public TO datadog;
GRANT pg_monitor TO datadog;
CREATE EXTENSION IF NOT EXISTS pg_stat_statements schema public;

다음 스키마를 모든 데이터베이스에 생성합니다.

CREATE SCHEMA datadog;
GRANT USAGE ON SCHEMA datadog TO datadog;
GRANT USAGE ON SCHEMA public TO datadog;
GRANT SELECT ON pg_stat_database TO datadog;
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

Agent가 pg_stat_activity 및 pg_stat_statements의 전체 내용을 읽을 수 있도록 다음 함수를 모든 데이터베이스에 생성합니다.

CREATE OR REPLACE FUNCTION datadog.pg_stat_activity() RETURNS SETOF pg_stat_activity AS
  $$ SELECT * FROM pg_catalog.pg_stat_activity; $$
LANGUAGE sql
SECURITY DEFINER;
CREATE OR REPLACE FUNCTION datadog.pg_stat_statements() RETURNS SETOF pg_stat_statements AS
    $$ SELECT * FROM pg_stat_statements; $$
LANGUAGE sql
SECURITY DEFINER;

호스트에서 실행하는 Database Monitoring 메트릭 수집을 설정하려면(예: 에이전트가 RDS 데이터베이스에서 수집할 수 있도록 소규모 EC2 인스턴스를 프로비저닝할 때) 다음을 따릅니다.

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

   init_config:
   instances:
     - dbm: true
       host: '<AWS_INSTANCE_ENDPOINT>'
       port: 5432
       username: datadog
       password: 'ENC[datadog_user_database_password]'
       aws:
         instance_endpoint: '<AWS_INSTANCE_ENDPOINT>'
         region: '<REGION>'
       tags:
         - "dbinstanceidentifier:<DB_INSTANCE_NAME>"
   
       ## Required for Postgres 9.6: Uncomment these lines to use the functions created in the setup
       # pg_stat_statements_view: datadog.pg_stat_statements()
       # pg_stat_activity_view: datadog.pg_stat_activity()
   
       ## Optional: Connect to a different database if needed for `custom_queries`
       # dbname: '<DB_NAME>'
   

   Agent 버전 ≤ 7.49의 경우 host와 port가 지정된 인스턴스 구성에 다음 설정을 추가하세요.

   ssl: allow
   

   IAM 인증을 사용할 경우 region 및 instance_endpoint 파라미터를 지정하고 managed_authentication.enabled를 true로 설정하세요.

   참고: IAM 인증을 사용하려는 경우에만 managed_authentication을 활성화하세요. IAM 인증은 password 필드보다 우선합니다.

   init_config:
   instances:
     - dbm: true
       host: '<AWS_INSTANCE_ENDPOINT>'
       port: 5432
       username: datadog
       aws:
         instance_endpoint: '<AWS_INSTANCE_ENDPOINT>'
         region: '<REGION>'
         managed_authentication:
           enabled: true
       tags:
         - "dbinstanceidentifier:<DB_INSTANCE_NAME>"
   
       ## Required for Postgres 9.6: Uncomment these lines to use the functions created in the setup
       # pg_stat_statements_view: datadog.pg_stat_statements()
       # pg_stat_activity_view: datadog.pg_stat_activity()
   
       ## Optional: Connect to a different database if needed for `custom_queries`
       # dbname: '<DB_NAME>'
   

   RDS 인스턴스에서 IAM 인증을 구성하는 방법에 대한 정보는 관리형 인증으로 연결하기를 참조하세요.

2. Agent를 재시작합니다.

ECS 또는 Fargate와 같이 Docker 컨테이너에서 실행되는 Agent에 통합을 구성하려면 여러 가지 방법을 사용할 수 있으며, 자세한 내용은 Docker 구성 설명서에 설명되어 있습니다.

아래 예제에서는 Docker 레이블과 Autodiscovery 템플릿를 사용하여 Postgres 통합을 구성하는 방법을 보여줍니다.

참고: 레이블에 대한 Autodiscovery가 작동하려면 Agent에 Docker 소켓에 대한 읽기 권한이 있어야 합니다.

명령줄

Agent를 시작하려면 명령줄에서 다음 명령을 실행합니다. 자리표시자 값은 실제 계정 및 환경 값으로 바꾸세요.

export DD_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export DD_AGENT_VERSION=<AGENT_VERSION>

docker run -e "DD_API_KEY=${DD_API_KEY}" \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -l com.datadoghq.ad.checks='{"postgres": {
    "init_config": {},
    "instances": [{
      "dbm": true,
      "host": "<AWS_INSTANCE_ENDPOINT>",
      "port": 5432,
      "username": "datadog",
      "password": "<UNIQUEPASSWORD>",
       "aws": {
         "instance_endpoint": "<AWS_INSTANCE_ENDPOINT>",
         "region": "<REGION>"
       },
      "tags": ["dbinstanceidentifier:<DB_INSTANCE_NAME>"]
    }]
  }}' \
  registry.datadoghq.com/agent:${DD_AGENT_VERSION}

Postgres 9.6의 경우 호스트와 포트가 지정된 인스턴스 구성에 다음 설정을 추가하세요.

"pg_stat_statements_view": "datadog.pg_stat_statements()",
"pg_stat_activity_view": "datadog.pg_stat_activity()"

Dockerfile

Dockerfile에 레이블을 지정하여 인프라 구성을 수정하지 않고도 사용자 지정 Agent를 빌드 및 배포할 수도 있습니다.

FROM registry.datadoghq.com/agent:<AGENT_VERSION>

LABEL "com.datadoghq.ad.check_names"='["postgres"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"dbm": true, "host": "<AWS_INSTANCE_ENDPOINT>", "port": 5432,"username": "datadog","password": "ENC[datadog_user_database_password]","aws": {"instance_endpoint": "<AWS_INSTANCE_ENDPOINT>", "region": "<REGION>"}, "tags": ["dbinstanceidentifier:<DB_INSTANCE_NAME>"]}]'

Postgres 9.6의 경우 호스트와 포트가 지정된 인스턴스 구성에 다음 설정을 추가하세요.

"pg_stat_statements_view": "datadog.pg_stat_statements()",
"pg_stat_activity_view": "datadog.pg_stat_activity()"

datadog 사용자의 비밀번호가 일반 텍스트로 노출되지 않도록 하려면 Agent의 시크릿 관리 패키지를 사용하고 ENC[] 구문을 사용하여 비밀번호를 선언하세요. 또는 Autodiscovery 템플릿 변수 설명서을 참조하여 환경 변수로 비밀번호를 제공할 수 있습니다.

Kubernetes 클러스터를 실행 중인 경우 Database Monitoring을 활성화하려면 Datadog Cluster Agent를 사용하세요.

참고: 계속 진행하기 전에 Datadog Cluster Agent에서 클러스터 검사가 활성화되어 있는지 확인하세요.

아래에는 다양한 Datadog Cluster Agent 배포 방식을 사용하여 Postgres 통합을 구성하는 단계별 지침이 나와 있습니다.

Operator

Kubernetes and Integrations의 Operator 지침을 참고하여 다음 단계에 따라 Postgres 통합을 설정하세요.

1. 다음 구성을 사용하여 datadog-agent.yaml 파일을 생성 또는 업데이트합니다.

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     global:
       clusterName: <CLUSTER_NAME>
       site: <DD_SITE>
       credentials:
         apiSecret:
           secretName: datadog-agent-secret
           keyName: api-key
   
     features:
       clusterChecks:
         enabled: true
   
     override:
       nodeAgent:
         image:
           name: agent
           tag: <AGENT_VERSION>
   
       clusterAgent:
         extraConfd:
           configDataMap:
             postgres.yaml: |-
               cluster_check: true
               init_config:
               instances:
               - host: <AWS_INSTANCE_ENDPOINT>
                 port: 5432
                 username: datadog
                 password: 'ENC[datadog_user_database_password]'
                 dbm: true
                 aws:
                   instance_endpoint: <AWS_INSTANCE_ENDPOINT>
                   region: <REGION>
                 tags:
                 - "dbinstanceidentifier:<DB_INSTANCE_NAME>"
   

   Note: For Postgres 9.6, add the following lines to the instance config where host and port are specified:

   pg_stat_statements_view: datadog.pg_stat_statements()
   pg_stat_activity_view: datadog.pg_stat_activity()
   

2. 다음 명령을 사용하여 변경 사항을 Datadog Operator에 적용합니다.

   kubectl apply -f datadog-agent.yaml
   

Helm

Kubernetes and Integrations의 Helm 지침을 참고하여 다음 단계에 따라 Postgres 통합을 설정하세요.

1. 다음 구성을 사용하여 datadog-values.yaml 파일(Cluster Agent 설치 지침에서 사용하는 파일)을 업데이트합니다.

   datadog:
     clusterChecks:
       enabled: true
   
   clusterChecksRunner:
     enabled: true
   
   clusterAgent:
     enabled: true
     confd:
       postgres.yaml: |-
         cluster_check: true
         init_config:
         instances:
         - dbm: true
           host: <AWS_INSTANCE_ENDPOINT>
           port: 5432
           username: datadog
           password: 'ENC[datadog_user_database_password]'
           aws:
             instance_endpoint: <AWS_INSTANCE_ENDPOINT>
             region: <REGION>
           tags:
           - "dbinstanceidentifier:<DB_INSTANCE_NAME>"
   

   Note: For Postgres 9.6, add the following lines to the instance config where host and port are specified:

   pg_stat_statements_view: datadog.pg_stat_statements()
   pg_stat_activity_view: datadog.pg_stat_activity()
   

2. 다음 명령을 사용하여 위 구성 파일과 함께 Agent를 배포합니다.

   helm install datadog-agent -f datadog-values.yaml datadog/datadog
   

마운팅된 파일로 구성

마운팅된 구성 파일로 클러스터 검사를 구성하려면 Cluster Agent 컨테이너의 다음 경로에 구성 파일을 마운트합니다. /conf.d/postgres.yaml

cluster_check: true  # Make sure to include this flag
init_config:
instances:
  - dbm: true
    host: '<AWS_INSTANCE_ENDPOINT>'
    port: 5432
    username: datadog
    password: 'ENC[datadog_user_database_password]'
    aws:
      instance_endpoint: <AWS_INSTANCE_ENDPOINT>
      region: <REGION>
    tags:
    - "dbinstanceidentifier:<DB_INSTANCE_NAME>"

    ## Required: For Postgres 9.6, uncomment these lines to use the functions created in the setup
    # pg_stat_statements_view: datadog.pg_stat_statements()
    # pg_stat_activity_view: datadog.pg_stat_activity()

Kubernetes 서비스 주석으로 구성

파일을 마운팅하는 대신 인스턴스 구성을 Kubernetes 서비스로 선언할 수 있습니다. Kubernetes에서 실행되는 Agent에 이 검사를 구성하려면 다음 구문을 사용하여 서비스를 생성합니다.

Autodiscovery annotations v2

apiVersion: v1
kind: Service
metadata:
  name: postgres
  labels:
    tags.datadoghq.com/env: '<ENV>'
    tags.datadoghq.com/service: '<SERVICE>'
  annotations:
    ad.datadoghq.com/service.checks: |
      {
        "postgres": {
          "init_config": <INIT_CONFIG>,
          "instances": [
            {
              "dbm": true,
              "host": "<AWS_INSTANCE_ENDPOINT>",
              "port": 5432,
              "username": "datadog",
              "password": "ENC[datadog_user_database_password]",
              "aws": {
                "instance_endpoint": "<AWS_INSTANCE_ENDPOINT>",
                "region": "<REGION>"
              },
              "tags": [
                "dbinstanceidentifier:<DB_INSTANCE_NAME>"
              ]
            }
          ]
        }
      }
spec:
  ports:
  - port: 5432
    protocol: TCP
    targetPort: 5432
    name: postgres

자세한 내용은 Autodiscovery Annotations를 참조하세요.

Postgres 9.6을 사용하는 경우 인스턴스 구성에 다음 내용을 추가합니다.

"pg_stat_statements_view": "datadog.pg_stat_statements()",
"pg_stat_activity_view": "datadog.pg_stat_activity()"

Cluster Agent가 자동으로 설정을 등록하고 Postgres 검사 실행을 시작합니다.

datadog 사용자의 비밀번호가 일반 텍스트로 노출되지 않도록 하려면 Agent의 시크릿 관리 패키지를 사용하고 ENC[] 구문을 사용하여 비밀번호를 선언하세요.