# Python

> <img width="35" class="img-initial otel-icon" src="/img/logos/32x32/Python_SDK.svg" alt="Python"> Реалізація OpenTelemetry для Python.

---

LLMS index: [llms.txt](/llms.txt)

---


Ласкаво просимо до документації OpenTelemetry для Python. У цьому розділі описано, як використовувати OpenTelemetry з Python для генерації та збору телеметричних даних, таких як метрики, журнали та трасування, за допомогою API та SDK OpenTelemetry. Ці сторінки призначені для того, щоб допомогти вам розпочати роботу та зрозуміти поточні можливості та стан OpenTelemetry для Python.

## Статус та випуски {#status-and-releases}

Поточний стан основних функціональних компонентів OpenTelemetry Python наступний:

| Трейси              | Метрики              | Логи              |
| ------------------- | -------------------- | ----------------- |
| [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Development](/docs/specs/otel/versioning-and-stability/#development) |

Випуски, зокрема [останній випуск][latest release], див. у розділі [Випуски][Releases]. 

[latest release]: <https://github.com/open-telemetry/opentelemetry-python/releases/latest>
[Releases]: <https://github.com/open-telemetry/opentelemetry-python/releases>
{{__hugo_ctx/}}


## Підтримка версій {#version-support}

OpenTelemetry-Python підтримує Python 3.9 і вище.

## Встановлення {#installation}

Пакунки API та SDK доступні на PyPI та можуть бути встановлені за допомогою pip:

```sh
pip install opentelemetry-api
pip install opentelemetry-sdk
```

Крім того, є кілька додаткових пакунків, які можна встановити окремо:

```sh
pip install opentelemetry-exporter-{exporter}
pip install opentelemetry-instrumentation-{instrumentation}
```

Це для бібліотек експортерів та інструментів відповідно. Експортери Jaeger, Zipkin, Prometheus, OTLP та OpenCensus можна знайти в теці [exporter](https://github.com/open-telemetry/opentelemetry-python/blob/main/exporter/) репозиторію. Інструменти та додаткові експортери можна знайти в репозиторії contrib в теках [instrumentation](https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation) та [exporter](https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/exporter).

## Розширення {#extensions}

Щоб знайти повʼязані проєкти, такі як експортери, бібліотеки інструментів, реалізації трасувальників тощо, відвідайте [Реєстр](/ecosystem/registry/?s=python).

### Встановлення новітніх пакунків {#installing-cutting-edge-packages}

Є деяка функціональність, яка ще не була випущена на PyPI. У такій ситуації ви можете встановити пакунки безпосередньо з репозиторію. Це можна зробити, клонуючи репозиторій та виконуючи [редаговане встановлення](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs):

```sh
git clone https://github.com/open-telemetry/opentelemetry-python.git
cd opentelemetry-python
pip install -e ./opentelemetry-api -e ./opentelemetry-sdk -e ./opentelemetry-semantic-conventions
```

## Репозиторії та бенчмарки {#repositories-and-benchmarks}

- Основний репозиторій: [opentelemetry-python][]
- Репозиторій contrib: [opentelemetry-python-contrib][]

[opentelemetry-python]: https://github.com/open-telemetry/opentelemetry-python
[opentelemetry-python-contrib]: https://github.com/open-telemetry/opentelemetry-python-contrib

---

Section pages:

- [Початок роботи](/uk/docs/languages/python/getting-started/): Отримайте телеметрію для вашого застосунку менш ніж за 5 хвилин!
- [Інструментування](/uk/docs/languages/python/instrumentation/): Ручне інструментування для OpenTelemetry Python
- [Використання бібліотек інструментування](/uk/docs/languages/python/libraries/)
- [Експортери](/uk/docs/languages/python/exporters/): Обробка та експорт ваших телеметричних даних
- [Поширення](/uk/docs/languages/python/propagation/): Поширення контексту для Python SDK
- [Рецепти](/uk/docs/languages/python/cookbook/)
- [OpenTelemetry Distro](/uk/docs/languages/python/distro/)
- [Використання mypy](/uk/docs/languages/python/mypy/)
- [Бенчмарки](/uk/docs/languages/python/benchmarks/)
- [Довідник API](/uk/docs/languages/python/api/)
- [Приклади](/uk/docs/languages/python/examples/)
- [Реєстр](/uk/docs/languages/python/registry/): Бібліотеки інструментів, експортери та інші корисні компоненти для OpenTelemetry Python