Componenti e versioni supportati Python

Per assicurarti che il pacchetto Instana Python sia compatibile con la tua configurazione attuale, verifica i componenti e le versioni supportati per il pacchetto Instana Python.

Per ulteriori informazioni sul monitoraggio delle applicazioni Python, consultare la pagina “Monitoraggio” all’indirizzo Python.

Runtime Python

Nota:
Instana Python 2.5.4 Le versioni precedenti supportano la tracciabilità per le librerie Tornado, asyncio e aiohttp solo sui runtime Python fino alla versione 3.10.
Python Versioni Instana Python versione del pacchetto
CPython >= 3.9 e <= 3.14 >= 3.9.0
CPython >= 3.8 e <= 3.13 >= 3.0.0
CPython >=3.8 e <3.13 >= 2.5.0
CPython > = 3.7 e < 3.10 < 2.5.0
CPython > = 2.7 e < = 3.6 < 2.0.0

Assistenza a lungo termine

Instana segue il calendario ufficiale relativo al supporto a lungo termine (LTS) e alla fine del ciclo di vita (EOL) pubblicato su Python.

Nota:
Quando una versione di Python raggiunge la data di fine vita (EOL), Instana offre un ulteriore anno di assistenza. Per evitare problemi, aggiorna regolarmente la versione di Python.

Ambienti supportati

Il pacchetto Instana Python supporta un'ampia gamma di ambienti.

Piattaforme

Sono supportate le seguenti piattaforme e architetture CPU:

Piattaforma x86_64/amd64 ppc64le s390x aarch64/arm64
Linux
Red Hat1
Windows2
AWS Fargate
AWS Lambda
Kubernetes
Google Cloud
Con tenitori3
IBM AIX 4
IBM i5
LinuxOne
Nota:
Instana Python Il pacchetto 3.5.0 ha introdotto ppc64le e il supporto s390 , mentre 3.6.0 ha aggiunto il supporto per Windows.

Traccia

Il pacchetto Instana Python supporta il tracciamento distribuito su altre piattaforme, tecnologie e linguaggi strumentati da Instana.

Nota:
La colonna “ InstanaPython package version” fornisce ulteriori informazioni sulle restrizioni relative alle versioni. Il valore della colonna “ InstanaPython ” Any indica che la versione del pacchetto è >= 3.0.0.
Nota:
È possibile che alcuni dei framework e delle librerie supportati non siano disponibili per tutte le architetture CPU e tutte le piattaforme.

Supporto delle specifiche

La tabella seguente elenca le specifiche supportate dal pacchetto Python di Instana :

Specifica Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
ASGI 45 giorni 2.0.0 3.0 Qualsiasi
WSGI 0 giorno PEP 333 1.0 1.0.1 Qualsiasi

HTTP

Le tabelle seguenti elencano i framework e le librerie di " HTTP " supportati dal pacchetto " Instana " Python :

Framework web

La tabella seguente elenca i framework web HTTP supportati dal pacchetto Python di Instana :

Framework Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
Django 45 giorni 1.11.0 6.0.7 Qualsiasi
FastAPI 45 giorni 0.51.0 0.141.1 Qualsiasi
Flask 45 giorni 0.12.0 3.1.3 Qualsiasi
Piramide 45 giorni 1.6.5 2.1 Qualsiasi
Sanico Su richiesta 21.9.0 25.12.1 Qualsiasi
Starlette 45 giorni 0.12.13 1.3.1 Qualsiasi
Tornado 45 giorni 6.0.0 6.5.7 Qualsiasi
Werkzeug 45 giorni 2.2.0 3.1.8 >= 3.15.0

Clienti e biblioteche

Le tabelle seguenti elencano i client e le librerie di HTTP supportati dal pacchetto Python di Instana :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
Http 45 giorni 3.1.0 3.14.3 Qualsiasi versione di Python con 3.9 o superiore
Httpx 45 giorni 0.20.0 0.28.1 >= 3.5.0
Richieste 45 giorni 2.16.1 2.34.2 Qualsiasi
Urllib3 45 giorni 1.26.5 2.7.0 Qualsiasi

RPC

Le tabelle seguenti elencano le librerie di « RPC » supportate dal pacchetto « Instana » Python :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
grpcio 45 giorni 1.14.1 1.83.0 Qualsiasi
Spyne 45 giorni 2.13.1a0 2.14.0 >= 3.4.0 con Python < 3.12

Database

Le tabelle seguenti elencano le librerie di database supportate dal pacchetto Instana Python :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
AWS DynamoDB6 45 giorni 1.15.0 1.43.59 Qualsiasi
AWS S36 45 giorni 1.15.0 1.43.59 Qualsiasi
cassandra-driver 45 giorni 3.20.2 3.30.1 Qualsiasi
Couchbase Su richiesta 2.3.5 2.5.12 Qualsiasi
Elasticsearch 45 giorni 8.0.0 9.4.1 >= 3.16.0
Miosqlclient 45 giorni 1.3.14 2.2.8 Qualsiasi
PyMySQL 45 giorni 0.6.7 1.2.0 Qualsiasi
pymongo 45 giorni 3.7.0 4.17.0 Qualsiasi
Psycopg2 45 giorni 2.7.2 2.9.12 Qualsiasi
Redis 45 giorni 2.10.6 8.0.1 Qualsiasi
SQLAlchemy 45 giorni 1.1.5 2.0.51 Qualsiasi

Messaggistica

Le tabelle seguenti elencano le librerie di messaggistica supportate dal pacchetto Python di Instana :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
Aioamqp 45 giorni 0.15.0 0.15.0 >= 3.4.0
Aio-pika 45 giorni 9.1.0 10.0.1 >= 3.5.0
Confluent Kafka 45 giorni 2.0.0 2.15.0 >= 3.4.0
kafka-python 45 giorni 2.0.0 2.2.15 >= 3.4.0 con Python < 3.12
Kafka -python-ng 45 giorni 2.0.0 2.2.3 >= 3.4.0 con Python >= 3.12
pika 45 giorni 1.0.0 1.4.2 Qualsiasi

Servizi Cloud

Le tabelle seguenti elencano le librerie dei servizi cloud supportate dal pacchetto Instana Python :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
Boto3 (SDK di AWS ) 45 giorni 1.15.0 1.43.59 Qualsiasi
Google - cloud-pubsub7 45 giorni 2.0.0 2.39.0 Qualsiasi
Google-cloud - storage 45 giorni 1.24.0 3.13.0 Qualsiasi

Python moduli integrati

Le tabelle seguenti elencano le librerie integrate di Python supportate dal pacchetto Python di Instana :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
Asyncio 0 giorno 1.4 23.7.0 Qualsiasi
Registrazione 0 giorno 4.3.0 5.5.3 Qualsiasi

Altre librerie

Le tabelle seguenti elencano le altre librerie supportate dal pacchetto Instana Python :

Libreria Politica di assistenza Versione minima Versione massima Instana Python versione del pacchetto
gevent Su richiesta 23.9.0.post1 26.7.0 >= 3.4.0
Sedano 45 giorni 4.3.0 5.6.3 Qualsiasi

Note e limitazioni relative alla tracciabilità

Consulta le autorizzazioni e le limitazioni di Instana Python Tracer.

Autorizzazione all'apertura di un thread

Il tracer Instana Python necessita dell'autorizzazione per creare e avviare oggetti threading.TimerPython. Nella maggior parte dei sistemi, questa autorizzazione viene concessa per impostazione predefinita. In alcuni scenari di containerizzazione annidata, ad esempio in alcune versioni di container del tipo " Docker -in- Docker ", l'autorizzazione non è concessa per impostazione predefinita.

Se vengono visualizzate eccezioni come RuntimeError: can't start new thread, le autorizzazioni insufficienti sono la causa più probabile. Se si esegue l'aggiornamento o si modifica il contenitore Docker -in- Docker, ma al contenitore dell'applicazione interna non sono stati concessi i permessi necessari, è possibile utilizzare il --privileged permesso come ultima risorsa per avviare il contenitore dell'applicazione.

Tracciamento oltre i confini dei thread

Il pacchetto Instana Python non supporta la tracciatura oltre i confini dei thread. Ad esempio, quando una richiesta viene gestita per la prima volta su un singolo thread e il carico di lavoro viene distribuito a più altri thread con l'aiuto di multiprocessing.ThreadPool, le chiamate in uscita che si verificano in tali thread non vengono catturate. Poiché ogni estensione di uscita deve avere un'estensione di entrata e l'estensione di entrata di inizio è fuori dall'ambito del thread, tali chiamate in uscita non sono registrate. Ciò è dovuto alle caratteristiche intrinseche dell' OpenTracing ThreadLocalScopeManagerpredefinito e alla mancanza di uno scope manager ThreadPool specifico.

Tracciamento delle funzioni non asincrone in FastAPI

Il pacchetto Instana Python supporta esclusivamente il tracciamento della concorrenza basata su coroutine in FastAPI. Ciò accade perché le funzioni non asincrone eseguite su un pool di thread non possono essere seguite attraverso i limiti del thread.

Tracciamento con più tracciatori

Non è supportato il tracciamento di una singola applicazione Python utilizzando contemporaneamente Instana e uno strumento di tracciamento di terze parti, ad esempio New Relic o OpenTelemetry.

Server web supportati

Il pacchetto Instana Python supporta i seguenti server web:

  • uWSGI
  • Gunicorno
  • mod_wsgi
  • WSGI Nginx
  • uvicorno

Raccolta dei dati dei sensori

Il sensore Instana Python raccoglie i seguenti dati:

Configurazione con tracciamento

Il sensore Instana Python raccoglie i seguenti dati di configurazione:

  • Nome
  • Runtime
  • PID
  • Moduli caricati

Metriche

Il sensore Instana Python raccoglie i seguenti dati:

  • Attività GC
  • Utilizzo della memoria
  • Thread
  • Impaginazione
  • I/O
  • Eventi
  • Switch di contesto

AutoProfile

Il pacchetto Instana Python genera i seguenti profili:

Profili Versioni Python Piattaforme
Utilizzo della CPU > = 2.7 e> = 3.4 Linux e macOS
Velocità di allocazione memoria >= 3.4 Linux e macOS
Blocco delle chiamate >= 3.4 Linux e macOS

Ulteriori informazioni

  1. Il pacchetto Instana Python supporta le seguenti versioni di Red Hat Enterprise Linux : RHEL 8.10, RHEL 9.6 e RHEL 10.0. ↩︎

  2. Il pacchetto " Instana " ( Python ) supporta le seguenti versioni di Windows : Windows 11 e Windows Server 2025. ↩︎

  3. DockerPodman e Rancher sono i motori di container e gli strumenti di gestione dei container supportati. ↩︎

  4. Il pacchetto Instana Python supporta le seguenti versioni di AIX : 7.2 e 7.3. ↩︎

  5. Il pacchetto " Instana " ( Python ) supporta " IBM i " ( 7.5 ). ↩︎

  6. AWS DynamoDB e AWS S3 sono implementati tramite il pacchetto Boto3. ↩︎

  7. Il pacchetto Instana Python supporta solo la distribuzione dei messaggi in modalità pull di Google Pub/Sub. ↩︎