Python risoluzione dei problemi

Tipo di problema di monitoraggio: python_sensor_not_installed

Il processo " Python " viene eseguito su una piattaforma che Instana non supporta per la strumentazione automatica, e per la strumentazione del processo non vengono utilizzati né il metodo "Activating Without Code Changes" né quello "Activating With Code Changes".

1. Controlla i registri dell'Host Agent su Instana per verificare se sono presenti messaggi relativi al processo Python.

   Molti processi Python vengono monitorati automaticamente da remoto. Nei casi in cui tale strumentazione non sia possibile, l'agente host potrebbe registrare un messaggio che segnala un problema.

2. Verifica che il tuo ambiente sia supportato e che tu stia utilizzando una versione supportata di Python

   Prima di dedicare troppo tempo alla diagnosi di un problema, assicurati innanzitutto che il componente e l'ambiente in questione siano supportati. Un elenco di tutti i componenti supportati è disponibile alla pagina Python, nella sezione "Componenti e versioni supportati".

3. Convalida le fasi di installazione

   Verifica se questa procedura è stata configurata tramite un webhook di AutoTrace o manualmente.

   Se il processo è monitorato tramite un webhook di AutoTrace, assicurati che i prerequisiti siano soddisfatti e che il webhook funzioni correttamente.

   Se manuale, verificare che le fasi di installazione manuale siano state seguite correttamente.

4. Verificare che il pacchetto Instana Python sia installato e disponibile per l'applicazione

   Per verificarlo, cerca instana nel file requirements.txt dell'applicazione Python.

   In alternativa, dall'ambiente applicativo Python è possibile eseguire il comando pip list, che elenca tutti i pacchetti Python disponibili per l'applicazione Python. Verifica che il pacchetto Instana Python sia presente in quell'elenco.

5. Assicurati che il pacchetto Instana sia aggiornato all'ultima versione.

   L'ultima versione disponibile è reperibile su PyPI.

   Nel requirements.txt, è necessario verificare che accanto al nome sia indicata l'ultima versione del pacchetto Instana Python, ad esempio instana==x.x.x. pip list emette anche i numeri di versione nell'elenco generato.

6. Verificare che Instana sia presente nell'output del log dell'applicazione.

   I log dell'applicazione o del container devono sempre contenere un messaggio di avvio simile a Stan is on the scene. Starting Instana instrumentation version x.x.x

   Se questo messaggio non viene visualizzato, è probabile che il pacchetto non sia installato o che le istruzioni per l'installazione manuale non siano state seguite correttamente.

7. Attiva l'output di debug e ricontrolla i log dell'applicazione o del container.

   Imposta la variabile di ambiente INSTANA_DEBUG=true per il processo Python e riconvalida i log dell'applicazione o del contenitore (come #6).

   Presta particolare attenzione per verificare se sono presenti messaggi di errore relativi a Instana.

8. Prova ad avviare l'applicazione Python in modalità dettagliata da una console

   Un esempio di come avviare il sistema dipende in gran parte dall'applicazione Python in questione. Ad esempio, se l'applicazione Python è contenuta in app.py , è possibile eseguire i seguenti comandi:

   export INSTANA_DEBUG=true
   python app.py
   

   Presta particolare attenzione per verificare se nell'output dell'applicazione Python compaiono messaggi di errore relativi a Instana.

9. Archiviare un ticket di supporto.

Se hai verificato tutti i passaggi e il processo " Python " continua a non comparire nella dashboard " Instana ", invia una richiesta di assistenza.

Il ticket di assistenza deve contenere:

1. Dettagli dell'ambiente; piattaforma, versione Python , framework in uso
2. Riepilogo di tutte le verifiche precedenti.

Se un'applicazione Python viene arrestata in modo anomalo dalla traccia e il messaggio RuntimeError: can't start new thread viene visualizzato nei log dell'applicazione, la causa più probabile è che sia necessario concedere le autorizzazioni all'applicazione. Per ulteriori informazioni sulla traccia e sull'autorizzazione di avvio del thread, consultare Traccia delle note e delle limitazioni.

1. File di un ticket di supporto

   Se il webhook AutoTrace sta mandando in crash un processo Python, proporre un ticket.

2. Arresta la strumentazione AutoTrace webhook per il processo specifico.

   Per ulteriori informazioni su come contrassegnare una risorsa per il webhook di AutoTrace, consultare Instana AutoTrace webhook. È inoltre possibile configurare un webhook di AutoTrace in modo da ignorare un intero spazio dei nomi di risorse. Inoltre, è possibile disattivare completamente il Tracer di Python nel webhook. Questo passo è una soluzione temporanea fino a quando la causa principale dell'arresto anomalo non viene identificata e corretta.

3. Utilizzare il metodo di installazione manuale

   Nel frattempo, puoi in alternativa utilizzare il metodo di installazione manuale per la visibilità Python .

gevent Il "monkey patching" interessa molte delle librerie standard di Python e uno dei geventrequisiti è che tale operazione venga eseguita il prima possibile durante il processo di avvio.

Se si utilizza il metodo di installazione «Attivazione senza modifiche al codice » (con la variabile AUTOWRAPT_BOOTSTRAP d'ambiente) o il webhook AutoTrace e il gevent pacchetto con Instana Python Tracer in una versione precedente alla 2.5.0, è possibile che si verifichi il seguente errore:

RecursionError: maximum recursion depth exceeded while calling a Python object
[Previous line repeated 212 more times]
super(SSLContext, SSLContext).options.__set__(self, value)

Questo errore si verifica perché autowrapt carica il pacchetto instana Python prima di qualsiasi altro (anche gevent).

In questo caso, utilizza Instana Python Tracer 2.5.0 o versioni successive, oppure passa al metodo di installazione manuale (aggiungendo import instana al tuo codice).

Se si utilizza il metodo di installazione «Attivazione senza modifiche al codice » (con la variabile AUTOWRAPT_BOOTSTRAP d'ambiente), oppure il webhook AutoTrace e i pacchetti Djangogevent e con Instana Python Tracer 2.5.0 o versioni successive, è possibile che venga visualizzato il seguente errore:

django.core.exceptions.ImproperlyConfigured: Requested settings, but settings are not configured. You must either define the environment variable DJANGO_SETTINGS_MODULE or call settings.configure() before accessing settings.

Assicurati quindi che la variabile DJANGO_SETTINGS_MODULE d'ambiente sia impostata prima dell'avvio dell'autotracing, come specificato nella documentazione di Django. Se l'impostazione della variabile DJANGO_SETTINGS_MODULE d'ambiente prima dell'avvio dell'autotracing non è ancora sufficiente, è possibile utilizzare il metodo "Attivazione tramite modifiche al codice" dell'attivazione del pacchetto.

Il webhook Instana AutoTrace è ora il metodo supportato per la strumentazione automatica delle applicazioni Python monitorate da Instana.

Per completare la migrazione al webhook di AutoTrace, è necessario rimuovere i seguenti elementi dalle proprie applicazioni:

1. Il pacchetto " Instana " Python

   Il webhook Instana AutoTrace gestisce in modo indipendente il pacchetto Instana Python per la tua applicazione. Non è necessario che tu o la tua organizzazione lo installiate manualmente.

   Assicurati di rimuovere il pacchetto instana Python dal tuo requirements.txt, Pipfile, o virtualenv.

   Se stai effettuando chiamate a OpenTracing API, devi invece opentracing importare esplicitamente e assicurarti che le chiamate vengano effettuate su quel pacchetto (ad esempio, opentracing.tracer.start_active_span). Instana riceve comunque le tracce risultanti.

2. Rimuovere la variabile d'ambiente AUTOWRAPT_BOOTSTRAP

   Questa variabile d'ambiente viene utilizzata per caricare il pacchetto Instana Python senza che sia necessario apportare modifiche al codice. Con il webhook Instana AutoTrace, questa variabile d'ambiente non è più necessaria.

3. Rimuovi tutte le chiamate import instana

   Python AutoTrace applica automaticamente il pacchetto Instana Python alle tue applicazioni Python. È possibile rimuovere le importazioni manuali del pacchetto Instana Python.