Otorga al datadog usuario permiso para las tablas relevantes:

ALTER ROLE datadog INHERIT;

Crea el siguiente esquema en cada base de datos:

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;

Crea el siguiente esquema en cada base de datos:

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;

Crea el siguiente esquema en cada base de datos:

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;

Crea funciones en cada base de datos para permitir que el Agente lea el contenido completo de pg_stat_activity y 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;

Para configurar la recolección de métricas de Monitoreo de Base de Datos para un Agente que se ejecuta en un host, por ejemplo, cuando provisionas una pequeña instancia de EC2 para que el Agente recolecte de una base de datos RDS:

1. Edita el archivo postgres.d/conf.yaml para apuntar a tu host / port y establece los maestros a monitorear. Consulta el archivo de ejemplo postgres.d/conf.yaml para ver todas las opciones de configuración disponibles.

   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>'
   

   Para versiones del Agente ≤ 7.49, agrega la siguiente opción a la configuración de la instancia donde se especifican host y port:

   ssl: allow
   

   Si deseas autenticarte con IAM, especifica los parámetros region y instance_endpoint, y establece managed_authentication.enabled en true.

   Nota: solo habilita managed_authentication si deseas usar la autenticación IAM. La autenticación IAM tiene prioridad sobre el campo 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>'
   

   Para información sobre cómo configurar la autenticación IAM en tu instancia de RDS, consulta Conexión con Autenticación Administrada.

2. Reiniciar el Agente.

Para configurar una integración para un Agente que se ejecuta en un contenedor Docker, como en ECS o Fargate, tienes un par de métodos disponibles, todos los cuales se cubren en detalle en la Documentación de Configuración de Docker.

Los ejemplos a continuación muestran cómo usar Etiquetas de Docker y Plantillas de Autodiscovery para configurar la integración de Postgres.

Nota: El Agente debe tener permiso de lectura en el socket de Docker para que el Autodiscovery de etiquetas funcione.

Línea de comandos

Ejecute el siguiente comando desde su línea de comandos para iniciar el Agente. Reemplace los valores de marcador de posición con los de su cuenta y entorno.

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}

Para Postgres 9.6, agregue la siguiente configuración a la instancia donde se especifican el servidor y el puerto:

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

Dockerfile

También puede especificar etiquetas en un Dockerfile, lo que le permite construir y desplegar un Agente personalizado sin modificar la configuración de su infraestructura.

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>"]}]'

Para Postgres 9.6, agregue la siguiente configuración a la instancia donde se especifican el servidor y el puerto:

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

Para evitar exponer la contraseña del usuario datadog en texto plano, use el paquete de gestión de secretos del Agent y declare la contraseña utilizando la sintaxis ENC[]. Alternativamente, consulte la documentación de variables de plantilla de Autodiscovery para proporcionar la contraseña como una variable de entorno.

Si está ejecutando un clúster de Kubernetes, use el Datadog Cluster Agent para habilitar Database Monitoring.

Nota: Asegúrese de que verificaciones de clúster estén habilitadas para su Datadog Cluster Agent antes de continuar.

A continuación se presentan instrucciones paso a paso para configurar la integración de Postgres utilizando diferentes métodos de implementación del Datadog Cluster Agent.

Operador

Usando las instrucciones del Operador en Kubernetes e Integraciones como referencia, siga los pasos a continuación para configurar la integración de Postgres:

1. Cree o actualice el archivo datadog-agent.yaml con la siguiente configuración:

   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. Aplique los cambios al Datadog Operator utilizando el siguiente comando:

   kubectl apply -f datadog-agent.yaml
   

Helm

Usando las instrucciones de Helm en Kubernetes e Integrations como referencia, siga los pasos a continuación para configurar la integración de Postgres:

1. Actualice su archivo datadog-values.yaml (utilizado en las instrucciones de instalación del Agente del Clúster) con la siguiente configuración:

   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. Despliega el Agente con el archivo de configuración anterior usando el siguiente comando:

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

Configura con archivos montados

Para configurar una verificación de clúster con un archivo de configuración montado, monta el archivo de configuración en el contenedor del Agente del Clúster en la ruta: /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()

Configura con anotaciones de servicio de Kubernetes

En lugar de montar un archivo, puedes declarar la configuración de la instancia como un servicio de Kubernetes. Para configurar esta verificación para un Agente que se ejecuta en Kubernetes, crea un servicio usando la siguiente sintaxis:

Autodiscovery anotaciones 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

Para más información, consulta Autodiscovery Annotations.

Si estás usando Postgres 9.6, añade lo siguiente a la configuración de la instancia:

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

El Agente del Clúster registra automáticamente esta configuración y comienza a ejecutar la verificación de Postgres.

Para evitar exponer la contraseña del datadog usuario en texto plano, utiliza el paquete de gestión de secretos del Agente y declara la contraseña usando la sintaxis ENC[].