Skip to content

Allow formatter customizations #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jun 3, 2015
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .travis.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
language: python
python:
- "2.6"
- "2.7"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@EvaSDK Why did you remove 2.6 from .travis.yml? It's still in tox.ini and seems working fine at least for me.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like I forgot to update .travis.yml when I re-added support for it. I'll fix that.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, got it. I'll fix it by myself.

- "3.2"
- "3.3"
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,9 @@ This client-library also has FluentHandler class for Python logging module.

logging.basicConfig(level=logging.INFO)
l = logging.getLogger('fluent.test')
l.addHandler(handler.FluentHandler('app.follow', host='host', port=24224))
h = handler.FluentHandler('app.follow', host='host', port=24224)
h.setFormatter(handler.FluentRecordFormatter())
l.addHandler(h)
l.info({
'from': 'userA',
'to': 'userB'
Expand Down
63 changes: 47 additions & 16 deletions fluent/handler.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

import logging
import socket
import sys

try:
import simplejson as json
Expand All @@ -16,35 +17,65 @@
from fluent import sender


class FluentRecordFormatter(object):
def __init__(self):
class FluentRecordFormatter(logging.Formatter, object):
""" A structured formatter for Fluent.

Best used with server storing data in an ElasticSearch cluster for example.

:param fmt: a dict with format string as values to map to provided keys.
"""
def __init__(self, fmt=None, datefmt=None):
super(FluentRecordFormatter, self).__init__(None, datefmt)

if not fmt:
self._fmt_dict = {
'sys_host': '%(hostname)s',
'sys_name': '%(name)s',
'sys_module': '%(module)s',
}
else:
self._fmt_dict = fmt

self.hostname = socket.gethostname()

def format(self, record):
data = {'sys_host': self.hostname,
'sys_name': record.name,
'sys_module': record.module,
# 'sys_lineno': record.lineno,
# 'sys_levelno': record.levelno,
# 'sys_levelname': record.levelname,
# 'sys_filename': record.filename,
# 'sys_funcname': record.funcName,
# 'sys_exc_info': record.exc_info,
}
# if 'sys_exc_info' in data and data['sys_exc_info']:
# data['sys_exc_info'] = self.formatException(data['sys_exc_info'])
# Only needed for python2.6
if sys.version_info[0:2] <= (2, 6) and self.usesTime():
record.asctime = self.formatTime(record, self.datefmt)

# Compute attributes handled by parent class.
super(FluentRecordFormatter, self).format(record)
# Add ours
record.hostname = self.hostname
# Apply format
data = dict([(key, value % record.__dict__)
for key, value in self._fmt_dict.items()])

self._structuring(data, record.msg)
return data

def usesTime(self):
return any([value.find('%(asctime)') >= 0
for value in self._fmt_dict.values()])

def _structuring(self, data, msg):
""" Melds `msg` into `data`.

:param data: dictionary to be sent to fluent server
:param msg: :class:`LogRecord`'s message to add to `data`.
`msg` can be a simple string for backward compatibility with
:mod:`logging` framework, a JSON encoded string or a dictionary
that will be merged into dictionary generated in :meth:`format.
"""
if isinstance(msg, dict):
self._add_dic(data, msg)
elif isinstance(msg, str):
elif isinstance(msg, basestring):
try:
self._add_dic(data, json.loads(str(msg)))
except ValueError:
pass
self._add_dic(data, {'message': msg})
else:
self._add_dic(data, {'message': msg})

@staticmethod
def _add_dic(data, dic):
Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@

setup(
name='fluent-logger',
version='0.3.5',
version='0.4.0.dev',
description=desc,
long_description=open(README).read(),
package_dir={'fluent': 'fluent'},
Expand Down
77 changes: 77 additions & 0 deletions tests/test_handler.py
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,80 @@ def test_simple(self):
eq('userB', data[0][2]['to'])
self.assertTrue(data[0][1])
self.assertTrue(isinstance(data[0][1], int))

def test_custom_fmt(self):
handler = fluent.handler.FluentHandler('app.follow', port=self._port)

logging.basicConfig(level=logging.INFO)
log = logging.getLogger('fluent.test')
handler.setFormatter(
fluent.handler.FluentRecordFormatter(fmt={
'name': '%(name)s',
'lineno': '%(lineno)d',
'emitted_at': '%(asctime)s',
})
)
log.addHandler(handler)
log.info({'sample': 'value'})
handler.close()

data = self.get_data()
self.assertTrue('name' in data[0][2])
self.assertEqual('fluent.test', data[0][2]['name'])
self.assertTrue('lineno' in data[0][2])
self.assertTrue('emitted_at' in data[0][2])

def test_json_encoded_message(self):
handler = fluent.handler.FluentHandler('app.follow', port=self._port)

logging.basicConfig(level=logging.INFO)
log = logging.getLogger('fluent.test')
handler.setFormatter(fluent.handler.FluentRecordFormatter())
log.addHandler(handler)
log.info('{"key": "hello world!", "param": "value"}')
handler.close()

data = self.get_data()
self.assertTrue('key' in data[0][2])
self.assertEqual('hello world!', data[0][2]['key'])

def test_unstructured_message(self):
handler = fluent.handler.FluentHandler('app.follow', port=self._port)

logging.basicConfig(level=logging.INFO)
log = logging.getLogger('fluent.test')
handler.setFormatter(fluent.handler.FluentRecordFormatter())
log.addHandler(handler)
log.info('hello world')
handler.close()

data = self.get_data()
self.assertTrue('message' in data[0][2])
self.assertEqual('hello world', data[0][2]['message'])

def test_non_string_simple_message(self):
handler = fluent.handler.FluentHandler('app.follow', port=self._port)

logging.basicConfig(level=logging.INFO)
log = logging.getLogger('fluent.test')
handler.setFormatter(fluent.handler.FluentRecordFormatter())
log.addHandler(handler)
log.info(42)
handler.close()

data = self.get_data()
self.assertTrue('message' in data[0][2])

def test_non_string_dict_message(self):
handler = fluent.handler.FluentHandler('app.follow', port=self._port)

logging.basicConfig(level=logging.INFO)
log = logging.getLogger('fluent.test')
handler.setFormatter(fluent.handler.FluentRecordFormatter())
log.addHandler(handler)
log.info({42: 'root'})
handler.close()

data = self.get_data()
# For some reason, non-string keys are ignored
self.assertFalse(42 in data[0][2])