Instrumentare un'app per il monitoraggio
A livello di base, la "strumentazione" consente semplicemente a un'applicazione di acquisire i dati di telemetria. Esistono due metodi per instrumentare l'applicazione:
- Strumentazione automatica (strumentazione automatica)
- Strumentazione manuale
La strumentazione automatica abilita la raccolta di dati di telemetria tramite la configurazione senza toccare il codice dell'applicazione. Anche se è più conveniente, tende a essere meno configurabile. Non è disponibile anche in tutte le lingue. Vedere Strumenti automatici supportati per ambienti e lingue. Quando è disponibile l'installazione automatica, è il modo più semplice per abilitare Application Insights di Monitoraggio di Azure.
La strumentazione manuale sta codificando in base all'API Application Insights o OpenTelemetry. Nel contesto di un utente, si riferisce in genere all'installazione di un SDK specifico del linguaggio in un'applicazione. Ciò significa che è necessario gestire gli aggiornamenti alla versione più recente del pacchetto manualmente. È possibile usare questa opzione se è necessario effettuare chiamate di dipendenza personalizzate o chiamate API che non vengono acquisite per impostazione predefinita con l'installazione automatica. Sono disponibili due opzioni per la strumentazione manuale:
Abilitazione tramite Application Insights SDK
È necessario installare Application Insights SDK solo nelle circostanze seguenti:
- Sono necessari eventi e metriche personalizzati
- È necessario controllare il flusso dei dati di telemetria
- La strumentazione automatica non è disponibile (in genere a causa di limitazioni del linguaggio o della piattaforma)
Per usare l'SDK, installare un piccolo pacchetto di strumentazione nell'app e quindi instrumentare l'app Web, gli eventuali componenti in background e JavaScript all'interno delle pagine Web. L'app e i relativi componenti non devono necessariamente essere ospitati in Azure. La strumentazione monitora l'app e indirizza i dati di telemetria a una risorsa di Application Insights tramite un token univoco.
Un elenco di versioni e nomi dell'SDK è ospitato in GitHub. Per altre informazioni, vedere Versione dell'SDK.
Abilitare tramite OpenTelemetry
Microsoft ha collaborato con gli stakeholder del progetto di due progetti di telemetria open source più diffusi, OpenCensus e OpenTracing. Insieme, abbiamo contribuito a creare un singolo progetto, OpenTelemetry. OpenTelemetry include contributi di tutti i principali fornitori di cloud e application performance management (APM) e vive all'interno di Cloud Native Computing Foundation (CNF). Microsoft è un membro Platinum del CNF.
Alcuni termini legacy in Application Insights confondono a causa della convergenza del settore in OpenTelemetry. Nella tabella seguente vengono evidenziate queste differenze. I termini openTelemetry sostituiscono i termini di Application Insights.
| Application Insights | OpenTelemetry |
|---|---|
| Autocollectors | Librerie di strumentazione |
| Channel | Esportatore |
| Senza codice/basato su agente | Strumentazione automatica |
| Tracce | Registri |
| Richieste | Intervalli di server |
| Dipendenze | Altri tipi span (client, interno e così via) |
| ID operazione | ID di traccia |
| ID o ID padre dell'operazione | ID intervallo |