Python package for logging to LogDNA
$ pip install logdnaimport logging
from logdna import LogDNAHandler
key = 'YOUR INGESTION KEY HERE'
log = logging.getLogger('logdna')
log.setLevel(logging.INFO)
options = {
'hostname': 'pytest'
}
# Defaults to false, when true ensures meta object will be searchable
options['index_meta'] = True
test = LogDNAHandler(key, options)
log.addHandler(test)
log.warn("Warning message", {'app': 'bloop'})
log.info("Info message")Required
Optional
- Hostname - (String) - max length 32 chars
- MAC Address - (String)
- IP Address - (String)
- Max Length - (Boolean) - formatted as options['max_length']
- Index Meta - (Boolean) - formatted as options['index_meta']
After initial setup, logging is as easy as:
# Simplest use case
log.info('My Sample Log Line')
# Add a custom level
log.info('My Sample Log Line', { 'level': 'MyCustomLevel' })
# Include an App name with this specific log
log.info('My Sample Log Line', { 'level': 'Warn', 'app': 'myAppName'})
# Pass any associated objects along as metadata
meta = {
'foo': 'bar',
'nested': {
'nest1': 'nested text'
}
}
opts = {
'level': 'warn',
'meta': meta
}
log.info('My Sample Log Line', opts)Required
Type: String
Values: YourAPIKey
The LogDNA API Key associated with your account.
Optional
Type: String
Default: ''
Values: YourCustomApp
Max Length: 32
The default app passed along with every log sent through this instance.
Optional
Type: String
Default: ''
Values: YourCustomEnv
Max Length: 32
The default env passed along with every log sent through this instance.
Optional
Type: String
Default: ''
Values: YourCustomHostname
Max Length: 32
The default hostname passed along with every log sent through this instance.
Optional
Type: Boolean
Default: False
We allow meta objects to be passed with each line. By default these meta objects will be stringified and will not be searchable, but will be displayed for informational purposes.
If this option is turned to true then meta objects will be parsed and will be searchable up to three levels deep. Any fields deeper than three levels will be stringified and cannot be searched.
WARNING When this option is true, your metadata objects across all types of log messages MUST have consistent types or the metadata object may not be parsed properly!
Optional
Type: String
Default: Info
Values: Debug, Trace, Info, Warn, Error, Fatal, YourCustomLevel
Max Length: 32
The default level passed along with every log sent through this instance.
Optional
Type: Boolean
Default: True
By default the line has a maximum length of 16000 chars, this can be turned off with the value false.
Required
Type: String
Default: ''
Max Length: 32000
The line which will be sent to the LogDNA system.
Optional
Type: String
Default: Info
Values: Debug, Trace, Info, Warn, Error, Fatal, YourCustomLevel
Max Length: 32
The level passed along with this log line.
Optional
Type: String
Default: ''
Values: YourCustomApp
Max Length: 32
The app passed along with this log line.
Optional
Type: String
Default: ''
Values: YourCustomEnv
Max Length: 32
The environment passed with this log line.
Optional
Type: JSON
Default: None
A meta object for additional metadata about the log line that is passed. Please ensure values are JSON serializable,
values that are not JSON serializable will be removed and the respective keys will be added to the __errors string.
Optional
Type: Boolean
Default: False
We allow meta objects to be passed with each line. By default these meta objects will be stringified and will not be searchable, but will be displayed for informational purposes.
If this option is turned to true then meta objects will be parsed and will be searchable up to three levels deep. Any fields deeper than three levels will be stringified and cannot be searched.
WARNING When this option is true, your metadata objects across all types of log messages MUST have consistent types or the metadata object may not be parsed properly!
Optional
Default: time.time()
A timestamp in ms, must be within one day otherwise it will be dropped and time.time() will be used in its place.
MIT © LogDNA
Happy Logging!