Skip to main content

Python Logger plugin to send logs to Logentries

Project description

This is a plugin library to enable logging to Logentries from the Python Logger. Additionally this plugin allows the user to get an overview of methods being executed, their execution time, as well as CPU and Memory statistics. Logentries is a real-time log management service on the cloud. More info at https://logentries.com. Note that this plugin is asynchronous.

Setup

To use this library, you must first create an account on Logentries. This will only take a few moments.

Install

To install this library, use the following command:

pip install logentries

Usage

#!/usr/bin/env python

import logging
from logentries import LogentriesHandler


log = logging.getLogger('logentries')
log.setLevel(logging.INFO)
test = LogentriesHandler(LOGENTRIES_TOKEN)

log.addHandler(test)

log.warn("Warning message")
log.info("Info message")

sleep(10)

Usage with metric functionality

import time
import logging
from logentries import LogentriesHandler, metrics


TEST = metrics.Metric(LOGENTRIES_METRIC_TOKEN)

@TEST.metric()
def function_one(t):
    """A dummy function that takes some time."""
    time.sleep(t)

if __name__ == '__main__':
        function_one(1)

Metric.Time()

This decorator function is used to log the execution time of given function. In the above example @TEST.time() will wrap function_one and send log message containing the name and execution time of this function.

Configure

The parameter LOGENTRIES_TOKEN needs to be filled in to point to a file in your Logentries account.

The parameter LOGENTRIES_METRIC_TOKEN needs to be filled in to point to a metric collection file in your Logentries account. However, please note that metric data can be send to LOGENTRIES_TOKEN and merged with other standard logs.

In your Logentries account, create a logfile, selecting Token TCP as the source_type. This will print a Token UUID. This is the value to use for LOGENTRIES_TOKEN or LOGENTRIES_METRIC_TOKEN.

The appender will attempt to send your log data over TLS over port 443, otherwise it will send over port 80.

You are now ready to start logging

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Logentries-0.17.tar.gz (5.4 kB view details)

Uploaded Source

File details

Details for the file Logentries-0.17.tar.gz.

File metadata

  • Download URL: Logentries-0.17.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Logentries-0.17.tar.gz
Algorithm Hash digest
SHA256 0414aef7577f64bf3c3778d8233413f81cb9f10cd19641e0d8601c91721aa0dc
MD5 1331c74052575b703d2ade991972ca94
BLAKE2b-256 ffdf1438cc205a9cf8c5c3738347d252171adde495c0c53cdd0e6731b5b05501

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page