Stringhe di connessione

Questo articolo illustra come usare stringa di connessione.

Panoramica

Nota

La documentazione seguente si basa sull'API classica di Application Insights. Il piano a lungo termine per Application Insights consiste nel raccogliere dati usando OpenTelemetry. Per altre informazioni, vedere Abilitare OpenTelemetry di Monitoraggio di Azure per le applicazioni .NET, Node.js, Python e Java.

Connessione stringhe definiscono dove inviare i dati di telemetria.

Le coppie chiave-valore offrono agli utenti un modo semplice per definire una combinazione di suffissi di prefisso per ogni servizio o prodotto di Application Insights.

Nota

Il 31 marzo 2025, il supporto per l'inserimento delle chiavi di strumentazione terminerà. L'inserimento di chiavi di strumentazione continuerà a funzionare, ma non forniamo più aggiornamenti o supporto per la funzionalità. Passare alle stringa di connessione per sfruttare le nuove funzionalità.

Panoramica dello scenario

Gli scenari più interessati da questa modifica:

• Eccezioni del firewall o reindirizzamenti proxy:

  Nei casi in cui è necessario il monitoraggio per il server Web Intranet, la soluzione precedente richiede di aggiungere singoli endpoint di servizio alla configurazione. Per altre informazioni, vedere è possibile monitorare un server Web Intranet? le stringhe di Connessione ion offrono un'alternativa migliore riducendo questo sforzo a una singola impostazione. Una semplice modifica di prefisso, suffisso, consente il popolamento automatico e il reindirizzamento di tutti gli endpoint ai servizi corretti.

• Ambienti cloud sovrani o ibridi:

  Gli utenti possono inviare dati a un'area di Azure per enti pubblici definita. Usando stringa di connessione, è possibile definire le impostazioni degli endpoint per i server Intranet o le impostazioni del cloud ibrido.

Operazioni preliminari

Esaminare le sezioni seguenti per iniziare.

Trovare la stringa di connessione

Il stringa di connessione viene visualizzato nella sezione Panoramica della risorsa di Application Insights.

Schema

Gli elementi dello schema sono illustrati nelle sezioni seguenti.

Lunghezza massima

La connessione ha una lunghezza massima supportata di 4.096 caratteri.

Coppie chiave-valore

Un stringa di connessione è costituito da un elenco di impostazioni rappresentate come coppie chiave-valore separate da un punto e virgola:key1=value1;key2=value2;key3=value3

Sintassi

• InstrumentationKey (ad esempio, 000000000-0000-0000-0000-000000000000000). InstrumentationKey è un campo obbligatorio .
• Authorization (ad esempio, ikey). Questa impostazione è facoltativa perché attualmente è supportata solo l'autorizzazione ikey.
• EndpointSuffix (ad esempio, applicationinsights.azure.cn). L'impostazione del suffisso dell'endpoint indica all'SDK il cloud di Azure a cui connettersi. L'SDK assembla il resto dell'endpoint per i singoli servizi.
• Endpoint espliciti. Qualsiasi servizio può essere sottoposto a override in modo esplicito nella stringa di connessione:
  • IngestionEndpoint (ad esempio, https://dc.applicationinsights.azure.com)
  • LiveEndpoint (ad esempio, https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (ad esempio, https://profiler.monitor.azure.com)
  • SnapshotEndpoint (ad esempio, https://snapshot.monitor.azure.com)

Schema endpoint

<prefix>.<suffix>

• Prefisso: definisce un servizio.
• Suffisso: definisce il nome di dominio comune.

Suffissi validi

• applicationinsights.azure.cn
• applicationinsights.us

Per altre informazioni, vedere Aree che richiedono la modifica dell'endpoint.

Prefissi validi

• Inserimento dati di telemetria: dc
• Metriche attive: live
• Profiler: profiler
• Snapshot: snapshot

Il stringa di connessione è un segreto?

Il stringa di connessione contiene una chiave ikey, ovvero un identificatore univoco usato dal servizio di inserimento per associare i dati di telemetria a una risorsa specifica di Application Insights. Questi identificatori univoci ikey non sono token di sicurezza o chiavi di sicurezza. Se si vuole proteggere la risorsa di intelligenza artificiale da un uso improprio, l'endpoint di inserimento fornisce opzioni di inserimento dei dati di telemetria autenticate in base all'ID Microsoft Entra.

Nota

Application Insights JavaScript SDK richiede che il stringa di connessione venga passato durante l'inizializzazione e la configurazione. È visualizzabile in testo normale nei browser client. Non esiste un modo semplice per usare l'autenticazione basata su ID di Microsoft Entra per i dati di telemetria del browser. È consigliabile creare una risorsa di Application Insights separata per i dati di telemetria del browser se è necessario proteggere i dati di telemetria del servizio.

esempi di stringhe di Connessione ion

Ecco alcuni esempi di stringa di connessione.

stringa Connessione ion con un suffisso dell'endpoint

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

In questo esempio, il stringa di connessione specifica il suffisso dell'endpoint e l'SDK costruisce gli endpoint di servizio:

• Per impostazione predefinita, lo schema di autorizzazione è "ikey"
• Chiave di strumentazione: 00000000-0000-0000-0000-000000000000
• Gli URI del servizio a livello di area si basano sul suffisso dell'endpoint fornito:
  • Ingestione: https://dc.ai.contoso.com
  • Metriche attive: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

stringa Connessione ion con override espliciti dell'endpoint

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

In questo esempio, il stringa di connessione specifica le sostituzioni esplicite per ogni servizio. L'SDK usa gli endpoint esatti forniti senza modifiche:

• Per impostazione predefinita, lo schema di autorizzazione è "ikey"
• Chiave di strumentazione: 00000000-0000-0000-0000-000000000000
• Gli URI del servizio a livello di area si basano sui valori di override espliciti:
  • Ingestione: https://custom.com:111/
  • Metriche attive: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Debugger: https://custom.com:444/

stringa di Connessione ion con un'area esplicita

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

In questo esempio, il stringa di connessione specifica l'area Stati Uniti centro-meridionali:

• Per impostazione predefinita, lo schema di autorizzazione è "ikey"
• Chiave di strumentazione: 00000000-0000-0000-0000-000000000000
• Gli URI del servizio a livello di area si basano sui valori di override espliciti:
  • Ingestione: https://southcentralus.in.applicationinsights.azure.com/

Eseguire il comando seguente nell'interfaccia della riga di comando di Azure per elencare le aree disponibili:

az account list-locations -o table

Impostare un stringa di connessione

le stringhe di Connessione ion sono supportate nelle versioni dell'SDK seguenti:

• .NET v2.12.0
• Java v2.5.1 e Java 3.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0

È possibile impostare un stringa di connessione nel codice o usando una variabile di ambiente o un file di configurazione.

Variabile di ambiente

stringa Connessione ion:APPLICATIONINSIGHTS_CONNECTION_STRING

Esempi di codice

.NET 5.0+

1. Impostare il stringa di connessione nel appsettings.json file:

   {
     "ApplicationInsights": {
       "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
       }
   }
   

2. Recuperare il stringa di connessione in Program.cs durante la registrazione del ApplicationInsightsTelemetry servizio:

   var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
   builder.Services.AddApplicationInsightsTelemetry(options: options);
   

.NET Framework

Impostare la proprietà TelemetryConfiguration.ConnessioneionString o ApplicationInsightsServiceOptions.ConnessioneionString.

Impostare in modo esplicito il stringa di connessione nel codice:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
};

Impostare il stringa di connessione usando un file di configurazione:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/</ConnectionString>
</ApplicationInsights>

Java

È possibile impostare il stringa di connessione nel applicationinsights.json file di configurazione:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
}

Per altre informazioni, vedere configurazione della stringa di Connessione ion.

JavaScript

JavaScript non supporta l'uso delle variabili di ambiente. è possibile procedere in due modi:

• Per usare lo script del caricatore SDK JavaScript (Web), vedere Script del caricatore SDK JavaScript (Web).
• Installazione manuale:

  import { ApplicationInsights } from '@microsoft/applicationinsights-web'
  
  const appInsights = new ApplicationInsights({ config: {
     connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
     /* ...Other Configuration Options... */
  } });
  appInsights.loadAppInsights();
  appInsights.trackPageView();
  

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/");
appInsights.start();

Python

È consigliabile che gli utenti impostino la variabile di ambiente.

Per impostare in modo esplicito il stringa di connessione:

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/'), sampler=ProbabilitySampler(1.0))

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Le nuove aree di Azure richiedono l'uso di stringhe di connessione?

Le nuove aree di Azure richiedono l'uso di stringhe di connessione anziché di chiavi di strumentazione. Connessione stringa identifica la risorsa da associare ai dati di telemetria. Consente anche di modificare gli endpoint usati dalla risorsa come destinazione per i dati di telemetria. Copiare il stringa di connessione e aggiungerlo al codice dell'applicazione o a una variabile di ambiente.

È necessario usare stringhe di connessione o chiavi di strumentazione?

È consigliabile usare stringa di connessione anziché le chiavi di strumentazione.

Passaggi successivi

Introduzione in fase di esecuzione a:

• Macchine virtuali di Azure e app ospitate in IIS set di scalabilità di macchine virtuali
• Server IIS
• App Web funzionalità del servizio app Azure

Introduzione in fase di sviluppo a:

• ASP.NET
• ASP.NET Core
• Java
• Node.js
• Python