Monday, March 22, 2010

The MySQL Audit plugin API

MySQl 5.5 is getting more and more solid, and one thing recently (at least I think so) pushed is the Audit plugin. Currently, this is only in the source repository (I tried from 5.5.4-m3). This prugin is actually quite useful, more useful than you might expect. Any event that would cause a write to the general query log will send a notification to a function in this API, and note that this will happen even if the general query log is enabled or not.

The stuff that gets passed to the notification function is a struct with similar data that gets written to an entry of the general query log, but don't let this limit you, also passed is a pointer to the THD class for the thread that caused the notification. And if you haven't looked a lot at the MySQL sourcecode, note that the THD class has MANY members, and contains all sorts of information.

If you wanted to create your own general log, that would allow filtering on, say, specific nodes, statements, users or something, this is where to hook into for that. Another advantage over using the general query log, is that you can log a lot more information, by virtue of the THD being passed.

Currently, there is a lack of documentation for the AUDIT plugin API, but you can figure it out from the null_audit plugin that is part of the 5.5.4-m3 source. The API is pretty simple, and only three functions are usually needed, one called when initializing the plugin, one to handle the event notification, and one that is called after when deinitalizing the plugin. A complete plugin that does this, that is based on the null_audit one, but which is written to support C++, as I want to use the THD which is a C++ class, this is a requirement if you want to get at the THD (unless you are cheating that is).

To begin with, we need some headers and stuff:
#include <../sql/mysql_priv.h>

#if !defined(__attribute__) && (defined(__cplusplus) || !defined(__GNUC__) || __GNUC__ == 2 && __GNUC_MINOR__ <>
#define __attribute__(A)

static FILE *log_fp;
static volatile int localhost_commands;

Then we need to init, deinit and notification functions:
static int my_general_log_plugin_init(void *arg __attribute__((unused)))
log_fp = NULL;
localhost_commands = 0;

static int my_general_log_plugin_deinit(void *arg __attribute__((unused)))

static void my_general_log_notify(MYSQL_THD thd, const struct mysql_event *event)
mysql_event_general *pEvent;

/* Open the log file, if not already done. */
if(log_fp == NULL)
log_fp = fopen("/tmp/my_general_log.log", "a");

/* Only log if on localhost. */
if(thd->net.vio->localhost && event->event_class == MYSQL_AUDIT_GENERAL_CLASS
&& log_fp != NULL)
pEvent = (mysql_event_general *) event;

if(pEvent->general_query != NULL && *(pEvent->general_query) != '\0')
fprintf(log_fp, "%s;\n\n", pEvent->general_query);

As you see, this is kept real simple, so as not to confuse things. But it is rather powerful, as I have both the event and the THD data available. Before I compile the above, I also need to add the structs that control the plugin itself:
static struct st_mysql_audit my_general_log_descriptor=
{(unsigned long) -1}

static struct st_mysql_show_var my_general_log_status[]=
{"my_general_log_commands", (char *) &localhost_commands, (enum_mysql_show_type) SHOW_INT},
{0,0,(enum_mysql_show_type) 0}

"Anders Karlsson",
"A general log that will log localhost access only",

The st_mysql_show_var struct provides a simple status value, that is displayed when you issue a SHOW STATUS command.

Beyond the above, you need a Makefile. I wrote mine myself, to keep things simple, and I also use no fancy macros, just the simple stuff:

g++ $(CFLAGS) -I$(MYSQL_BASE)/include -I$(MYSQL_BASE)/regex -I$(MYSQL_BASE)/sql -c my_general_log.o
g++ -shared my_general_log.o -o


If you are to try this yourself, you will need to modify the names and the paths and stuff, but I think you get the point and then run make and make install. The last thing to do is to enable the plugin. Just enter the mysql commandline client as root and run:
install plugin my_general_log soname '';

As foir the MySQL base source for this, either get 5.5.4-m3 from launchpad, or wait a few days and get it from when it is available there.

Hey, even being audited can be fun!



hingo said...

Interesting that you would post this today, I was just thinking about this 12 hours ago...

I can see this API becoming quite useful - at least in telco audit popped up every now and then, I'm sure banking etc is the same.

Ojanx said...

It's very useful for me, thanks a lot for this information.
iklan gratis

Lan Linh said...

Do not know what to say, I liked your article and I hope you will have many entries or more.
pacman games
happy wheels demo
my little pony games
hulk games
mickey mouse games
car games
bike games
free fun games
unblocked games

Britney Smith said...

Thank you very much for your post, it makes us have more and more discs in our life, So kind for you, I also hope you will make more and more excellent post and let’s more and more talk, thank you very much, dear.
happy wheels| friv|monster high| shooting games| tetris| 8 ball pool
cool math games| barbie games| friv4school| agario| sudoku

marko said...

The essential records were kept by store assistants that would acknowledge a marker consequently for stock. These representatives would then safeguard nitty gritty records off remarkable credits and find out when individuals were lived up to expectations. cash advance

hoa huy said...

Big Farm

Big Farm is an awesome multiplayer farm management game made by the Goodgame Studios.
Your mission is simple: Create a big farm, grow crops, breed animals,
and become the richest farmer of the universe. Enjoy Goodgame's Big Farm!

hoa huy said...

Big Farm

Big Farm is an awesome multiplayer farm management game made by the Goodgame Studios.
Your mission is simple: Create a big farm, grow crops, breed animals,
and become the richest farmer of the universe. Enjoy Goodgame's Big Farm!

thị hậu nguyễn said...

I found the perfect place for my needs. Contains wonderful and useful messages. I have read most of them and has a lot of them.
happy wheels
super mario bros

Justin said...

Unsecured auto advances have been prevalent with the credit seekers due to the danger free nature. Since, there is no association of security; so advance seekers don't have a danger of losing it. The auto advance is handled rapidly. Check Cashing Corona

Hieu Nguyen said...

When you see the stress in work, life, friv could well be a good site to try.
Thanks you for sharing
Friv Games, Friv Online,, Friv

Ha Thu Tran said...

greath post, Thank you for presenting a wide variety of information that is very interesting to see in this artikle
Friv 1
Juegos Friv 3

Love KidsTV said...

Thanks for your post. Click to play Plants vs Zombies , Solitaire,Tom And Jerry Games, Brain Games, Happy Wheels , Five Nights At Freddy's

Love KidsTV said...

Truyen ngon tinh hay la the loai truyen tinh cam
Truyen teen hay la nhung truyen tinh yeu tuoi teen
Don doc tai trang doc truyen online.

Hieu Nguyen said...

Play free Friv games flash online games flash.
Thanks you for sharing
Friv Games | Friv Online

hoang duong said...

I love all the posts, I really enjoyed, I would like more information about this, because it is very nice., Thanks for sharing.
Kizi 2
Friv 2

Online Game said...

You need to kill time, you need entertainment. Refer to our website. hope you get the most comfort.
Thanks you for sharing!
Friv Games
Yepi 4
Kizi 4

Hieu Nguyen said...

you'd have time to look these kids active. Please visit our website and let us play the game interesting.
Thanks for sharing !
Friv 10
Kizi 10
Yepi 2