Applicare le patch alle librerie per analizzare le chiamate a valle - AWS X-Ray

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Applicare le patch alle librerie per analizzare le chiamate a valle

Per strumentare le chiamate downstream, usa X-Ray SDK for Python per applicare patch alle librerie utilizzate dall'applicazione. L'X-Ray SDK per Python può applicare patch alle seguenti librerie.

Librerie supportate
  • botocore,boto3— StrumentoAWS SDK for Python (Boto)clienti.

  • pynamodb— La versione del client Amazon DynamoDB di Instrument PynamoDB.

  • aiobotocore,aioboto3— Strumentoasincrono-versioni integrate di SDK per client Python.

  • requests,aiohttp— Client HTTP di alto livello dello strumento.

  • httplib,http.client— Strumenta i client HTTP di basso livello e le librerie di livello superiore che li utilizzano.

  • sqlite3— Client SQLite di Instrument.

  • mysql-connector-python— Client Instrument MySQL.

  • pg8000— Interfaccia PostgreSQL dello strumento Pure-Python.

  • psycopg2— Adattatore per database Instrument PostgreSQL.

  • pymongo— Client Instrument MongoDB.

  • pymysql— StrumentoPyMyClient basati su SQL per MySQL e MariaDB.

Quando si utilizza una libreria con patch, X-Ray SDK per Python crea un sottosegmento per la chiamata e registra le informazioni della richiesta e della risposta. Un segmento devono essere disponibili affinché l'SDK possa creare il sottosegmento, sia dal middleware dell'SDK che da AWS Lambda.

Nota

Se utilizzi SQLAlchemy ORM, puoi analizzare le tue query SQL importando la versione dell'SDK delle classi della sessione e delle query di SQLAlchemy. Consulta Utilizzare SQLAlchemy ORM per le relative istruzioni.

Per installare le patch disponibili per tutte le librerie, utilizza la funzione patch_all in aws_xray_sdk.core. Alcune librerie, ad esempio httplib e urllib, potrebbero dover abilitare l'applicazione di patch doppie chiamando patch_all(double_patch=True).

Esempio main.py — Patch tutte le librerie supportate
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()

Per applicare patch a una singola libreria, chiamare patch con una tupla del nome della libreria. Per raggiungere questo risultato, è necessario fornire un singolo elenco di elementi.

Esempio main.py: applica patch a librerie specifiche
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)
Nota

In alcuni casi, la chiave utilizzata per installare le patch di una libreria non corrisponde al nome della libreria. Alcune chiavi servono come alias per una o più librerie.

Alias librerie

Tracciamento del contesto per le attività asincrone

Perasynciolibrerie integrate, oppurecreare sottosegmenti per funzioni asincrone, è inoltre necessario configurare X-Ray SDK per Python con un contesto asincrono. Importa ilAsyncContextclasse e ne passa un'istanza al registratore a raggi X.

Nota

Le librerie di supporto del framework Web, come AIOHTTP, non vengono gestite tramite il modulo aws_xray_sdk.core.patcher. Non sono presenti nel catalogo patcher delle librerie supportate.

Esempio 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)