Nota: Al generar métricas personalizadas que requieren que se consulten tablas adicionales, puede que sea necesario conceder el permiso SELECT al usuario datadog para acceder a esas tablas. Ejemplo: grant SELECT on <TABLE_NAME> to datadog;. Para obtener más información, consulta la sección FAQ.

Host

Para configurar este check para un Agent que se ejecuta en un host:

Recopilación de métricas

1. Edita el archivo postgres.d/conf.yaml para que apunte a tu host/port y define los principales para monitorizar. Consulta el ejemplo de postgres.d/conf.yaml para ver todas las opciones de configuración disponibles.

   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. Para recopilar métricas de relación, conecta el Agent a cada base de datos lógica. Estas bases de datos pueden ser detectadas automáticamente o cada una puede estar enumerada explícitamente en la configuración.

   • Para detectar bases de datos lógicas automáticamente en una instancia determinada, activa la detección automática en esa instancia:

   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: .*
   

   • También puedes listar cada base de datos lógica como una instancia en la configuración:

   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. Reinicia el Agent.

Recopilación de trazas

Datadog APM se integra con Postgres para visualizar trazas (traces) a través de tu sistema distribuido. La recopilación de trazas está activada por defecto en el Datadog Agent v6 o posteriores. Para empezar a recopilar trazas:

1. Activa la recopilación de trazas en Datadog.
2. Instrumenta tu aplicación que realiza solicitudes a Postgres.

Recopilación de logs

La generación de logs por defecto de PostgreSQL es para stderr y los logs no incluyen información detallada. Se recomienda generar logs en un archivo con detalles adicionales especificados en el prefijo de línea de los logs. Para obtener más información, consulta la documentación de PostgreSQL sobre informes de error y generación de logs.

1. La generación de logs se configura en el archivo /etc/postgresql/<VERSION>/main/postgresql.conf. Para obtener resultados regulares en logs, incluidos los resultados de sentencias, descomenta los siguientes parámetros en la sección de logs:

     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. Para recopilar métricas de duración detallada y permitir su búsqueda en la interfaz de Datadog, deben configurarse en línea con la propia sentencia. Consulta a continuación las diferencias de configuración recomendadas con respecto a las anteriores. Nota: Las opciones log_statement y log_duration están comentadas. Para ver una discusión sobre este tema, consulta Sentencia/duración de la generación de logs en la misma línea.

   Esta configuración registra todas las sentencias. Para reducir los resultados en función de la duración, ajusta el valor log_min_duration_statement a la duración mínima deseada (en milisegundos):

     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. La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

4. Añade y edita este bloque de configuración a tu archivo postgres.d/conf.yaml para empezar a recopilar tus logs de 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
   

   Cambia los valores de los parámetros service y path y configúralos para tu entorno. Consulta el ejemplo de postgres.d/conf.yaml para ver todas las opciones de configuración disponibles.

5. Reinicia el Agent.

Docker

Para configurar este check para un Agent que se ejecuta en un contenedor:

Recopilación de métricas

Configura plantillas de integración de Autodiscovery como etiquetas (labels) de Docker en el contenedor de tu aplicación:

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

Recopilación de logs

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta Recopilación de logs de Docker.

A continuación, configura integraciones de logs como etiquetas de Docker:

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

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con el Agent v6 o posterior, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Para ver una lista completa de las variables de entorno y la configuración disponibles, consulta Rastreo de aplicaciones Docker.

A continuación, instrumenta el contenedor de tu aplicación que realiza solicitudes a Postgres y configura DD_AGENT_HOST con el nombre del contenedor de tu Agent.

Kubernetes

Para Configurar este check para un Agent que se ejecuta en Kubernetes:

Recopilación de métricas

Configura plantillas de integración de Autodiscovery como anotaciones de pod en el contenedor de tu aplicación. Aparte de esto, las plantillas también se pueden configurar con un archivo, un mapa de configuración o un almacén clave-valor.

Anotaciones v1 (para el Datadog Agent < 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

Anotaciones v2 (para el Datadog Agent v7.36 o posterior)

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

Recopilación de logs

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta Recopilación de logs de Kubernetes.

A continuación, configura integraciones de logs como anotaciones de pod. Esto también se puede configurar con un archivo, un mapa de configuración o un almacén clave-valor.

Anotaciones v1/v2

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

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con hosts que se ejecutan en la versión 6 o posteriores del Agent, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Consulta Rastreo de aplicaciones Kubernetes y Configuración de Kubernetes DaemonSet para obtener una lista completa de las variables de entorno y la configuración disponibles.

A continuación, instrumenta el contenedor de tu aplicación que realiza solicitudes a Postgres.

ECS

Para configurar este check para un Agent que se ejecuta en ECS:

Recopilación de métricas

Configura plantillas de integración de Autodiscovery como etiquetas de Docker en el contenedor de tu aplicación:

Anotaciones v1 (para el Datadog Agent < v7.36)

{
  "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>\"}]"
    }
  }]
}

Anotaciones v2 (para el Datadog Agent v7.36 o posterior)

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

Recopilación de logs

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta Recopilación de logs de ECS.

A continuación, configura integraciones de logs como etiquetas de Docker:

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

Recopilación de trazas

APM para aplicaciones en contenedores es compatible con el Agent v6 o posterior, pero requiere configuración adicional para empezar a recopilar trazas.

Variables de entorno requeridas en el contenedor del Agent:

Para ver una lista completa de las variables de entorno y la configuración disponibles, consulta Rastreo de aplicaciones Docker.

A continuación, instrumenta el contenedor de tu aplicación que realiza solicitudes a Postgres y configura DD_AGENT_HOST con la dirección IP privada de EC2.