Připojovací řetězce

Tento článek ukazuje, jak používat připojovací řetězec.

Přehled

Poznámka:

Následující dokumentace se spoléhá na rozhraní API Přehledy Application Přehledy Classic. Dlouhodobým plánem pro application Přehledy je shromažďovat data pomocí OpenTelemetry. Další informace najdete v tématu Povolení OpenTelemetry služby Azure Monitor pro aplikace .NET, Node.js, Python a Java.

Připojení ionové řetězce definují, kam se mají odesílat telemetrická data.

Páry klíč-hodnota poskytují uživatelům snadný způsob, jak definovat kombinaci přípon předpony pro každou službu nebo produkt Přehledy aplikace.

Poznámka:

Podpora příjmu dat založeného na instrumentačním klíči skončí 31. března 2025. Příjem klíčů instrumentace bude dál fungovat, ale už nebudeme poskytovat aktualizace ani podporu pro tuto funkci. Přechod na připojovací řetězec, abyste mohli využívat nové funkce.

Přehled scénáře

Scénáře nejvíce ovlivněné touto změnou:

• Výjimky brány firewall nebo přesměrování proxy serveru:

  V případech, kdy se vyžaduje monitorování intranetového webového serveru, naše dřívější řešení vás požádalo, abyste do konfigurace přidali jednotlivé koncové body služby. Další informace najdete v tématu Můžu monitorovat intranetový webový server? Připojení řetězce nabízejí lepší alternativu snížením tohoto úsilí na jedno nastavení. Jednoduchý předpona, dodatek přípony, umožňuje automatické základní soubory a přesměrování všech koncových bodů na správné služby.

• Suverénní nebo hybridní cloudová prostředí:

  Uživatelé můžou odesílat data do definované oblasti Azure Government. Pomocí připojovací řetězec můžete definovat nastavení koncového bodu pro intranetové servery nebo nastavení hybridního cloudu.

Začínáme

Začněte tím, že si projděte následující části.

Vyhledání připojovacího řetězce

Vaše připojovací řetězec se zobrazí v části Přehled prostředku Přehledy aplikace.

Schéma

Prvky schématu jsou vysvětleny v následujících částech.

Maximální délka

Připojení má maximální podporovanou délku 4 096 znaků.

Páry klíč-hodnota

Připojovací řetězec se skládá ze seznamu nastavení reprezentovaných jako páry klíč-hodnota oddělené středníkem:key1=value1;key2=value2;key3=value3

Syntaxe

• InstrumentationKey (například 000000000-0000-0000-0000-00000000000000). InstrumentationKeyje povinné pole.
• Authorization (například ikey). Toto nastavení je volitelné, protože dnes podporujeme pouze autorizaci ikey.
• EndpointSuffix (například applicationinsights.azure.cn). Nastavení přípony koncového bodu říká sadě SDK, ke kterému cloudu Azure se má připojit. Sada SDK sestaví zbytek koncového bodu pro jednotlivé služby.
• Explicitní koncové body Libovolnou službu je možné explicitně přepsat v připojovací řetězec:
  • IngestionEndpoint (například https://dc.applicationinsights.azure.com)
  • LiveEndpoint (například https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (například https://profiler.monitor.azure.com)
  • SnapshotEndpoint (například https://snapshot.monitor.azure.com)

Schéma koncového bodu

<prefix>.<suffix>

• Předpona: Definuje službu.
• Přípona: Definuje běžný název domény.

Platné přípony

• applicationinsights.azure.cn
• applicationinsights.us

Další informace najdete v tématu Oblasti, které vyžadují úpravy koncového bodu.

Platné předpony

• Příjem telemetrie: dc
• Živé metriky: live
• Profiler: profiler
• Snímek: snapshot

Je připojovací řetězec tajný kód?

Připojovací řetězec obsahuje klíč, což je jedinečný identifikátor používaný službou příjmu dat k přidružení telemetrie ke konkrétnímu prostředku Přehledy aplikace. Tyto jedinečné identifikátory klíče nejsou tokeny zabezpečení ani klíče zabezpečení. Pokud chcete chránit prostředek AI před zneužitím, koncový bod příjmu dat poskytuje ověřené možnosti příjmu telemetrie na základě ID Microsoft Entra.

Poznámka:

Sada Application Přehledy JavaScript SDK vyžaduje předání připojovací řetězec během inicializace a konfigurace. V klientských prohlížečích je možné ho zobrazit ve formátu prostého textu. Neexistuje žádný snadný způsob, jak pro telemetrii prohlížeče použít ověřování založené na ID Microsoft Entra. Pokud potřebujete zabezpečit telemetrii služby, doporučujeme zvážit vytvoření samostatného prostředku Přehledy aplikace pro telemetrii prohlížeče.

Příklady řetězců Připojení ion

Tady je několik příkladů připojovací řetězec.

řetězec Připojení ion s příponou koncového bodu

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

V tomto příkladu připojovací řetězec určuje příponu koncového bodu a koncové body služby sady SDK:

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI regionální služby jsou založené na zadané příponě koncového bodu:
  • Požití: https://dc.ai.contoso.com
  • Živé metriky: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Ladicí program: https://snapshot.ai.contoso.com

řetězec Připojení s explicitními přepsáními koncových bodů

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/;

V tomto příkladu připojovací řetězec určuje explicitní přepsání pro každou službu. Sada SDK používá přesné koncové body poskytnuté beze změny:

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI regionální služby jsou založené na explicitních hodnotách přepsání:
  • Požití: https://custom.com:111/
  • Živé metriky: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Ladicí program: https://custom.com:444/

řetězec Připojení s explicitní oblastí

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

V tomto příkladu připojovací řetězec určuje oblast USA – středojiž:

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI regionální služby jsou založené na explicitních hodnotách přepsání:
  • Požití: https://southcentralus.in.applicationinsights.azure.com/

Spuštěním následujícího příkazu v Azure CLI zobrazte seznam dostupných oblastí:

az account list-locations -o table

Nastavení připojovací řetězec

Připojení řetězce jsou podporovány v následujících verzích sady SDK:

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

Můžete nastavit připojovací řetězec v kódu nebo pomocí proměnné prostředí nebo konfiguračního souboru.

Proměnná prostředí

řetězec Připojení ion:APPLICATIONINSIGHTS_CONNECTION_STRING

Ukázky kódu

.NET 5.0+

1. Nastavte v souboru připojovací řetězecappsettings.json:

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

2. Načtení připojovací řetězec Program.cs při registraci ApplicationInsightsTelemetry služby:

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

.NET Framework

Nastavení vlastnosti TelemetryConfiguration.PřipojeníionString nebo Application Přehledy ServiceOptions.PřipojeníionString.

Explicitně nastavte připojovací řetězec v kódu:

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/"
};

Nastavte připojovací řetězec pomocí konfiguračního souboru:

<?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

V konfiguračním applicationinsights.json souboru můžete nastavit připojovací řetězec:

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

Další informace najdete v tématu Připojení ion konfigurace řetězce.

JavaScript

JavaScript nepodporuje použití proměnných prostředí. K dispozici jsou dvě možnosti:

• Pokud chcete použít skript zavaděče sady JavaScript (Web) SDK, přečtěte si téma Skript zavaděče sady JavaScript (Web) SDK.
• Ruční nastavení:

  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

Doporučujeme, aby uživatelé nastavili proměnnou prostředí.

Explicitní nastavení připojovací řetězec:

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))

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Vyžadují nové oblasti Azure použití připojovací řetězec?

Nové oblasti Azure vyžadují použití připojovací řetězec místo instrumentačních klíčů. řetězec Připojení ion identifikuje prostředek, který chcete přidružit k datům telemetrie. Umožňuje také upravit koncové body, které váš prostředek používá jako cíl pro vaši telemetrii. Zkopírujte připojovací řetězec a přidejte ho do kódu aplikace nebo do proměnné prostředí.

Mám používat připojovací řetězec nebo instrumentační klíče?

Místo instrumentačních klíčů doporučujeme používat připojovací řetězec.

Další kroky

Začínáme při spuštění:

• Virtuální počítače Azure a aplikace hostované službou IIS služby Azure Virtual Machine Scale Sets
• Server IIS
• Funkce Web Apps služby Aplikace Azure

Začínáme při vývoji:

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