Información general

Con este check se monitoriza IBM Db2 a través del Datadog Agent .

Configuración

Instalación

El check de IBM Db2 está incluido en el paquete del Datadog Agent.

Dependencias

Se necesita la biblioteca cliente ibm_db. Para instalarla, asegúrate de tener un compilador que funcione y ejecute:

Unix

sudo -Hu dd-agent /opt/datadog-agent/embedded/bin/pip install ibm_db==3.2.3

Nota: Si utilizas el Agent con Python 2, usa ibm_db==3.0.1 en lugar de ibm_db=3.1.0.

Windows

Para las versiones del Agent <= 6.11:

"C:\Program Files\Datadog\Datadog Agent\embedded\python.exe" -m pip install ibm_db==3.0.1

Para las versiones del Agent >= 6.12 y < 7.0:

"C:\Program Files\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe" -m pip install ibm_db==3.0.1

Para las versiones del Agent >= 7.0 y < 7.58:

"C:\Program Files\Datadog\Datadog Agent\embedded3\python.exe" -m pip install ibm_db==3.1.4

Para versiones del Agent 7.58 o posteriores:

"C:\Program Files\Datadog\Datadog Agent\embedded3\python.exe" -m pip install ibm_db==3.2.3

En Linux, puede ser necesaria la funcionalidad XML. Si encuentras errores durante el proceso de compilación, instala libxslt-dev (o libxslt-devel para RPM).

Habilitar la monitorización

La integración de IBM Db2 extrae los datos mediante las siguientes funciones de tabla:

• MON_GET_TABLESPACE
• MON_GET_TRANSACTION_LOG
• MON_GET_BUFFERPOOL
• MON_GET_DATABASE
• MON_GET_INSTANCE

Para obtener más información sobre estas funciones de tablas, consulta la documentación oficial de IBM.

Para monitorizar una instancia de Db2, crea un usuario de Db2 con el permiso EXECUTE en las cinco funciones de tabla anteriores, o concede al usuario de Db2 uno de los siguientes roles:

• Autoridad DATAACCESS
• Autoridad DBADM
• Autoridad SQLADM

Para monitorizar el estado de una instancia, sus bases de datos asociadas y los objetos de base de datos, habilita los interruptores de monitorización del sistema de base de datos para cada uno de los objetos que quieras monitorizar:

• Sentencia
• Bloqueo
• Tablas
• Grupo de buffers

Cambia al usuario maestro de la instancia y ejecuta estos comandos en la línea db2:

update dbm cfg using HEALTH_MON on
update dbm cfg using DFT_MON_STMT on
update dbm cfg using DFT_MON_LOCK on
update dbm cfg using DFT_MON_TABLE on
update dbm cfg using DFT_MON_BUFPOOL on

Luego, ejecuta get dbm cfg y deberías ver lo siguiente:

 Default database monitor switches
   Buffer pool                         (DFT_MON_BUFPOOL) = ON
   Lock                                   (DFT_MON_LOCK) = ON
   Sort                                   (DFT_MON_SORT) = OFF
   Statement                              (DFT_MON_STMT) = ON
   Table                                 (DFT_MON_TABLE) = ON
   Timestamp                         (DFT_MON_TIMESTAMP) = ON
   Unit of work                            (DFT_MON_UOW) = OFF
 Monitor health of instance and databases   (HEALTH_MON) = ON

Configuración

Validación

[Ejecuta el subcomando de estado del Agent(https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) y busca ibm_db2 en la sección Checks.

Datos recopilados

Métricas

Eventos

• ibm_db2.tablespace_state_change se activa cada vez que cambia el estado de un espacio de tablas.

Checks de servicio

ibm_db2.can_connect

Devuelve CRITICAL si el Agent no puede conectarse a la base de datos IBM Db2 monitorizada o OK en caso contrario.

Estados: ok, crítico

ibm_db2.status

Devuelve CRITICAL si la base de datos IBM Db2 monitorizada está en modo inactivo, WARNING para el modo inactivo pendiente o puestas al día o OK en caso contrario.

Estados: ok, advertencia, crítico, desconocido

Solucionar problemas

Error del controlador de la CLI SQL1531N

Es posible que te encuentres con un problema que produce un logs con errores como el siguiente:

2023-08-10 23:34:47 UTC | CORE | ERROR | (pkg/collector/python/datadog_agent.go:129 in LogMessage) | ibm_db2:c051131490335a94 | (ibm_db2.py:563) | Unable to connect to database `datadog` as user `db2inst1`: [IBM][CLI Driver] SQL1531N  The connection failed because the name specified with the DSN connection string keyword could not be found in either the db2dsdriver.cfg configuration file or the db2cli.ini configuration file.  Data source name specified in the connection string: "DATADOG". SQLCODE=-1531

En ese caso, lo más probable es que se deba a una de las siguientes situaciones:

• Falta un host y un puerto en la configuración (conf.yaml).
• El controlador de la CLI no es capaz de localizar la base de datos debido a la ausencia de db2cli.ini y db2dsdriver.cfg.

El Agent necesita la información de los dos escenarios anteriores para determinar dónde conectarse correctamente a la base de datos. Para resolver este problema, puedes incluir un parámetro de host y puerto para cada instancia del check de ibm_db2 que tenga este problema. De manera alternativa, si quieres utilizar los DSN definidos en los archivos db2cli.ini o db2dsdriver.cfg, puedes copiar dichos archivos en el directorio clidriver que utiliza el Agent. En circunstancias normales, ese directorio se encuentra en /opt/datadog-agent/embedded/lib/python3.9/site-packages/clidriver/cfg para Linux.

Instalación de la biblioteca de cliente ibm_db sin conexión

Si trabajas en un entorno sin conexión o con una red restringida donde no es posible ejecutar pip install ibm_db==x.y.z con x.y.z como el número de versión, puedes instalar ibm_db mediante el siguiente método:

1. En una máquina con acceso a la red, descarga los tarballs source (fuente) para la biblioteca ibm_db y el ODBC y CLI. El ODBC y la CLI deben descargarse por separado porque la biblioteca ibm_db los necesita, pero no puede descargarlos a través de pip. El siguiente script instala el archivo para ibm_db==x.y.z en una máquina Linux, donde x.y.z es el número de versión:

   curl -Lo ibm_db.tar.gz https://github.com/ibmdb/python-ibmdb/archive/refs/tags/vx.y.z.tar.gz
   
   curl -Lo linuxx64_odbc_cli.tar.gz https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
   

2. Mueve los dos archivos al host restringido y, luego, extrae el archivo.

   tar -xvf ibm_db.tar.gz
   
   tar -xvf linuxx64_odbc_cli.tar.gz
   

3. Define la variable de entorno IBM_DB_HOME como la localización de donde extrajiste /clidriver de linuxx64_odbc_cli.tar.gz. Esto evitará que la biblioteca ibm_db instale una nueva versión de la ODBC y la CLI, ya que eso generaría un error.

   export IBM_DB_HOME=/path/to/clidriver
   

4. Mediante la utilización del pip insertado en el Agent, instala la bblioteca ibm_db localmente. Los archivos de la biblioteca están contenidos en python-ibmdb-x.y.z extraído de ibm_db.tar.gz.

   /opt/datadog-agent/embedded/bin/pip install --no-index --no-deps --no-build-isolation  /path/to/python-ibmdb-x.y.z/IBM_DB/ibm_db/
   

Si obtienes el siguiente error:

  error: subprocess-exited-with-error

  × Preparing metadata (pyproject.toml) did not run successfully.
  | exit code: 1
   -> [8 lines of output]
      Detected 64-bit Python
      Detected platform = linux, uname = x86_64
      Downloading https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
       Downloading DSDriver from url =  https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
      Pre-requisite check [which gcc] : Failed

      No Gcc installation detected.
      Please install gcc and continue with the installation of the ibm_db.
      [end of output]

Es posible que debas instalar gcc.

¿Necesitas ayuda? Ponte en contacto con asistencia técnica de Datadog.

Referencias adicionales

Documentación útil adicional, enlaces y artículos:

• Monitoriza IBM DB2 con Datadog