Merge branch 'collectd-4.5'
[collectd.git] / src / postgresql.c
index 135a827..a5bacf4 100644 (file)
@@ -97,12 +97,17 @@ typedef struct {
 
        c_psql_col_t *cols;
        int           cols_num;
+
+       int min_pg_version;
+       int max_pg_version;
 } c_psql_query_t;
 
 typedef struct {
        PGconn      *conn;
        c_complain_t conn_complaint;
 
+       int proto_version;
+
        int max_params_num;
 
        /* user configuration */
@@ -128,7 +133,8 @@ static char *def_queries[] = {
        "queries",
        "query_plans",
        "table_states",
-       "disk_io"
+       "disk_io",
+       "disk_usage"
 };
 static int def_queries_num = STATIC_ARRAY_SIZE (def_queries);
 
@@ -158,6 +164,9 @@ static c_psql_query_t *c_psql_query_new (const char *name)
 
        query->cols     = NULL;
        query->cols_num = 0;
+
+       query->min_pg_version = 0;
+       query->max_pg_version = INT_MAX;
        return query;
 } /* c_psql_query_new */
 
@@ -180,12 +189,15 @@ static void c_psql_query_delete (c_psql_query_t *query)
        return;
 } /* c_psql_query_delete */
 
-static c_psql_query_t *c_psql_query_get (const char *name)
+static c_psql_query_t *c_psql_query_get (const char *name, int server_version)
 {
        int i;
 
        for (i = 0; i < queries_num; ++i)
-               if (0 == strcasecmp (name, queries[i].name))
+               if (0 == strcasecmp (name, queries[i].name)
+                               && ((-1 == server_version)
+                                       || ((queries[i].min_pg_version <= server_version)
+                                               && (server_version <= queries[i].max_pg_version))))
                        return queries + i;
        return NULL;
 } /* c_psql_query_get */
@@ -205,8 +217,9 @@ static c_psql_database_t *c_psql_database_new (const char *name)
 
        db->conn = NULL;
 
-       db->conn_complaint.last     = 0;
-       db->conn_complaint.interval = 0;
+       C_COMPLAIN_INIT (&db->conn_complaint);
+
+       db->proto_version = 0;
 
        db->max_params_num = 0;
 
@@ -230,6 +243,7 @@ static c_psql_database_t *c_psql_database_new (const char *name)
 static void c_psql_database_delete (c_psql_database_t *db)
 {
        PQfinish (db->conn);
+       db->conn = NULL;
 
        sfree (db->queries);
        db->queries_num = 0;
@@ -322,6 +336,11 @@ static int c_psql_check_connection (c_psql_database_t *db)
                                        db->database, PQerrorMessage (db->conn));
                        return -1;
                }
+
+               db->proto_version = PQprotocolVersion (db->conn);
+               if (3 > db->proto_version)
+                       log_warn ("Protocol version %d does not support parameters.",
+                                       db->proto_version);
        }
 
        c_release (LOG_INFO, &db->conn_complaint,
@@ -329,20 +348,11 @@ static int c_psql_check_connection (c_psql_database_t *db)
        return 0;
 } /* c_psql_check_connection */
 
-static int c_psql_exec_query (c_psql_database_t *db, int idx)
+static PGresult *c_psql_exec_query_params (c_psql_database_t *db,
+               c_psql_query_t *query)
 {
-       c_psql_query_t *query;
-       PGresult       *res;
-
        char *params[db->max_params_num];
-
-       int rows, cols;
-       int i;
-
-       if (idx >= db->queries_num)
-               return -1;
-
-       query = db->queries[idx];
+       int   i;
 
        assert (db->max_params_num >= query->params_num);
 
@@ -363,9 +373,40 @@ static int c_psql_exec_query (c_psql_database_t *db, int idx)
                }
        }
 
-       res = PQexecParams (db->conn, query->query, query->params_num, NULL,
+       return PQexecParams (db->conn, query->query, query->params_num, NULL,
                        (const char *const *)((0 == query->params_num) ? NULL : params),
                        NULL, NULL, /* return text data */ 0);
+} /* c_psql_exec_query_params */
+
+static PGresult *c_psql_exec_query_noparams (c_psql_database_t *db,
+               c_psql_query_t *query)
+{
+       return PQexec (db->conn, query->query);
+} /* c_psql_exec_query_noparams */
+
+static int c_psql_exec_query (c_psql_database_t *db, int idx)
+{
+       c_psql_query_t *query;
+       PGresult       *res;
+
+       int rows, cols;
+       int i;
+
+       if (idx >= db->queries_num)
+               return -1;
+
+       query = db->queries[idx];
+
+       if (3 <= db->proto_version)
+               res = c_psql_exec_query_params (db, query);
+       else if (0 == query->params_num)
+               res = c_psql_exec_query_noparams (db, query);
+       else {
+               log_err ("Connection to database \"%s\" does not support parameters "
+                               "(protocol version %d) - cannot execute query \"%s\".",
+                               db->database, db->proto_version, query->name);
+               return -1;
+       }
 
        if (PGRES_TUPLES_OK != PQresultStatus (res)) {
                log_err ("Failed to execute SQL query: %s",
@@ -376,14 +417,17 @@ static int c_psql_exec_query (c_psql_database_t *db, int idx)
        }
 
        rows = PQntuples (res);
-       if (1 > rows)
+       if (1 > rows) {
+               PQclear (res);
                return 0;
+       }
 
        cols = PQnfields (res);
        if (query->cols_num != cols) {
                log_err ("SQL query returned wrong number of fields "
                                "(expected: %i, got: %i)", query->cols_num, cols);
                log_info ("SQL query was: %s", query->query);
+               PQclear (res);
                return -1;
        }
 
@@ -401,6 +445,7 @@ static int c_psql_exec_query (c_psql_database_t *db, int idx)
                                submit_gauge (db, col.type, col.type_instance, value);
                }
        }
+       PQclear (res);
        return 0;
 } /* c_psql_exec_query */
 
@@ -503,6 +548,14 @@ static int c_psql_init (void)
                char *server_host;
                int   server_version;
 
+               int j;
+
+               /* this will happen during reinitialization */
+               if (NULL != db->conn) {
+                       c_psql_check_connection (db);
+                       continue;
+               }
+
                status = ssnprintf (buf, buf_len, "dbname = '%s'", db->database);
                if (0 < status) {
                        buf     += status;
@@ -521,6 +574,8 @@ static int c_psql_init (void)
                if (0 != c_psql_check_connection (db))
                        continue;
 
+               db->proto_version = PQprotocolVersion (db->conn);
+
                server_host    = PQhost (db->conn);
                server_version = PQserverVersion (db->conn);
                log_info ("Sucessfully connected to database %s (user %s) "
@@ -529,7 +584,38 @@ static int c_psql_init (void)
                                PQdb (db->conn), PQuser (db->conn),
                                C_PSQL_SOCKET3 (server_host, PQport (db->conn)),
                                C_PSQL_SERVER_VERSION3 (server_version),
-                               PQprotocolVersion (db->conn), PQbackendPID (db->conn));
+                               db->proto_version, PQbackendPID (db->conn));
+
+               if (3 > db->proto_version)
+                       log_warn ("Protocol version %d does not support parameters.",
+                                       db->proto_version);
+
+               /* Now that we know the PostgreSQL server version, we can get the
+                * right version of each query definition. */
+               for (j = 0; j < db->queries_num; ++j) {
+                       c_psql_query_t *tmp;
+
+                       tmp = c_psql_query_get (db->queries[j]->name, server_version);
+
+                       if (tmp == db->queries[j])
+                               continue;
+
+                       if (NULL == tmp) {
+                               log_err ("Query \"%s\" not found for server version %i - "
+                                               "please check your configuration.",
+                                               db->queries[j]->name, server_version);
+
+                               if (db->queries_num - j - 1 > 0)
+                                       memmove (db->queries + j, db->queries + j + 1,
+                                                       (db->queries_num - j - 1) * sizeof (*db->queries));
+
+                               --db->queries_num;
+                               --j;
+                               continue;
+                       }
+
+                       db->queries[j] = tmp;
+               }
        }
 
        plugin_register_read ("postgresql", c_psql_read);
@@ -537,7 +623,7 @@ static int c_psql_init (void)
        return 0;
 } /* c_psql_init */
 
-static int config_set (char *name, char **var, const oconfig_item_t *ci)
+static int config_set_s (char *name, char **var, const oconfig_item_t *ci)
 {
        if ((0 != ci->children_num) || (1 != ci->values_num)
                        || (OCONFIG_TYPE_STRING != ci->values[0].type)) {
@@ -548,7 +634,19 @@ static int config_set (char *name, char **var, const oconfig_item_t *ci)
        sfree (*var);
        *var = sstrdup (ci->values[0].value.string);
        return 0;
-} /* config_set */
+} /* config_set_s */
+
+static int config_set_i (char *name, int *var, const oconfig_item_t *ci)
+{
+       if ((0 != ci->children_num) || (1 != ci->values_num)
+                       || (OCONFIG_TYPE_NUMBER != ci->values[0].type)) {
+               log_err ("%s expects a single number argument.", name);
+               return 1;
+       }
+
+       *var = (int)ci->values[0].value.number;
+       return 0;
+} /* config_set_i */
 
 static int config_set_param (c_psql_query_t *query, const oconfig_item_t *ci)
 {
@@ -620,20 +718,14 @@ static int config_set_column (c_psql_query_t *query, const oconfig_item_t *ci)
        return 0;
 } /* config_set_column */
 
-static int config_set_query (c_psql_database_t *db, const oconfig_item_t *ci)
+static int set_query (c_psql_database_t *db, const char *name)
 {
        c_psql_query_t *query;
 
-       if ((0 != ci->children_num) || (1 != ci->values_num)
-                       || (OCONFIG_TYPE_STRING != ci->values[0].type)) {
-               log_err ("Query expects a single string argument.");
-               return 1;
-       }
-
-       query = c_psql_query_get (ci->values[0].value.string);
+       query = c_psql_query_get (name, -1);
        if (NULL == query) {
                log_err ("Query \"%s\" not found - please check your configuration.",
-                               ci->values[0].value.string);
+                               name);
                return 1;
        }
 
@@ -649,6 +741,16 @@ static int config_set_query (c_psql_database_t *db, const oconfig_item_t *ci)
 
        db->queries[db->queries_num - 1] = query;
        return 0;
+} /* set_query */
+
+static int config_set_query (c_psql_database_t *db, const oconfig_item_t *ci)
+{
+       if ((0 != ci->children_num) || (1 != ci->values_num)
+                       || (OCONFIG_TYPE_STRING != ci->values[0].type)) {
+               log_err ("Query expects a single string argument.");
+               return 1;
+       }
+       return set_query (db, ci->values[0].value.string);
 } /* config_set_query */
 
 static int c_psql_config_query (oconfig_item_t *ci)
@@ -669,14 +771,48 @@ static int c_psql_config_query (oconfig_item_t *ci)
                oconfig_item_t *c = ci->children + i;
 
                if (0 == strcasecmp (c->key, "Query"))
-                       config_set ("Query", &query->query, c);
+                       config_set_s ("Query", &query->query, c);
                else if (0 == strcasecmp (c->key, "Param"))
                        config_set_param (query, c);
                else if (0 == strcasecmp (c->key, "Column"))
                        config_set_column (query, c);
+               else if (0 == strcasecmp (c->key, "MinPGVersion"))
+                       config_set_i ("MinPGVersion", &query->min_pg_version, c);
+               else if (0 == strcasecmp (c->key, "MaxPGVersion"))
+                       config_set_i ("MaxPGVersion", &query->max_pg_version, c);
                else
                        log_warn ("Ignoring unknown config key \"%s\".", c->key);
        }
+
+       for (i = 0; i < queries_num - 1; ++i) {
+               c_psql_query_t *q = queries + i;
+
+               if ((0 == strcasecmp (q->name, query->name))
+                               && (q->min_pg_version <= query->max_pg_version)
+                               && (query->min_pg_version <= q->max_pg_version)) {
+                       log_err ("Ignoring redefinition (with overlapping version ranges) "
+                                       "of query \"%s\".", query->name);
+                       c_psql_query_delete (query);
+                       --queries_num;
+                       return 1;
+               }
+       }
+
+       if (query->min_pg_version > query->max_pg_version) {
+               log_err ("Query \"%s\": MinPGVersion > MaxPGVersion.",
+                               query->name);
+               c_psql_query_delete (query);
+               --queries_num;
+               return 1;
+       }
+
+       if (NULL == query->query) {
+               log_err ("Query \"%s\" does not include an SQL query string - "
+                               "please check your configuration.", query->name);
+               c_psql_query_delete (query);
+               --queries_num;
+               return 1;
+       }
        return 0;
 } /* c_psql_config_query */
 
@@ -698,19 +834,19 @@ static int c_psql_config_database (oconfig_item_t *ci)
                oconfig_item_t *c = ci->children + i;
 
                if (0 == strcasecmp (c->key, "Host"))
-                       config_set ("Host", &db->host, c);
+                       config_set_s ("Host", &db->host, c);
                else if (0 == strcasecmp (c->key, "Port"))
-                       config_set ("Port", &db->port, c);
+                       config_set_s ("Port", &db->port, c);
                else if (0 == strcasecmp (c->key, "User"))
-                       config_set ("User", &db->user, c);
+                       config_set_s ("User", &db->user, c);
                else if (0 == strcasecmp (c->key, "Password"))
-                       config_set ("Password", &db->password, c);
+                       config_set_s ("Password", &db->password, c);
                else if (0 == strcasecmp (c->key, "SSLMode"))
-                       config_set ("SSLMode", &db->sslmode, c);
+                       config_set_s ("SSLMode", &db->sslmode, c);
                else if (0 == strcasecmp (c->key, "KRBSrvName"))
-                       config_set ("KRBSrvName", &db->krbsrvname, c);
+                       config_set_s ("KRBSrvName", &db->krbsrvname, c);
                else if (0 == strcasecmp (c->key, "Service"))
-                       config_set ("Service", &db->service, c);
+                       config_set_s ("Service", &db->service, c);
                else if (0 == strcasecmp (c->key, "Query"))
                        config_set_query (db, c);
                else
@@ -718,18 +854,8 @@ static int c_psql_config_database (oconfig_item_t *ci)
        }
 
        if (NULL == db->queries) {
-               db->queries = (c_psql_query_t **)malloc (def_queries_num
-                               * sizeof (*db->queries));
-
-               for (i = 0; i < def_queries_num; ++i) {
-                       db->queries[i] = c_psql_query_get (def_queries[i]);
-                       if (NULL == db->queries[i])
-                               log_err ("Query \"%s\" not found - "
-                                               "please check your installation.",
-                                               def_queries[i]);
-                       else
-                               ++db->queries_num;
-               }
+               for (i = 0; i < def_queries_num; ++i)
+                       set_query (db, def_queries[i]);
        }
        return 0;
 }