Composants et versions pris en charge par Python

Pour vous assurer que le package Instana Python est compatible avec votre configuration actuelle, consultez la liste des composants et versions pris en charge pour le package Instana Python.

Pour plus d'informations sur la surveillance des applications Python, consultez la page Surveillance Python.

Webhook Instana AutoTrace

Le webhook Instana AutoTrace permet d'instrumenter automatiquement vos processus Python sur l'ensemble d'un cluster Kubernetes.

Contextes d'exécution Python

Remarque : les versions Instana, Python, 2.5.4 et antérieures prennent en charge le traçage pour les bibliothèques Tornado, asyncio et aiohttp uniquement sur les environnements d'exécution Python jusqu'à la version 3.10.
Python Versions Instana Python version du paquet
CPython >= 3.9 et <= 3.14 >= 3.9.0
CPython >= 3.8 et <= 3.13 >= 3.0.0
CPython >=3.8 et <3.13 >= 2.5.0
CPython > = 3.7 et < 3.10 < 2.5.0
CPython > = 2.7 et < = 3.6 < 2.0.0

Assistance à long terme

Instana suit le calendrier officiel de prise en charge à long terme (LTS) et de fin de vie (EOL) disponible sur Python.

Remarque : lorsqu'une version d' Python e arrive à sa date de fin de vie (EOL), Instana propose une année supplémentaire de support. Pour éviter tout problème, mettez régulièrement à jour votre version d' Python.

Environnements pris en charge

Le package Instana Python prend en charge un large éventail d'environnements.

Plateformes

Les plateformes et architectures de processeur suivantes sont prises en charge :

Plateforme x86_64/amd64 ppc64le s390x aarch64/arm64
Linux
Red Hat1
Windows2
AWS Fargate
AWS Lambda
Kubernetes
Google Cloud
Con teneurs3
IBM AIX4
IBM i5
LinuxOne
Remarque : le paquet Instana Python 3.5.0 a introduit la prise en ppc64le charge de s390 et, tandis que 3.6.0 a ajouté la prise en charge de Windows.

Traçage

Le package « Instana » ( Python ) prend en charge le traçage distribué sur d'autres plateformes, technologies et langages instrumentés par Instana.

Remarque : la colonne « Instana Python package version » fournit des informations supplémentaires sur les restrictions liées aux versions. La valeur de la colonne « Instana PythonAny version du paquet » indique que la version du paquet est supérieure ou égale à 3.0.0.
Remarque : certains des frameworks et bibliothèques pris en charge peuvent ne pas être disponibles sur toutes les architectures de processeur et toutes les plateformes.

Prise en charge des spécifications

Le tableau suivant répertorie les spécifications prises en charge par le package Instana Python :

Spécification Politique de support Version minimale Version maximale Instana Python version du paquet
ASGI 45 jours 2.0.0 3.0 Tous
WSGI 0 jour PEP 333 1.0 1.0.1 Tous

HTTP

Les tableaux suivants répertorient les frameworks et bibliothèques d' HTTP s pris en charge par le paquet Instana Python :

Infrastructures Web

Le tableau suivant répertorie les frameworks web d' HTTP s pris en charge par le package Python de l' Instana :

Infrastructure Politique de support Version minimale Version maximale Instana Python version du paquet
Django 45 jours 1.11.0 6.0.6 Tous
FastAPI 45 jours 0.51.0 0.136.3 Tous
Flask 45 jours 0.12.0 3.1.3 Tous
Pyramid 45 jours 1.6.5 2.1 Tous
Sanic A la demande 21.9.0 25.12.1 Tous
Starlette 45 jours 0.12.13 1.3.1 Tous
Tornado 45 jours 6.0.0 6.5.7 Tous
Outil 45 jours 2.2.0 3.1.8 >= 3.15.0

Clients et bibliothèques

Les tableaux suivants répertorient les clients et bibliothèques d' HTTP s pris en charge par le paquet Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
aiohttp 45 jours 3.1.0 3.14.1 Tout élément dont Python >= 3.9
Httpx 45 jours 0.20.0 0.28.1 >= 3.5.0
Demandes 45 jours 2.16.1 2.34.2 Tous
Urllib3 45 jours 1.26.5 2.7.0 Tous

RPC

Les tableaux suivants répertorient les bibliothèques d' RPC s prises en charge par le paquet Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
grpcio 45 jours 1.14.1 1.81.1 Tous
Spyne 45 jours 2.13.1a0 2.14.0 >= 3.4.0 avec Python < 3.12

Bases de données

Les tableaux suivants répertorient les bibliothèques de bases de données prises en charge par le package Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
AWS DynamoDB6 45 jours 1.15.0 1.43.11 Tous
AWS S36 45 jours 1.15.0 1.43.11 Tous
Cassandra -conducteur 45 jours 3.20.2 3.30.0 Tous
Couchbase A la demande 2.3.5 2.5.12 Tous
mysqlclient 45 jours 1.3.14 2.2.8 Tous
PyMySQL 45 jours 0.6.7 1.2.0 Tous
pymongo 45 jours 3.7.0 4.17.0 Tous
Psycopg2 45 jours 2.7.2 2.9.12 Tous
Redis 45 jours 2.10.6 8.0.0 Tous
SQLAlchemy 45 jours 1.1.5 2.0.51 Tous

Messagerie

Les tableaux suivants répertorient les bibliothèques de messagerie prises en charge par le paquet Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
Aioamqp 45 jours 0.15.0 0.15.0 >= 3.4.0
Aio-pika 45 jours 9.1.0 9.6.2 >= 3.5.0
Confluent Kafka 45 jours 2.0.0 2.14.2 >= 3.4.0
Kafka -python 45 jours 2.0.0 2.2.15 >= 3.4.0 avec Python < 3.12
Kafka -python-ng 45 jours 2.0.0 2.2.3 >= 3.4.0 avec Python >= 3.12
pika 45 jours 1.0.0 1.4.1 Tous

Services de cloud

Les tableaux suivants répertorient les bibliothèques de services cloud prises en charge par le package Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
Boto3 (Kit de développement logiciel AWS ) 45 jours 1.15.0 1.43.11 Tous
Google - cloud-pubsub7 45 jours 2.0.0 2.39.0 Tous
google-cloud-storage 45 jours 1.24.0 3.12.0 Tous

Python modules intégrés

Les tableaux suivants répertorient les bibliothèques intégrées d' Python prises en charge par le paquet Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
Asyncio 0 jour 1.4 23.7.0 Tous
Journalisation 0 jour 4.3.0 5.5.3 Tous

Autres bibliothèques

Les tableaux suivants répertorient les autres bibliothèques prises en charge par le paquet Instana Python :

Bibliothèque Politique de support Version minimale Version maximale Instana Python version du paquet
gevent A la demande 23.9.0.post1 26.5.0 >= 3.4.0
Celery 45 jours 4.3.0 5.6.3 Tous

Notes et limites relatives au traçage

Consultez les autorisations et les restrictions du Tracer de l' Instana Python.

Autorisation de créer un fil de discussion

Le traceur Instana Python a besoin d'une autorisation pour créer et lancer des objets threading.Timer Python. Sur la plupart des systèmes, cette autorisation est accordée par défaut. Dans certains scénarios de conteneurisation imbriquée, par exemple dans certaines versions de conteneurs de type « Docker -in- Docker », cette autorisation n'est pas accordée par défaut.

Si vous voyez des exceptions telles que RuntimeError: can't start new thread, des droits insuffisants sont la cause la plus probable. Si vous mettez à niveau ou modifiez le conteneur « Docker » de « Docker », mais que les autorisations requises ne sont pas accordées au conteneur d'application interne, vous pouvez alors utiliser --privileged l'autorisation en dernier recours pour démarrer le conteneur d'application.

Suivi au-delà des limites des threads

Le package Instana Python ne prend pas en charge le traçage au-delà des limites des threads. Par exemple, lorsqu'une demande est traitée pour la première fois sur une seule unité d'exécution, puis que la charge de travail est distribuée à plusieurs autres unités d'exécution avec l'aide de multiprocessing.ThreadPool, les appels sortants qui se produisent dans ces autres unités d'exécution ne sont pas capturés. Etant donné que chaque plage d'exit doit avoir une plage d'entrée et que la plage d'entrée initiale est hors de la portée de l'unité d'exécution, les appels sortants de ce type ne sont pas enregistrés. Cela est dû aux caractéristiques intrinsèques de l' OpenTracing par défaut ThreadLocalScopeManager et à l'absence d'un gestionnaire ThreadPool de portée spécifique.

Tracé avec plusieurs traceurs

Il n'est pas pris en charge de suivre simultanément une application Python à l'aide d' Instana et d'un outil de traçage tiers, par exemple New Relic ou OpenTelemetry.

Serveurs Web pris en charge

Le package « Instana » Python prend en charge les serveurs Web suivants :

  • uWSGI
  • Gunicorn
  • mod_wsgi
  • Nginx WSGI
  • uvicorn

Collecte de données du capteur

Le capteur Instana Python recueille les données suivantes :

Configuration suivie

Le capteur Instana Python recueille les données de configuration suivantes :

  • Nom
  • Environnement d'exécution
  • PID
  • Modules chargés

Métriques

Le capteur Instana Python recueille les indicateurs suivants :

  • Activité GC
  • Utilisation de la mémoire
  • Unités d'exécution
  • Pagination
  • E-S
  • Evénements
  • Changement de contexte

AutoProfile

Le package Instana Python génère les profils suivants :

Profils Versions de Python Plateformes
Utilisation de l'UC > = 2.7 et > = 3.4 Linux et macOS
Taux d'allocation de mémoire >= 3.4 Linux et macOS
Appels bloquants >= 3.4 Linux et macOS

Informations supplémentaires

  1. Le package Instana Python prend en charge les versions suivantes d' Red Hat Enterprise Linux : RHEL 8.10, RHEL 9.6 et RHEL 10.0. ↩︎

  2. Le package « Instana » ( Python ) prend en charge les versions suivantes d' Windows : Windows 11 et Windows Server 2025. ↩︎

  3. Docker, Podman et Rancher sont les moteurs de conteneurs et les outils de gestion de conteneurs pris en charge.

  4. Le package « Instana » ( Python ) prend en charge les versions suivantes d' AIX : 7.2 et 7.3. ↩︎

  5. Le package « Instana » ( Python ) prend en charge « IBM i » ( 7.5 ). ↩︎

  6. AWS DynamoDB et AWS S3 sont gérés via le package Boto3. ↩︎

  7. Le package « Instana » Python ne prend en charge que la diffusion de messages en mode « pull » du service Pub/Sub d' Google. ↩︎