Structured Logging Utilities for ECL microservices
Internal package for consistent structured logging across ECL microservices. Features JSON formatting, automatic metadata capture, and environment-based configuration. Utility will also handle pushing logs to OpenSearch if the OpenSearch related environment variables are set.
Features
- 📝 Structured JSON logs with consistent schema
- 🕒 Automatic timestamping in ISO 8601 format
- 📍 Complete source location (file path, line number, module, function)
- 🔍 Query-ready fields (transaction_id, request_ip, service_name)
- ⚙️ Environment-controlled log levels
- 🔗 Request context propagation across services
- ☁️ Push logs to OpenSearch enterprise-grade search and observability suite that brings order to unstructured data at scale.
- 👖 Push error and critical logs to Slack
- 🛡 Private package for internal use of ECL
Environment Variables
- ECL_LOGGING_UTILITY_LOG_LEVEL: Set the log level, default: INFO
- ECL_LOGGING_UTILITY_APP_VERSION: Denotes the app version which will be displayed in the log, default: AMBIVALENT_APP_VERSION
- ECL_LOGGING_UTILITY_SERVICE_NAME: Denotes the service name which will be displayed in the log, default: AMBIVALENT_SERVICE_NAME
- ECL_LOGGING_UTILITY_OPENSEARCH_ENABLED: Flag to enable/disable pushing logs to OpenSearch endpoint, default: False
- ECL_LOGGING_UTILITY_OPENSEARCH_HOST: OpenSearch endpoint's host, default: localhost
- ECL_LOGGING_UTILITY_OPENSEARCH_PORT: OpenSearch endpoint's port, default: 9200
- ECL_LOGGING_UTILITY_OPENSEARCH_USERNAME: Basic Auth username, default: None
- ECL_LOGGING_UTILITY_OPENSEARCH_PASSWORD: Basic Auth password, default: None
- ECL_LOGGING_UTILITY_SLACK_WEBHOOK_URL: Webhook URL of Slack channel to push notification in case of
error&criticallogs - ECL_LOGGING_UTILITY_INDEX_PATTERN_UUID: UUID of the OpenSearch index pattern with which the log is discovered. It is used to generate the OpenSearch dashboard link.
Installation
pip install ecl-logging-utility
Usage
from ecl_logging_utility import logger
logger.info("You have hit heartbeat", custom_1="1234", custom_2=500.0)
Version History
See CHANGELOG.md for release notes.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ecl_logging_utility-1.0.20.tar.gz.
File metadata
- Download URL: ecl_logging_utility-1.0.20.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c769605bc7f734bd8714f279559de6244230305e293fa610bf5c06dfb7d16e66
|
|
| MD5 |
019da321708b7442935b8bb05f2548b7
|
|
| BLAKE2b-256 |
4fc73f3fe5143280dc811ca8b0c03ac26c206dd8324316e10fea948dcee6d659
|
File details
Details for the file ecl_logging_utility-1.0.20-py3-none-any.whl.
File metadata
- Download URL: ecl_logging_utility-1.0.20-py3-none-any.whl
- Upload date:
- Size: 8.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa3d6da7fea09a078ec16372bf0bebe660957b774ccc3a52f22b81fae34585c1
|
|
| MD5 |
aba1c80fe274f6712ef44e10d497f45a
|
|
| BLAKE2b-256 |
fb73d48086b638004068575ad3f02130e63ef4143dd767650092ecba8df0bc90
|
