Metadata-Version: 2.1
Name: ecs-logging
Version: 2.0.0
Summary: Logging formatters for ECS (Elastic Common Schema) in Python
Home-page: https://github.com/elastic/ecs-logging-python
License: UNKNOWN
Author: Seth Michael Larson
Author-email: seth.larson@elastic.co
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: System :: Logging
Classifier: License :: OSI Approved :: Apache Software License
Requires-Dist: backports.functools-lru-cache; python_version < '3.3'
Requires-Dist: pytest ; extra == "develop"
Requires-Dist: pytest-cov ; extra == "develop"
Requires-Dist: mock ; extra == "develop"
Requires-Dist: structlog ; extra == "develop"
Requires-Dist: elastic-apm ; extra == "develop"
Project-URL: Changelog, https://github.com/elastic/ecs-logging-python/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/elastic/ecs-logging-python
Project-URL: Download, https://github.com/elastic/ecs-logging-python/releases
Project-URL: Issue Tracker, https://github.com/elastic/ecs-logging-python/issues
Project-URL: Source, https://github.com/elastic/ecs-logging-python
Provides-Extra: develop

# ecs-logging-python

[![Build Status](https://apm-ci.elastic.co/job/apm-agent-python/job/ecs-logging-python-mbp/job/main/badge/icon)](https://apm-ci.elastic.co/blue/organizations/jenkins/apm-agent-python%2Fecs-logging-python-mbp/branches)
[![PyPI](https://img.shields.io/pypi/v/ecs-logging)](https://pypi.org/project/ecs-logging)
[![Versions Supported](https://img.shields.io/pypi/pyversions/ecs-logging)](https://pypi.org/project/ecs-logging)

Check out the [Elastic Common Schema (ECS) reference](https://www.elastic.co/guide/en/ecs/current/index.html)
for more information.

The library currently implements ECS 1.6.

## Installation

```console
$ python -m pip install ecs-logging
```

## Documentation

See the [ECS Logging Python reference](https://www.elastic.co/guide/en/ecs-logging/python/current/index.html) on elastic.co to get started.

## Elastic APM Log Correlation

`ecs-logging-python` supports automatically collecting [ECS tracing fields](https://www.elastic.co/guide/en/ecs/master/ecs-tracing.html)
from the [Elastic APM Python agent](https://github.com/elastic/apm-agent-python) in order to
[correlate logs to spans, transactions and traces](https://www.elastic.co/guide/en/apm/agent/python/current/log-correlation.html) in Elastic APM.

## License

Apache-2.0

