9 Motor Database

9.2.1 Driver Oracle#

Cadena de conexión.

Se pasa tal cual al cliente de Oracle, así que admite cualquier forma que este acepte:

ConnectionString = oraprod                          # alias de tnsnames.ora
ConnectionString = dbhost.empresa.com:1521/ORAPROD  # Easy Connect
ConnectionString = (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORAPROD)))

Para usar alias, la variable TNS_ADMIN del servicio debe apuntar al directorio del tnsnames.ora.

ConnectOptions.

SYSDBA conecta con privilegios de administrador (necesario para ASM). Sin valor, conexión normal.

Contextos.

Container: el contenedor (PDB) activo, que se cambia con ALTER SESSION SET CONTAINER. Solo está disponible en Oracle 12c o posterior, en una base de datos multitenant y conectando al contenedor raíz (CDB$ROOT). En cualquier otro caso, el driver no admite contextos y ORACLE.CONTAINER vale 0.

Variables de enlace.

Nativas de Oracle (:nombre).

9.2.2 Driver PGsql#

Cadena de conexión.

Pares clave=valor de libpq separados por espacios (host, port, dbname, sslmode, connect_timeout…). El usuario y la contraseña se añaden desde UserName y Password; no los ponga en la cadena.

ConnectionString = host=pg01.empresa.com port=5432 dbname=postgres sslmode=require

ConnectOptions.

No se usa.

Contextos.

Database: la base de datos activa. Como PostgreSQL no permite cambiar de base de datos en una conexión, el driver abre una conexión por cada base de datos que se usa (sustituyendo el dbname de la cadena) y las mantiene abiertas.

Variables de enlace.

Se convierten a $1, $2…

9.2.3 Driver ODBC#

Cadena de conexión.

Se pasa a SQLDriverConnect añadiendo ;UID=…;PWD=… con el usuario y la contraseña. Puede referirse a una fuente de datos de odbc.ini o describir la conexión completa:

ConnectionString = DSN=MSSQL_PROD
ConnectionString = DRIVER={FreeTDS};SERVER=mssql.empresa.com;PORT=1433;DATABASE=master

Para usar DSN, la variable ODBCINI del servicio debe apuntar al fichero odbc.ini.

ConnectOptions.

No se usa.

Contextos.

Database: la base de datos (catálogo) activa, que se cambia en la misma conexión con el atributo ODBC SQL_ATTR_CURRENT_CATALOG. Funciona con los drivers que lo admiten, como los de SQL Server.

Variables de enlace.

Se convierten a ?.

9.2.4 Datos de ejecución#

Los datos de ejecución se consultan en las condiciones de <when> con runtime(’NOMBRE’) (sección 9.6) y en queryexplorer con getRuntimeValue.

Así, un mismo XML puede elegir el SQL según el producto (runtime(’DB.DATABASE’) = ’Microsoft SQL Server’), según la versión (major(runtime(’DB.VERSION’)) >= 12) o según si la base de datos es multitenant (runtime(’ORACLE.CONTAINER’) = ’1’).

9.4.1 Consulta básica#

La sentencia devuelve exactamente una fila. Cada <item> toma el valor de una columna.

<query name="PGWriter" module="PG">
    <sql><![CDATA[
        select checkpoints_timed, checkpoints_req from pg_stat_bgwriter
        ]]>
    </sql>
    <item name="tez.pg.checkpointtimed" column="checkpoints_timed"/>
    <item name="tez.pg.checkpointreq"   column="checkpoints_req"/>
</query>

Si la sentencia devuelve cero filas o más de una, todos los ítems de la consulta pasan a no soportados.

9.4.2 Consulta de filtro (select="FILTER")#

La sentencia devuelve muchas filas. Cada <parameter> con column relaciona un parámetro de la clave con una columna, y cada ítem se queda con la fila cuyas columnas coinciden con los parámetros de su clave. La sentencia se ejecuta una sola vez para todos los ítems, así que es la forma más eficiente de vigilar colecciones de objetos (tablespaces, bases de datos, trabajos…).

<query name="PGSessions" module="PG" select="FILTER">
    <sql><![CDATA[
        select datname,
               count(st.pid) as n,
               sum(case st.state when 'active' then 1 else 0 end) as active
        from pg_database db
             left outer join pg_stat_activity st using (datname)
        where datname not like 'template%'
        group by datname
        ]]>
    </sql>
    <parameter column="datname" order="1" type="STRING"/>
    <item name="tez.pg.sessions"       column="n"/>
    <item name="tez.pg.sessionsactive" column="active" default="0"/>
</query>

Las cuatro primeras claves se resuelven con una única ejecución de la sentencia. La comparación es exacta: distingue mayúsculas y minúsculas (Ventas no coincide con ventas) y solo elimina los espacios de los extremos del parámetro. Si una columna tiene espacios de relleno (tipo char), recórtelos en el SQL con trim().

<query name="MSStateRepl" module="MSSQL" select="FILTER">
    <sql><![CDATA[ exec sp_replmonitorhelppublication ]]></sql>
    <default context="Database" value="distribution"/>
    <parameter column="publisher_db" order="1" type="STRING"/>
    <parameter column="publication"  order="2" type="STRING"/>
    <item name="tez.mssql.repl.status" column="status"/>
</query>

<parameter column="job_id" order="1" type="INT"/>
<item name="local.job.status" column="status"/>

9.4.3 Consulta con variables de enlace (select="BIND")#

El parámetro de la clave se pasa a la sentencia como variable de enlace. La sentencia se ejecuta una vez por cada clave distinta y debe devolver exactamente una fila.

<query name="PGParameter" module="PG" select="BIND">
    <sql><![CDATA[
        select setting from pg_settings where name = :name
        ]]>
    </sql>
    <parameter bind=":name" order="1" type="STRING"/>
    <item name="tez.pg.param" column="setting"/>
</query>

La variable se escribe siempre como :nombre, sea cual sea el driver (sección 9.2). Con type="INT", el valor se enlaza como número.

9.4.4 Consulta de descubrimiento#

Cada fila del resultado es una entidad descubierta, y cada <field> toma el valor de una columna (column) o de un contexto (context).

<query name="TSDiscover" module="DB" discovery="yes">
    <sql><![CDATA[
        select tablespace_name, contents
        from dba_tablespaces where status = 'ONLINE'
        ]]>
    </sql>
    <item name="tez.ora.tspace.discovery"/>
    <field name="TSNAME"   column="tablespace_name"/>
    <field name="CONTENTS" column="contents"/>
</query>

Valor del ítem tez.ora.tspace.discovery:

{"data":[
  {"{#TSNAME}":"SYSTEM", "{#CONTENTS}":"PERMANENT"},
  {"{#TSNAME}":"USERS",  "{#CONTENTS}":"PERMANENT"},
  {"{#TSNAME}":"TEMP",   "{#CONTENTS}":"TEMPORARY"}
]}

En Zabbix, el prototipo tez.ora.tspace.pctfree[{#TSNAME}] genera los ítems tez.ora.tspace.pctfree[SYSTEM], [USERS] y [TEMP], que resuelve una consulta FILTER con parameter column="tablespace_name".

Los descubrimientos solo admiten parámetros de contexto.

<query name="MSDiscoverFG" module="MSSQL" discovery="yes">
    <sql context="Database"><![CDATA[
        select name from sys.databases where name not in ('model')
        ]]>
    </sql>
    <sql><![CDATA[
        select name from sys.filegroups
        ]]>
    </sql>
    <item name="tez.mssql.fg.discovery"/>
    <field name="DBNAME" context="Database"/>
    <field name="FGNAME" column="name"/>
</query>

{"data":[
  {"{#DBNAME}":"master", "{#FGNAME}":"PRIMARY"},
  {"{#DBNAME}":"ventas", "{#FGNAME}":"PRIMARY"},
  {"{#DBNAME}":"ventas", "{#FGNAME}":"HISTORICO"}
]}

9.5.1 Declaración#

Los contextos se declaran en el nivel de <Queries>:

<environment name="PGAdminDB" default="postgres"/>
<context name="Database" module="PG" default="${PGAdminDB}"/>

9.5.2 Uso en consultas#

Hay tres formas de elegir el contexto de una consulta:

1. Por defecto. Si la consulta no dice nada, se ejecuta con el valor default del contexto.

2. Fijo para la consulta, con <default>:

   <default context="Database" value="msdb"/>

   Si value vale __IGNORE__ (por ejemplo, a través de una variable de entorno sin configurar), el elemento se ignora y se mantiene el valor por defecto.

3. Tomado de la clave del ítem, con un parámetro de contexto:

   <parameter context="Database" order="1"/>

9.5.3 Ejemplo: filtro dentro de cada base de datos#

Con un parámetro de contexto, el primer parámetro de la clave elige la base de datos y los siguientes, la fila:

<context name="Database" module="MSSQL" default="master"/>

<query name="MSFGSpace" module="MSSQL" select="FILTER">
    <sql><![CDATA[
        select g.name as filegroup_name,
               sum(cast(fileproperty(f.name, 'SPACEUSED') as bigint) * 8192) as used
        from sys.database_files f
             inner join sys.filegroups g on g.data_space_id = f.data_space_id
        group by g.name
        ]]>
    </sql>
    <parameter context="Database" order="1"/>
    <parameter column="filegroup_name" order="2" type="STRING"/>
    <item name="tez.mssql.fgspace.used" column="used"/>
</query>

Databbix agrupa las ejecuciones por contexto: entra en ventas una sola vez, ejecuta la sentencia y resuelve las dos primeras claves con el mismo resultado. Si no puede entrar en un contexto, marca como no soportados los ítems de ese contexto. Si el contexto que falla es el por defecto y ConnLostOnDefaultCtxError = yes, da la conexión por perdida y reconecta.

9.7.1 Ejemplo: Oracle#

[General]
Name = ORAPROD

[Zabbix]
Server = zabbix.empresa.com
Port = 10051
PassivePort = 10153

[Data]
Module = DB
Module = Instance

[Database]
DBDriver = Oracle
ConnectionString = oraprod          # alias de tnsnames.ora
UserName = zabbix
Password = secreto

9.7.2 Ejemplo: Oracle multitenant#

[General]
Name = ORACDB
QueryFile = /etc/databbix/query-mt.xml

[Zabbix]
Server = zabbix.empresa.com
Port = 10051

[Data]
Module = MT

[Database]
DBDriver = Oracle
ConnectionString = oracdb
UserName = c\043\043zabbix          # c##zabbix
Password = secreto

9.7.3 Ejemplo: ASM#

[General]
Name = asm

[Zabbix]
Server = zabbix.empresa.com
Port = 10051

[Data]
Module = ASM

[Database]
DBDriver = Oracle
ConnectionString = asm
ConnectOptions = SYSDBA
UserName = sys
Password = secreto

9.7.4 Ejemplo: PostgreSQL#

[General]
Name = PGPROD
QueryFile = /etc/databbix/query-pg.xml
QueryFile = /etc/databbix/query-pg-10.xml
Environment = PGAdminDB=postgres

[Zabbix]
Server = zabbix.empresa.com
Port = 10051

[Data]
Module = PG

[Database]
DBDriver = PGsql
ConnectionString = host=pg01.empresa.com port=5432 dbname=postgres
UserName = zabbix
Password = secreto

9.7.5 Ejemplo: SQL Server por ODBC#

Primero se define la fuente de datos en /etc/databbix/odbc.ini:

[MSSQL_PROD]
Driver=FreeTDS
Description=SQL Server de producción
Server=mssql.empresa.com
Port=1433
Database=master

Y después el monitor la referencia por su nombre:

[General]
Name = MSSQLPROD
QueryFile = /etc/databbix/query-mssql.xml

[Zabbix]
Server = zabbix.empresa.com
Port = 10051

[Data]
Module = MSSQL

[Database]
DBDriver = ODBC
ConnectionString = DSN=MSSQL_PROD
UserName = zabbix
Password = secreto