2001-09-18 03:59:07 +02:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
*
|
|
|
|
* instrument.h
|
|
|
|
* definitions for run-time statistics collection
|
|
|
|
*
|
|
|
|
*
|
2008-01-01 20:46:01 +01:00
|
|
|
* Copyright (c) 2001-2008, PostgreSQL Global Development Group
|
2001-09-18 03:59:07 +02:00
|
|
|
*
|
2008-01-01 20:46:01 +01:00
|
|
|
* $PostgreSQL: pgsql/src/include/executor/instrument.h,v 1.18 2008/01/01 19:45:57 momjian Exp $
|
2001-09-18 03:59:07 +02:00
|
|
|
*
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
#ifndef INSTRUMENT_H
|
|
|
|
#define INSTRUMENT_H
|
|
|
|
|
|
|
|
#include <sys/time.h>
|
|
|
|
|
|
|
|
|
2005-03-20 23:27:52 +01:00
|
|
|
/*
|
|
|
|
* gettimeofday() does not have sufficient resolution on Windows,
|
|
|
|
* so we must use QueryPerformanceCounter() instead. These macros
|
|
|
|
* also give some breathing room to use other high-precision-timing APIs
|
2005-10-15 04:49:52 +02:00
|
|
|
* on yet other platforms. (The macro-ization is not complete, however;
|
2005-03-20 23:27:52 +01:00
|
|
|
* see subtraction code in instrument.c and explain.c.)
|
|
|
|
*/
|
|
|
|
#ifndef WIN32
|
|
|
|
|
|
|
|
typedef struct timeval instr_time;
|
|
|
|
|
|
|
|
#define INSTR_TIME_IS_ZERO(t) ((t).tv_sec == 0 && (t).tv_usec == 0)
|
|
|
|
#define INSTR_TIME_SET_ZERO(t) ((t).tv_sec = 0, (t).tv_usec = 0)
|
|
|
|
#define INSTR_TIME_SET_CURRENT(t) gettimeofday(&(t), NULL)
|
|
|
|
#define INSTR_TIME_GET_DOUBLE(t) \
|
|
|
|
(((double) (t).tv_sec) + ((double) (t).tv_usec) / 1000000.0)
|
2005-10-15 04:49:52 +02:00
|
|
|
#else /* WIN32 */
|
2005-03-20 23:27:52 +01:00
|
|
|
|
|
|
|
typedef LARGE_INTEGER instr_time;
|
|
|
|
|
|
|
|
#define INSTR_TIME_IS_ZERO(t) ((t).QuadPart == 0)
|
|
|
|
#define INSTR_TIME_SET_ZERO(t) ((t).QuadPart = 0)
|
|
|
|
#define INSTR_TIME_SET_CURRENT(t) QueryPerformanceCounter(&(t))
|
|
|
|
#define INSTR_TIME_GET_DOUBLE(t) \
|
|
|
|
(((double) (t).QuadPart) / GetTimerFrequency())
|
|
|
|
|
|
|
|
static __inline__ double
|
|
|
|
GetTimerFrequency(void)
|
|
|
|
{
|
|
|
|
LARGE_INTEGER f;
|
|
|
|
|
|
|
|
QueryPerformanceFrequency(&f);
|
|
|
|
return (double) f.QuadPart;
|
|
|
|
}
|
2005-10-15 04:49:52 +02:00
|
|
|
#endif /* WIN32 */
|
2005-03-20 23:27:52 +01:00
|
|
|
|
|
|
|
|
2001-09-18 03:59:07 +02:00
|
|
|
typedef struct Instrumentation
|
|
|
|
{
|
|
|
|
/* Info about current plan cycle: */
|
2001-10-25 07:50:21 +02:00
|
|
|
bool running; /* TRUE if we've completed first tuple */
|
2005-03-20 23:27:52 +01:00
|
|
|
instr_time starttime; /* Start time of current iteration of node */
|
2005-04-16 22:07:35 +02:00
|
|
|
instr_time counter; /* Accumulated runtime for this node */
|
2001-10-25 07:50:21 +02:00
|
|
|
double firsttuple; /* Time for first tuple of this cycle */
|
2005-04-16 22:07:35 +02:00
|
|
|
double tuplecount; /* Tuples emitted so far this cycle */
|
2001-09-18 03:59:07 +02:00
|
|
|
/* Accumulated statistics across all completed cycles: */
|
2001-10-25 07:50:21 +02:00
|
|
|
double startup; /* Total startup time (in seconds) */
|
|
|
|
double total; /* Total total time (in seconds) */
|
|
|
|
double ntuples; /* Total tuples produced */
|
|
|
|
double nloops; /* # of run cycles for this node */
|
2001-09-18 03:59:07 +02:00
|
|
|
} Instrumentation;
|
|
|
|
|
2005-03-25 22:58:00 +01:00
|
|
|
extern Instrumentation *InstrAlloc(int n);
|
2001-09-18 03:59:07 +02:00
|
|
|
extern void InstrStartNode(Instrumentation *instr);
|
2006-05-30 16:01:58 +02:00
|
|
|
extern void InstrStopNode(Instrumentation *instr, double nTuples);
|
2001-09-18 03:59:07 +02:00
|
|
|
extern void InstrEndLoop(Instrumentation *instr);
|
2001-10-28 07:26:15 +01:00
|
|
|
|
2001-11-05 18:46:40 +01:00
|
|
|
#endif /* INSTRUMENT_H */
|