Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Patchen von Bibliotheken zum Instrumentieren von nachgelagerten Aufrufen
**Anmerkung**
SDK/Daemon X-Ray-Wartungshinweis — Am 25. Februar 2026 wechselt das AWS X-Ray SDKs/Daemon in den Wartungsmodus, in dem die Versionen von X-Ray SDK und Daemon auf Sicherheitsprobleme beschränkt AWS werden. Weitere Informationen zum Zeitplan für den Support finden Sie unter. [Zeitplan für die Support von X-Ray SDK und Daemon](xray-sdk-daemon-timeline.md) Wir empfehlen die Migration zu OpenTelemetry. Weitere Informationen zur Migration zu OpenTelemetry finden Sie unter [Migration von X-Ray-Instrumentierung zu OpenTelemetry Instrumentierung](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html).
Um Downstream-Aufrufe zu instrumentieren, verwenden Sie das X-Ray-SDK für Python, um die Bibliotheken zu patchen, die Ihre Anwendung verwendet. Das X-Ray-SDK für Python kann die folgenden Bibliotheken patchen.
**Unterstützte Bibliotheken**
+ `[botocore](https://pypi.python.org/pypi/botocore)`, `[boto3](https://pypi.python.org/pypi/boto3)` — AWS SDK für Python (Boto) Instrumenten-Clients.
+ `[pynamodb](https://pypi.python.org/pypi/pynamodb/)`— Instrumentieren Sie die Version des Amazon DynamoDB-Clients von PynamoDB.
+ `[aiobotocore](https://pypi.python.org/pypi/aiobotocore)`, `[aioboto3](https://pypi.python.org/pypi/aioboto3)` — Instrument [asyncio](https://docs.python.org/3/library/asyncio.html) -integrierte Versionen des SDK für Python-Clients.
+ `[requests](https://pypi.python.org/pypi/requests)`, `[aiohttp](https://pypi.python.org/pypi/aiohttp)` — Instrumentieren Sie HTTP-Clients auf hoher Ebene.
+ `[httplib](https://docs.python.org/2/library/httplib.html)`, [https://docs.python.org/3/library/http.client.html](https://docs.python.org/3/library/http.client.html)— Instrumentieren Sie HTTP-Clients auf niedriger Ebene und die Bibliotheken auf höherer Ebene, die sie verwenden.
+ `[sqlite3](https://docs.python.org/3/library/sqlite3.html)`— SQLite Instrumenten-Clients.
+ `[mysql-connector-python](https://pypi.python.org/pypi/mysql-connector-python)`— Instrumentieren Sie MySQL-Clients.
+ `[pg8000](https://pypi.org/project/pg8000/)`— Instrument Pure-Python PostgreSQL-Schnittstelle.
+ `[psycopg2](https://pypi.org/project/psycopg2/)`— Instrument PostgreSQL-Datenbankadapter.
+ `[pymongo](https://pypi.org/project/pymongo/)`— Instrumentieren Sie MongoDB-Clients.
+ `[pymysql](https://pypi.org/project/PyMySQL/)`— Instrument PyMy SQL-basierte Clients für MySQL und MariaDB.
Wenn Sie eine gepatchte Bibliothek verwenden, erstellt das X-Ray SDK für Python ein Untersegment für den Aufruf und zeichnet Informationen aus der Anfrage und Antwort auf. Für das SDK muss ein Segment zur Verfügung stehen, damit es ein Untersegment aus der SDK-Middleware oder aus AWS Lambda erstellen kann.
**Anmerkung**
Wenn Sie SQLAlchemy ORM verwenden, können Sie Ihre SQL-Abfragen instrumentieren, indem Sie die SDK-Version der SQLAlchemy Sitzungs- und Abfrageklassen importieren. Anweisungen finden [Sie unter SQLAlchemy ORM verwenden](https://github.com/aws/aws-xray-sdk-python/blob/master/README.md#use-sqlalchemy-orm).
Um alle verfügbaren Bibliotheken zu patchen, verwenden Sie die `patch_all`-Funktion in `aws_xray_sdk.core`. Einige Bibliotheken, wie z. B. `httplib` und `urllib`, müssen möglicherweise doppelte Patches durch Aufruf von `patch_all(double_patch=True)` aktivieren.
**Example main.py — Patchen Sie alle unterstützten Bibliotheken**
```
import boto3
import botocore
import requests
import sqlite3
from aws_xray_sdk.core import xray_recorder
from aws_xray_sdk.core import patch_all
patch_all()
```
Rufen Sie zum Patchen einer einzelnen Bibliothek `patch` mit einem Tupel des Bibliotheksnamens auf. Um dies zu erreichen, müssen Sie eine einzelne Elementliste bereitstellen.
**Example main.py — Patchen Sie bestimmte Bibliotheken**
```
import boto3
import botocore
import requests
import mysql-connector-python
from aws_xray_sdk.core import xray_recorder
from aws_xray_sdk.core import patch
libraries = (['botocore'])
patch(libraries)
```
**Anmerkung**
In einigen Fällen stimmt der Schlüssel, mit dem Sie eine Bibliothek patchen, nicht mit dem Namen der Bibliothek überein. Einige Schlüssel dienen als Aliase für eine oder mehrere Bibliotheken.
`httplib` – `[httplib](https://docs.python.org/2/library/httplib.html)` und [https://docs.python.org/3/library/http.client.html](https://docs.python.org/3/library/http.client.html)
`mysql` – `[mysql-connector-python](https://pypi.python.org/pypi/mysql-connector-python)`
## Ablaufverfolgungskontext für asynchrone Vorgänge
Für `asyncio` integrierte Bibliotheken oder um [Untersegmente für asynchrone Funktionen zu erstellen](xray-sdk-python-subsegments.md), müssen Sie auch das X-Ray SDK für Python mit einem asynchronen Kontext konfigurieren. Importieren Sie die `AsyncContext` Klasse und übergeben Sie eine Instanz davon an den X-Ray-Recorder.
**Anmerkung**
Bibliotheken für die Unterstützung von Web-Frameworks, wie beispielsweise AIOHTTP, werden nicht über das Modul `aws_xray_sdk.core.patcher` bearbeitet. Sie werden nicht im `patcher`-Katalog unterstützter Bibliotheken angezeigt.
**Example main.py — Patch aioboto3**
```
import asyncio
import aioboto3
import requests
from aws_xray_sdk.core.async_context import AsyncContext
from aws_xray_sdk.core import xray_recorder
xray_recorder.configure(service='my_service', context=AsyncContext())
from aws_xray_sdk.core import patch
libraries = (['aioboto3'])
patch(libraries)
```