Documentazione / Collega / Collega le tue app
Python Pre-alpha
Il pacchetto closeyourit manda errori, log e metriche da applicazioni Python lato server.
Cosa raccoglie
- gli errori non gestiti;
- i log, dal logging standard di Python;
- le metriche di durata, con
measure(); - le query lente, con SQLAlchemy;
- la durata dei task Celery;
- la telemetria d'uso, se la accendi.
Ha integrazioni per Django, Flask, WSGI, ASGI, Celery, HTTP e SQLAlchemy. La versione 0.4.0 aggiunge anche la raccolta delle query Django e adattatori espliciti FastAPI/Starlette.
Cosa serve
- Python 3.11 o più recente.
Installa
pip install closeyourit
Le integrazioni si installano una per una:
pip install "closeyourit[django]"
pip install "closeyourit[flask]"
pip install "closeyourit[celery]"
Configura
Legge queste variabili dall'ambiente dell'applicazione:
| Variabile | A cosa serve |
|---|---|
CLOSEYOURIT_ENDPOINT_URL | l'indirizzo della tua installazione |
CLOSEYOURIT_TOKEN | il token segreto, solo lato server |
CLOSEYOURIT_PROJECT_ID | l'ID del progetto |
CLOSEYOURIT_ENVIRONMENT | l'ambiente |
CLOSEYOURIT_RELEASE | la versione dell'app |
Se manca qualcosa l'SDK si spegne da solo, senza dare errore.
Nuovi adattatori
La versione 0.4.0 aggiunge DjangoMiddleware(query_monitoring=True) e i profili query reversibili instrument_django(client), da attivare esplicitamente. FastAPI e Starlette usano instrument_fastapi(api, client) o instrument_starlette(api, client): passa al server ASGI il risultato restituito. Installa prima dell’avvio e usa uninstall() per rimuovere l’integrazione. L’applicazione resta responsabile della chiusura del client.
Le aggiunte hanno prove locali del framework e dell’invio, non una garanzia di pubblicazione. Consulta il README della versione esatta installata. OpenTelemetry lato server è un percorso separato: le metriche native di durata non sono tracce OTLP.